zvlogevents.h

一个内存日志系统

#ifndef __ZEVIOLOG_EVENTS_H__
#define __ZEVIOLOG_EVENTS_H__


/******************************************************************************\
* Log Events                                                                   *
*                                                                              *
* This enumerated type defines all types of events which can be entered into   *
* the C-Ware Log.  One of these event IDs is stored in the lower-order 16 bits *
* of the first word of each log entry.                                         *
*                                                                              *
\******************************************************************************/

typedef enum tagZEVIO_LOG_EVENT
{
    // ZEVIOLog
    ZEVIO_EVENT_LOG_INITIALIZED,
    ZEVIO_EVENT_LOG_SUSPEND,
    ZEVIO_EVENT_LOG_RESUME,
    ZEVIO_EVENT_LOG_BUFFERFULL,

    // OpengGL command event
    ZEVIO_EVENT_OPENGL_Nop,
    ZEVIO_EVENT_OPENGL_JumpAddress_HEADER_LINK,
    ZEVIO_EVENT_OPENGL_JumpAddress_ADDR,
    ZEVIO_EVENT_OPENGL_JumpReturn,
    ZEVIO_EVENT_OPENGL_StopAndInterrupt,
    ZEVIO_EVENT_OPENGL_LoadWordToVBP_HEADER,
    ZEVIO_EVENT_OPENGL_LoadWordToVBP_ADDR,
    ZEVIO_EVENT_OPENGL_LoadWordToDRP_HEADER,
    ZEVIO_EVENT_OPENGL_LoadWordToDRP_ADDR,
    ZEVIO_EVENT_OPENGL_LoadDataToRenderer_HEADER_SIZE,
    ZEVIO_EVENT_OPENGL_LoadDataToRenderer_ADDRESS,
    ZEVIO_EVENT_OPENGL_LoadWordToSRP_HEADER,
    ZEVIO_EVENT_OPENGL_LoadWordToSRP_ADDR,
    ZEVIO_EVENT_OPENGL_DrawingOffset,
    ZEVIO_EVENT_OPENGL_ClipWindowTopLeft,
    ZEVIO_EVENT_OPENGL_ClipWindowBottomRight,
    ZEVIO_EVENT_OPENGL_TextureMode,
    ZEVIO_EVENT_OPENGL_TexturePointer,
    ZEVIO_EVENT_OPENGL_DepthTestMode,
    ZEVIO_EVENT_OPENGL_DepthBufferOffset,
    ZEVIO_EVENT_OPENGL_DrawingModes,
    ZEVIO_EVENT_OPENGL_TextureCacheInvalidate,
    ZEVIO_EVENT_OPENGL_RendererFlush,
    ZEVIO_EVENT_OPENGL_FogColor,
    ZEVIO_EVENT_OPENGL_FogNear,    
    ZEVIO_EVENT_OPENGL_FogFar,
    ZEVIO_EVENT_OPENGL_AlphaLevel,
    ZEVIO_EVENT_OPENGL_LoadSTT,
    ZEVIO_EVENT_OPENGL_LoadEntireCLUT0,
    ZEVIO_EVENT_OPENGL_LoadEntireCLUT1,
    ZEVIO_EVENT_OPENGL_LoadEntireCLUT2,
    ZEVIO_EVENT_OPENGL_LoadCLUT0Subset,
    ZEVIO_EVENT_OPENGL_LoadCLUT1Subset,
    ZEVIO_EVENT_OPENGL_LoadCLUT2Subset,
    ZEVIO_EVENT_OPENGL_RendererInterrupt,
    ZEVIO_EVENT_OPENGL_RendererVertex_Q,
    ZEVIO_EVENT_OPENGL_RendererVertex_X_Y,
    ZEVIO_EVENT_OPENGL_RendererVertex_U_V,
    ZEVIO_EVENT_OPENGL_RendererVertex_COLOR,
    ZEVIO_EVENT_OPENGL_RendererVertex_OFFSET,
    ZEVIO_EVENT_OPENGL_RendererVertex_TERMINATION,
    ZEVIO_EVENT_OPENGL_RendererVertex_W_H,
    ZEVIO_EVENT_OPENGL_RendererTriangleStripDraw,
    ZEVIO_EVENT_OPENGL_RendererTriangleDraw,
    ZEVIO_EVENT_OPENGL_RendererLineStripDraw,
    ZEVIO_EVENT_OPENGL_RendererLineDraw,
    ZEVIO_EVENT_OPENGL_RendererPointDraw,
    ZEVIO_EVENT_OPENGL_RendererSpriteDraw,
    ZEVIO_EVENT_OPENGL_TransferToGPUMemory_HEADER,
    ZEVIO_EVENT_OPENGL_TransferToGPUMemory_X_Y,
    ZEVIO_EVENT_OPENGL_TransferToGPUMemory_W_H,
    ZEVIO_EVENT_OPENGL_TransferFromGPUMemory_HEADER,
    ZEVIO_EVENT_OPENGL_TransferFromGPUMemory_X_Y,
    ZEVIO_EVENT_OPENGL_TransferFromGPUMemory_W_H,
    ZEVIO_EVENT_OPENGL_BlockTransfer_HEADER,
    ZEVIO_EVENT_OPENGL_BlockTransfer_DSTX_DSTY,
    ZEVIO_EVENT_OPENGL_BlockTransfer_W_H,
    ZEVIO_EVENT_OPENGL_BlockTransfer_SRCX_SRCY,
    ZEVIO_EVENT_OPENGL_BlockFill_HEADER,
    ZEVIO_EVENT_OPENGL_BlockFill_X_Y,
    ZEVIO_EVENT_OPENGL_BlockFill_W_H,
    ZEVIO_EVENT_OPENGL_BlockFill_VALUE,
    ZEVIO_EVENT_OPENGL_ConditionalTransfer_HEADER,
    ZEVIO_EVENT_OPENGL_ConditionalTransfer_X_Y,
    ZEVIO_EVENT_OPENGL_ConditionalTransfer_W_H,
    ZEVIO_EVENT_OPENGL_ConditionalBlockTransfer_HEADER,
    ZEVIO_EVENT_OPENGL_ConditionalBlockTransfer_DSTX_DSTY,
    ZEVIO_EVENT_OPENGL_ConditionalBlockTransfer_W_H,
    ZEVIO_EVENT_OPENGL_ConditionalBlockTransfer_SRCX_SRCY,
    ZEVIO_EVENT_OPENGL_ScalingVector_HEADER,
    ZEVIO_EVENT_OPENGL_ScalingVector_SX_SY,
    ZEVIO_EVENT_OPENGL_ScalingVector_SZ,
    ZEVIO_EVENT_OPENGL_Local2WorldRotationalMatrix_HEADER,
    ZEVIO_EVENT_OPENGL_Local2WorldRotationalMatrix_M11_M12,
    ZEVIO_EVENT_OPENGL_Local2WorldRotationalMatrix_M13_M21,
    ZEVIO_EVENT_OPENGL_Local2WorldRotationalMatrix_M22_M23,
    ZEVIO_EVENT_OPENGL_Local2WorldRotationalMatrix_M31_M32,
    ZEVIO_EVENT_OPENGL_Local2WorldRotationalMatrix_M33,
    ZEVIO_EVENT_OPENGL_Local2WorldTranslationVector_HEADER,
    ZEVIO_EVENT_OPENGL_Local2WorldTranslationVector_TX_TY,
    ZEVIO_EVENT_OPENGL_Local2WorldTranslationVector_TZ,
    ZEVIO_EVENT_OPENGL_World2ViewRotationalMatrix_HEADER,
    ZEVIO_EVENT_OPENGL_World2ViewRotationalMatrix_M11_M12,
    ZEVIO_EVENT_OPENGL_World2ViewRotationalMatrix_M13_M21,
    ZEVIO_EVENT_OPENGL_World2ViewRotationalMatrix_M22_M23,
    ZEVIO_EVENT_OPENGL_World2ViewRotationalMatrix_M31_M32,
    ZEVIO_EVENT_OPENGL_World2ViewRotationalMatrix_M33,
    ZEVIO_EVENT_OPENGL_World2ViewTranslationVector_HEADER,
    ZEVIO_EVENT_OPENGL_World2ViewTranslationVector_TX_TY,
    ZEVIO_EVENT_OPENGL_World2ViewTranslationVector_TZ,
    ZEVIO_EVENT_OPENGL_Light0DirectionalVector_HEADER,
    ZEVIO_EVENT_OPENGL_Light0DirectionalVector_X_Y,
    ZEVIO_EVENT_OPENGL_Light0DirectionalVector_Z,
    ZEVIO_EVENT_OPENGL_Light0RGB_HEADER,
    ZEVIO_EVENT_OPENGL_Light0RGB_RGB,
    ZEVIO_EVENT_OPENGL_Light1DirectionalVector_HEADER,
    ZEVIO_EVENT_OPENGL_Light1DirectionalVector_X_Y,
    ZEVIO_EVENT_OPENGL_Light1DirectionalVector_Z,
    ZEVIO_EVENT_OPENGL_Light1RGB_HEADER,
    ZEVIO_EVENT_OPENGL_Light1RGB_RGB,
    ZEVIO_EVENT_OPENGL_Light2DirectionalVector_HEADER,
    ZEVIO_EVENT_OPENGL_Light2DirectionalVector_X_Y,
    ZEVIO_EVENT_OPENGL_Light2DirectionalVector_Z,
    ZEVIO_EVENT_OPENGL_Light2RGB_HEADER,
    ZEVIO_EVENT_OPENGL_Light2RGB_RGB,
    ZEVIO_EVENT_OPENGL_AmbientLightRGB_HEADER,
    ZEVIO_EVENT_OPENGL_AmbientLightRGB_RGB,
    ZEVIO_EVENT_OPENGL_MaterialRGBCoefficients_HEADER,
    ZEVIO_EVENT_OPENGL_MaterialRGBCoefficients_RGB,
    ZEVIO_EVENT_OPENGL_SpecularRGBCoefficients_HEADER,
    ZEVIO_EVENT_OPENGL_SpecularRGBCoefficients_RGB,
    ZEVIO_EVENT_OPENGL_ZcullingZMax_HEADER,
    ZEVIO_EVENT_OPENGL_ZcullingZMax_Z,
    ZEVIO_EVENT_OPENGL_NearClippingZNearPlane_HEADER,
    ZEVIO_EVENT_OPENGL_NearClippingZNearPlane_Z,
    ZEVIO_EVENT_OPENGL_XYProjectionPlaneScaling_HEADER,
    ZEVIO_EVENT_OPENGL_XYProjectionPlaneScaling_HX_HY,
    ZEVIO_EVENT_OPENGL_GLEMode,
    ZEVIO_EVENT_OPENGL_GLEMaterialSetting,
    ZEVIO_EVENT_OPENGL_GLEVertex_X_Y,
    ZEVIO_EVENT_OPENGL_GLEVertex_Z_NX,
    ZEVIO_EVENT_OPENGL_GLEVertex_NY_NZ,
    ZEVIO_EVENT_OPENGL_GLEVertex_U_V,
    ZEVIO_EVENT_OPENGL_GLEVertex_COLOR_OFFSET,
    ZEVIO_EVENT_OPENGL_GLEVertex_SNX_SNY,
    ZEVIO_EVENT_OPENGL_GLEVertex_SNZ,
    ZEVIO_EVENT_OPENGL_GLETriangleDraw,
    ZEVIO_EVENT_OPENGL_GLELineDraw,
    ZEVIO_EVENT_OPENGL_GLEPointDraw,
    ZEVIO_EVENT_OPENGL_ModelScaling,
    ZEVIO_EVENT_OPENGL_ModelTransformation,
    ZEVIO_EVENT_OPENGL_ModelTranslation,
    ZEVIO_EVENT_OPENGL_VertexNormalTransformation,
    ZEVIO_EVENT_OPENGL_SurfaceNormalTransformation,
    ZEVIO_EVENT_OPENGL_MixMMC,
    ZEVIO_EVENT_OPENGL_chExecStatusUNEXECUTION,
    ZEVIO_EVENT_OPENGL_UNDEFINE,
    
    
    ZEVIO_EVENT_NUM_EVENTS
} ZEVIO_LOG_EVENT;


