1 | /* $Id: cr_dump.h 62492 2016-07-22 18:42:47Z vboxsync $ */
|
---|
2 |
|
---|
3 | /** @file
|
---|
4 | * Debugging: Dump API
|
---|
5 | */
|
---|
6 | /*
|
---|
7 | * Copyright (C) 2013-2016 Oracle Corporation
|
---|
8 | *
|
---|
9 | * This file is part of VirtualBox Open Source Edition (OSE), as
|
---|
10 | * available from http://www.virtualbox.org. This file is free software;
|
---|
11 | * you can redistribute it and/or modify it under the terms of the GNU
|
---|
12 | * General Public License (GPL) as published by the Free Software
|
---|
13 | * Foundation, in version 2 as it comes in the "COPYING" file of the
|
---|
14 | * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
|
---|
15 | * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
|
---|
16 | */
|
---|
17 | #ifndef ___cr_dump_h__
|
---|
18 | #define ___cr_dump_h__
|
---|
19 |
|
---|
20 | /* dump stuff */
|
---|
21 | //#define VBOX_WITH_CRDUMPER
|
---|
22 | #ifdef VBOX_WITH_CRDUMPER
|
---|
23 |
|
---|
24 | #include <iprt/cdefs.h>
|
---|
25 | #include <iprt/string.h>
|
---|
26 | #include <cr_spu.h>
|
---|
27 | #include <cr_glstate.h>
|
---|
28 | #include <cr_blitter.h>
|
---|
29 |
|
---|
30 | # define VBOXDUMPDECL(_type) _type RTCALL
|
---|
31 |
|
---|
32 | RT_C_DECLS_BEGIN
|
---|
33 |
|
---|
34 | #ifdef RT_OS_WINDOWS
|
---|
35 | DECLEXPORT(void) crDmpDumpImgDmlBreak(struct CR_DUMPER * pDumper, CR_BLITTER_IMG *pImg, const char*pszEntryDesc);
|
---|
36 |
|
---|
37 | DECLEXPORT(void) crDmpDumpStrDbgPrint(struct CR_DUMPER * pDumper, const char*pszStr);
|
---|
38 | #endif
|
---|
39 |
|
---|
40 | struct CR_DUMPER;
|
---|
41 |
|
---|
42 | typedef DECLCALLBACKPTR(void, PFNCRDUMPIMG)(struct CR_DUMPER * pDumper, CR_BLITTER_IMG *pImg, const char*pszEntryDesc);
|
---|
43 | typedef DECLCALLBACKPTR(void, PFNCRDUMPSTR)(struct CR_DUMPER * pDumper, const char*pszStr);
|
---|
44 |
|
---|
45 | typedef struct CR_DUMPER
|
---|
46 | {
|
---|
47 | PFNCRDUMPIMG pfnDumpImg;
|
---|
48 | PFNCRDUMPSTR pfnDumpStr;
|
---|
49 | } CR_DUMPER;
|
---|
50 |
|
---|
51 | #define crDmpImg(_pDumper, _pImg, _pDesc) do { \
|
---|
52 | (_pDumper)->pfnDumpImg((_pDumper), (_pImg), (_pDesc)); \
|
---|
53 | } while (0)
|
---|
54 |
|
---|
55 | #define crDmpStr(_pDumper, _pDesc) do { \
|
---|
56 | (_pDumper)->pfnDumpStr((_pDumper), (_pDesc)); \
|
---|
57 | } while (0)
|
---|
58 |
|
---|
59 | #ifndef RT_OS_WINDOWS
|
---|
60 | # define vsprintf_s vsnprintf
|
---|
61 | # define sprintf_s snprintf
|
---|
62 | #endif
|
---|
63 |
|
---|
64 | DECLINLINE(void) crDmpStrV(CR_DUMPER *pDumper, const char *pszStr, va_list pArgList)
|
---|
65 | {
|
---|
66 | char szBuffer[4096] = {0};
|
---|
67 | vsprintf_s(szBuffer, sizeof (szBuffer), pszStr, pArgList);
|
---|
68 | crDmpStr(pDumper, szBuffer);
|
---|
69 | }
|
---|
70 |
|
---|
71 | DECLINLINE(void) crDmpStrF(CR_DUMPER *pDumper, const char *pszStr, ...)
|
---|
72 | {
|
---|
73 | va_list pArgList;
|
---|
74 | va_start(pArgList, pszStr);
|
---|
75 | crDmpStrV(pDumper, pszStr, pArgList);
|
---|
76 | va_end(pArgList);
|
---|
77 | }
|
---|
78 |
|
---|
79 | DECLINLINE(void) crDmpImgV(CR_DUMPER *pDumper, CR_BLITTER_IMG *pImg, const char *pszStr, va_list pArgList)
|
---|
80 | {
|
---|
81 | char szBuffer[4096] = {0};
|
---|
82 | vsprintf_s(szBuffer, sizeof (szBuffer), pszStr, pArgList);
|
---|
83 | crDmpImg(pDumper, pImg, szBuffer);
|
---|
84 | }
|
---|
85 |
|
---|
86 | DECLINLINE(void) crDmpImgF(CR_DUMPER *pDumper, CR_BLITTER_IMG *pImg, const char *pszStr, ...)
|
---|
87 | {
|
---|
88 | va_list pArgList;
|
---|
89 | va_start(pArgList, pszStr);
|
---|
90 | crDmpImgV(pDumper, pImg, pszStr, pArgList);
|
---|
91 | va_end(pArgList);
|
---|
92 | }
|
---|
93 |
|
---|
94 | VBOXDUMPDECL(size_t) crDmpFormatArray(char *pString, size_t cbString, const char *pszElFormat, uint32_t cbEl, const void *pVal, uint32_t cVal);
|
---|
95 | VBOXDUMPDECL(size_t) crDmpFormatRawArray(char *pString, size_t cbString, const char *pszElFormat, uint32_t cbEl, const void *pVal, uint32_t cVal);
|
---|
96 | VBOXDUMPDECL(size_t) crDmpFormatMatrixArray(char *pString, size_t cbString, const char *pszElFormat, uint32_t cbEl, const void *pVal, uint32_t cX, uint32_t cY);
|
---|
97 |
|
---|
98 | typedef struct CR_DBGPRINT_DUMPER
|
---|
99 | {
|
---|
100 | CR_DUMPER Base;
|
---|
101 | } CR_DBGPRINT_DUMPER;
|
---|
102 |
|
---|
103 | typedef struct CR_HTML_DUMPER
|
---|
104 | {
|
---|
105 | CR_DUMPER Base;
|
---|
106 | const char* pszFile;
|
---|
107 | const char* pszDir;
|
---|
108 | FILE *pFile;
|
---|
109 | uint32_t cImg;
|
---|
110 | } CR_HTML_DUMPER;
|
---|
111 |
|
---|
112 | DECLEXPORT(bool) crDmpHtmlIsInited(struct CR_HTML_DUMPER * pDumper);
|
---|
113 | DECLEXPORT(void) crDmpHtmlTerm(struct CR_HTML_DUMPER * pDumper);
|
---|
114 | DECLEXPORT(int) crDmpHtmlInit(struct CR_HTML_DUMPER * pDumper, const char *pszDir, const char *pszFile);
|
---|
115 | DECLEXPORT(int) crDmpHtmlInitV(struct CR_HTML_DUMPER * pDumper, const char *pszDir, const char *pszFile, va_list pArgList);
|
---|
116 | DECLEXPORT(int) crDmpHtmlInitF(struct CR_HTML_DUMPER * pDumper, const char *pszDir, const char *pszFile, ...);
|
---|
117 |
|
---|
118 | #ifdef RT_OS_WINDOWS
|
---|
119 | DECLINLINE(void) crDmpDbgPrintInit(CR_DBGPRINT_DUMPER *pDumper)
|
---|
120 | {
|
---|
121 | pDumper->Base.pfnDumpImg = crDmpDumpImgDmlBreak;
|
---|
122 | pDumper->Base.pfnDumpStr = crDmpDumpStrDbgPrint;
|
---|
123 | }
|
---|
124 | #endif
|
---|
125 |
|
---|
126 | typedef struct CR_RECORDER
|
---|
127 | {
|
---|
128 | CR_BLITTER *pBlitter;
|
---|
129 | SPUDispatchTable *pDispatch;
|
---|
130 | CR_DUMPER *pDumper;
|
---|
131 | } CR_RECORDER;
|
---|
132 |
|
---|
133 | DECLINLINE(void) crRecInit(CR_RECORDER *pRec, CR_BLITTER *pBlitter, SPUDispatchTable *pDispatch, CR_DUMPER *pDumper)
|
---|
134 | {
|
---|
135 | pRec->pBlitter = pBlitter;
|
---|
136 | pRec->pDispatch = pDispatch;
|
---|
137 | pRec->pDumper = pDumper;
|
---|
138 | }
|
---|
139 |
|
---|
140 | VBOXDUMPDECL(void) crRecDumpBuffer(CR_RECORDER *pRec, CRContext *ctx, GLint idRedirFBO, VBOXVR_TEXTURE *pRedirTex);
|
---|
141 | VBOXDUMPDECL(void) crRecDumpTextures(CR_RECORDER *pRec, CRContext *ctx);
|
---|
142 | VBOXDUMPDECL(void) crRecDumpTextureV(CR_RECORDER *pRec, const VBOXVR_TEXTURE *pTex, CR_BLITTER_CONTEXT *pCurCtx, CR_BLITTER_WINDOW *pCurWin, const char *pszStr, va_list pArgList);
|
---|
143 | VBOXDUMPDECL(void) crRecDumpTextureF(CR_RECORDER *pRec, const VBOXVR_TEXTURE *pTex, const char *pszStr, ...);
|
---|
144 | VBOXDUMPDECL(void) crRecDumpTextureByIdV(CR_RECORDER *pRec, CRContext *ctx, GLint id, CR_BLITTER_CONTEXT *pCurCtx, CR_BLITTER_WINDOW *pCurWin, const char *pszStr, va_list pArgList);
|
---|
145 | VBOXDUMPDECL(void) crRecDumpTextureByIdF(CR_RECORDER *pRec, CRContext *ctx, GLint id, CR_BLITTER_CONTEXT *pCurCtx, CR_BLITTER_WINDOW *pCurWin, const char *pszStr, ...);
|
---|
146 | VBOXDUMPDECL(void) crRecDumpShader(CR_RECORDER *pRec, CRContext *ctx, GLint id, GLint hwid);
|
---|
147 | VBOXDUMPDECL(void) crRecDumpProgram(CR_RECORDER *pRec, CRContext *ctx, GLint id, GLint hwid);
|
---|
148 | VBOXDUMPDECL(void) crRecRecompileShader(CR_RECORDER *pRec, CRContext *ctx, GLint id, GLint hwid);
|
---|
149 | VBOXDUMPDECL(void) crRecRecompileProgram(CR_RECORDER *pRec, CRContext *ctx, GLint id, GLint hwid);
|
---|
150 | VBOXDUMPDECL(void) crRecDumpCurrentProgram(CR_RECORDER *pRec, CRContext *ctx);
|
---|
151 | VBOXDUMPDECL(void) crRecDumpProgramUniforms(CR_RECORDER *pRec, CRContext *ctx, GLint id, GLint hwid);
|
---|
152 | VBOXDUMPDECL(void) crRecDumpCurrentProgramUniforms(CR_RECORDER *pRec, CRContext *ctx);
|
---|
153 | VBOXDUMPDECL(void) crRecRecompileCurrentProgram(CR_RECORDER *pRec, CRContext *ctx);
|
---|
154 | VBOXDUMPDECL(void) crRecDumpProgramAttribs(CR_RECORDER *pRec, CRContext *ctx, GLint id, GLint hwid);
|
---|
155 | VBOXDUMPDECL(void) crRecDumpCurrentProgramAttribs(CR_RECORDER *pRec, CRContext *ctx);
|
---|
156 | VBOXDUMPDECL(void) crRecDumpGlGetState(CR_RECORDER *pRec, CRContext *ctx);
|
---|
157 | VBOXDUMPDECL(void) crRecDumpGlEnableState(CR_RECORDER *pRec, CRContext *ctx);
|
---|
158 | VBOXDUMPDECL(void) crRecDumpVertAttrv(CR_RECORDER *pRec, CRContext *ctx, GLuint idx, const char*pszElFormat, uint32_t cbEl, const void *pvVal, uint32_t cVal);
|
---|
159 | VBOXDUMPDECL(void) crRecDumpVertAttrF(CR_RECORDER *pRec, CRContext *ctx, const char*pszFormat, ...);
|
---|
160 | VBOXDUMPDECL(void) crRecDumpVertAttrV(CR_RECORDER *pRec, CRContext *ctx, const char*pszFormat, va_list pArgList);
|
---|
161 | VBOXDUMPDECL(void) crRecDumpTexParam(CR_RECORDER *pRec, CRContext *ctx, GLenum enmTarget);
|
---|
162 | VBOXDUMPDECL(void) crRecDumpTexEnv(CR_RECORDER *pRec, CRContext *ctx);
|
---|
163 | VBOXDUMPDECL(void) crRecDumpTexGen(CR_RECORDER *pRec, CRContext *ctx);
|
---|
164 |
|
---|
165 | VBOXDUMPDECL(int) crRecAlphaImgCreate(const CR_BLITTER_IMG *pImg, CR_BLITTER_IMG *pAlphaImg);
|
---|
166 | VBOXDUMPDECL(void) crRecAlphaImgDestroy(CR_BLITTER_IMG *pImg);
|
---|
167 |
|
---|
168 |
|
---|
169 | typedef DECLCALLBACKPTR(GLuint, PFNCRDUMPGETHWID)(void *pvObj);
|
---|
170 | void* crDmpHashtableSearchByHwid(CRHashTable *pHash, GLuint hwid, PFNCRDUMPGETHWID pfnGetHwid, unsigned long *pKey);
|
---|
171 |
|
---|
172 | RT_C_DECLS_END
|
---|
173 |
|
---|
174 | #endif /* VBOX_WITH_CRDUMPER */
|
---|
175 | /* */
|
---|
176 |
|
---|
177 | #endif /* #ifndef ___cr_dump_h__ */
|
---|