énumération D3D12_TEXTURE_LAYOUT (d3d12.h)

Article
08/23/2023

Spécifie les options de disposition de texture.

Syntax

typedef enum D3D12_TEXTURE_LAYOUT {
  D3D12_TEXTURE_LAYOUT_UNKNOWN = 0,
  D3D12_TEXTURE_LAYOUT_ROW_MAJOR = 1,
  D3D12_TEXTURE_LAYOUT_64KB_UNDEFINED_SWIZZLE = 2,
  D3D12_TEXTURE_LAYOUT_64KB_STANDARD_SWIZZLE = 3
} ;

Constantes


`D3D12_TEXTURE_LAYOUT_UNKNOWN` Valeur : 0 Indique que la disposition est inconnue et qu’elle dépend probablement de l’adaptateur. Lors de la création, le pilote choisit la disposition la plus efficace en fonction d’autres propriétés de ressource, en particulier la taille des ressources et les indicateurs. Préférez ce choix, sauf si certaines fonctionnalités sont requises à partir d’une autre disposition de texture. Il existe des optimisations de chargement de textures de copie zéro pour les architectures UMA ; consultez ID3D12Resource ::WriteToSubresource.
`D3D12_TEXTURE_LAYOUT_ROW_MAJOR` Valeur : 1 Indique que les données de la texture sont stockées dans l’ordre principal des lignes (parfois appelé « ordre linéaire de tangage »). Cette disposition de texture localise les texels consécutifs d’une ligne contiguëment en mémoire, avant les texels de la ligne suivante. De même, les texels consécutifs d’une profondeur ou d’une tranche de tableau particulière sont contigus en mémoire avant les texels de la profondeur ou de la tranche de tableau suivante. Un remplissage peut exister entre les lignes et entre les tranches de profondeur ou de tableau pour aligner les collections de données. Une foulée est la distance en mémoire entre les lignes, la profondeur ou les tranches de tableau ; et il inclut n’importe quel remplissage. Cette disposition de texture permet de partager les données de texture entre plusieurs adaptateurs, lorsque d’autres dispositions ne sont pas disponibles. De nombreuses restrictions s’appliquent, car cette disposition n’est généralement pas efficace pour une utilisation intensive : La localité des texels à proximité n’est pas invariante. Seules les propriétés de texture suivantes sont prises en charge : D3D12_RESOURCE_DIMENSION_TEXTURE_2D. Niveau mip unique. Une seule tranche de tableau. Alignement de 64 Ko. Non-MSAA. Aucune D3D12_RESOURCE_FLAG_ALLOW_DEPTH_STENCIL. Le format ne peut pas être un format YUV. La texture doit être créée sur un tas avec D3D12_HEAP_FLAG_SHARED_CROSS_ADAPTER. Les mémoires tampons sont créées avec D3D12_TEXTURE_LAYOUT_ROW_MAJOR, car les données de texture principale de ligne peuvent y être localisées sans créer d’objet de texture. Il est couramment utilisé pour charger ou lire des données de texture, en particulier pour les adaptateurs discrets/NUMA. Toutefois, D3D12_TEXTURE_LAYOUT_ROW_MAJOR peut également être utilisé lors du marshaling de données de texture entre des GPU ou des adaptateurs. Pour obtenir des exemples d’utilisation avec ID3D12GraphicsCommandList ::CopyTextureRegion, consultez certaines des rubriques suivantes : Mappage de textures par défaut et Swizzle standard Prédicat Synchronisation multi-moteur Chargement de données de texture
`D3D12_TEXTURE_LAYOUT_64KB_UNDEFINED_SWIZZLE` Valeur : 2 Indique que la disposition dans les vignettes de 64 Ko et l’empaquetage de la queue est à la charge du pilote. Aucun modèle swizzle standard. Cette disposition de texture est organisée en régions contiguës de 64 Ko, également appelées vignettes, contenant une quantité quasi équilatérale d’un nombre consécutif de texels le long de chaque dimension. Les vignettes sont organisées dans l’ordre principal des lignes. Bien qu’il n’y ait pas de remplissage entre les vignettes, il existe généralement des texels inutilisés dans la dernière vignette de chaque dimension. La disposition des texels dans la vignette n’est pas définie. Chaque sous-ressource suit immédiatement l’emplacement où se termine la sous-ressource précédente, et l’ordre de sous-ressource suit la même séquence que les ordinaux de sous-ressource. Toutefois, l’empaquetage de la queue est spécifique à l’adaptateur. Pour plus d’informations, consultez Niveau de ressource en mosaïque et ID3D12Device ::GetResourceTiling. Cette disposition de texture permet des scénarios de texture partiellement résidents ou partiellement épars lorsqu’ils sont utilisés avec la fonctionnalité de mappage de page de mémoire virtuelle. Cette disposition de texture doit être utilisée avec ID3D12Device ::CreateReservedResource pour permettre l’utilisation de ID3D12CommandQueue ::UpdateTileMappings. Certaines restrictions s’appliquent aux textures avec cette disposition : L’adaptateur doit prendre en charge D3D12_TILED_RESOURCES_TIER 1 ou supérieur. Un alignement de 64 Ko doit être utilisé. D3D12_RESOURCE_DIMENSION_TEXTURE1D n’est pas pris en charge, pas plus que tous les formats. Le niveau de ressource en mosaïque indique si les textures avec D3D12_RESOURCE_DIMENSION_TEXTURE3D sont prises en charge.
`D3D12_TEXTURE_LAYOUT_64KB_STANDARD_SWIZZLE` Valeur : 3 Indique qu’une texture par défaut utilise le modèle swizzle standardisé. Cette disposition de texture est organisée de la même façon que D3D12_TEXTURE_LAYOUT_64KB_UNDEFINED_SWIZZLE, sauf que la disposition des texels dans la vignette est définie. L’empaquetage de la queue mip est spécifique à l’adaptateur. Cette disposition de texture permet d’optimiser le marshaling des données entre plusieurs adaptateurs ou entre le processeur et le GPU. La quantité de copie peut être réduite lorsque plusieurs composants comprennent la disposition de la mémoire de texture. Cette disposition est généralement plus efficace pour une utilisation intensive que la disposition de ligne principale, en raison de la localité invariante de rotation des texels voisins. Cette disposition ne peut généralement être utilisée qu’avec des adaptateurs qui prennent en charge swizzle standard, mais des exceptions existent pour les tas partagés entre adaptateurs. Les restrictions pour cette disposition sont que les éléments suivants ne sont pas pris en charge : D3D12_RESOURCE_DIMENSION_TEXTURE1D Multi-sample anti-aliasing (MSAA) D3D12_RESOURCE_FLAG_ALLOW_DEPTH_STENCIL Formats au sein du groupe DXGI_FORMAT_R32G32B32_TYPELESS

