VirtualBox

source: vbox/trunk/src/VBox/Devices/Graphics/DevVGA-SVGA3d.h@ 74983

Last change on this file since 74983 was 74549, checked in by vboxsync, 6 years ago

DevVGA-SVGA: further cleanup of context windows creation (Windows host only); removed obsolete debug code.
  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 12.1 KB
Line 
1/* $Id: DevVGA-SVGA3d.h 74549 2018-10-01 11:56:56Z vboxsync $ */
2/** @file
3 * DevVMWare - VMWare SVGA device - 3D part.
4 */
5
6/*
7 * Copyright (C) 2013-2017 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
18#ifndef ___DEVVMWARE3D_H___
19#define ___DEVVMWARE3D_H___
20
21#include "vmsvga/svga_reg.h"
22#include "vmsvga/svga3d_reg.h"
23#include "vmsvga/svga_escape.h"
24#include "vmsvga/svga_overlay.h"
25
26
27/** Arbitrary limit */
28#define SVGA3D_MAX_SHADER_IDS 0x800
29/** D3D allows up to 8 texture stages. */
30#define SVGA3D_MAX_TEXTURE_STAGES 8
31/** Samplers: 16 Pixel Shader + 1 Displacement Map + 4 Vertex Shader */
32#define SVGA3D_MAX_SAMPLERS_PS 16
33#define SVGA3D_MAX_SAMPLERS_DMAP 1
34#define SVGA3D_MAX_SAMPLERS_VS 4
35#define SVGA3D_MAX_SAMPLERS (SVGA3D_MAX_SAMPLERS_PS + SVGA3D_MAX_SAMPLERS_DMAP + SVGA3D_MAX_SAMPLERS_VS)
36/** Arbitrary upper limit; seen 8 so far. */
37#define SVGA3D_MAX_LIGHTS 32
38/** Arbitrary upper limit; 2GB enough for 32768x16384*4. */
39#define SVGA3D_MAX_SURFACE_MEM_SIZE 0x80000000
40
41
42/**@def FLOAT_FMT_STR
43 * Format string bits to go with FLOAT_FMT_ARGS. */
44#define FLOAT_FMT_STR "%d.%06u"
45/** @def FLOAT_FMT_ARGS
46 * Format arguments for a float value, corresponding to FLOAT_FMT_STR.
47 * @param r The floating point value to format. */
48#define FLOAT_FMT_ARGS(r) (int)(r), ((unsigned)(RT_ABS(r) * 1000000) % 1000000U)
49
50
51/* DevVGA-SVGA.cpp: */
52void vmsvgaGMRFree(PVGASTATE pThis, uint32_t idGMR);
53int vmsvgaGMRTransfer(PVGASTATE pThis, const SVGA3dTransferType enmTransferType,
54 uint8_t *pbHstBuf, uint32_t cbHstBuf, uint32_t offHst, int32_t cbHstPitch,
55 SVGAGuestPtr gstPtr, uint32_t offGst, int32_t cbGstPitch,
56 uint32_t cbWidth, uint32_t cHeight);
57void vmsvga3dSurfaceUpdateHeapBuffersOnFifoThread(PVGASTATE pThis, uint32_t sid);
58
59
60/* DevVGA-SVGA3d-ogl.cpp & DevVGA-SVGA3d-win.cpp: */
61int vmsvga3dInit(PVGASTATE pThis);
62int vmsvga3dPowerOn(PVGASTATE pThis);
63int vmsvga3dLoadExec(PVGASTATE pThis, PSSMHANDLE pSSM, uint32_t uVersion, uint32_t uPass);
64int vmsvga3dSaveExec(PVGASTATE pThis, PSSMHANDLE pSSM);
65int vmsvga3dTerminate(PVGASTATE pThis);
66int vmsvga3dReset(PVGASTATE pThis);
67void vmsvga3dUpdateHostScreenViewport(PVGASTATE pThis, uint32_t idScreen, VMSVGAVIEWPORT const *pOldViewport);
68int vmsvga3dQueryCaps(PVGASTATE pThis, uint32_t idx3dCaps, uint32_t *pu32Val);
69
70int vmsvga3dSurfaceDefine(PVGASTATE pThis, uint32_t sid, uint32_t surfaceFlags, SVGA3dSurfaceFormat format, SVGA3dSurfaceFace face[SVGA3D_MAX_SURFACE_FACES], uint32_t multisampleCount, SVGA3dTextureFilter autogenFilter, uint32_t cMipLevels, SVGA3dSize *pMipLevelSize);
71int vmsvga3dSurfaceDestroy(PVGASTATE pThis, uint32_t sid);
72int vmsvga3dSurfaceCopy(PVGASTATE pThis, SVGA3dSurfaceImageId dest, SVGA3dSurfaceImageId src, uint32_t cCopyBoxes, SVGA3dCopyBox *pBox);
73int vmsvga3dSurfaceStretchBlt(PVGASTATE pThis, SVGA3dSurfaceImageId const *pDstSfcImg, SVGA3dBox const *pDstBox,
74 SVGA3dSurfaceImageId const *pSrcSfcImg, SVGA3dBox const *pSrcBox, SVGA3dStretchBltMode enmMode);
75int vmsvga3dSurfaceDMA(PVGASTATE pThis, SVGA3dGuestImage guest, SVGA3dSurfaceImageId host, SVGA3dTransferType transfer, uint32_t cCopyBoxes, SVGA3dCopyBox *pBoxes);
76int vmsvga3dSurfaceBlitToScreen(PVGASTATE pThis, uint32_t dest, SVGASignedRect destRect, SVGA3dSurfaceImageId src, SVGASignedRect srcRect, uint32_t cRects, SVGASignedRect *pRect);
77
78int vmsvga3dContextDefine(PVGASTATE pThis, uint32_t cid);
79int vmsvga3dContextDestroy(PVGASTATE pThis, uint32_t cid);
80
81int vmsvga3dChangeMode(PVGASTATE pThis);
82
83int vmsvga3dSetTransform(PVGASTATE pThis, uint32_t cid, SVGA3dTransformType type, float matrix[16]);
84int vmsvga3dSetZRange(PVGASTATE pThis, uint32_t cid, SVGA3dZRange zRange);
85int vmsvga3dSetRenderState(PVGASTATE pThis, uint32_t cid, uint32_t cRenderStates, SVGA3dRenderState *pRenderState);
86int vmsvga3dSetRenderTarget(PVGASTATE pThis, uint32_t cid, SVGA3dRenderTargetType type, SVGA3dSurfaceImageId target);
87int vmsvga3dSetTextureState(PVGASTATE pThis, uint32_t cid, uint32_t cTextureStates, SVGA3dTextureState *pTextureState);
88int vmsvga3dSetMaterial(PVGASTATE pThis, uint32_t cid, SVGA3dFace face, SVGA3dMaterial *pMaterial);
89int vmsvga3dSetLightData(PVGASTATE pThis, uint32_t cid, uint32_t index, SVGA3dLightData *pData);
90int vmsvga3dSetLightEnabled(PVGASTATE pThis, uint32_t cid, uint32_t index, uint32_t enabled);
91int vmsvga3dSetViewPort(PVGASTATE pThis, uint32_t cid, SVGA3dRect *pRect);
92int vmsvga3dSetClipPlane(PVGASTATE pThis, uint32_t cid, uint32_t index, float plane[4]);
93int vmsvga3dCommandClear(PVGASTATE pThis, uint32_t cid, SVGA3dClearFlag clearFlag, uint32_t color, float depth, uint32_t stencil, uint32_t cRects, SVGA3dRect *pRect);
94int vmsvga3dCommandPresent(PVGASTATE pThis, uint32_t sid, uint32_t cRects, SVGA3dCopyRect *pRect);
95int vmsvga3dDrawPrimitives(PVGASTATE pThis, uint32_t cid, uint32_t numVertexDecls, SVGA3dVertexDecl *pVertexDecl, uint32_t numRanges, SVGA3dPrimitiveRange *pNumRange, uint32_t cVertexDivisor, SVGA3dVertexDivisor *pVertexDivisor);
96int vmsvga3dSetScissorRect(PVGASTATE pThis, uint32_t cid, SVGA3dRect *pRect);
97int vmsvga3dGenerateMipmaps(PVGASTATE pThis, uint32_t sid, SVGA3dTextureFilter filter);
98
99int vmsvga3dShaderDefine(PVGASTATE pThis, uint32_t cid, uint32_t shid, SVGA3dShaderType type, uint32_t cbData, uint32_t *pShaderData);
100int vmsvga3dShaderDestroy(PVGASTATE pThis, uint32_t cid, uint32_t shid, SVGA3dShaderType type);
101int vmsvga3dShaderSet(PVGASTATE pThis, struct VMSVGA3DCONTEXT *pContext, uint32_t cid, SVGA3dShaderType type, uint32_t shid);
102int vmsvga3dShaderSetConst(PVGASTATE pThis, uint32_t cid, uint32_t reg, SVGA3dShaderType type, SVGA3dShaderConstType ctype, uint32_t cRegisters, uint32_t *pValues);
103
104int vmsvga3dQueryBegin(PVGASTATE pThis, uint32_t cid, SVGA3dQueryType type);
105int vmsvga3dQueryEnd(PVGASTATE pThis, uint32_t cid, SVGA3dQueryType type, SVGAGuestPtr guestResult);
106int vmsvga3dQueryWait(PVGASTATE pThis, uint32_t cid, SVGA3dQueryType type, SVGAGuestPtr guestResult);
107
108/* DevVGA-SVGA3d-shared.h: */
109#if defined(RT_OS_WINDOWS) && defined(IN_RING3)
110# include <iprt/win/windows.h>
111
112# define WM_VMSVGA3D_WAKEUP (WM_APP+1)
113# define WM_VMSVGA3D_CREATEWINDOW (WM_APP+2)
114# define WM_VMSVGA3D_DESTROYWINDOW (WM_APP+3)
115# define WM_VMSVGA3D_EXIT (WM_APP+5)
116
117DECLCALLBACK(int) vmsvga3dWindowThread(RTTHREAD ThreadSelf, void *pvUser);
118int vmsvga3dSendThreadMessage(RTTHREAD pWindowThread, RTSEMEVENT WndRequestSem, UINT msg, WPARAM wParam, LPARAM lParam);
119int vmsvga3dContextWindowCreate(HINSTANCE hInstance, RTTHREAD pWindowThread, RTSEMEVENT WndRequestSem, HWND *pHwnd);
120
121#endif
122
123void vmsvga3dUpdateHeapBuffersForSurfaces(PVGASTATE pThis, uint32_t sid);
124void vmsvga3dInfoContextWorker(PVGASTATE pThis, PCDBGFINFOHLP pHlp, uint32_t cid, bool fVerbose);
125void vmsvga3dInfoSurfaceWorker(PVGASTATE pThis, PCDBGFINFOHLP pHlp, uint32_t sid, bool fVerbose, uint32_t cxAscii, bool fInvY, const char *pszBitmapPath);
126
127void vmsvgaClipRect(SVGASignedRect const *pBound,
128 SVGASignedRect *pRect);
129
130/* DevVGA-SVGA3d-shared.cpp: */
131
132/**
133 * Structure for use with vmsvga3dInfoU32Flags.
134 */
135typedef struct VMSVGAINFOFLAGS32
136{
137 /** The flags. */
138 uint32_t fFlags;
139 /** The corresponding mnemonic. */
140 const char *pszJohnny;
141} VMSVGAINFOFLAGS32;
142/** Pointer to a read-only flag translation entry. */
143typedef VMSVGAINFOFLAGS32 const *PCVMSVGAINFOFLAGS32;
144void vmsvga3dInfoU32Flags(PCDBGFINFOHLP pHlp, uint32_t fFlags, const char *pszPrefix, PCVMSVGAINFOFLAGS32 paFlags, uint32_t cFlags);
145
146/**
147 * Structure for use with vmsvgaFormatEnumValueEx and vmsvgaFormatEnumValue.
148 */
149typedef struct VMSVGAINFOENUM
150{
151 /** The enum value. */
152 int32_t iValue;
153 /** The corresponding value name. */
154 const char *pszName;
155} VMSVGAINFOENUM;
156/** Pointer to a read-only enum value translation entry. */
157typedef VMSVGAINFOENUM const *PCVMSVGAINFOENUM;
158/**
159 * Structure for use with vmsvgaFormatEnumValueEx and vmsvgaFormatEnumValue.
160 */
161typedef struct VMSVGAINFOENUMMAP
162{
163 /** Pointer to the value mapping array. */
164 PCVMSVGAINFOENUM paValues;
165 /** The number of value mappings. */
166 size_t cValues;
167 /** The prefix. */
168 const char *pszPrefix;
169#ifdef RT_STRICT
170 /** Indicates whether we've checked that it's sorted or not. */
171 bool *pfAsserted;
172#endif
173} VMSVGAINFOENUMMAP;
174typedef VMSVGAINFOENUMMAP const *PCVMSVGAINFOENUMMAP;
175/** @def VMSVGAINFOENUMMAP_MAKE
176 * Macro for defining a VMSVGAINFOENUMMAP, silently dealing with pfAsserted.
177 *
178 * @param a_Scope The scope. RT_NOTHING or static.
179 * @param a_VarName The variable name for this map.
180 * @param a_aValues The variable name of the value mapping array.
181 * @param a_pszPrefix The value name prefix.
182 */
183#ifdef VBOX_STRICT
184# define VMSVGAINFOENUMMAP_MAKE(a_Scope, a_VarName, a_aValues, a_pszPrefix) \
185 static bool RT_CONCAT(a_VarName,_AssertedSorted) = false; \
186 a_Scope VMSVGAINFOENUMMAP const a_VarName = { \
187 a_aValues, RT_ELEMENTS(a_aValues), a_pszPrefix, &RT_CONCAT(a_VarName,_AssertedSorted) \
188 }
189#else
190# define VMSVGAINFOENUMMAP_MAKE(a_Scope, a_VarName, a_aValues, a_pszPrefix) \
191 a_Scope VMSVGAINFOENUMMAP const a_VarName = { a_aValues, RT_ELEMENTS(a_aValues), a_pszPrefix }
192#endif
193extern VMSVGAINFOENUMMAP const g_SVGA3dSurfaceFormat2String;
194const char *vmsvgaLookupEnum(int32_t iValue, PCVMSVGAINFOENUMMAP pEnumMap);
195char *vmsvgaFormatEnumValueEx(char *pszBuffer, size_t cbBuffer, const char *pszName, int32_t iValue,
196 bool fPrefix, PCVMSVGAINFOENUMMAP pEnumMap);
197char *vmsvgaFormatEnumValue(char *pszBuffer, size_t cbBuffer, const char *pszName, uint32_t uValue,
198 const char *pszPrefix, const char * const *papszValues, size_t cValues);
199
200/**
201 * ASCII "art" scanline printer callback.
202 *
203 * @param pszLine The line to output.
204 * @param pvUser The user argument.
205 */
206typedef DECLCALLBACK(void) FMVMSVGAASCIIPRINTLN(const char *pszLine, void *pvUser);
207/** Pointer to an ASCII "art" print line callback. */
208typedef FMVMSVGAASCIIPRINTLN *PFMVMSVGAASCIIPRINTLN;
209void vmsvga3dAsciiPrint(PFMVMSVGAASCIIPRINTLN pfnPrintLine, void *pvUser, void const *pvImage, size_t cbImage,
210 uint32_t cx, uint32_t cy, uint32_t cbScanline, SVGA3dSurfaceFormat enmFormat, bool fInvY,
211 uint32_t cchMaxX, uint32_t cchMaxY);
212DECLCALLBACK(void) vmsvga3dAsciiPrintlnInfo(const char *pszLine, void *pvUser);
213DECLCALLBACK(void) vmsvga3dAsciiPrintlnLog(const char *pszLine, void *pvUser);
214
215char *vmsvga3dFormatRenderState(char *pszBuffer, size_t cbBuffer, SVGA3dRenderState const *pRenderState);
216char *vmsvga3dFormatTextureState(char *pszBuffer, size_t cbBuffer, SVGA3dTextureState const *pTextureState);
217void vmsvga3dInfoHostWindow(PCDBGFINFOHLP pHlp, uint64_t idHostWindow);
218
219uint32_t vmsvga3dSurfaceFormatSize(SVGA3dSurfaceFormat format,
220 uint32_t *pu32BlockWidth,
221 uint32_t *pu32BlockHeight);
222
223#ifdef LOG_ENABLED
224const char *vmsvga3dGetCapString(uint32_t idxCap);
225const char *vmsvga3dGet3dFormatString(uint32_t format);
226const char *vmsvga3dGetRenderStateName(uint32_t state);
227const char *vmsvga3dTextureStateToString(SVGA3dTextureStateName textureState);
228const char *vmsvgaTransformToString(SVGA3dTransformType type);
229const char *vmsvgaDeclUsage2String(SVGA3dDeclUsage usage);
230const char *vmsvgaDeclType2String(SVGA3dDeclType type);
231const char *vmsvgaDeclMethod2String(SVGA3dDeclMethod method);
232const char *vmsvgaSurfaceType2String(SVGA3dSurfaceFormat format);
233const char *vmsvga3dPrimitiveType2String(SVGA3dPrimitiveType PrimitiveType);
234#endif
235
236#endif /* !___DEVVMWARE3D_H___ */
237
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette