SampleCmpLevelZero::SampleCmpLevelZero(S,float,float,int,uint) function for Texture1D
Échantillonne une texture au niveau mipmap 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 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 -
CompareValue [in]
-
Type : float
Valeur à virgule flottante à utiliser comme valeur de comparaison.
-
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