Remarques

Cette énumération est utilisée par la structure D3D12_RESOURCE_DESC .

Cette énumération contrôle le modèle swizzle des textures par défaut et active la prise en charge de la carte sur les textures par défaut. Les appelants doivent interroger D3D12_FEATURE_DATA_D3D12_OPTIONS pour s’assurer que chaque option est prise en charge.

Les formats swizzle standard s’appliquent à chaque bloc de taille de page, et les pages sont disposées dans un ordre linéaire les unes par rapport aux autres. Un modèle entrelacé 16 bits définit la conversion de l’emplacement intrapage pré-swizzled vers l’emplacement post-swizzled.

Pour illustrer, considérez le format swizzle 2D 32bpp ci-dessus. Cela est représenté par les masques entrelacés suivants, où les bits à gauche sont les plus significatifs :

UINT xBytesMask = 1010 1010 1000 1111
UINT yMask =      0101 0101 0111 0000

Pour calculer l’adresse swizzled, le code suivant peut être utilisé (où l’instruction intrinsèque _pdep_u32 est prise en charge) :

UINT swizzledOffset = resourceBaseOffset +
                      _pdep_u32(xOffset, xBytesMask) +
                      _pdep_u32(yOffset, yBytesMask);

Configuration requise

Condition requise	Valeur
En-tête	d3d12.h

Voir aussi

CD3DX12_RESOURCE_DESC

Énumérations principales

Optimisations UMA : Textures accessibles au processeur et Swizzle standard

Partager via