estructura D3DDDIARG_COMPOSERECTS (d3dumddi.h)
La estructura D3DDDIARG_COMPOSERECTS describe los parámetros que se usan para componer áreas rectangulares.
Sintaxis
typedef struct _D3DDDIARG_COMPOSERECTS {
[in] HANDLE hSrcResource;
[in] UINT SrcSubResourceIndex;
[in] HANDLE hDstResource;
[in] UINT DstSubResourceIndex;
[in] HANDLE hSrcRectDescsVB;
[in] UINT NumRects;
[in] HANDLE hDstRectDescsVB;
[in] D3DDDI_COMPOSERECTSOP Operation;
[in] INT XOffset;
[in] INT YOffset;
} D3DDDIARG_COMPOSERECTS;
Miembros
[in] hSrcResource
Identificador del recurso de origen que contiene la superficie de origen. Cuando se crea la superficie, el controlador de pantalla en modo de usuario recibe el valor de D3DDDIFMT_A1 (un bit por píxel) en el miembro Format y la marca de campo de bits TextApi en el miembro Flags de la estructura D3DDDIARG_CREATERESOURCE en una llamada a la función CreateResource del controlador. La superficie debe crearse como parte de una textura.
[in] SrcSubResourceIndex
Índice de la superficie de origen dentro del recurso de origen.
[in] hDstResource
Identificador del recurso de destino que contiene la superficie de destino. Cuando se crea la superficie, el controlador de pantalla en modo de usuario recibe el valor de D3DDDIFMT_A1 (un bit por píxel) en el miembro Format de D3DDDIARG_CREATERESOURCE en una llamada al createResource del controlador. La superficie debe crearse como parte de una textura. Es posible que la superficie se haya creado con la marca de campo de bits TextApi .
[in] DstSubResourceIndex
Índice de la superficie de destino dentro del recurso de destino.
[in] hSrcRectDescsVB
Identificador de un búfer de vértices que contiene una matriz de estructuras de D3DCOMPOSERECTSRCDESC. Cada elemento de la matriz define un rectángulo en la superficie de origen. Cuando se crea el búfer de vértices, el controlador de pantalla en modo de usuario recibe la marca de campo de bits TextApi en el miembro Flags de la estructura D3DDDIARG_CREATERESOURCE en una llamada a la función CreateResource del controlador.
[in] NumRects
Número de áreas rectangulares que se van a copiar, que es el número de estructuras de D3DCOMPOSERECTDSTDESC en el búfer de vértices identificado por el miembro hDstRectDescsVB . Los controladores deben omitir las llamadas a ComposeRects con NumRects establecido en mayor que 0xFFFF.
[in] hDstRectDescsVB
Identificador de un búfer de vértices que contiene una matriz de estructuras de D3DCOMPOSERECTDSTDESC. Cada elemento de la matriz define dónde copiar un rectángulo de origen en la superficie de destino. Para obtener más información, vea la sección Comentarios que se muestra más adelante. Cuando se crea el búfer de vértices, el controlador de pantalla en modo de usuario recibe la marca de campo de bits TextApi en el miembro Flags de la estructura D3DDDIARG_CREATERESOURCE en una llamada a la función CreateResource del controlador.
[in] Operation
Valor de D3DDDI_COMPOSERECTSOP que describe cómo componer las áreas rectangulares. Este miembro puede ser uno de los siguientes valores.
| Valor | Significado |
|---|---|
| D3DDDICOMPOSERECTS_COPY | Copie cada bit de origen en el destino. |
| D3DDDICOMPOSERECTS_OR | Combine bits de origen y destino en una operación OR y copie en el destino. |
| D3DDDICOMPOSERECTS_AND | Combine bits de origen y destino en una operación AND y copie en el destino. |
| D3DDDICOMPOSERECTS_NEG | Combine el negativo de los bits de origen con los bits de destino y copie en el destino. [Dest bit & (~ Src bit)] |
[in] XOffset
Desplazamiento que se va a agregar a las coordenadas x de todas las áreas rectangulares de destino. El desplazamiento puede ser negativo, lo que puede hacer que los rectángulos resultantes se rechacen o se recorten.
[in] YOffset
Desplazamiento que se va a agregar a las coordenadas y de todas las áreas rectangulares de destino. El desplazamiento puede ser negativo, lo que puede hacer que los rectángulos resultantes se rechacen o se recorten.
Comentarios
Los búferes de vértices que contienen las instrucciones de redacción se crean con D3DUSAGE_TEXTAPI uso. El código siguiente define las estructuras contenidas en las matrices de búfer de vértices. Para obtener más información sobre estas estructuras, consulte la documentación del SDK de DirectX.
struct D3DCOMPOSERECTSRCDESC {
USHORT X, Y; // Coordinates of top-left corner
USHORT width, height; // Width and height of the glyph in bits
};
struct D3DCOMPOSERECTDSTDESC {
USHORT RectDescIndex; // Index of one of the D3DCOMPOSERECTSRCDESC structures in the vertex buffer represented by hSrcRectDescsVB
USHORT reserved; // Use to align the struct and fields to good boundaries
SHORT X, Y; // Position in bits in the destination surface
};
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
| Encabezado | d3dumddi.h (incluya D3dumddi.h) |