Lumberyard
Guía del usuario (Version 1.21)

Creación y uso de anotaciones

El generador de perfiles está en versión preliminar y sujeto a cambios.

En el generador de perfiles, las anotaciones constituyen una forma cómoda de resaltar la información de registro por fotogramas de los datos capturados desde su aplicación. Después de aprender a usar las anotaciones en el generador de perfiles, podrá modificar su aplicación para que aparezcan en el generador de perfiles.

Uso de las anotaciones

Las anotaciones de la herramienta de generación de perfiles de Lumberyard marcan los fotogramas de los datos capturados que tienen información de registro asociada. De forma predeterminada, las anotaciones están desactivadas.

Para utilizar las anotaciones

  1. Para activar anotaciones en la herramienta de generación de perfiles de Lumberyard, haga clic en Configure Annotations (Configurar anotaciones):

    
              Configure Annotations (Configurar anotaciones)
    
              Cuadro de diálogo Configure Annotations (Configurar anotaciones)

    El cuadro de diálogo Configure Annotations (Configurar anotaciones) contiene una lista de las anotaciones disponibles y sus colores de visualización. Para obtener información acerca de cómo crear anotaciones para su aplicación, consulte Creación de anotaciones.

  2. Cuando selecciona una anotación en el cuadro de diálogo, se muestran un marcador y una línea del mismo color en la visualización del canal. Tenga en cuenta que es posible que tenga que desplazarse horizontalmente para encontrar el marcador.

    
              Marcador de anotaciones
  3. Para visualizar los detalles de las anotaciones que se han producido en un fotograma, detenga el puntero sobre el marcador de una anotación. En la imagen del ejemplo, las direcciones IP se han eliminado.

    
              Contenido de la anotación

Creación de anotaciones

Para crear una anotación, añada una o varias líneas de código de registro C++ a su aplicación. El código añadido indica al sistema de registro de Lumberyard que incluya la información de registro que especifica como parte de su captura. Lumberyard transforma los mensajes registrados en anotaciones para el usuario. Si, en el generador de perfiles, se hace clic en Configure Annotations (Configurar anotaciones), en realidad se está escogiendo las anotaciones del sistema que se visualizarán (por ejemplo GridMate o MultiplayerProject).

Para crear una anotación, ponga una línea de código C++ como la siguiente en su aplicación:

AZ_TracePrintf("GridMate","Connection %s => %s (%s) (Connections=%d!\n")

El primer parámetro corresponde a la ventana (es decir, el sistema) del seguimiento (en este caso, GridMate) y el segundo al contenido del seguimiento que se mostrará como anotación.

El ejemplo da como resultado el texto de anotación siguiente:

GridMate - Connection <IP_Address>|64090 => <IP_Address>|57455 (Client) (Connections=1)!

El texto que se muestra en el generador de perfiles tiene este aspecto:


          Visualización de una anotación en el generador de perfiles

Alternativas a AZ_TracePrintf

En el código, en lugar de utilizar AZ_TracePrintf, puede utilizar AZ_Error o AZ_Warning, en función del grado de gravedad que desee. AZ_TracePrintf siempre registra un mensaje, pero desde el punto de vista de una inspección, corresponde a una gravedad mínima.

El siguiente ejemplo utiliza AZ_Error:

if (networkTableContext.ReadValue(elementIndex,forcedDataSetIndex)) { AZ_Error("ScriptComponent",forcedDataSetIndex >= 1 && forcedDataSetIndex <= ScriptComponentReplicaChunk::k_maxScriptableDataSets,"Trying to force Property (%s) to an invalid DataSetIndex(%i).",scriptProperty->m_name.c_str(),forcedDataSetIndex); if (forcedDataSetIndex >= 1 && forcedDataSetIndex <= ScriptComponentReplicaChunk::k_maxScriptableDataSets) { networkedTableValue.SetForcedDataSetIndex(forcedDataSetIndex); } } else { AZ_Error("ScriptComponent",false,"Trying to force Property (%s) to unknown DataSetIndex. Ignoring field.", scriptProperty->m_name.c_str()); }

En el ejemplo, si se produce una de las dos condiciones de error, se crea una anotación.

Visualización de anotaciones en el generador de perfiles de mensajes de seguimiento

Otra forma de confirmar que sus anotaciones estén en vigor consiste en utilizar el generador de perfiles de mensajes de seguimiento.

En el canal Logging (Registro) del generador de perfiles, haga clic en el icono de detalles del generador de perfiles Trace messages (Mensajes de seguimiento) para ver los sistemas de registro en vigor en el momento en curso:


          Icono de detalles de los mensajes de seguimiento

La instancia del generador de perfiles Trace messages (Mensajes de seguimiento) muestra todos los mensajes de seguimiento que se han generado desde que comenzó la captura hasta el fotograma analizado actualmente. Los mensajes se muestran con el mensaje más antiguo en la parte superior y los últimos mensajes en la parte inferior:


          Vista detallada de los mensajes de seguimiento

Puede utilizar Window Filter (Filtro de ventana) para mostrar el sistema o Message Filter (Filtro de mensajes) para mostrar el texto de los mensajes en los que esté interesado.

En el siguiente ejemplo, con el filtro "GridMate" aplicado, se muestra el mensaje especificado por la línea de código que se añadió a la aplicación:


          Vista de los detalles de los mensajes de seguimiento filtrados