1 /**********************************************************
2 * Copyright 2008-2009 VMware, Inc. All rights reserved.
4 * Permission is hereby granted, free of charge, to any person
5 * obtaining a copy of this software and associated documentation
6 * files (the "Software"), to deal in the Software without
7 * restriction, including without limitation the rights to use, copy,
8 * modify, merge, publish, distribute, sublicense, and/or sell copies
9 * of the Software, and to permit persons to whom the Software is
10 * furnished to do so, subject to the following conditions:
12 * The above copyright notice and this permission notice shall be
13 * included in all copies or substantial portions of the Software.
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
16 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
17 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
18 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
19 * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
20 * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
21 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
24 **********************************************************/
29 * Command construction utility for the SVGA3D protocol used by
30 * the VMware SVGA device, based on the svgautil library.
33 #include "svga_winsys.h"
34 #include "svga_resource_buffer.h"
35 #include "svga_resource_texture.h"
36 #include "svga_surface.h"
40 *----------------------------------------------------------------------
42 * surface_to_surfaceid --
44 * Utility function for surface ids.
45 * Can handle null surface. Does a surface_reallocation so you need
46 * to have allocated the fifo space before converting.
52 * One surface relocation is performed for texture handle.
54 *----------------------------------------------------------------------
58 void surface_to_surfaceid(struct svga_winsys_context
*swc
, // IN
59 struct pipe_surface
*surface
, // IN
60 SVGA3dSurfaceImageId
*id
, // OUT
64 struct svga_surface
*s
= svga_surface(surface
);
65 swc
->surface_relocation(swc
, &id
->sid
, s
->handle
, flags
);
66 id
->face
= s
->real_face
; /* faces have the same order */
67 id
->mipmap
= s
->real_level
;
70 swc
->surface_relocation(swc
, &id
->sid
, NULL
, flags
);
78 *----------------------------------------------------------------------
80 * SVGA3D_FIFOReserve --
82 * Reserve space for an SVGA3D FIFO command.
84 * The 2D SVGA commands have been around for a while, so they
85 * have a rather asymmetric structure. The SVGA3D protocol is
86 * more uniform: each command begins with a header containing the
87 * command number and the full size.
89 * This is a convenience wrapper around SVGA_FIFOReserve. We
90 * reserve space for the whole command, and write the header.
92 * This function must be paired with SVGA_FIFOCommitAll().
95 * Returns a pointer to the space reserved for command-specific
96 * data. It must be 'cmdSize' bytes long.
99 * Begins a FIFO reservation.
101 *----------------------------------------------------------------------
105 SVGA3D_FIFOReserve(struct svga_winsys_context
*swc
,
107 uint32 cmdSize
, // IN
108 uint32 nr_relocs
) // IN
110 SVGA3dCmdHeader
*header
;
112 header
= swc
->reserve(swc
, sizeof *header
+ cmdSize
, nr_relocs
);
117 header
->size
= cmdSize
;
124 SVGA_FIFOCommitAll(struct svga_winsys_context
*swc
)
131 *----------------------------------------------------------------------
133 * SVGA3D_DefineContext --
135 * Create a new context, to be referred to with the provided ID.
137 * Context objects encapsulate all render state, and shader
138 * objects are per-context.
140 * Surfaces are not per-context. The same surface can be shared
141 * between multiple contexts, and surface operations can occur
144 * If the provided context ID already existed, it is redefined.
146 * Context IDs are arbitrary small non-negative integers,
147 * global to the entire SVGA device.
155 *----------------------------------------------------------------------
159 SVGA3D_DefineContext(struct svga_winsys_context
*swc
) // IN
161 SVGA3dCmdDefineContext
*cmd
;
163 cmd
= SVGA3D_FIFOReserve(swc
,
164 SVGA_3D_CMD_CONTEXT_DEFINE
, sizeof *cmd
, 0);
166 return PIPE_ERROR_OUT_OF_MEMORY
;
177 *----------------------------------------------------------------------
179 * SVGA3D_DestroyContext --
181 * Delete a context created with SVGA3D_DefineContext.
189 *----------------------------------------------------------------------
193 SVGA3D_DestroyContext(struct svga_winsys_context
*swc
) // IN
195 SVGA3dCmdDestroyContext
*cmd
;
197 cmd
= SVGA3D_FIFOReserve(swc
,
198 SVGA_3D_CMD_CONTEXT_DESTROY
, sizeof *cmd
, 0);
200 return PIPE_ERROR_OUT_OF_MEMORY
;
211 *----------------------------------------------------------------------
213 * SVGA3D_BeginDefineSurface --
215 * Begin a SURFACE_DEFINE command. This reserves space for it in
216 * the FIFO, and returns pointers to the command's faces and
219 * This function must be paired with SVGA_FIFOCommitAll().
220 * The faces and mipSizes arrays are initialized to zero.
222 * This creates a "surface" object in the SVGA3D device,
223 * with the provided surface ID (sid). Surfaces are generic
224 * containers for host VRAM objects like textures, vertex
225 * buffers, and depth/stencil buffers.
227 * Surfaces are hierarchical:
229 * - Surface may have multiple faces (for cube maps)
231 * - Each face has a list of mipmap levels
233 * - Each mipmap image may have multiple volume
234 * slices, if the image is three dimensional.
236 * - Each slice is a 2D array of 'blocks'
238 * - Each block may be one or more pixels.
239 * (Usually 1, more for DXT or YUV formats.)
241 * Surfaces are generic host VRAM objects. The SVGA3D device
242 * may optimize surfaces according to the format they were
243 * created with, but this format does not limit the ways in
244 * which the surface may be used. For example, a depth surface
245 * can be used as a texture, or a floating point image may
246 * be used as a vertex buffer. Some surface usages may be
247 * lower performance, due to software emulation, but any
248 * usage should work with any surface.
250 * If 'sid' is already defined, the old surface is deleted
251 * and this new surface replaces it.
253 * Surface IDs are arbitrary small non-negative integers,
254 * global to the entire SVGA device.
257 * Returns pointers to arrays allocated in the FIFO for 'faces'
261 * Begins a FIFO reservation.
263 *----------------------------------------------------------------------
267 SVGA3D_BeginDefineSurface(struct svga_winsys_context
*swc
,
268 struct svga_winsys_surface
*sid
, // IN
269 SVGA3dSurfaceFlags flags
, // IN
270 SVGA3dSurfaceFormat format
, // IN
271 SVGA3dSurfaceFace
**faces
, // OUT
272 SVGA3dSize
**mipSizes
, // OUT
273 uint32 numMipSizes
) // IN
275 SVGA3dCmdDefineSurface
*cmd
;
277 cmd
= SVGA3D_FIFOReserve(swc
,
278 SVGA_3D_CMD_SURFACE_DEFINE
, sizeof *cmd
+
279 sizeof **mipSizes
* numMipSizes
, 1);
281 return PIPE_ERROR_OUT_OF_MEMORY
;
283 swc
->surface_relocation(swc
, &cmd
->sid
, sid
, SVGA_RELOC_WRITE
);
284 cmd
->surfaceFlags
= flags
;
285 cmd
->format
= format
;
287 *faces
= &cmd
->face
[0];
288 *mipSizes
= (SVGA3dSize
*) &cmd
[1];
290 memset(*faces
, 0, sizeof **faces
* SVGA3D_MAX_SURFACE_FACES
);
291 memset(*mipSizes
, 0, sizeof **mipSizes
* numMipSizes
);
298 *----------------------------------------------------------------------
300 * SVGA3D_DefineSurface2D --
302 * This is a simplified version of SVGA3D_BeginDefineSurface(),
303 * which does not support cube maps, mipmaps, or volume textures.
311 *----------------------------------------------------------------------
315 SVGA3D_DefineSurface2D(struct svga_winsys_context
*swc
, // IN
316 struct svga_winsys_surface
*sid
, // IN
319 SVGA3dSurfaceFormat format
) // IN
321 SVGA3dSize
*mipSizes
;
322 SVGA3dSurfaceFace
*faces
;
325 ret
= SVGA3D_BeginDefineSurface(swc
,
326 sid
, 0, format
, &faces
, &mipSizes
, 1);
330 faces
[0].numMipLevels
= 1;
332 mipSizes
[0].width
= width
;
333 mipSizes
[0].height
= height
;
334 mipSizes
[0].depth
= 1;
343 *----------------------------------------------------------------------
345 * SVGA3D_DestroySurface --
347 * Release the host VRAM encapsulated by a particular surface ID.
355 *----------------------------------------------------------------------
359 SVGA3D_DestroySurface(struct svga_winsys_context
*swc
,
360 struct svga_winsys_surface
*sid
) // IN
362 SVGA3dCmdDestroySurface
*cmd
;
364 cmd
= SVGA3D_FIFOReserve(swc
,
365 SVGA_3D_CMD_SURFACE_DESTROY
, sizeof *cmd
, 1);
367 return PIPE_ERROR_OUT_OF_MEMORY
;
369 swc
->surface_relocation(swc
, &cmd
->sid
, sid
, SVGA_RELOC_READ
);
377 *----------------------------------------------------------------------
379 * SVGA3D_SurfaceDMA--
381 * Emit a SURFACE_DMA command.
383 * When the SVGA3D device asynchronously processes this FIFO
384 * command, a DMA operation is performed between host VRAM and
385 * a generic SVGAGuestPtr. The guest pointer may refer to guest
386 * VRAM (provided by the SVGA PCI device) or to guest system
387 * memory that has been set up as a Guest Memory Region (GMR)
388 * by the SVGA device.
390 * The guest's DMA buffer must remain valid (not freed, paged out,
391 * or overwritten) until the host has finished processing this
392 * command. The guest can determine that the host has finished
393 * by using the SVGA device's FIFO Fence mechanism.
395 * The guest's image buffer can be an arbitrary size and shape.
396 * Guest image data is interpreted according to the SVGA3D surface
397 * format specified when the surface was defined.
399 * The caller may optionally define the guest image's pitch.
400 * guestImage->pitch can either be zero (assume image is tightly
401 * packed) or it must be the number of bytes between vertically
402 * adjacent image blocks.
404 * The provided copybox list specifies which regions of the source
405 * image are to be copied, and where they appear on the destination.
407 * NOTE: srcx/srcy are always on the guest image and x/y are
408 * always on the host image, regardless of the actual transfer
411 * For efficiency, the SVGA3D device is free to copy more data
412 * than specified. For example, it may round copy boxes outwards
413 * such that they lie on particular alignment boundaries.
415 *----------------------------------------------------------------------
419 SVGA3D_SurfaceDMA(struct svga_winsys_context
*swc
,
420 struct svga_transfer
*st
, // IN
421 SVGA3dTransferType transfer
, // IN
422 const SVGA3dCopyBox
*boxes
, // IN
423 uint32 numBoxes
, // IN
424 SVGA3dSurfaceDMAFlags flags
) // IN
426 struct svga_texture
*texture
= svga_texture(st
->base
.resource
);
427 SVGA3dCmdSurfaceDMA
*cmd
;
428 SVGA3dCmdSurfaceDMASuffix
*pSuffix
;
429 uint32 boxesSize
= sizeof *boxes
* numBoxes
;
430 unsigned region_flags
;
431 unsigned surface_flags
;
433 if(transfer
== SVGA3D_WRITE_HOST_VRAM
) {
434 region_flags
= SVGA_RELOC_READ
;
435 surface_flags
= SVGA_RELOC_WRITE
;
437 else if(transfer
== SVGA3D_READ_HOST_VRAM
) {
438 region_flags
= SVGA_RELOC_WRITE
;
439 surface_flags
= SVGA_RELOC_READ
;
443 return PIPE_ERROR_BAD_INPUT
;
446 cmd
= SVGA3D_FIFOReserve(swc
,
447 SVGA_3D_CMD_SURFACE_DMA
,
448 sizeof *cmd
+ boxesSize
+ sizeof *pSuffix
,
451 return PIPE_ERROR_OUT_OF_MEMORY
;
453 swc
->region_relocation(swc
, &cmd
->guest
.ptr
, st
->hwbuf
, 0, region_flags
);
454 cmd
->guest
.pitch
= st
->base
.stride
;
456 swc
->surface_relocation(swc
, &cmd
->host
.sid
, texture
->handle
, surface_flags
);
457 cmd
->host
.face
= st
->face
; /* PIPE_TEX_FACE_* and SVGA3D_CUBEFACE_* match */
458 cmd
->host
.mipmap
= st
->base
.level
;
460 cmd
->transfer
= transfer
;
462 memcpy(&cmd
[1], boxes
, boxesSize
);
464 pSuffix
= (SVGA3dCmdSurfaceDMASuffix
*)((uint8_t*)cmd
+ sizeof *cmd
+ boxesSize
);
465 pSuffix
->suffixSize
= sizeof *pSuffix
;
466 pSuffix
->maximumOffset
= st
->hw_nblocksy
*st
->base
.stride
;
467 pSuffix
->flags
= flags
;
476 SVGA3D_BufferDMA(struct svga_winsys_context
*swc
,
477 struct svga_winsys_buffer
*guest
,
478 struct svga_winsys_surface
*host
,
479 SVGA3dTransferType transfer
, // IN
481 uint32 guest_offset
, // IN
482 uint32 host_offset
, // IN
483 SVGA3dSurfaceDMAFlags flags
) // IN
485 SVGA3dCmdSurfaceDMA
*cmd
;
487 SVGA3dCmdSurfaceDMASuffix
*pSuffix
;
488 unsigned region_flags
;
489 unsigned surface_flags
;
491 if(transfer
== SVGA3D_WRITE_HOST_VRAM
) {
492 region_flags
= SVGA_RELOC_READ
;
493 surface_flags
= SVGA_RELOC_WRITE
;
495 else if(transfer
== SVGA3D_READ_HOST_VRAM
) {
496 region_flags
= SVGA_RELOC_WRITE
;
497 surface_flags
= SVGA_RELOC_READ
;
501 return PIPE_ERROR_BAD_INPUT
;
504 cmd
= SVGA3D_FIFOReserve(swc
,
505 SVGA_3D_CMD_SURFACE_DMA
,
506 sizeof *cmd
+ sizeof *box
+ sizeof *pSuffix
,
509 return PIPE_ERROR_OUT_OF_MEMORY
;
511 swc
->region_relocation(swc
, &cmd
->guest
.ptr
, guest
, 0, region_flags
);
512 cmd
->guest
.pitch
= 0;
514 swc
->surface_relocation(swc
, &cmd
->host
.sid
, host
, surface_flags
);
516 cmd
->host
.mipmap
= 0;
518 cmd
->transfer
= transfer
;
520 box
= (SVGA3dCopyBox
*)&cmd
[1];
521 box
->x
= host_offset
;
527 box
->srcx
= guest_offset
;
531 pSuffix
= (SVGA3dCmdSurfaceDMASuffix
*)((uint8_t*)cmd
+ sizeof *cmd
+ sizeof *box
);
532 pSuffix
->suffixSize
= sizeof *pSuffix
;
533 pSuffix
->maximumOffset
= guest_offset
+ size
;
534 pSuffix
->flags
= flags
;
543 *----------------------------------------------------------------------
545 * SVGA3D_SetRenderTarget --
547 * Bind a surface object to a particular render target attachment
548 * point on the current context. Render target attachment points
549 * exist for color buffers, a depth buffer, and a stencil buffer.
551 * The SVGA3D device is quite lenient about the types of surfaces
552 * that may be used as render targets. The color buffers must
553 * all be the same size, but the depth and stencil buffers do not
554 * have to be the same size as the color buffer. All attachments
557 * Some combinations of render target formats may require software
558 * emulation, depending on the capabilities of the host graphics
559 * API and graphics hardware.
567 *----------------------------------------------------------------------
571 SVGA3D_SetRenderTarget(struct svga_winsys_context
*swc
,
572 SVGA3dRenderTargetType type
, // IN
573 struct pipe_surface
*surface
) // IN
575 SVGA3dCmdSetRenderTarget
*cmd
;
577 cmd
= SVGA3D_FIFOReserve(swc
,
578 SVGA_3D_CMD_SETRENDERTARGET
, sizeof *cmd
, 1);
580 return PIPE_ERROR_OUT_OF_MEMORY
;
584 surface_to_surfaceid(swc
, surface
, &cmd
->target
, SVGA_RELOC_WRITE
);
592 *----------------------------------------------------------------------
594 * SVGA3D_DefineShader --
596 * Upload the bytecode for a new shader. The bytecode is "SVGA3D
597 * format", which is theoretically a binary-compatible superset
598 * of Microsoft's DirectX shader bytecode. In practice, the
599 * SVGA3D bytecode doesn't yet have any extensions to DirectX's
602 * The SVGA3D device supports shader models 1.1 through 2.0.
604 * The caller chooses a shader ID (small positive integer) by
605 * which this shader will be identified in future commands. This
606 * ID is in a namespace which is per-context and per-shader-type.
608 * 'bytecodeLen' is specified in bytes. It must be a multiple of 4.
616 *----------------------------------------------------------------------
620 SVGA3D_DefineShader(struct svga_winsys_context
*swc
,
622 SVGA3dShaderType type
, // IN
623 const uint32
*bytecode
, // IN
624 uint32 bytecodeLen
) // IN
626 SVGA3dCmdDefineShader
*cmd
;
628 assert(bytecodeLen
% 4 == 0);
630 cmd
= SVGA3D_FIFOReserve(swc
,
631 SVGA_3D_CMD_SHADER_DEFINE
, sizeof *cmd
+ bytecodeLen
,
634 return PIPE_ERROR_OUT_OF_MEMORY
;
639 memcpy(&cmd
[1], bytecode
, bytecodeLen
);
647 *----------------------------------------------------------------------
649 * SVGA3D_DestroyShader --
651 * Delete a shader that was created by SVGA3D_DefineShader. If
652 * the shader was the current vertex or pixel shader for its
653 * context, rendering results are undefined until a new shader is
662 *----------------------------------------------------------------------
666 SVGA3D_DestroyShader(struct svga_winsys_context
*swc
,
668 SVGA3dShaderType type
) // IN
670 SVGA3dCmdDestroyShader
*cmd
;
672 cmd
= SVGA3D_FIFOReserve(swc
,
673 SVGA_3D_CMD_SHADER_DESTROY
, sizeof *cmd
,
676 return PIPE_ERROR_OUT_OF_MEMORY
;
688 *----------------------------------------------------------------------
690 * SVGA3D_SetShaderConst --
692 * Set the value of a shader constant.
694 * Shader constants are analogous to uniform variables in GLSL,
695 * except that they belong to the render context rather than to
696 * an individual shader.
698 * Constants may have one of three types: A 4-vector of floats,
699 * a 4-vector of integers, or a single boolean flag.
707 *----------------------------------------------------------------------
711 SVGA3D_SetShaderConst(struct svga_winsys_context
*swc
,
713 SVGA3dShaderType type
, // IN
714 SVGA3dShaderConstType ctype
, // IN
715 const void *value
) // IN
717 SVGA3dCmdSetShaderConst
*cmd
;
719 cmd
= SVGA3D_FIFOReserve(swc
,
720 SVGA_3D_CMD_SET_SHADER_CONST
, sizeof *cmd
,
723 return PIPE_ERROR_OUT_OF_MEMORY
;
732 case SVGA3D_CONST_TYPE_FLOAT
:
733 case SVGA3D_CONST_TYPE_INT
:
734 memcpy(&cmd
->values
, value
, sizeof cmd
->values
);
737 case SVGA3D_CONST_TYPE_BOOL
:
738 memset(&cmd
->values
, 0, sizeof cmd
->values
);
739 cmd
->values
[0] = *(uint32
*)value
;
754 *----------------------------------------------------------------------
756 * SVGA3D_SetShaderConsts --
758 * Set the value of successive shader constants.
760 * Shader constants are analogous to uniform variables in GLSL,
761 * except that they belong to the render context rather than to
762 * an individual shader.
764 * Constants may have one of three types: A 4-vector of floats,
765 * a 4-vector of integers, or a single boolean flag.
773 *----------------------------------------------------------------------
777 SVGA3D_SetShaderConsts(struct svga_winsys_context
*swc
,
779 uint32 numRegs
, // IN
780 SVGA3dShaderType type
, // IN
781 SVGA3dShaderConstType ctype
, // IN
782 const void *values
) // IN
784 SVGA3dCmdSetShaderConst
*cmd
;
786 cmd
= SVGA3D_FIFOReserve(swc
,
787 SVGA_3D_CMD_SET_SHADER_CONST
,
788 sizeof *cmd
+ (numRegs
- 1) * sizeof cmd
->values
,
791 return PIPE_ERROR_OUT_OF_MEMORY
;
798 memcpy(&cmd
->values
, values
, numRegs
* sizeof cmd
->values
);
810 *----------------------------------------------------------------------
812 * SVGA3D_SetShader --
814 * Switch active shaders. This binds a new vertex or pixel shader
815 * to the specified context.
817 * A shader ID of SVGA3D_INVALID_ID unbinds any shader, switching
818 * back to the fixed function vertex or pixel pipeline.
826 *----------------------------------------------------------------------
830 SVGA3D_SetShader(struct svga_winsys_context
*swc
,
831 SVGA3dShaderType type
, // IN
834 SVGA3dCmdSetShader
*cmd
;
836 cmd
= SVGA3D_FIFOReserve(swc
,
837 SVGA_3D_CMD_SET_SHADER
, sizeof *cmd
,
840 return PIPE_ERROR_OUT_OF_MEMORY
;
852 *----------------------------------------------------------------------
854 * SVGA3D_BeginClear --
856 * Begin a CLEAR command. This reserves space for it in the FIFO,
857 * and returns a pointer to the command's rectangle array. This
858 * function must be paired with SVGA_FIFOCommitAll().
860 * Clear is a rendering operation which fills a list of
861 * rectangles with constant values on all render target types
862 * indicated by 'flags'.
864 * Clear is not affected by clipping, depth test, or other
865 * render state which affects the fragment pipeline.
871 * May write to attached render target surfaces.
873 *----------------------------------------------------------------------
877 SVGA3D_BeginClear(struct svga_winsys_context
*swc
,
878 SVGA3dClearFlag flags
, // IN
881 uint32 stencil
, // IN
882 SVGA3dRect
**rects
, // OUT
883 uint32 numRects
) // IN
887 cmd
= SVGA3D_FIFOReserve(swc
,
889 sizeof *cmd
+ sizeof **rects
* numRects
,
892 return PIPE_ERROR_OUT_OF_MEMORY
;
895 cmd
->clearFlag
= flags
;
898 cmd
->stencil
= stencil
;
899 *rects
= (SVGA3dRect
*) &cmd
[1];
906 *----------------------------------------------------------------------
908 * SVGA3D_ClearRect --
910 * This is a simplified version of SVGA3D_BeginClear().
918 *----------------------------------------------------------------------
922 SVGA3D_ClearRect(struct svga_winsys_context
*swc
,
923 SVGA3dClearFlag flags
, // IN
926 uint32 stencil
, // IN
935 ret
= SVGA3D_BeginClear(swc
, flags
, color
, depth
, stencil
, &rect
, 1);
937 return PIPE_ERROR_OUT_OF_MEMORY
;
939 memset(rect
, 0, sizeof *rect
);
951 *----------------------------------------------------------------------
953 * SVGA3D_BeginDrawPrimitives --
955 * Begin a DRAW_PRIMITIVES command. This reserves space for it in
956 * the FIFO, and returns a pointer to the command's arrays.
957 * This function must be paired with SVGA_FIFOCommitAll().
959 * Drawing commands consist of two variable-length arrays:
960 * SVGA3dVertexDecl elements declare a set of vertex buffers to
961 * use while rendering, and SVGA3dPrimitiveRange elements specify
962 * groups of primitives each with an optional index buffer.
964 * The decls and ranges arrays are initialized to zero.
970 * May write to attached render target surfaces.
972 *----------------------------------------------------------------------
976 SVGA3D_BeginDrawPrimitives(struct svga_winsys_context
*swc
,
977 SVGA3dVertexDecl
**decls
, // OUT
978 uint32 numVertexDecls
, // IN
979 SVGA3dPrimitiveRange
**ranges
, // OUT
980 uint32 numRanges
) // IN
982 SVGA3dCmdDrawPrimitives
*cmd
;
983 SVGA3dVertexDecl
*declArray
;
984 SVGA3dPrimitiveRange
*rangeArray
;
985 uint32 declSize
= sizeof **decls
* numVertexDecls
;
986 uint32 rangeSize
= sizeof **ranges
* numRanges
;
988 cmd
= SVGA3D_FIFOReserve(swc
,
989 SVGA_3D_CMD_DRAW_PRIMITIVES
,
990 sizeof *cmd
+ declSize
+ rangeSize
,
991 numVertexDecls
+ numRanges
);
993 return PIPE_ERROR_OUT_OF_MEMORY
;
996 cmd
->numVertexDecls
= numVertexDecls
;
997 cmd
->numRanges
= numRanges
;
999 declArray
= (SVGA3dVertexDecl
*) &cmd
[1];
1000 rangeArray
= (SVGA3dPrimitiveRange
*) &declArray
[numVertexDecls
];
1002 memset(declArray
, 0, declSize
);
1003 memset(rangeArray
, 0, rangeSize
);
1006 *ranges
= rangeArray
;
1013 *----------------------------------------------------------------------
1015 * SVGA3D_BeginSurfaceCopy --
1017 * Begin a SURFACE_COPY command. This reserves space for it in
1018 * the FIFO, and returns a pointer to the command's arrays. This
1019 * function must be paired with SVGA_FIFOCommitAll().
1021 * The box array is initialized with zeroes.
1027 * Asynchronously copies a list of boxes from surface to surface.
1029 *----------------------------------------------------------------------
1033 SVGA3D_BeginSurfaceCopy(struct svga_winsys_context
*swc
,
1034 struct pipe_surface
*src
, // IN
1035 struct pipe_surface
*dest
, // IN
1036 SVGA3dCopyBox
**boxes
, // OUT
1037 uint32 numBoxes
) // IN
1039 SVGA3dCmdSurfaceCopy
*cmd
;
1040 uint32 boxesSize
= sizeof **boxes
* numBoxes
;
1042 cmd
= SVGA3D_FIFOReserve(swc
,
1043 SVGA_3D_CMD_SURFACE_COPY
, sizeof *cmd
+ boxesSize
,
1046 return PIPE_ERROR_OUT_OF_MEMORY
;
1048 surface_to_surfaceid(swc
, src
, &cmd
->src
, SVGA_RELOC_READ
);
1049 surface_to_surfaceid(swc
, dest
, &cmd
->dest
, SVGA_RELOC_WRITE
);
1050 *boxes
= (SVGA3dCopyBox
*) &cmd
[1];
1052 memset(*boxes
, 0, boxesSize
);
1059 *----------------------------------------------------------------------
1061 * SVGA3D_SurfaceStretchBlt --
1063 * Issue a SURFACE_STRETCHBLT command: an asynchronous
1064 * surface-to-surface blit, with scaling.
1070 * Asynchronously copies one box from surface to surface.
1072 *----------------------------------------------------------------------
1076 SVGA3D_SurfaceStretchBlt(struct svga_winsys_context
*swc
,
1077 struct pipe_surface
*src
, // IN
1078 struct pipe_surface
*dest
, // IN
1079 SVGA3dBox
*boxSrc
, // IN
1080 SVGA3dBox
*boxDest
, // IN
1081 SVGA3dStretchBltMode mode
) // IN
1083 SVGA3dCmdSurfaceStretchBlt
*cmd
;
1085 cmd
= SVGA3D_FIFOReserve(swc
,
1086 SVGA_3D_CMD_SURFACE_STRETCHBLT
, sizeof *cmd
,
1089 return PIPE_ERROR_OUT_OF_MEMORY
;
1091 surface_to_surfaceid(swc
, src
, &cmd
->src
, SVGA_RELOC_READ
);
1092 surface_to_surfaceid(swc
, dest
, &cmd
->dest
, SVGA_RELOC_WRITE
);
1093 cmd
->boxSrc
= *boxSrc
;
1094 cmd
->boxDest
= *boxDest
;
1103 *----------------------------------------------------------------------
1105 * SVGA3D_SetViewport --
1107 * Set the current context's viewport rectangle. The viewport
1108 * is clipped to the dimensions of the current render target,
1109 * then all rendering is clipped to the viewport.
1117 *----------------------------------------------------------------------
1121 SVGA3D_SetViewport(struct svga_winsys_context
*swc
,
1122 SVGA3dRect
*rect
) // IN
1124 SVGA3dCmdSetViewport
*cmd
;
1126 cmd
= SVGA3D_FIFOReserve(swc
,
1127 SVGA_3D_CMD_SETVIEWPORT
, sizeof *cmd
,
1130 return PIPE_ERROR_OUT_OF_MEMORY
;
1132 cmd
->cid
= swc
->cid
;
1143 *----------------------------------------------------------------------
1145 * SVGA3D_SetScissorRect --
1147 * Set the current context's scissor rectangle. If scissor
1148 * is enabled then all rendering is clipped to the scissor.
1156 *----------------------------------------------------------------------
1160 SVGA3D_SetScissorRect(struct svga_winsys_context
*swc
,
1161 SVGA3dRect
*rect
) // IN
1163 SVGA3dCmdSetScissorRect
*cmd
;
1165 cmd
= SVGA3D_FIFOReserve(swc
,
1166 SVGA_3D_CMD_SETSCISSORRECT
, sizeof *cmd
,
1169 return PIPE_ERROR_OUT_OF_MEMORY
;
1171 cmd
->cid
= swc
->cid
;
1179 *----------------------------------------------------------------------
1181 * SVGA3D_SetClipPlane --
1183 * Set one of the current context's clip planes. If the clip
1184 * plane is enabled then all 3d rendering is clipped to against
1193 *----------------------------------------------------------------------
1197 SVGA3D_SetClipPlane(struct svga_winsys_context
*swc
,
1198 uint32 index
, const float *plane
)
1200 SVGA3dCmdSetClipPlane
*cmd
;
1202 cmd
= SVGA3D_FIFOReserve(swc
,
1203 SVGA_3D_CMD_SETCLIPPLANE
, sizeof *cmd
,
1206 return PIPE_ERROR_OUT_OF_MEMORY
;
1208 cmd
->cid
= swc
->cid
;
1210 cmd
->plane
[0] = plane
[0];
1211 cmd
->plane
[1] = plane
[1];
1212 cmd
->plane
[2] = plane
[2];
1213 cmd
->plane
[3] = plane
[3];
1220 *----------------------------------------------------------------------
1222 * SVGA3D_SetZRange --
1224 * Set the range of the depth buffer to use. 'min' and 'max'
1225 * are values between 0.0 and 1.0.
1233 *----------------------------------------------------------------------
1237 SVGA3D_SetZRange(struct svga_winsys_context
*swc
,
1241 SVGA3dCmdSetZRange
*cmd
;
1243 cmd
= SVGA3D_FIFOReserve(swc
,
1244 SVGA_3D_CMD_SETZRANGE
, sizeof *cmd
,
1247 return PIPE_ERROR_OUT_OF_MEMORY
;
1249 cmd
->cid
= swc
->cid
;
1250 cmd
->zRange
.min
= zMin
;
1251 cmd
->zRange
.max
= zMax
;
1259 *----------------------------------------------------------------------
1261 * SVGA3D_BeginSetTextureState --
1263 * Begin a SETTEXTURESTATE command. This reserves space for it in
1264 * the FIFO, and returns a pointer to the command's texture state
1265 * array. This function must be paired with SVGA_FIFOCommitAll().
1267 * This command sets rendering state which is per-texture-unit.
1269 * XXX: Individual texture states need documentation. However,
1270 * they are very similar to the texture states defined by
1271 * Direct3D. The D3D documentation is a good starting point
1272 * for understanding SVGA3D texture states.
1280 *----------------------------------------------------------------------
1284 SVGA3D_BeginSetTextureState(struct svga_winsys_context
*swc
,
1285 SVGA3dTextureState
**states
, // OUT
1286 uint32 numStates
) // IN
1288 SVGA3dCmdSetTextureState
*cmd
;
1290 cmd
= SVGA3D_FIFOReserve(swc
,
1291 SVGA_3D_CMD_SETTEXTURESTATE
,
1292 sizeof *cmd
+ sizeof **states
* numStates
,
1295 return PIPE_ERROR_OUT_OF_MEMORY
;
1297 cmd
->cid
= swc
->cid
;
1298 *states
= (SVGA3dTextureState
*) &cmd
[1];
1305 *----------------------------------------------------------------------
1307 * SVGA3D_BeginSetRenderState --
1309 * Begin a SETRENDERSTATE command. This reserves space for it in
1310 * the FIFO, and returns a pointer to the command's texture state
1311 * array. This function must be paired with SVGA_FIFOCommitAll().
1313 * This command sets rendering state which is global to the context.
1315 * XXX: Individual render states need documentation. However,
1316 * they are very similar to the render states defined by
1317 * Direct3D. The D3D documentation is a good starting point
1318 * for understanding SVGA3D render states.
1326 *----------------------------------------------------------------------
1330 SVGA3D_BeginSetRenderState(struct svga_winsys_context
*swc
,
1331 SVGA3dRenderState
**states
, // OUT
1332 uint32 numStates
) // IN
1334 SVGA3dCmdSetRenderState
*cmd
;
1336 cmd
= SVGA3D_FIFOReserve(swc
,
1337 SVGA_3D_CMD_SETRENDERSTATE
,
1338 sizeof *cmd
+ sizeof **states
* numStates
,
1341 return PIPE_ERROR_OUT_OF_MEMORY
;
1343 cmd
->cid
= swc
->cid
;
1344 *states
= (SVGA3dRenderState
*) &cmd
[1];
1351 *----------------------------------------------------------------------
1353 * SVGA3D_BeginQuery--
1355 * Issues a SVGA_3D_CMD_BEGIN_QUERY command.
1361 * Commits space in the FIFO memory.
1363 *----------------------------------------------------------------------
1367 SVGA3D_BeginQuery(struct svga_winsys_context
*swc
,
1368 SVGA3dQueryType type
) // IN
1370 SVGA3dCmdBeginQuery
*cmd
;
1372 cmd
= SVGA3D_FIFOReserve(swc
,
1373 SVGA_3D_CMD_BEGIN_QUERY
,
1377 return PIPE_ERROR_OUT_OF_MEMORY
;
1379 cmd
->cid
= swc
->cid
;
1389 *----------------------------------------------------------------------
1393 * Issues a SVGA_3D_CMD_END_QUERY command.
1399 * Commits space in the FIFO memory.
1401 *----------------------------------------------------------------------
1405 SVGA3D_EndQuery(struct svga_winsys_context
*swc
,
1406 SVGA3dQueryType type
, // IN
1407 struct svga_winsys_buffer
*buffer
) // IN/OUT
1409 SVGA3dCmdEndQuery
*cmd
;
1411 cmd
= SVGA3D_FIFOReserve(swc
,
1412 SVGA_3D_CMD_END_QUERY
,
1416 return PIPE_ERROR_OUT_OF_MEMORY
;
1418 cmd
->cid
= swc
->cid
;
1421 swc
->region_relocation(swc
, &cmd
->guestResult
, buffer
, 0,
1431 *----------------------------------------------------------------------
1433 * SVGA3D_WaitForQuery--
1435 * Issues a SVGA_3D_CMD_WAIT_FOR_QUERY command. This reserves space
1436 * for it in the FIFO. This doesn't actually wait for the query to
1437 * finish but instead tells the host to start a wait at the driver
1438 * level. The caller can wait on the status variable in the
1439 * guestPtr memory or send an insert fence instruction after this
1440 * command and wait on the fence.
1446 * Commits space in the FIFO memory.
1448 *----------------------------------------------------------------------
1452 SVGA3D_WaitForQuery(struct svga_winsys_context
*swc
,
1453 SVGA3dQueryType type
, // IN
1454 struct svga_winsys_buffer
*buffer
) // IN/OUT
1456 SVGA3dCmdWaitForQuery
*cmd
;
1458 cmd
= SVGA3D_FIFOReserve(swc
,
1459 SVGA_3D_CMD_WAIT_FOR_QUERY
,
1463 return PIPE_ERROR_OUT_OF_MEMORY
;
1465 cmd
->cid
= swc
->cid
;
1468 swc
->region_relocation(swc
, &cmd
->guestResult
, buffer
, 0,