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
427 struct svga_texture
*texture
= svga_texture(st
->base
.resource
);
428 SVGA3dCmdSurfaceDMA
*cmd
;
429 SVGA3dCmdSurfaceDMASuffix
*pSuffix
;
430 uint32 boxesSize
= sizeof *boxes
* numBoxes
;
431 unsigned region_flags
;
432 unsigned surface_flags
;
434 if(transfer
== SVGA3D_WRITE_HOST_VRAM
) {
435 region_flags
= SVGA_RELOC_READ
;
436 surface_flags
= SVGA_RELOC_WRITE
;
438 else if(transfer
== SVGA3D_READ_HOST_VRAM
) {
439 region_flags
= SVGA_RELOC_WRITE
;
440 surface_flags
= SVGA_RELOC_READ
;
444 return PIPE_ERROR_BAD_INPUT
;
447 cmd
= SVGA3D_FIFOReserve(swc
,
448 SVGA_3D_CMD_SURFACE_DMA
,
449 sizeof *cmd
+ boxesSize
+ sizeof *pSuffix
,
452 return PIPE_ERROR_OUT_OF_MEMORY
;
454 swc
->region_relocation(swc
, &cmd
->guest
.ptr
, st
->hwbuf
, 0, region_flags
);
455 cmd
->guest
.pitch
= st
->base
.stride
;
457 swc
->surface_relocation(swc
, &cmd
->host
.sid
, texture
->handle
, surface_flags
);
458 cmd
->host
.face
= st
->base
.sr
.face
; /* PIPE_TEX_FACE_* and SVGA3D_CUBEFACE_* match */
459 cmd
->host
.mipmap
= st
->base
.sr
.level
;
461 cmd
->transfer
= transfer
;
463 memcpy(&cmd
[1], boxes
, boxesSize
);
465 pSuffix
= (SVGA3dCmdSurfaceDMASuffix
*)((uint8_t*)cmd
+ sizeof *cmd
+ boxesSize
);
466 pSuffix
->suffixSize
= sizeof *pSuffix
;
467 pSuffix
->maximumOffset
= st
->hw_nblocksy
*st
->base
.stride
;
468 memset(&pSuffix
->flags
, 0, sizeof pSuffix
->flags
);
477 SVGA3D_BufferDMA(struct svga_winsys_context
*swc
,
478 struct svga_winsys_buffer
*guest
,
479 struct svga_winsys_surface
*host
,
480 SVGA3dTransferType transfer
, // IN
482 uint32 guest_offset
, // IN
483 uint32 host_offset
, // IN
484 SVGA3dSurfaceDMAFlags flags
) // IN
486 SVGA3dCmdSurfaceDMA
*cmd
;
488 SVGA3dCmdSurfaceDMASuffix
*pSuffix
;
489 unsigned region_flags
;
490 unsigned surface_flags
;
492 if(transfer
== SVGA3D_WRITE_HOST_VRAM
) {
493 region_flags
= SVGA_RELOC_READ
;
494 surface_flags
= SVGA_RELOC_WRITE
;
496 else if(transfer
== SVGA3D_READ_HOST_VRAM
) {
497 region_flags
= SVGA_RELOC_WRITE
;
498 surface_flags
= SVGA_RELOC_READ
;
502 return PIPE_ERROR_BAD_INPUT
;
505 cmd
= SVGA3D_FIFOReserve(swc
,
506 SVGA_3D_CMD_SURFACE_DMA
,
507 sizeof *cmd
+ sizeof *box
+ sizeof *pSuffix
,
510 return PIPE_ERROR_OUT_OF_MEMORY
;
512 swc
->region_relocation(swc
, &cmd
->guest
.ptr
, guest
, 0, region_flags
);
513 cmd
->guest
.pitch
= 0;
515 swc
->surface_relocation(swc
, &cmd
->host
.sid
, host
, surface_flags
);
517 cmd
->host
.mipmap
= 0;
519 cmd
->transfer
= transfer
;
521 box
= (SVGA3dCopyBox
*)&cmd
[1];
522 box
->x
= host_offset
;
528 box
->srcx
= guest_offset
;
532 pSuffix
= (SVGA3dCmdSurfaceDMASuffix
*)((uint8_t*)cmd
+ sizeof *cmd
+ sizeof *box
);
533 pSuffix
->suffixSize
= sizeof *pSuffix
;
534 pSuffix
->maximumOffset
= guest_offset
+ size
;
535 pSuffix
->flags
= flags
;
544 *----------------------------------------------------------------------
546 * SVGA3D_SetRenderTarget --
548 * Bind a surface object to a particular render target attachment
549 * point on the current context. Render target attachment points
550 * exist for color buffers, a depth buffer, and a stencil buffer.
552 * The SVGA3D device is quite lenient about the types of surfaces
553 * that may be used as render targets. The color buffers must
554 * all be the same size, but the depth and stencil buffers do not
555 * have to be the same size as the color buffer. All attachments
558 * Some combinations of render target formats may require software
559 * emulation, depending on the capabilities of the host graphics
560 * API and graphics hardware.
568 *----------------------------------------------------------------------
572 SVGA3D_SetRenderTarget(struct svga_winsys_context
*swc
,
573 SVGA3dRenderTargetType type
, // IN
574 struct pipe_surface
*surface
) // IN
576 SVGA3dCmdSetRenderTarget
*cmd
;
578 cmd
= SVGA3D_FIFOReserve(swc
,
579 SVGA_3D_CMD_SETRENDERTARGET
, sizeof *cmd
, 1);
581 return PIPE_ERROR_OUT_OF_MEMORY
;
588 surface_to_surfaceid(swc
, surface
, &cmd
->target
, SVGA_RELOC_WRITE
);
601 *----------------------------------------------------------------------
603 * SVGA3D_DefineShader --
605 * Upload the bytecode for a new shader. The bytecode is "SVGA3D
606 * format", which is theoretically a binary-compatible superset
607 * of Microsoft's DirectX shader bytecode. In practice, the
608 * SVGA3D bytecode doesn't yet have any extensions to DirectX's
611 * The SVGA3D device supports shader models 1.1 through 2.0.
613 * The caller chooses a shader ID (small positive integer) by
614 * which this shader will be identified in future commands. This
615 * ID is in a namespace which is per-context and per-shader-type.
617 * 'bytecodeLen' is specified in bytes. It must be a multiple of 4.
625 *----------------------------------------------------------------------
629 SVGA3D_DefineShader(struct svga_winsys_context
*swc
,
631 SVGA3dShaderType type
, // IN
632 const uint32
*bytecode
, // IN
633 uint32 bytecodeLen
) // IN
635 SVGA3dCmdDefineShader
*cmd
;
637 assert(bytecodeLen
% 4 == 0);
639 cmd
= SVGA3D_FIFOReserve(swc
,
640 SVGA_3D_CMD_SHADER_DEFINE
, sizeof *cmd
+ bytecodeLen
,
643 return PIPE_ERROR_OUT_OF_MEMORY
;
648 memcpy(&cmd
[1], bytecode
, bytecodeLen
);
656 *----------------------------------------------------------------------
658 * SVGA3D_DestroyShader --
660 * Delete a shader that was created by SVGA3D_DefineShader. If
661 * the shader was the current vertex or pixel shader for its
662 * context, rendering results are undefined until a new shader is
671 *----------------------------------------------------------------------
675 SVGA3D_DestroyShader(struct svga_winsys_context
*swc
,
677 SVGA3dShaderType type
) // IN
679 SVGA3dCmdDestroyShader
*cmd
;
681 cmd
= SVGA3D_FIFOReserve(swc
,
682 SVGA_3D_CMD_SHADER_DESTROY
, sizeof *cmd
,
685 return PIPE_ERROR_OUT_OF_MEMORY
;
697 *----------------------------------------------------------------------
699 * SVGA3D_SetShaderConst --
701 * Set the value of a shader constant.
703 * Shader constants are analogous to uniform variables in GLSL,
704 * except that they belong to the render context rather than to
705 * an individual shader.
707 * Constants may have one of three types: A 4-vector of floats,
708 * a 4-vector of integers, or a single boolean flag.
716 *----------------------------------------------------------------------
720 SVGA3D_SetShaderConst(struct svga_winsys_context
*swc
,
722 SVGA3dShaderType type
, // IN
723 SVGA3dShaderConstType ctype
, // IN
724 const void *value
) // IN
726 SVGA3dCmdSetShaderConst
*cmd
;
728 cmd
= SVGA3D_FIFOReserve(swc
,
729 SVGA_3D_CMD_SET_SHADER_CONST
, sizeof *cmd
,
732 return PIPE_ERROR_OUT_OF_MEMORY
;
741 case SVGA3D_CONST_TYPE_FLOAT
:
742 case SVGA3D_CONST_TYPE_INT
:
743 memcpy(&cmd
->values
, value
, sizeof cmd
->values
);
746 case SVGA3D_CONST_TYPE_BOOL
:
747 memset(&cmd
->values
, 0, sizeof cmd
->values
);
748 cmd
->values
[0] = *(uint32
*)value
;
766 *----------------------------------------------------------------------
768 * SVGA3D_SetShader --
770 * Switch active shaders. This binds a new vertex or pixel shader
771 * to the specified context.
773 * A shader ID of SVGA3D_INVALID_ID unbinds any shader, switching
774 * back to the fixed function vertex or pixel pipeline.
782 *----------------------------------------------------------------------
786 SVGA3D_SetShader(struct svga_winsys_context
*swc
,
787 SVGA3dShaderType type
, // IN
790 SVGA3dCmdSetShader
*cmd
;
792 cmd
= SVGA3D_FIFOReserve(swc
,
793 SVGA_3D_CMD_SET_SHADER
, sizeof *cmd
,
796 return PIPE_ERROR_OUT_OF_MEMORY
;
808 *----------------------------------------------------------------------
810 * SVGA3D_BeginClear --
812 * Begin a CLEAR command. This reserves space for it in the FIFO,
813 * and returns a pointer to the command's rectangle array. This
814 * function must be paired with SVGA_FIFOCommitAll().
816 * Clear is a rendering operation which fills a list of
817 * rectangles with constant values on all render target types
818 * indicated by 'flags'.
820 * Clear is not affected by clipping, depth test, or other
821 * render state which affects the fragment pipeline.
827 * May write to attached render target surfaces.
829 *----------------------------------------------------------------------
833 SVGA3D_BeginClear(struct svga_winsys_context
*swc
,
834 SVGA3dClearFlag flags
, // IN
837 uint32 stencil
, // IN
838 SVGA3dRect
**rects
, // OUT
839 uint32 numRects
) // IN
843 cmd
= SVGA3D_FIFOReserve(swc
,
845 sizeof *cmd
+ sizeof **rects
* numRects
,
848 return PIPE_ERROR_OUT_OF_MEMORY
;
851 cmd
->clearFlag
= flags
;
854 cmd
->stencil
= stencil
;
855 *rects
= (SVGA3dRect
*) &cmd
[1];
862 *----------------------------------------------------------------------
864 * SVGA3D_ClearRect --
866 * This is a simplified version of SVGA3D_BeginClear().
874 *----------------------------------------------------------------------
878 SVGA3D_ClearRect(struct svga_winsys_context
*swc
,
879 SVGA3dClearFlag flags
, // IN
882 uint32 stencil
, // IN
891 ret
= SVGA3D_BeginClear(swc
, flags
, color
, depth
, stencil
, &rect
, 1);
893 return PIPE_ERROR_OUT_OF_MEMORY
;
895 memset(rect
, 0, sizeof *rect
);
907 *----------------------------------------------------------------------
909 * SVGA3D_BeginDrawPrimitives --
911 * Begin a DRAW_PRIMITIVES command. This reserves space for it in
912 * the FIFO, and returns a pointer to the command's arrays.
913 * This function must be paired with SVGA_FIFOCommitAll().
915 * Drawing commands consist of two variable-length arrays:
916 * SVGA3dVertexDecl elements declare a set of vertex buffers to
917 * use while rendering, and SVGA3dPrimitiveRange elements specify
918 * groups of primitives each with an optional index buffer.
920 * The decls and ranges arrays are initialized to zero.
926 * May write to attached render target surfaces.
928 *----------------------------------------------------------------------
932 SVGA3D_BeginDrawPrimitives(struct svga_winsys_context
*swc
,
933 SVGA3dVertexDecl
**decls
, // OUT
934 uint32 numVertexDecls
, // IN
935 SVGA3dPrimitiveRange
**ranges
, // OUT
936 uint32 numRanges
) // IN
938 SVGA3dCmdDrawPrimitives
*cmd
;
939 SVGA3dVertexDecl
*declArray
;
940 SVGA3dPrimitiveRange
*rangeArray
;
941 uint32 declSize
= sizeof **decls
* numVertexDecls
;
942 uint32 rangeSize
= sizeof **ranges
* numRanges
;
944 cmd
= SVGA3D_FIFOReserve(swc
,
945 SVGA_3D_CMD_DRAW_PRIMITIVES
,
946 sizeof *cmd
+ declSize
+ rangeSize
,
947 numVertexDecls
+ numRanges
);
949 return PIPE_ERROR_OUT_OF_MEMORY
;
952 cmd
->numVertexDecls
= numVertexDecls
;
953 cmd
->numRanges
= numRanges
;
955 declArray
= (SVGA3dVertexDecl
*) &cmd
[1];
956 rangeArray
= (SVGA3dPrimitiveRange
*) &declArray
[numVertexDecls
];
958 memset(declArray
, 0, declSize
);
959 memset(rangeArray
, 0, rangeSize
);
962 *ranges
= rangeArray
;
969 *----------------------------------------------------------------------
971 * SVGA3D_BeginSurfaceCopy --
973 * Begin a SURFACE_COPY command. This reserves space for it in
974 * the FIFO, and returns a pointer to the command's arrays. This
975 * function must be paired with SVGA_FIFOCommitAll().
977 * The box array is initialized with zeroes.
983 * Asynchronously copies a list of boxes from surface to surface.
985 *----------------------------------------------------------------------
989 SVGA3D_BeginSurfaceCopy(struct svga_winsys_context
*swc
,
990 struct pipe_surface
*src
, // IN
991 struct pipe_surface
*dest
, // IN
992 SVGA3dCopyBox
**boxes
, // OUT
993 uint32 numBoxes
) // IN
995 SVGA3dCmdSurfaceCopy
*cmd
;
996 uint32 boxesSize
= sizeof **boxes
* numBoxes
;
998 cmd
= SVGA3D_FIFOReserve(swc
,
999 SVGA_3D_CMD_SURFACE_COPY
, sizeof *cmd
+ boxesSize
,
1002 return PIPE_ERROR_OUT_OF_MEMORY
;
1004 surface_to_surfaceid(swc
, src
, &cmd
->src
, SVGA_RELOC_READ
);
1005 surface_to_surfaceid(swc
, dest
, &cmd
->dest
, SVGA_RELOC_WRITE
);
1006 *boxes
= (SVGA3dCopyBox
*) &cmd
[1];
1008 memset(*boxes
, 0, boxesSize
);
1015 *----------------------------------------------------------------------
1017 * SVGA3D_SurfaceStretchBlt --
1019 * Issue a SURFACE_STRETCHBLT command: an asynchronous
1020 * surface-to-surface blit, with scaling.
1026 * Asynchronously copies one box from surface to surface.
1028 *----------------------------------------------------------------------
1032 SVGA3D_SurfaceStretchBlt(struct svga_winsys_context
*swc
,
1033 struct pipe_surface
*src
, // IN
1034 struct pipe_surface
*dest
, // IN
1035 SVGA3dBox
*boxSrc
, // IN
1036 SVGA3dBox
*boxDest
, // IN
1037 SVGA3dStretchBltMode mode
) // IN
1039 SVGA3dCmdSurfaceStretchBlt
*cmd
;
1041 cmd
= SVGA3D_FIFOReserve(swc
,
1042 SVGA_3D_CMD_SURFACE_STRETCHBLT
, sizeof *cmd
,
1045 return PIPE_ERROR_OUT_OF_MEMORY
;
1047 surface_to_surfaceid(swc
, src
, &cmd
->src
, SVGA_RELOC_READ
);
1048 surface_to_surfaceid(swc
, dest
, &cmd
->dest
, SVGA_RELOC_WRITE
);
1049 cmd
->boxSrc
= *boxSrc
;
1050 cmd
->boxDest
= *boxDest
;
1059 *----------------------------------------------------------------------
1061 * SVGA3D_SetViewport --
1063 * Set the current context's viewport rectangle. The viewport
1064 * is clipped to the dimensions of the current render target,
1065 * then all rendering is clipped to the viewport.
1073 *----------------------------------------------------------------------
1077 SVGA3D_SetViewport(struct svga_winsys_context
*swc
,
1078 SVGA3dRect
*rect
) // IN
1080 SVGA3dCmdSetViewport
*cmd
;
1082 cmd
= SVGA3D_FIFOReserve(swc
,
1083 SVGA_3D_CMD_SETVIEWPORT
, sizeof *cmd
,
1086 return PIPE_ERROR_OUT_OF_MEMORY
;
1088 cmd
->cid
= swc
->cid
;
1099 *----------------------------------------------------------------------
1101 * SVGA3D_SetScissorRect --
1103 * Set the current context's scissor rectangle. If scissor
1104 * is enabled then all rendering is clipped to the scissor.
1112 *----------------------------------------------------------------------
1116 SVGA3D_SetScissorRect(struct svga_winsys_context
*swc
,
1117 SVGA3dRect
*rect
) // IN
1119 SVGA3dCmdSetScissorRect
*cmd
;
1121 cmd
= SVGA3D_FIFOReserve(swc
,
1122 SVGA_3D_CMD_SETSCISSORRECT
, sizeof *cmd
,
1125 return PIPE_ERROR_OUT_OF_MEMORY
;
1127 cmd
->cid
= swc
->cid
;
1135 *----------------------------------------------------------------------
1137 * SVGA3D_SetClipPlane --
1139 * Set one of the current context's clip planes. If the clip
1140 * plane is enabled then all 3d rendering is clipped to against
1149 *----------------------------------------------------------------------
1152 enum pipe_error
SVGA3D_SetClipPlane(struct svga_winsys_context
*swc
,
1153 uint32 index
, const float *plane
)
1155 SVGA3dCmdSetClipPlane
*cmd
;
1157 cmd
= SVGA3D_FIFOReserve(swc
,
1158 SVGA_3D_CMD_SETCLIPPLANE
, sizeof *cmd
,
1161 return PIPE_ERROR_OUT_OF_MEMORY
;
1163 cmd
->cid
= swc
->cid
;
1165 cmd
->plane
[0] = plane
[0];
1166 cmd
->plane
[1] = plane
[1];
1167 cmd
->plane
[2] = plane
[2];
1168 cmd
->plane
[3] = plane
[3];
1175 *----------------------------------------------------------------------
1177 * SVGA3D_SetZRange --
1179 * Set the range of the depth buffer to use. 'min' and 'max'
1180 * are values between 0.0 and 1.0.
1188 *----------------------------------------------------------------------
1192 SVGA3D_SetZRange(struct svga_winsys_context
*swc
,
1196 SVGA3dCmdSetZRange
*cmd
;
1198 cmd
= SVGA3D_FIFOReserve(swc
,
1199 SVGA_3D_CMD_SETZRANGE
, sizeof *cmd
,
1202 return PIPE_ERROR_OUT_OF_MEMORY
;
1204 cmd
->cid
= swc
->cid
;
1205 cmd
->zRange
.min
= zMin
;
1206 cmd
->zRange
.max
= zMax
;
1214 *----------------------------------------------------------------------
1216 * SVGA3D_BeginSetTextureState --
1218 * Begin a SETTEXTURESTATE command. This reserves space for it in
1219 * the FIFO, and returns a pointer to the command's texture state
1220 * array. This function must be paired with SVGA_FIFOCommitAll().
1222 * This command sets rendering state which is per-texture-unit.
1224 * XXX: Individual texture states need documentation. However,
1225 * they are very similar to the texture states defined by
1226 * Direct3D. The D3D documentation is a good starting point
1227 * for understanding SVGA3D texture states.
1235 *----------------------------------------------------------------------
1239 SVGA3D_BeginSetTextureState(struct svga_winsys_context
*swc
,
1240 SVGA3dTextureState
**states
, // OUT
1241 uint32 numStates
) // IN
1243 SVGA3dCmdSetTextureState
*cmd
;
1245 cmd
= SVGA3D_FIFOReserve(swc
,
1246 SVGA_3D_CMD_SETTEXTURESTATE
,
1247 sizeof *cmd
+ sizeof **states
* numStates
,
1250 return PIPE_ERROR_OUT_OF_MEMORY
;
1252 cmd
->cid
= swc
->cid
;
1253 *states
= (SVGA3dTextureState
*) &cmd
[1];
1260 *----------------------------------------------------------------------
1262 * SVGA3D_BeginSetRenderState --
1264 * Begin a SETRENDERSTATE command. This reserves space for it in
1265 * the FIFO, and returns a pointer to the command's texture state
1266 * array. This function must be paired with SVGA_FIFOCommitAll().
1268 * This command sets rendering state which is global to the context.
1270 * XXX: Individual render states need documentation. However,
1271 * they are very similar to the render states defined by
1272 * Direct3D. The D3D documentation is a good starting point
1273 * for understanding SVGA3D render states.
1281 *----------------------------------------------------------------------
1285 SVGA3D_BeginSetRenderState(struct svga_winsys_context
*swc
,
1286 SVGA3dRenderState
**states
, // OUT
1287 uint32 numStates
) // IN
1289 SVGA3dCmdSetRenderState
*cmd
;
1291 cmd
= SVGA3D_FIFOReserve(swc
,
1292 SVGA_3D_CMD_SETRENDERSTATE
,
1293 sizeof *cmd
+ sizeof **states
* numStates
,
1296 return PIPE_ERROR_OUT_OF_MEMORY
;
1298 cmd
->cid
= swc
->cid
;
1299 *states
= (SVGA3dRenderState
*) &cmd
[1];
1306 *----------------------------------------------------------------------
1308 * SVGA3D_BeginQuery--
1310 * Issues a SVGA_3D_CMD_BEGIN_QUERY command.
1316 * Commits space in the FIFO memory.
1318 *----------------------------------------------------------------------
1322 SVGA3D_BeginQuery(struct svga_winsys_context
*swc
,
1323 SVGA3dQueryType type
) // IN
1325 SVGA3dCmdBeginQuery
*cmd
;
1327 cmd
= SVGA3D_FIFOReserve(swc
,
1328 SVGA_3D_CMD_BEGIN_QUERY
,
1332 return PIPE_ERROR_OUT_OF_MEMORY
;
1334 cmd
->cid
= swc
->cid
;
1344 *----------------------------------------------------------------------
1348 * Issues a SVGA_3D_CMD_END_QUERY command.
1354 * Commits space in the FIFO memory.
1356 *----------------------------------------------------------------------
1360 SVGA3D_EndQuery(struct svga_winsys_context
*swc
,
1361 SVGA3dQueryType type
, // IN
1362 struct svga_winsys_buffer
*buffer
) // IN/OUT
1364 SVGA3dCmdEndQuery
*cmd
;
1366 cmd
= SVGA3D_FIFOReserve(swc
,
1367 SVGA_3D_CMD_END_QUERY
,
1371 return PIPE_ERROR_OUT_OF_MEMORY
;
1373 cmd
->cid
= swc
->cid
;
1376 swc
->region_relocation(swc
, &cmd
->guestResult
, buffer
, 0,
1386 *----------------------------------------------------------------------
1388 * SVGA3D_WaitForQuery--
1390 * Issues a SVGA_3D_CMD_WAIT_FOR_QUERY command. This reserves space
1391 * for it in the FIFO. This doesn't actually wait for the query to
1392 * finish but instead tells the host to start a wait at the driver
1393 * level. The caller can wait on the status variable in the
1394 * guestPtr memory or send an insert fence instruction after this
1395 * command and wait on the fence.
1401 * Commits space in the FIFO memory.
1403 *----------------------------------------------------------------------
1407 SVGA3D_WaitForQuery(struct svga_winsys_context
*swc
,
1408 SVGA3dQueryType type
, // IN
1409 struct svga_winsys_buffer
*buffer
) // IN/OUT
1411 SVGA3dCmdWaitForQuery
*cmd
;
1413 cmd
= SVGA3D_FIFOReserve(swc
,
1414 SVGA_3D_CMD_WAIT_FOR_QUERY
,
1418 return PIPE_ERROR_OUT_OF_MEMORY
;
1420 cmd
->cid
= swc
->cid
;
1423 swc
->region_relocation(swc
, &cmd
->guestResult
, buffer
, 0,