Fonction SampleLevel::SampleLevel(S,float,float,int,uint) pour Texture2DArray

Échantillonne une texture au niveau mipmap spécifié et retourne status sur l’opération.

Syntaxe

DXGI_FORMAT SampleLevel(
  in  SamplerState S,
  in  float        Location,
  in  float        LOD,
  in  int          Offset,
  out uint         Status
);

Paramètres

S [in]

Type : SamplerState

État de l’échantillonneur. Il s’agit d’un objet déclaré dans un fichier d’effet qui contient des affectations d’état.

Emplacement [in]

Type : float

Coordonnées de texture. Le type d’argument dépend du type d’objet de texture.

Texture-Object Type	Type de paramètre
Texture1D	float
Texture1DArray, Texture2D	float2
Texture2DArray, Texture3D, TextureCube	float3
TextureCubeArray	float4

 

LOD [in]

Type : float

[in] Nombre qui spécifie le niveau mipmap. Si la valeur est ≤ 0, mipmap niveau 0 (plus grande carte) est utilisé. La valeur fractionnaire (si elle est fournie) est utilisée pour interpoler entre deux niveaux mipmap.

Offset [in]

Type : int

Décalage de coordonnées de texture facultatif, qui peut être utilisé pour n’importe quel type d’objet de texture ; le décalage est appliqué à l’emplacement avant l’échantillonnage. Utiliser un décalage uniquement à un miplevel entier ; sinon, vous risquez d’obtenir des résultats qui ne se traduisent pas correctement en matériel. Le type d’argument dépend du type d’objet de texture. Pour plus d’informations, consultez Application de décalages d’entiers.

Texture-Object Type	Type de paramètre
Texture1D, Texture1DArray	int
Texture2D, Texture2DArray	int2
Texture3D	int3
TextureCube, TextureCubeArray	non pris en charge

 

État [out]

Type : uint

L’état de l’opération. Vous ne pouvez pas accéder directement à l’status ; au lieu de cela, transmettez le status à la fonction intrinsèque CheckAccessFullyMapped. CheckAccessFullyMapped retourne TRUE si toutes les valeurs de l’opération Sample, Gather ou Load correspondante ont accédé à des vignettes mappées dans une ressource en mosaïque. Si des valeurs ont été extraites d’une vignette non mappée, CheckAccessFullyMapped renvoie FALSE.

Valeur retournée

Type : DXGI_FORMAT

Format de texture, qui est l’une des valeurs typées répertoriées dans DXGI_FORMAT.

Voir aussi

Méthodes SampleLevel

Texture2DArray