Fonction SampleGrad::SampleGrad(S,float,float,float,int,float,uint) pour Texture2D
Échantillonne une Texture2D, à l’aide d’un dégradé pour influencer la façon dont l’emplacement de l’échantillon est calculé, avec une valeur facultative pour fixer les valeurs de niveau de détail des échantillons (LOD). Retourne status sur l’opération.
Syntaxe
DXGI_FORMAT SampleGrad(
in SamplerState S,
in float Location,
in float DDX,
in float DDY,
in int Offset,
in float Clamp,
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 -
DDX [in]
-
Type : float
Taux de modification de la géométrie de surface dans la direction x. Le type d’argument dépend du type texture-objet.
type Texture-Object Type de paramètre Texture1D, Texture1DArray float Texture2D, Texture2DArray float2 Texture3D, TextureCube, TextureCubeArray float3 Texture2DMS, Texture2DMSArray non pris en charge -
DDY [in]
-
Type : float
Taux de modification de la géométrie de surface dans le sens y. Le type d’argument dépend du type texture-objet.
type Texture-Object Type de paramètre Texture1D, Texture1DArray float Texture2D, Texture2DArray float2 Texture3D, TextureCube, TextureCubeArray float3 Texture2DMS, Texture2DMSArray non pris en charge -
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 -
Pince [in]
-
Type : float
Valeur facultative à laquelle fixer les exemples de valeurs LOD. Par exemple, si vous passez 2.0f pour la valeur de serrage, vous vous assurez qu’aucun échantillon individuel n’accède à un niveau mip inférieur à 2,0f.
-
É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