Partager via


Fonction SampleGrad::SampleGrad(S,float,float,float,float,uint) pour TextureCubeArray

É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 limiter les valeurs de niveau de détail de l’échantillon (LOD). Retourne status sur l’opération.

Syntaxe

DXGI_FORMAT SampleGrad(
  in  SamplerState S,
  in  float        Location,
  in  float        DDX,
  in  float        DDY,
  in  float        Clamp,
  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

 

DDX [in]

Type : float

Vitesse de modification de la géométrie de surface dans la direction x. Le type d’argument dépend du type d’objet de texture.

Texture-Object Type 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 la direction y. Le type d’argument dépend du type d’objet de texture.

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

 

Clamp [in]

Type : float

Valeur facultative à laquelle limiter les exemples de valeurs LOD. Par exemple, si vous passez 2,0f pour la valeur de clamp, 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 à 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

Méthodes SampleGrad

TextureCubeArray