DDS_HEADER_DXT10-Struktur

DDS-Headererweiterung zum Verarbeiten von Ressourcenarrays, DXGI-Pixelformaten, die nicht den älteren Microsoft DirectDraw-Pixelformatstrukturen zugeordnet sind, und zusätzliche Metadaten.

Syntax

typedef struct {
  DXGI_FORMAT              dxgiFormat;
  D3D10_RESOURCE_DIMENSION resourceDimension;
  UINT                     miscFlag;
  UINT                     arraySize;
  UINT                     miscFlags2;
} DDS_HEADER_DXT10;

Member

dxgiFormat

Typ: DXGI_FORMAT

Das Surface-Pixelformat (siehe DXGI_FORMAT).

resourceDimension

Typ: D3D10_RESOURCE_DIMENSION

Gibt den Typ der Ressource an. Die folgenden Werte für diesen Member sind eine Teilmenge der Werte in der D3D10_RESOURCE_DIMENSION- oder D3D11_RESOURCE_DIMENSION-Enumeration :

Typ	Beschreibung	Wert
DDS_DIMENSION_TEXTURE1D (D3D10_RESOURCE_DIMENSION_TEXTURE1D)	Ressource ist eine 1D-Textur. Der dwWidth-Member von DDS_HEADER gibt die Größe der Textur an. In der Regel legen Sie den dwHeight-Member von DDS_HEADER auf 1 fest. Sie müssen auch das DDSD_HEIGHT-Flag im dwFlags-Element von DDS_HEADER festlegen.	2
DDS_DIMENSION_TEXTURE2D (D3D10_RESOURCE_DIMENSION_TEXTURE2D)	Ressource ist eine 2D-Textur mit einem Bereich, der durch die Elemente dwWidth und dwHeightvon DDS_HEADER angegeben wird. Sie können diesen Typ auch verwenden, um eine Würfelzuordnungstextur zu identifizieren. Weitere Informationen zum Identifizieren einer Cubezuordnungstextur finden Sie unter miscFlag - und arraySize-Member .	3
DDS_DIMENSION_TEXTURE3D (D3D10_RESOURCE_DIMENSION_TEXTURE3D)	Ressource ist eine 3D-Textur mit einem Volumen, das von den Elementen dwWidth, dwHeight und dwDepthvon DDS_HEADER angegeben wird. Außerdem müssen Sie das flag DDSD_DEPTH im dwFlags-Element von DDS_HEADER festlegen.	4

miscFlag

Typ: UINT

Identifiziert andere, weniger gängige Optionen für Ressourcen. Der folgende Wert für diesen Member ist eine Teilmenge der Werte in der D3D10_RESOURCE_MISC_FLAG- oder D3D11_RESOURCE_MISC_FLAG-Enumeration :

Typ	Beschreibung	Wert
DDS_RESOURCE_MISC_TEXTURECUBE	Gibt an, dass eine 2D-Textur eine Würfelzuordnungstextur ist.	0x4

arraySize

Typ: UINT

Die Anzahl der Elemente im Array.

Bei einer 2D-Textur , die auch eine Würfelzuordnungstextur ist, stellt diese Zahl die Anzahl der Würfel dar. Diese Zahl entspricht der Zahl im NumCubes-Element von D3D10_TEXCUBE_ARRAY_SRV1 oder D3D11_TEXCUBE_ARRAY_SRV). In diesem Fall enthält die DDS-Datei arraySize*6 2D-Texturen. Weitere Informationen zu diesem Fall finden Sie in der MiscFlag-Beschreibung .

Für eine 3D-Textur müssen Sie diese Zahl auf 1 festlegen.

miscFlags2

Typ: UINT

Enthält zusätzliche Metadaten (früher reserviert). Die unteren 3 Bits geben den Alphamodus der zugeordneten Ressource an. Die oberen 29 Bits sind reserviert und in der Regel 0.

Typ	Beschreibung	Wert
DDS_ALPHA_MODE_UNKNOWN	Der Alphakanalinhalt ist unbekannt. Dies ist der Wert für Legacydateien, der in der Regel als "gerades" Alpha angenommen wird.	0x0
DDS_ALPHA_MODE_STRAIGHT	Es wird davon ausgegangen, dass jeder Alphakanalinhalt gerades Alpha verwendet.	0x1
DDS_ALPHA_MODE_PREMULTIPLIED	Jeder Alphakanalinhalt verwendet prämultipliziertes Alpha. Die einzigen älteren Dateiformate, die diese Informationen angeben, sind "DX2" und "DX4".	0x2
DDS_ALPHA_MODE_OPAQUE	Alle Alphakanalinhalte sind auf vollständig undurchsichtig festgelegt.	0x3
DDS_ALPHA_MODE_CUSTOM	Jeder Alphakanalinhalt wird als 4. Kanal verwendet und soll keine Transparenz darstellen (gerade oder vormultipliziert).	0x4

Hinweis

Die Legacybibliotheken D3DX 10 und D3DX 11 können nicht geladen werden. DDS-Datei mit miscFlags2 nicht gleich Null.

Bemerkungen

Verwenden Sie diese Struktur zusammen mit einem DDS_HEADER , um ein Ressourcenarray in einer DDS-Datei zu speichern. Weitere Informationen finden Sie unter Texturarrays.

Dieser Header ist vorhanden, wenn das dwFourCC-Element der DDS_PIXELFORMAT-Struktur auf "DX10" festgelegt ist.

Anforderungen

Anforderung	Wert
Header	Dds.h

Siehe auch

Referenz für DDS