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

Échantillonne une texture en utilisant un dégradé pour influencer la façon dont l’emplacement de l’échantillon est calculé, avec une valeur facultative pour fixer des valeurs d’exemple de niveau de détail (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

[ 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

Ddx [ dans]

Type : float

Taux de modification de la géométrie de la surface dans l’axe x. Le type d’argument est dépendant du type de texture-objet.

Type de Texture-Object Type de paramètre
Texture1D, Texture1DArray float
Texture2D, Texture2DArray float2
Texture3D, TextureCube, TextureCubeArray float3
Texture2DMS, Texture2DMSArray non pris en charge

Ddy [ dans]

Type : float

Taux de modification de la géométrie de la surface dans l’axe y. Le type d’argument est dépendant du type de texture-objet.

Type de Texture-Object Type de paramètre
Texture1D, Texture1DArray float
Texture2D, Texture2DArray float2
Texture3D, TextureCube, TextureCubeArray float3
Texture2DMS, Texture2DMSArray non pris en charge

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.

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 SampleGrad