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 preformed 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 hierarchial:
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_BeginSurfaceDMA--
381 * Begin a SURFACE_DMA command. This reserves space for it in
382 * the FIFO, and returns a pointer to the command's box array.
383 * This function must be paired with SVGA_FIFOCommitAll().
385 * When the SVGA3D device asynchronously processes this FIFO
386 * command, a DMA operation is performed between host VRAM and
387 * a generic SVGAGuestPtr. The guest pointer may refer to guest
388 * VRAM (provided by the SVGA PCI device) or to guest system
389 * memory that has been set up as a Guest Memory Region (GMR)
390 * by the SVGA device.
392 * The guest's DMA buffer must remain valid (not freed, paged out,
393 * or overwritten) until the host has finished processing this
394 * command. The guest can determine that the host has finished
395 * by using the SVGA device's FIFO Fence mechanism.
397 * The guest's image buffer can be an arbitrary size and shape.
398 * Guest image data is interpreted according to the SVGA3D surface
399 * format specified when the surface was defined.
401 * The caller may optionally define the guest image's pitch.
402 * guestImage->pitch can either be zero (assume image is tightly
403 * packed) or it must be the number of bytes between vertically
404 * adjacent image blocks.
406 * The provided copybox list specifies which regions of the source
407 * image are to be copied, and where they appear on the destination.
409 * NOTE: srcx/srcy are always on the guest image and x/y are
410 * always on the host image, regardless of the actual transfer
413 * For efficiency, the SVGA3D device is free to copy more data
414 * than specified. For example, it may round copy boxes outwards
415 * such that they lie on particular alignment boundaries.
417 *----------------------------------------------------------------------
421 SVGA3D_SurfaceDMA(struct svga_winsys_context
*swc
,
422 struct svga_transfer
*st
, // IN
423 SVGA3dTransferType transfer
, // IN
424 const SVGA3dCopyBox
*boxes
, // IN
425 uint32 numBoxes
, // IN
426 SVGA3dSurfaceDMAFlags flags
) // IN
428 struct svga_texture
*texture
= svga_texture(st
->base
.resource
);
429 SVGA3dCmdSurfaceDMA
*cmd
;
430 SVGA3dCmdSurfaceDMASuffix
*pSuffix
;
431 uint32 boxesSize
= sizeof *boxes
* numBoxes
;
432 unsigned region_flags
;
433 unsigned surface_flags
;
435 if(transfer
== SVGA3D_WRITE_HOST_VRAM
) {
436 region_flags
= SVGA_RELOC_READ
;
437 surface_flags
= SVGA_RELOC_WRITE
;
439 else if(transfer
== SVGA3D_READ_HOST_VRAM
) {
440 region_flags
= SVGA_RELOC_WRITE
;
441 surface_flags
= SVGA_RELOC_READ
;
445 return PIPE_ERROR_BAD_INPUT
;
448 cmd
= SVGA3D_FIFOReserve(swc
,
449 SVGA_3D_CMD_SURFACE_DMA
,
450 sizeof *cmd
+ boxesSize
+ sizeof *pSuffix
,
453 return PIPE_ERROR_OUT_OF_MEMORY
;
455 swc
->region_relocation(swc
, &cmd
->guest
.ptr
, st
->hwbuf
, 0, region_flags
);
456 cmd
->guest
.pitch
= st
->base
.stride
;
458 swc
->surface_relocation(swc
, &cmd
->host
.sid
, texture
->handle
, surface_flags
);
459 cmd
->host
.face
= st
->face
; /* PIPE_TEX_FACE_* and SVGA3D_CUBEFACE_* match */
460 cmd
->host
.mipmap
= st
->base
.level
;
462 cmd
->transfer
= transfer
;
464 memcpy(&cmd
[1], boxes
, boxesSize
);
466 pSuffix
= (SVGA3dCmdSurfaceDMASuffix
*)((uint8_t*)cmd
+ sizeof *cmd
+ boxesSize
);
467 pSuffix
->suffixSize
= sizeof *pSuffix
;
468 pSuffix
->maximumOffset
= st
->hw_nblocksy
*st
->base
.stride
;
469 pSuffix
->flags
= flags
;
478 SVGA3D_BufferDMA(struct svga_winsys_context
*swc
,
479 struct svga_winsys_buffer
*guest
,
480 struct svga_winsys_surface
*host
,
481 SVGA3dTransferType transfer
, // IN
483 uint32 guest_offset
, // IN
484 uint32 host_offset
, // IN
485 SVGA3dSurfaceDMAFlags flags
) // IN
487 SVGA3dCmdSurfaceDMA
*cmd
;
489 SVGA3dCmdSurfaceDMASuffix
*pSuffix
;
490 unsigned region_flags
;
491 unsigned surface_flags
;
493 if(transfer
== SVGA3D_WRITE_HOST_VRAM
) {
494 region_flags
= SVGA_RELOC_READ
;
495 surface_flags
= SVGA_RELOC_WRITE
;
497 else if(transfer
== SVGA3D_READ_HOST_VRAM
) {
498 region_flags
= SVGA_RELOC_WRITE
;
499 surface_flags
= SVGA_RELOC_READ
;
503 return PIPE_ERROR_BAD_INPUT
;
506 cmd
= SVGA3D_FIFOReserve(swc
,
507 SVGA_3D_CMD_SURFACE_DMA
,
508 sizeof *cmd
+ sizeof *box
+ sizeof *pSuffix
,
511 return PIPE_ERROR_OUT_OF_MEMORY
;
513 swc
->region_relocation(swc
, &cmd
->guest
.ptr
, guest
, 0, region_flags
);
514 cmd
->guest
.pitch
= 0;
516 swc
->surface_relocation(swc
, &cmd
->host
.sid
, host
, surface_flags
);
518 cmd
->host
.mipmap
= 0;
520 cmd
->transfer
= transfer
;
522 box
= (SVGA3dCopyBox
*)&cmd
[1];
523 box
->x
= host_offset
;
529 box
->srcx
= guest_offset
;
533 pSuffix
= (SVGA3dCmdSurfaceDMASuffix
*)((uint8_t*)cmd
+ sizeof *cmd
+ sizeof *box
);
534 pSuffix
->suffixSize
= sizeof *pSuffix
;
535 pSuffix
->maximumOffset
= guest_offset
+ size
;
536 pSuffix
->flags
= flags
;
545 *----------------------------------------------------------------------
547 * SVGA3D_SetRenderTarget --
549 * Bind a surface object to a particular render target attachment
550 * point on the current context. Render target attachment points
551 * exist for color buffers, a depth buffer, and a stencil buffer.
553 * The SVGA3D device is quite lenient about the types of surfaces
554 * that may be used as render targets. The color buffers must
555 * all be the same size, but the depth and stencil buffers do not
556 * have to be the same size as the color buffer. All attachments
559 * Some combinations of render target formats may require software
560 * emulation, depending on the capabilities of the host graphics
561 * API and graphics hardware.
569 *----------------------------------------------------------------------
573 SVGA3D_SetRenderTarget(struct svga_winsys_context
*swc
,
574 SVGA3dRenderTargetType type
, // IN
575 struct pipe_surface
*surface
) // IN
577 SVGA3dCmdSetRenderTarget
*cmd
;
579 cmd
= SVGA3D_FIFOReserve(swc
,
580 SVGA_3D_CMD_SETRENDERTARGET
, sizeof *cmd
, 1);
582 return PIPE_ERROR_OUT_OF_MEMORY
;
589 surface_to_surfaceid(swc
, surface
, &cmd
->target
, SVGA_RELOC_WRITE
);
602 *----------------------------------------------------------------------
604 * SVGA3D_DefineShader --
606 * Upload the bytecode for a new shader. The bytecode is "SVGA3D
607 * format", which is theoretically a binary-compatible superset
608 * of Microsoft's DirectX shader bytecode. In practice, the
609 * SVGA3D bytecode doesn't yet have any extensions to DirectX's
612 * The SVGA3D device supports shader models 1.1 through 2.0.
614 * The caller chooses a shader ID (small positive integer) by
615 * which this shader will be identified in future commands. This
616 * ID is in a namespace which is per-context and per-shader-type.
618 * 'bytecodeLen' is specified in bytes. It must be a multiple of 4.
626 *----------------------------------------------------------------------
630 SVGA3D_DefineShader(struct svga_winsys_context
*swc
,
632 SVGA3dShaderType type
, // IN
633 const uint32
*bytecode
, // IN
634 uint32 bytecodeLen
) // IN
636 SVGA3dCmdDefineShader
*cmd
;
638 assert(bytecodeLen
% 4 == 0);
640 cmd
= SVGA3D_FIFOReserve(swc
,
641 SVGA_3D_CMD_SHADER_DEFINE
, sizeof *cmd
+ bytecodeLen
,
644 return PIPE_ERROR_OUT_OF_MEMORY
;
649 memcpy(&cmd
[1], bytecode
, bytecodeLen
);
657 *----------------------------------------------------------------------
659 * SVGA3D_DestroyShader --
661 * Delete a shader that was created by SVGA3D_DefineShader. If
662 * the shader was the current vertex or pixel shader for its
663 * context, rendering results are undefined until a new shader is
672 *----------------------------------------------------------------------
676 SVGA3D_DestroyShader(struct svga_winsys_context
*swc
,
678 SVGA3dShaderType type
) // IN
680 SVGA3dCmdDestroyShader
*cmd
;
682 cmd
= SVGA3D_FIFOReserve(swc
,
683 SVGA_3D_CMD_SHADER_DESTROY
, sizeof *cmd
,
686 return PIPE_ERROR_OUT_OF_MEMORY
;
698 *----------------------------------------------------------------------
700 * SVGA3D_SetShaderConst --
702 * Set the value of a shader constant.
704 * Shader constants are analogous to uniform variables in GLSL,
705 * except that they belong to the render context rather than to
706 * an individual shader.
708 * Constants may have one of three types: A 4-vector of floats,
709 * a 4-vector of integers, or a single boolean flag.
717 *----------------------------------------------------------------------
721 SVGA3D_SetShaderConst(struct svga_winsys_context
*swc
,
723 SVGA3dShaderType type
, // IN
724 SVGA3dShaderConstType ctype
, // IN
725 const void *value
) // IN
727 SVGA3dCmdSetShaderConst
*cmd
;
729 cmd
= SVGA3D_FIFOReserve(swc
,
730 SVGA_3D_CMD_SET_SHADER_CONST
, sizeof *cmd
,
733 return PIPE_ERROR_OUT_OF_MEMORY
;
742 case SVGA3D_CONST_TYPE_FLOAT
:
743 case SVGA3D_CONST_TYPE_INT
:
744 memcpy(&cmd
->values
, value
, sizeof cmd
->values
);
747 case SVGA3D_CONST_TYPE_BOOL
:
748 memset(&cmd
->values
, 0, sizeof cmd
->values
);
749 cmd
->values
[0] = *(uint32
*)value
;
767 *----------------------------------------------------------------------
769 * SVGA3D_SetShader --
771 * Switch active shaders. This binds a new vertex or pixel shader
772 * to the specified context.
774 * A shader ID of SVGA3D_INVALID_ID unbinds any shader, switching
775 * back to the fixed function vertex or pixel pipeline.
783 *----------------------------------------------------------------------
787 SVGA3D_SetShader(struct svga_winsys_context
*swc
,
788 SVGA3dShaderType type
, // IN
791 SVGA3dCmdSetShader
*cmd
;
793 cmd
= SVGA3D_FIFOReserve(swc
,
794 SVGA_3D_CMD_SET_SHADER
, sizeof *cmd
,
797 return PIPE_ERROR_OUT_OF_MEMORY
;
809 *----------------------------------------------------------------------
811 * SVGA3D_BeginClear --
813 * Begin a CLEAR command. This reserves space for it in the FIFO,
814 * and returns a pointer to the command's rectangle array. This
815 * function must be paired with SVGA_FIFOCommitAll().
817 * Clear is a rendering operation which fills a list of
818 * rectangles with constant values on all render target types
819 * indicated by 'flags'.
821 * Clear is not affected by clipping, depth test, or other
822 * render state which affects the fragment pipeline.
828 * May write to attached render target surfaces.
830 *----------------------------------------------------------------------
834 SVGA3D_BeginClear(struct svga_winsys_context
*swc
,
835 SVGA3dClearFlag flags
, // IN
838 uint32 stencil
, // IN
839 SVGA3dRect
**rects
, // OUT
840 uint32 numRects
) // IN
844 cmd
= SVGA3D_FIFOReserve(swc
,
846 sizeof *cmd
+ sizeof **rects
* numRects
,
849 return PIPE_ERROR_OUT_OF_MEMORY
;
852 cmd
->clearFlag
= flags
;
855 cmd
->stencil
= stencil
;
856 *rects
= (SVGA3dRect
*) &cmd
[1];
863 *----------------------------------------------------------------------
865 * SVGA3D_ClearRect --
867 * This is a simplified version of SVGA3D_BeginClear().
875 *----------------------------------------------------------------------
879 SVGA3D_ClearRect(struct svga_winsys_context
*swc
,
880 SVGA3dClearFlag flags
, // IN
883 uint32 stencil
, // IN
892 ret
= SVGA3D_BeginClear(swc
, flags
, color
, depth
, stencil
, &rect
, 1);
894 return PIPE_ERROR_OUT_OF_MEMORY
;
896 memset(rect
, 0, sizeof *rect
);
908 *----------------------------------------------------------------------
910 * SVGA3D_BeginDrawPrimitives --
912 * Begin a DRAW_PRIMITIVES command. This reserves space for it in
913 * the FIFO, and returns a pointer to the command's arrays.
914 * This function must be paired with SVGA_FIFOCommitAll().
916 * Drawing commands consist of two variable-length arrays:
917 * SVGA3dVertexDecl elements declare a set of vertex buffers to
918 * use while rendering, and SVGA3dPrimitiveRange elements specify
919 * groups of primitives each with an optional index buffer.
921 * The decls and ranges arrays are initialized to zero.
927 * May write to attached render target surfaces.
929 *----------------------------------------------------------------------
933 SVGA3D_BeginDrawPrimitives(struct svga_winsys_context
*swc
,
934 SVGA3dVertexDecl
**decls
, // OUT
935 uint32 numVertexDecls
, // IN
936 SVGA3dPrimitiveRange
**ranges
, // OUT
937 uint32 numRanges
) // IN
939 SVGA3dCmdDrawPrimitives
*cmd
;
940 SVGA3dVertexDecl
*declArray
;
941 SVGA3dPrimitiveRange
*rangeArray
;
942 uint32 declSize
= sizeof **decls
* numVertexDecls
;
943 uint32 rangeSize
= sizeof **ranges
* numRanges
;
945 cmd
= SVGA3D_FIFOReserve(swc
,
946 SVGA_3D_CMD_DRAW_PRIMITIVES
,
947 sizeof *cmd
+ declSize
+ rangeSize
,
948 numVertexDecls
+ numRanges
);
950 return PIPE_ERROR_OUT_OF_MEMORY
;
953 cmd
->numVertexDecls
= numVertexDecls
;
954 cmd
->numRanges
= numRanges
;
956 declArray
= (SVGA3dVertexDecl
*) &cmd
[1];
957 rangeArray
= (SVGA3dPrimitiveRange
*) &declArray
[numVertexDecls
];
959 memset(declArray
, 0, declSize
);
960 memset(rangeArray
, 0, rangeSize
);
963 *ranges
= rangeArray
;
970 *----------------------------------------------------------------------
972 * SVGA3D_BeginSurfaceCopy --
974 * Begin a SURFACE_COPY command. This reserves space for it in
975 * the FIFO, and returns a pointer to the command's arrays. This
976 * function must be paired with SVGA_FIFOCommitAll().
978 * The box array is initialized with zeroes.
984 * Asynchronously copies a list of boxes from surface to surface.
986 *----------------------------------------------------------------------
990 SVGA3D_BeginSurfaceCopy(struct svga_winsys_context
*swc
,
991 struct pipe_surface
*src
, // IN
992 struct pipe_surface
*dest
, // IN
993 SVGA3dCopyBox
**boxes
, // OUT
994 uint32 numBoxes
) // IN
996 SVGA3dCmdSurfaceCopy
*cmd
;
997 uint32 boxesSize
= sizeof **boxes
* numBoxes
;
999 cmd
= SVGA3D_FIFOReserve(swc
,
1000 SVGA_3D_CMD_SURFACE_COPY
, sizeof *cmd
+ boxesSize
,
1003 return PIPE_ERROR_OUT_OF_MEMORY
;
1005 surface_to_surfaceid(swc
, src
, &cmd
->src
, SVGA_RELOC_READ
);
1006 surface_to_surfaceid(swc
, dest
, &cmd
->dest
, SVGA_RELOC_WRITE
);
1007 *boxes
= (SVGA3dCopyBox
*) &cmd
[1];
1009 memset(*boxes
, 0, boxesSize
);
1016 *----------------------------------------------------------------------
1018 * SVGA3D_SurfaceStretchBlt --
1020 * Issue a SURFACE_STRETCHBLT command: an asynchronous
1021 * surface-to-surface blit, with scaling.
1027 * Asynchronously copies one box from surface to surface.
1029 *----------------------------------------------------------------------
1033 SVGA3D_SurfaceStretchBlt(struct svga_winsys_context
*swc
,
1034 struct pipe_surface
*src
, // IN
1035 struct pipe_surface
*dest
, // IN
1036 SVGA3dBox
*boxSrc
, // IN
1037 SVGA3dBox
*boxDest
, // IN
1038 SVGA3dStretchBltMode mode
) // IN
1040 SVGA3dCmdSurfaceStretchBlt
*cmd
;
1042 cmd
= SVGA3D_FIFOReserve(swc
,
1043 SVGA_3D_CMD_SURFACE_STRETCHBLT
, sizeof *cmd
,
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 cmd
->boxSrc
= *boxSrc
;
1051 cmd
->boxDest
= *boxDest
;
1060 *----------------------------------------------------------------------
1062 * SVGA3D_SetViewport --
1064 * Set the current context's viewport rectangle. The viewport
1065 * is clipped to the dimensions of the current render target,
1066 * then all rendering is clipped to the viewport.
1074 *----------------------------------------------------------------------
1078 SVGA3D_SetViewport(struct svga_winsys_context
*swc
,
1079 SVGA3dRect
*rect
) // IN
1081 SVGA3dCmdSetViewport
*cmd
;
1083 cmd
= SVGA3D_FIFOReserve(swc
,
1084 SVGA_3D_CMD_SETVIEWPORT
, sizeof *cmd
,
1087 return PIPE_ERROR_OUT_OF_MEMORY
;
1089 cmd
->cid
= swc
->cid
;
1100 *----------------------------------------------------------------------
1102 * SVGA3D_SetScissorRect --
1104 * Set the current context's scissor rectangle. If scissor
1105 * is enabled then all rendering is clipped to the scissor.
1113 *----------------------------------------------------------------------
1117 SVGA3D_SetScissorRect(struct svga_winsys_context
*swc
,
1118 SVGA3dRect
*rect
) // IN
1120 SVGA3dCmdSetScissorRect
*cmd
;
1122 cmd
= SVGA3D_FIFOReserve(swc
,
1123 SVGA_3D_CMD_SETSCISSORRECT
, sizeof *cmd
,
1126 return PIPE_ERROR_OUT_OF_MEMORY
;
1128 cmd
->cid
= swc
->cid
;
1136 *----------------------------------------------------------------------
1138 * SVGA3D_SetClipPlane --
1140 * Set one of the current context's clip planes. If the clip
1141 * plane is enabled then all 3d rendering is clipped to against
1150 *----------------------------------------------------------------------
1153 enum pipe_error
SVGA3D_SetClipPlane(struct svga_winsys_context
*swc
,
1154 uint32 index
, const float *plane
)
1156 SVGA3dCmdSetClipPlane
*cmd
;
1158 cmd
= SVGA3D_FIFOReserve(swc
,
1159 SVGA_3D_CMD_SETCLIPPLANE
, sizeof *cmd
,
1162 return PIPE_ERROR_OUT_OF_MEMORY
;
1164 cmd
->cid
= swc
->cid
;
1166 cmd
->plane
[0] = plane
[0];
1167 cmd
->plane
[1] = plane
[1];
1168 cmd
->plane
[2] = plane
[2];
1169 cmd
->plane
[3] = plane
[3];
1176 *----------------------------------------------------------------------
1178 * SVGA3D_SetZRange --
1180 * Set the range of the depth buffer to use. 'min' and 'max'
1181 * are values between 0.0 and 1.0.
1189 *----------------------------------------------------------------------
1193 SVGA3D_SetZRange(struct svga_winsys_context
*swc
,
1197 SVGA3dCmdSetZRange
*cmd
;
1199 cmd
= SVGA3D_FIFOReserve(swc
,
1200 SVGA_3D_CMD_SETZRANGE
, sizeof *cmd
,
1203 return PIPE_ERROR_OUT_OF_MEMORY
;
1205 cmd
->cid
= swc
->cid
;
1206 cmd
->zRange
.min
= zMin
;
1207 cmd
->zRange
.max
= zMax
;
1215 *----------------------------------------------------------------------
1217 * SVGA3D_BeginSetTextureState --
1219 * Begin a SETTEXTURESTATE command. This reserves space for it in
1220 * the FIFO, and returns a pointer to the command's texture state
1221 * array. This function must be paired with SVGA_FIFOCommitAll().
1223 * This command sets rendering state which is per-texture-unit.
1225 * XXX: Individual texture states need documentation. However,
1226 * they are very similar to the texture states defined by
1227 * Direct3D. The D3D documentation is a good starting point
1228 * for understanding SVGA3D texture states.
1236 *----------------------------------------------------------------------
1240 SVGA3D_BeginSetTextureState(struct svga_winsys_context
*swc
,
1241 SVGA3dTextureState
**states
, // OUT
1242 uint32 numStates
) // IN
1244 SVGA3dCmdSetTextureState
*cmd
;
1246 cmd
= SVGA3D_FIFOReserve(swc
,
1247 SVGA_3D_CMD_SETTEXTURESTATE
,
1248 sizeof *cmd
+ sizeof **states
* numStates
,
1251 return PIPE_ERROR_OUT_OF_MEMORY
;
1253 cmd
->cid
= swc
->cid
;
1254 *states
= (SVGA3dTextureState
*) &cmd
[1];
1261 *----------------------------------------------------------------------
1263 * SVGA3D_BeginSetRenderState --
1265 * Begin a SETRENDERSTATE command. This reserves space for it in
1266 * the FIFO, and returns a pointer to the command's texture state
1267 * array. This function must be paired with SVGA_FIFOCommitAll().
1269 * This command sets rendering state which is global to the context.
1271 * XXX: Individual render states need documentation. However,
1272 * they are very similar to the render states defined by
1273 * Direct3D. The D3D documentation is a good starting point
1274 * for understanding SVGA3D render states.
1282 *----------------------------------------------------------------------
1286 SVGA3D_BeginSetRenderState(struct svga_winsys_context
*swc
,
1287 SVGA3dRenderState
**states
, // OUT
1288 uint32 numStates
) // IN
1290 SVGA3dCmdSetRenderState
*cmd
;
1292 cmd
= SVGA3D_FIFOReserve(swc
,
1293 SVGA_3D_CMD_SETRENDERSTATE
,
1294 sizeof *cmd
+ sizeof **states
* numStates
,
1297 return PIPE_ERROR_OUT_OF_MEMORY
;
1299 cmd
->cid
= swc
->cid
;
1300 *states
= (SVGA3dRenderState
*) &cmd
[1];
1307 *----------------------------------------------------------------------
1309 * SVGA3D_BeginQuery--
1311 * Issues a SVGA_3D_CMD_BEGIN_QUERY command.
1317 * Commits space in the FIFO memory.
1319 *----------------------------------------------------------------------
1323 SVGA3D_BeginQuery(struct svga_winsys_context
*swc
,
1324 SVGA3dQueryType type
) // IN
1326 SVGA3dCmdBeginQuery
*cmd
;
1328 cmd
= SVGA3D_FIFOReserve(swc
,
1329 SVGA_3D_CMD_BEGIN_QUERY
,
1333 return PIPE_ERROR_OUT_OF_MEMORY
;
1335 cmd
->cid
= swc
->cid
;
1345 *----------------------------------------------------------------------
1349 * Issues a SVGA_3D_CMD_END_QUERY command.
1355 * Commits space in the FIFO memory.
1357 *----------------------------------------------------------------------
1361 SVGA3D_EndQuery(struct svga_winsys_context
*swc
,
1362 SVGA3dQueryType type
, // IN
1363 struct svga_winsys_buffer
*buffer
) // IN/OUT
1365 SVGA3dCmdEndQuery
*cmd
;
1367 cmd
= SVGA3D_FIFOReserve(swc
,
1368 SVGA_3D_CMD_END_QUERY
,
1372 return PIPE_ERROR_OUT_OF_MEMORY
;
1374 cmd
->cid
= swc
->cid
;
1377 swc
->region_relocation(swc
, &cmd
->guestResult
, buffer
, 0,
1387 *----------------------------------------------------------------------
1389 * SVGA3D_WaitForQuery--
1391 * Issues a SVGA_3D_CMD_WAIT_FOR_QUERY command. This reserves space
1392 * for it in the FIFO. This doesn't actually wait for the query to
1393 * finish but instead tells the host to start a wait at the driver
1394 * level. The caller can wait on the status variable in the
1395 * guestPtr memory or send an insert fence instruction after this
1396 * command and wait on the fence.
1402 * Commits space in the FIFO memory.
1404 *----------------------------------------------------------------------
1408 SVGA3D_WaitForQuery(struct svga_winsys_context
*swc
,
1409 SVGA3dQueryType type
, // IN
1410 struct svga_winsys_buffer
*buffer
) // IN/OUT
1412 SVGA3dCmdWaitForQuery
*cmd
;
1414 cmd
= SVGA3D_FIFOReserve(swc
,
1415 SVGA_3D_CMD_WAIT_FOR_QUERY
,
1419 return PIPE_ERROR_OUT_OF_MEMORY
;
1421 cmd
->cid
= swc
->cid
;
1424 swc
->region_relocation(swc
, &cmd
->guestResult
, buffer
, 0,