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

Échantillonne une texture, en utilisant une valeur de comparaison pour rejeter les exemples, avec une valeur facultative pour fixer des exemples de valeurs de niveau de détail (LOD) à. Retourne l’état de l’opération.

Syntaxe

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

Paramètres

[ Dans]

Type : SamplerState

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

Emplacement [ dans]

Type : float

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

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

CompareValue [ dans]

Type : float

Valeur à virgule flottante à utiliser comme valeur de comparaison.

Décalage [ dans]

Type : int

Décalage de coordonnée de texture facultatif, qui peut être utilisé pour tout type d’objet de texture ; l’offset est appliqué à l’emplacement avant l’échantillonnage. Utilisez un décalage uniquement au niveau d’un miplevel entier ; dans le cas contraire, vous risquez d’obtenir des résultats qui ne se traduisent pas bien en matériel. Le type d’argument est dépendant du type de texture-objet. Pour plus d’informations, consultez application de décalages d’entiers.

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

Clamp [ dans]

Type : float

Valeur facultative pour fixer l’exemple de valeurs LOD à. Par exemple, si vous transmettez 2.0 f pour la valeur clamp, vous vous assurez qu’aucun exemple individuel n’accède à un niveau MIP inférieur à 2.0 f.

État [ à]

Type : uint

État de l'opération. Vous ne pouvez pas accéder directement à l’État. au lieu de cela, transmettez l’État à la fonction intrinsèque CheckAccessFullyMapped . CheckAccessFullyMapped retourne la valeur true si toutes les valeurs de l' exemple, de regroupement ou d’opération de chargement correspondant 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 retourne false.

Valeur de retour

Type : dxgi _ format

Le format de texture, qui est l’une des valeurs typées énumérées dans le _ format dxgi.

Voir aussi

Méthodes SampleCmp

Texture2DArray