Partager via


Fonction Texture3D::Sample(S,float,int,float)

Échantillonne une texture avec une valeur facultative pour limiter les valeurs de niveau de détail (LOD).

Syntaxe

DXGI_FORMAT Sample(
  in SamplerState S,
  in float        Location,
  in int          Offset,
  in float        Clamp
);

Paramètres

S [in]

É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]

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

 

Offset [in]

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

 

Clamp [in]

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.

Valeur retournée

Format de texture, qui est l’une des valeurs typées répertoriées dans DXGI_FORMAT.

Voir aussi

Exemples de méthodes

Texture3D