D3DFORMAT

Definiert die verschiedenen Arten von Oberflächenformaten.

typedef enum _D3DFORMAT {
    D3DFMT_UNKNOWN              =  0,

    D3DFMT_R8G8B8               = 20,
    D3DFMT_A8R8G8B8             = 21,
    D3DFMT_X8R8G8B8             = 22,
    D3DFMT_R5G6B5               = 23,
    D3DFMT_X1R5G5B5             = 24,
    D3DFMT_A1R5G5B5             = 25,
    D3DFMT_A4R4G4B4             = 26,
    D3DFMT_R3G3B2               = 27,
    D3DFMT_A8                   = 28,
    D3DFMT_A8R3G3B2             = 29,
    D3DFMT_X4R4G4B4             = 30,
    D3DFMT_A2B10G10R10          = 31,
    D3DFMT_A8B8G8R8             = 32,
    D3DFMT_X8B8G8R8             = 33,
    D3DFMT_G16R16               = 34,
    D3DFMT_A2R10G10B10          = 35,
    D3DFMT_A16B16G16R16         = 36,

    D3DFMT_A8P8                 = 40,
    D3DFMT_P8                   = 41,

    D3DFMT_L8                   = 50,
    D3DFMT_A8L8                 = 51,
    D3DFMT_A4L4                 = 52,

    D3DFMT_V8U8                 = 60,
    D3DFMT_L6V5U5               = 61,
    D3DFMT_X8L8V8U8             = 62,
    D3DFMT_Q8W8V8U8             = 63,
    D3DFMT_V16U16               = 64,
    D3DFMT_A2W10V10U10          = 67,

    D3DFMT_UYVY                 = MAKEFOURCC('U', 'Y', 'V', 'Y'),
    D3DFMT_R8G8_B8G8            = MAKEFOURCC('R', 'G', 'B', 'G'),
    D3DFMT_YUY2                 = MAKEFOURCC('Y', 'U', 'Y', '2'),
    D3DFMT_G8R8_G8B8            = MAKEFOURCC('G', 'R', 'G', 'B'),
    D3DFMT_DXT1                 = MAKEFOURCC('D', 'X', 'T', '1'),
    D3DFMT_DXT2                 = MAKEFOURCC('D', 'X', 'T', '2'),
    D3DFMT_DXT3                 = MAKEFOURCC('D', 'X', 'T', '3'),
    D3DFMT_DXT4                 = MAKEFOURCC('D', 'X', 'T', '4'),
    D3DFMT_DXT5                 = MAKEFOURCC('D', 'X', 'T', '5'),

    D3DFMT_D16_LOCKABLE         = 70,
    D3DFMT_D32                  = 71,
    D3DFMT_D15S1                = 73,
    D3DFMT_D24S8                = 75,
    D3DFMT_D24X8                = 77,
    D3DFMT_D24X4S4              = 79,
    D3DFMT_D16                  = 80,

    D3DFMT_D32F_LOCKABLE        = 82,
    D3DFMT_D24FS8               = 83,

#if !defined(D3D_DISABLE_9EX)
    D3DFMT_D32_LOCKABLE         = 84,
    D3DFMT_S8_LOCKABLE          = 85,
#endif // !D3D_DISABLE_9EX

    D3DFMT_L16                  = 81,

    D3DFMT_VERTEXDATA           =100,
    D3DFMT_INDEX16              =101,
    D3DFMT_INDEX32              =102,

    D3DFMT_Q16W16V16U16         =110,

    D3DFMT_MULTI2_ARGB8         = MAKEFOURCC('M','E','T','1'),

    D3DFMT_R16F                 = 111,
    D3DFMT_G16R16F              = 112,
    D3DFMT_A16B16G16R16F        = 113,

    D3DFMT_R32F                 = 114,
    D3DFMT_G32R32F              = 115,
    D3DFMT_A32B32G32R32F        = 116,

    D3DFMT_CxV8U8               = 117,

#if !defined(D3D_DISABLE_9EX)
    D3DFMT_A1                   = 118,
    D3DFMT_A2B10G10R10_XR_BIAS  = 119,
    D3DFMT_BINARYBUFFER         = 199,
#endif // !D3D_DISABLE_9EX

    D3DFMT_FORCE_DWORD          =0x7fffffff
} D3DFORMAT;

Bemerkungen

Es gibt mehrere Arten von Formaten:

• BackBuffer- oder Anzeigeformate
• Pufferformate
• DXTn-Formate für komprimierte Texturen
• Gleitkommaformate
• FOURCC-Formate
• IEEE-Formate
• Gemischte Formate
• Signierte Formate
• Formate ohne Vorzeichen
• Andere

