DDS_HEADER_DXT10-Struktur

  • Artikel

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