DDS_HEADER_DXT10 struttura

  • Articolo

Estensione dell'intestazione DDS per gestire le matrici di risorse, formati pixel DXGI che non vengono mappati alle strutture di formato pixel di Microsoft DirectDraw legacy e metadati aggiuntivi.

Sintassi

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

Members

dxgiFormat

Tipo: DXGI_FORMAT

Formato pixel di superficie (vedere DXGI_FORMAT).

resourceDimension

Tipo: D3D10_RESOURCE_DIMENSION

Identifica il tipo di risorsa. I valori seguenti per questo membro sono un subset dei valori nell'enumerazione D3D10_RESOURCE_DIMENSION o D3D11_RESOURCE_DIMENSION :

Tipo Descrizione Valore
DDS_DIMENSION_TEXTURE1D (D3D10_RESOURCE_DIMENSION_TEXTURE1D) La risorsa è una trama 1D. Il membro dwWidth di DDS_HEADER specifica le dimensioni della trama. In genere, si imposta il membro dwHeight di DDS_HEADER su 1; è anche necessario impostare il flag di DDSD_HEIGHT nel membro dwFlags di DDS_HEADER. 2
DDS_DIMENSION_TEXTURE2D (D3D10_RESOURCE_DIMENSION_TEXTURE2D) La risorsa è una trama 2D con un'area specificata dai membri dwWidth e dwHeight di DDS_HEADER. È anche possibile usare questo tipo per identificare una trama mappa cubo. Per altre informazioni su come identificare una trama mappa cubo, vedere membri miscFlag e arraySize . 3
DDS_DIMENSION_TEXTURE3D (D3D10_RESOURCE_DIMENSION_TEXTURE3D) La risorsa è una trama 3D con un volume specificato dai membri dwWidth, dwHeight e dwDepth di DDS_HEADER. È anche necessario impostare il flag di DDSD_DEPTH nel membro dwFlags di DDS_HEADER. 4

miscFlag

Tipo: UINT

Identifica altre opzioni meno comuni per le risorse. Il valore seguente per questo membro è un subset dei valori nell'enumerazione D3D10_RESOURCE_MISC_FLAG o D3D11_RESOURCE_MISC_FLAG :

Tipo Descrizione Valore
DDS_RESOURCE_MISC_TEXTURECUBE Indica che una trama 2D è una trama mappa cubo. 0x4

arraySize

Tipo: UINT

Numero di elementi nella matrice.

Per una trama 2D che è anche una trama mappa cubo, questo numero rappresenta il numero di cubi. Questo numero è lo stesso del numero nel membro NumCubes di D3D10_TEXCUBE_ARRAY_SRV1 o D3D11_TEXCUBE_ARRAY_SRV. In questo caso, il file DDS contiene trame arraySize*6 2D. Per altre informazioni su questo caso, vedere la descrizione del miscFlag .

Per una trama 3D, è necessario impostare questo numero su 1.

miscFlags2

Tipo: UINT

Contiene metadati aggiuntivi (in precedenza era riservato). I 3 bit inferiori indicano la modalità alfa della risorsa associata. I 29 bit superiori sono riservati e sono in genere 0.

Tipo Descrizione Valore
DDS_ALPHA_MODE_UNKNOWN Il contenuto del canale alfa è sconosciuto. Questo è il valore per i file legacy, che in genere si presuppone essere "dritto". 0x0
DDS_ALPHA_MODE_STRAIGHT Qualsiasi contenuto del canale alfa è presunto usare alfa dritto. 0x1
DDS_ALPHA_MODE_PREMULTIPLIED Qualsiasi contenuto del canale alfa usa alfa premultiplied alfa. Gli unici formati di file legacy che indicano queste informazioni sono "DX2" e "DX4". 0x2
DDS_ALPHA_MODE_OPAQUE Qualsiasi contenuto del canale alfa è tutto impostato su completamente opaco. 0x3
DDS_ALPHA_MODE_CUSTOM Qualsiasi contenuto del canale alfa viene usato come 4° canale e non è destinato a rappresentare la trasparenza (direttamente o premultiplied). 0x4

Nota

Le librerie di utilità D3DX 10 e D3DX 11 legacy non riusciranno a caricare qualsiasi . File DDS con miscFlags2 non uguale a zero.

Commenti

Usare questa struttura insieme a un DDS_HEADER per archiviare una matrice di risorse in un file DDS. Per altre informazioni, vedere matrici di trame.

Questa intestazione è presente se il membro dwFourCC della struttura DDS_PIXELFORMAT è impostato su "DX10".

Requisiti

Requisito Valore
Intestazione
Dds.h

Vedi anche

Riferimento per DDS