Alle Formate werden von links nach rechts aufgelistet, wobei das relevanteste Bit bis zum kleinsten Bit angezeigt wird. Beispielsweise wird D3DFORMAT_ARGB vom wichtigsten Bitkanal A (Alpha) bis zum geringstmöglichen Bitkanal B (blau) sortiert. Bei der Durchquerung von Oberflächendaten werden die Daten im Arbeitsspeicher vom geringsten bis zum bedeutendsten Bit gespeichert. Dies bedeutet, dass die Kanalreihenfolge im Arbeitsspeicher vom geringstmöglichen Bit (blau) zum bedeutendsten Bit (Alpha) reicht.

Der Standardwert für Formate, die nicht definierte Kanäle enthalten (G16R16, A8 usw.) ist 1. Die einzige Ausnahme ist das A8-Format, das für die drei Farbkanäle mit 000 initialisiert wird.

Die Reihenfolge der Bits geht zuerst vom bedeutendsten Byte aus, sodass D3DFMT_A8L8 angibt, dass das hohe Byte dieses 2-Byte-Formats Alpha ist. D3DFMT_D16 gibt einen 16-Bit-Ganzzahlwert und eine für die Anwendung gesperrte Oberfläche an.

Pixelformate wurden ausgewählt, um den Ausdruck von vom Hardwarehersteller definierten Erweiterungsformaten zu ermöglichen und die bewährte FOURCC-Methode einzuschließen. Der Satz von Formaten, die von der Direct3D-Runtime verstanden werden, wird von D3DFORMAT definiert.

Beachten Sie, dass Formate von unabhängigen Hardwareherstellern (IHVs) bereitgestellt werden und viele FOURCC-Codes nicht aufgeführt sind. Die Formate in dieser Enumeration sind insofern eindeutig, als sie von der Runtime sanktioniert werden, was bedeutet, dass der Verweisraster für alle diese Typen verwendet wird. IHV-bereitgestellte Formate werden von den einzelnen IHVs Karte-by-Karte-Basis unterstützt.

BackBuffer- oder Anzeigeformate

Diese Formate sind die einzigen gültigen Formate für einen Hintergrundpuffer oder eine Anzeige.

Pufferformate

Tiefen-, Schablonen-, Scheitelpunkt- und Indexpuffer weisen jeweils eindeutige Formate auf.

Alle Tiefenschablonenformate mit Ausnahme von D3DFMT_D16_LOCKABLE geben keine bestimmte Bitreihenfolge pro Pixel an, und der Treiber darf mehr als die angegebene Anzahl von Bits pro Tiefenkanal nutzen (aber nicht schablonenkanal).

DXTn-Formate für komprimierte Texturen

Diese Flags werden für komprimierte Texturen verwendet:

Die Runtime erlaubt es einer Anwendung nicht, eine Oberfläche mit einem DXTn-Format zu erstellen, es sei denn, die Oberflächendimensionen sind Vielfaches von 4. Dies gilt für offscreen-einfache Oberflächen, Renderziele, 2D-Texturen, Cubetexturen und Volumentexturen.

Floating-Point Formate

Diese Flags werden für Gleitkommaflächenformate verwendet. Diese 16-Bits-pro-Kanal-Formate werden auch als s10e5-Formate bezeichnet.

FOURCC-Formate

Daten in einem FOURCC-Format sind komprimierte Daten.

MAKEFOURCC

Es folgt ein Makro zum Generieren von Vierzeichencodes:

#define MAKEFOURCC(ch0, ch1, ch2, ch3)                              \
                ((DWORD)(BYTE)(ch0) | ((DWORD)(BYTE)(ch1) << 8) |   \
                ((DWORD)(BYTE)(ch2) << 16) | ((DWORD)(BYTE)(ch3) << 24 ))

Hier sind die definierten FOURCC-Formate:

IEEE-Formate

Diese Flags werden für Gleitkommaflächenformate verwendet. Diese 32-Bits-pro-Kanal-Formate werden auch als s23e8-Formate bezeichnet.

Gemischte Formate

Daten in gemischten Formaten können eine Kombination aus unsignierten Daten und signierten Daten enthalten.

Signierte Formate

Daten in einem signierten Format können sowohl positiv als auch negativ sein. Signierte Formate verwenden Kombinationen von Daten (U), (V), (W) und (Q).

Nicht signierte Formate

Daten in einem format ohne Vorzeichen müssen positiv sein. Nicht signierte Formate verwenden Kombinationen von Daten (R)ed, (G)reen, (B)lue, (A)lpha, (L)uminance und (P)alette. Palettendaten werden auch als farbindizierte Daten bezeichnet, da die Daten zum Indizieren einer Farbpalette verwendet werden.

Sonstiges

Dieses Flag wird für nicht definierte Formate verwendet.

Anforderungen

Siehe auch

Direct3D-Enumerationen