Structure DDPIXELFORMAT (ksmedia.h)
La structure DDPIXELFORMAT décrit le format de pixel d’un objet DirectDrawSurface .
Syntaxe
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;
Membres
dwSize
Spécifie la taille en octets de la structure DDPIXELFORMAT. Le pilote doit initialiser ce membre avant d’utiliser la structure.
DirectX 9.0 et versions ultérieures uniquement. Spécifie, lors de l’entrée, la version du runtime Microsoft DirectX utilisé par l’application. Ce membre est défini sur DD_RUNTIME_VERSION, ce qui est 0x00000900 pour DirectX 9.0, au format membre de la structure DD_GETFORMATDATA pour une requête D3DGDI2_TYPE_GETFORMAT.
dwFlags
Indique un ensemble d’indicateurs qui spécifient des indicateurs de contrôle facultatifs. Ce membre est un or au niveau du bit de l’une des valeurs suivantes :
| Indicateur | Signification |
|---|---|
| DDPF_ALPHA | Le format de pixels décrit une surface alpha uniquement. |
| DDPF_ALPHAPIXELS | La surface contient des informations de canal alpha au format pixel. |
| DDPF_ALPHAPREMULT | Les composants de couleur dans le pixel sont prémultipliés par la valeur alpha dans le pixel. Si cet indicateur est défini, l’indicateur DDPF_ALPHAPIXELS doit également être défini. Si cet indicateur n’est pas défini, mais que l’indicateur DDPF_ALPHAPIXELS est défini, les composants de couleur au format pixel ne sont pas prémultipliés par alpha. Dans ce cas, les composants de couleur doivent être multipliés par la valeur alpha au moment où une opération de fusion alpha est effectuée. |
| DDPF_BUMPDUDV | Les données dUdV du mappage de bosses au format de pixels sont valides. |
| DDPF_BUMPHEIGHT | Les données de hauteur de la carte de bosses au format de pixels sont valides. |
| DDPF_COMPRESSED | La surface accepte les données de pixels au format spécifié et les compresse pendant l’opération d’écriture. |
| DDPF_D3DFORMAT | Indique une entrée de capacité de format DirectX 8.0 et versions ultérieures dans la liste des formats de texture. Cet indicateur n’est pas exposé aux applications. |
| DDPF_FOURCC | Le code FOURCC est valide. |
| DDPF_LUMINANCE | Les données de luminance au format pixel sont valides. Utilisez cet indicateur pour les surfaces luminance-only ou luminance-plus-alpha ; la profondeur de bits est ensuite spécifiée dans le membre dwLuminanceBitCount . |
| DDPF_LUMINANCEPIXELS | Les données de luminance au format pixel sont valides. Utilisez cet indicateur lors de la suspension de la luminance, par exemple des surfaces de bumpmap. Le masque de bits pour la partie luminance du pixel est ensuite spécifié dans le membre dwBumpLuminanceBitMask . |
| DDPF_NOVEL_TEXTURE_FORMAT | Indique un nouveau format de surface que le runtime peut ne pas exposer à toutes les applications. |
| DDPF_PALETTEINDEXED1 | La surface est indexée en couleur 1 bits. |
| DDPF_PALETTEINDEXED2 | La surface est indexée en couleur 2 bits. |
| DDPF_PALETTEINDEXED4 | La surface est indexée en couleur 4 bits. |
| DDPF_PALETTEINDEXED8 | La surface est indexée en couleur 8 bits. |
| DDPF_PALETTEINDEXEDTO8 | La surface est une couleur 1, 2 ou 4 bits indexée dans une palette 8 bits. |
| DDPF_RGB | Les données RVB dans la structure de format de pixels sont valides. |
| DDPF_RGBTOYUV | La surface accepte les données RVB et les traduit pendant l’opération d’écriture en données YUV. Le format des données à écrire est contenu dans la structure de format de pixels. L’indicateur DDPF_RGB est défini. |
| DDPF_STENCILBUFFER | La surface encode les informations de gabarit et de profondeur dans chaque pixel de la mémoire tampon z. |
| DDPF_YUV | Les données YUV dans la structure de format pixel sont valides. |
| DDPF_ZBUFFER | Le format de pixels décrit une surface z-buffer-only. |
| DDPF_ZPIXELS | La surface est au format RVBZ. |
dwFourCC
Spécifie un code de format surface incluant l’un des codes du type énuméré D3DFORMAT. Certains codes FOURCC font partie de D3DFORMAT. Pour plus d’informations sur D3DFORMAT, consultez la documentation du Kit de développement logiciel (SDK). Les fournisseurs de matériel peuvent également définir et fournir des codes de format spécifiques à leur matériel.
dwRGBBitCount
Spécifie le nombre de bits RVB par pixel (4, 8, 16, 24 ou 32).
dwYUVBitCount
Spécifie le nombre de bits YUV par pixel.
dwZBufferBitDepth
Spécifie la profondeur de bits de mémoire tampon Z (8, 16, 24 ou 32 bits).
dwAlphaBitDepth
Spécifie la profondeur de bits du canal Alpha.
dwRBitMask
Spécifie le masque pour les bits rouges.
dwYBitMask
Spécifie le masque pour les bits Y.
dwGBitMask
Spécifie le masque pour les bits verts.
dwUBitMask
Spécifie le masque pour les bits U.
dwBBitMask
Spécifie le masque pour les bits bleus.
dwVBitMask
Spécifie le masque pour les bits V.
dwRGBAlphaBitMask
Masque pour le canal alpha.
dwYUVAlphaBitMask
Masque pour le canal alpha.
dwRGBZBitMask
Masque pour le canal Z.
dwYUVZBitMask
Masque pour le canal Z.
Remarques
Le runtime DirectX 8.0 et ultérieur impose les règles suivantes à la liste des opérations (op) :
Un seul endian-ness (grand ou petit) pour n’importe quel format DS est autorisé, par exemple D15S1 ou S1D15, non indépendant des autres bits.
Une liste ne doit inclure D3DFORMAT_OP_DISPLAYMODE que pour un format 16bpp (par exemple, elle ne doit pas énumérer 5 :5 :5 et 5 :6 :5).
Une liste ne doit pas contenir de formats alpha avec D3DFORMAT_OP_DISPLAYMODE ou D3DFORMAT_OP_3DACCELLERATION défini.
L’indicateur D3DFORMAT_OP_3DACCELLERATION ne peut être défini que lorsque l’indicateur D3DFORMAT_OP_DISPLAYMODE est également défini.
Si le pilote prend en charge un D16 verrouillable, il doit signaler D3DFMT_D16_LOCKABLE dans la liste des opérations ; sinon, il devrait signaler D3DFMT_D16.
Les pilotes prenant en charge le multiéchantillonnage doivent remplir les MultiSampleCaps dans les formats profondeur/gabarit pour lesquels le multi-échantillonnage peut être pris en charge. Cela permet au runtime de détecter si un pilote prend en charge le multi-échantillonnage pour les combinaisons de formats cible de rendu et de mémoire tampon Z. Pour plus d’informations sur les restrictions liées à l’échantillonnage multiéchantillonnage étendu, consultez la description de D3DPRASTERCAPS_STRETCHBLTMULTISAMPLE limite dans les rastercaps contenues dans la structure D3DCAPS8 dans la documentation du Kit de développement logiciel (SDK).
Le type énuméré D3DMULTISAMPLE_TYPE défini dans d3d8types.h est utilisé lors de la définition des bits dans wFlipMSTypes et wBltMSTypes. Pour spécifier la prise en charge d’un nombre spécifique d’exemples par pixel, il suffit de déplacer logiquement 1 en fonction de la valeur appropriée à partir de l’D3DMULTISAMPLE_TYPE le type énuméré moins 1 et OR ceci dans le champ approprié (wFlipMSTypes et wBltMSTypes).
Par exemple, si le pilote prend en charge deux et quatre exemples par pixel lors du basculement (mode plein écran) et quatre exemples par pixel lors de la fente (mode fenêtré) sur X8R8G8B8 surface, l’entrée suivante est signalée dans la liste des formats de surface.
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));
Il n’est pas nécessaire de spécifier 1 << (D3DMULTISAMPLE_NONE - 1) lors des formats de création de rapports. Il est supposé que n’importe quel format signalé peut également être utilisé sans multi-échantillonnage. Si le matériel prend en charge le rendu multi-échantillon avec une mémoire tampon z, les formats z-buffer signalés doivent également inclure les exemples pris en charge par pixels.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ksmedia.h (include Ddraw.h) |
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour