Partager via


SampleCmpLevelZero::SampleCmpLevelZero(S,float,float,int,uint) pour la fonction Texture2DArray

Échantillonne une texture sur mipmap niveau 0 uniquement et compare le résultat à une valeur de comparaison. Retourne status sur l’opération.

Syntaxe

DXGI_FORMAT SampleCmpLevelZero(
  in  SamplerState S,
  in  float        Location,
  in  float        CompareValue,
  in  int          Offset,
  out uint         Status
);

Paramètres

S [in]

Type : SamplerState

État Sampler. Il s’agit d’un objet déclaré dans un fichier d’effet qui contient des attributions d’état.

Emplacement [in]

Type : float

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

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

 

CompareValue [in]

Type : float

Valeur à virgule flottante à utiliser comme valeur de comparaison.

Décalage [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. Utilisez un décalage uniquement à un miplevel entier ; sinon, vous pouvez obtenir des résultats qui ne se traduisent pas bien en matériel. Le type d’argument dépend du type texture-objet. Pour plus d’informations, consultez Application de décalages d’entiers.

type Texture-Object 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 au status; au lieu de cela, passez 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 SampleCmpLevelZero

Texture2DArray