Estructura DDPIXELFORMAT (ksmedia.h)

La estructura DDPIXELFORMAT describe el formato de píxel de un objeto DirectDrawSurface .

Sintaxis

typedef struct _DDPIXELFORMAT {
  DWORD dwSize;
  DWORD dwFlags;
  DWORD dwFourCC;
  union {
    DWORD dwRGBBitCount;
    DWORD dwYUVBitCount;
    DWORD dwZBufferBitDepth;
    DWORD dwAlphaBitDepth;
  };
  union {
    DWORD dwRBitMask;
    DWORD dwYBitMask;
  };
  union {
    DWORD dwGBitMask;
    DWORD dwUBitMask;
  };
  union {
    DWORD dwBBitMask;
    DWORD dwVBitMask;
  };
  union {
    DWORD dwRGBAlphaBitMask;
    DWORD dwYUVAlphaBitMask;
    DWORD dwRGBZBitMask;
    DWORD dwYUVZBitMask;
  };
} DDPIXELFORMAT, *LPDDPIXELFORMAT;

Miembros

dwSize

Especifica el tamaño en bytes de la estructura DDPIXELFORMAT. El controlador debe inicializar este miembro antes de usar la estructura.

DirectX 9.0 y versiones posteriores solo. Especifica, en la entrada, la versión del entorno de ejecución de Microsoft DirectX que usa la aplicación. Este miembro se establece en DD_RUNTIME_VERSION, que es 0x00000900 para DirectX 9.0, en el miembro de formato de la estructura de DD_GETFORMATDATA para una consulta de D3DGDI2_TYPE_GETFORMAT.

dwFlags

Indica un conjunto de marcas que especifican marcas de control opcionales. Este miembro es un OR bit a bit de cualquiera de los siguientes valores:

dwFourCC

Especifica un código de formato de superficie que incluye cualquiera de los códigos del tipo enumerado D3DFORMAT. Algunos códigos FOURCC forman parte de D3DFORMAT. Para más información sobre D3DFORMAT, consulte la documentación del SDK. Los proveedores de hardware también pueden definir y proporcionar códigos de formato específicos de su hardware.

dwRGBBitCount

Especifica el número de bits RGB por píxel (4, 8, 16, 24 o 32).

dwYUVBitCount

Especifica el número de bits YUV por píxel.

dwZBufferBitDepth

Especifica la profundidad de bits del búfer Z (8, 16, 24 o 32 bits).

dwAlphaBitDepth

Especifica la profundidad del bit de canal Alfa.

dwRBitMask

Especifica la máscara para bits rojos.

dwYBitMask

Especifica la máscara para bits Y.

dwGBitMask

Especifica la máscara para bits verdes.

dwUBitMask

Especifica la máscara para bits U.

dwBBitMask

Especifica la máscara para bits azules.

dwVBitMask

Especifica la máscara para los bits V.

dwRGBAlphaBitMask

Máscara para el canal alfa.

dwYUVAlphaBitMask

Máscara para el canal alfa.

dwRGBZBitMask

Máscara para el canal Z.

dwYUVZBitMask

Máscara para el canal Z.

Comentarios

El entorno de ejecución de DirectX 8.0 y versiones posteriores impone las siguientes reglas en la lista de operaciones (op):

• Solo se permite una endian-ness (grande o pequeña) para cualquier formato DS, por ejemplo, D15S1 o S1D15, no ambos independientes de otros bits.

• Una lista solo debe incluir D3DFORMAT_OP_DISPLAYMODE para exactamente un formato de 16bpp (por ejemplo, no debe enumerar 5:5:5 y 5:6:5).

• Una lista no debe contener ningún formato alfa con D3DFORMAT_OP_DISPLAYMODE o D3DFORMAT_OP_3DACCELLERATION establecido.

• La marca D3DFORMAT_OP_3DACCELLERATION solo se puede establecer cuando también se establece la marca de D3DFORMAT_OP_DISPLAYMODE.

Si el controlador admite un D16 bloqueable, debe notificar D3DFMT_D16_LOCKABLE en la lista de operaciones; de lo contrario, debe notificar D3DFMT_D16.

Los controladores que admiten el muestreo múltiple deben rellenar MultiSampleCaps en los formatos de galería de símbolos/profundidad para los que se puede admitir el muestreo múltiple. Esto permite que el entorno de ejecución detecte si un controlador admite el muestreo múltiple para combinaciones de formatos de destino de representación y búfer Z. Para obtener más información sobre las restricciones relacionadas con el muestreo múltiple de blt extendido, consulte la descripción de D3DPRASTERCAPS_STRETCHBLTMULTISAMPLE cap en los rástercaps incluidos en la estructura de D3DCAPS8 en la documentación del SDK.

El tipo enumerado D3DMULTISAMPLE_TYPE definido en d3d8types.h se usa al establecer los bits en wFlipMSTypes y wBltMSTypes. Para especificar la compatibilidad con un número específico de muestras por píxel, basta con cambiar lógicamente 1 por el valor adecuado del tipo enumerado D3DMULTISAMPLE_TYPE menor 1 y OR en el campo adecuado (wFlipMSTypes y wBltMSTypes).

Por ejemplo, si el controlador admite dos y cuatro muestras por píxel al voltear (modo de pantalla completa) y cuatro muestras por píxel cuando se bifurque (modo de ventana) en X8R8G8B8 superficie, se notificará la siguiente entrada en la lista de formatos de superficie.

DDPIXELFORMAT ddpf;
ZeroMemory(&ddpf, sizeof(ddpf));
ddpf.dwSize       = sizeof(DDPIXELFORMAT);
ddpf.dwFlags      = DDPF_D3DFORMAT;
ddpf.dwFourCC     = D3DFMT_X8R8G8B8;
ddpf.dwOperations = D3DFORMAT_OP_DISPLAYMODE |
                    D3DFORMAT_OP_3DACCELERATION;
ddpf.MultiSampleCaps.wFlipMSTypes = (1 << (D3DMULTISAMPLE_4_SAMPLES âˆ' 1))
                                  | (1 << (D3DMULTISAMPLE_2_SAMPLES âˆ' 1));
ddpf.MultiSampleCaps.wBltMSTypes = (1 << (D3DMULTISAMPLE_4_SAMPLES âˆ' 1));

No es necesario especificar 1 << (D3DMULTISAMPLE_NONE - 1) al notificar formatos. Se supone que cualquier formato notificado también se puede usar sin muestreo múltiple. Si el hardware admite la representación multimuestra con un búfer z, los formatos de búfer z notificados también deben incluir los ejemplos admitidos por píxeles.

Requisitos