estrutura D3DDDIARG_COMPOSERECTS (d3dumddi.h)
A estrutura D3DDDIARG_COMPOSERECTS descreve os parâmetros usados para compor áreas retangulares.
Sintaxe
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;
Membros
[in] hSrcResource
Um identificador para o recurso de origem que contém a superfície de origem. Quando a superfície é criada, o driver de exibição do modo de usuário recebe o valor D3DDDIFMT_A1 (um bit por pixel) no membro Format e o sinalizador de campo de bit TextApi no membro Flags da estrutura D3DDDIARG_CREATERESOURCE em uma chamada para a função CreateResource do driver. A superfície deve ser criada como parte de uma textura.
[in] SrcSubResourceIndex
O índice para a superfície de origem dentro do recurso de origem.
[in] hDstResource
Um identificador para o recurso de destino que contém a superfície de destino. Quando a superfície é criada, o driver de exibição do modo de usuário recebe o valor de D3DDDIFMT_A1 (um bit por pixel) no membro Format de D3DDDIARG_CREATERESOURCE em uma chamada para CreateResource do driver. A superfície deve ser criada como parte de uma textura. A superfície pode ter sido criada com o sinalizador de campo de bits TextApi .
[in] DstSubResourceIndex
O índice para a superfície de destino dentro do recurso de destino.
[in] hSrcRectDescsVB
Um identificador para um buffer de vértice que contém uma matriz de estruturas D3DCOMPOSERECTSRCDESC. Cada elemento na matriz define um retângulo na superfície de origem. Quando o buffer de vértice é criado, o driver de exibição do modo de usuário recebe o sinalizador de campo de bit TextApi no membro Flags da estrutura D3DDDIARG_CREATERESOURCE em uma chamada para a função CreateResource do driver.
[in] NumRects
O número de áreas retangulares a serem copiadas, que é o número de estruturas D3DCOMPOSERECTDSTDESC no buffer de vértice que é identificado pelo membro hDstRectDescsVB . Os drivers devem ignorar chamadas para ComposeRects com NumRects definidos como maiores que 0xFFFF.
[in] hDstRectDescsVB
Um identificador para um buffer de vértice que contém uma matriz de estruturas D3DCOMPOSERECTDSTDESC. Cada elemento na matriz define onde copiar um retângulo de origem na superfície de destino. Para obter mais informações, consulte a seção Comentários a seguir. Quando o buffer de vértice é criado, o driver de exibição do modo de usuário recebe o sinalizador de campo de bit TextApi no membro Flags da estrutura D3DDDIARG_CREATERESOURCE em uma chamada para a função CreateResource do driver.
[in] Operation
Um valor D3DDDI_COMPOSERECTSOP que descreve como compor as áreas retangulares. Esse membro pode ser um dos valores a seguir.
| Valor | Significado |
|---|---|
| D3DDDICOMPOSERECTS_COPY | Copie cada bit de origem para o destino. |
| D3DDDICOMPOSERECTS_OR | Combine bits de origem e destino em uma operação OR e copie para o destino. |
| D3DDDICOMPOSERECTS_AND | Combine bits de origem e destino em uma operação AND e copie para o destino. |
| D3DDDICOMPOSERECTS_NEG | Combine o negativo dos bits de origem com os bits de destino e copie para o destino. [Dest bit & (~ bit Src)] |
[in] XOffset
Um deslocamento a ser adicionado às coordenadas x de todas as áreas retangulares de destino. O deslocamento pode ser negativo, o que pode fazer com que os retângulos resultantes sejam rejeitados ou recortados.
[in] YOffset
Um deslocamento a ser adicionado às coordenadas y de todas as áreas retangulares de destino. O deslocamento pode ser negativo, o que pode fazer com que os retângulos resultantes sejam rejeitados ou recortados.
Comentários
Os buffers de vértice que contêm as instruções de composição são criados com D3DUSAGE_TEXTAPI uso. O código a seguir define as estruturas contidas nas matrizes de buffer de vértice. Para obter mais informações sobre essas estruturas, consulte a documentação do SDK do 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 | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| Cabeçalho | d3dumddi.h (inclua D3dumddi.h) |