/******************************************************************************\
* Log Event Structure                                                          *
*                                                                              *
* Each event logged in the C-Ware log consists of a ZEVIOLogEvent structure plus  *
* zero or more additional words of information specific to that event.  The    *
* basic structure contains an entry word and a timestamp.  The timestamp is    *
* recorded in microseconds.                                                    *
*                                                                              *
* The entry word consists of three fields.  Bytes 0-15 are a ZEVIO_LOG_EVENT type *
* which identify what event is being logged.  Bytes 16-23 record the size, in  *
* words, of the log entry beyond the standard ZEVIOLogEvent structure.  Bytes     *
* 24-31 record the log level which this particular entry was entered with,     *
* such as ZEVIO_LOG_FATAL.                                                        *
*                                                                              *
\******************************************************************************/

typedef struct tagZEVIOLogEvent
{
    unsigned int  entry;
    unsigned int  time;
} ZEVIOLogEvent;


/******************************************************************************\
* Log Entry Macros                                                             *
*                                                                              *
* As described above, the entry word of each ZEVIOLogEvent structure has three    *
* different fields.  These macros provide a shortcut for retrieving the value  *
* of each of these fields.                                                     *
*                                                                              *
\******************************************************************************/

#define ZEVIO_LOG_ENTRY_ID( E )    (((ZEVIOLogEvent *)&(E))->entry & 0x0000FFFF)
#define ZEVIO_LOG_ENTRY_SIZE( E )  (((ZEVIOLogEvent *)&(E))->entry << 4 >> 20)
#define ZEVIO_LOG_ENTRY_LEVEL( E ) (((ZEVIOLogEvent *)&(E))->entry >> 28)


#endif // __ZEVIOLOG_EVENTS_H__