Partager via


Fonction SampleGrad::SampleGrad(S,float,float,float,int,float) pour Texture1D

Échantillonne une texture, à 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).

Syntaxe

DXGI_FORMAT SampleGrad(
  in SamplerState S,
  in float        Location,
  in float        DDX,
  in float        DDY,
  in int          Offset,
  in float        Clamp
);

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.

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 SampleGrad