Texture1DArray::Sample(S,float,int,float,uint) fonction

Échantillonne une texture avec une valeur facultative pour limiter les valeurs de niveau de détail (LOD) d’échantillon et retourne l’état de l’opération.

Syntaxe

DXGI_FORMAT Sample(
  in  SamplerState S,
  in  float        Location,
  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.

Texture-Object Type Type de paramètre
Texture1D float
Texture1DArray, Texture2D float2
Texture2DArray, Texture3D, TextureCube float3
TextureCubeArray float4

 

Offset [in]

Type : int

Décalage de coordonnées de texture facultatif, qui peut être utilisé pour n’importe quel type d’objet 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 correctement en matériel. Le type d’argument dépend du type texture-objet. Pour plus d’informations, consultez Appliquer des décalages entiers.

Texture-Object Type Type de paramètre
Texture1D, Texture1DArray int
Texture2D, Texture2DArray int2
Texture3D int3
TextureCube, TextureCubeArray non pris en charge

 

Pince [in]

Type : float

Valeur facultative pour pincer des exemples de valeurs LOD à. Par exemple, si vous passez 2.0f pour la valeur de pince, vous assurez qu’aucun échantillon individuel n’accède à un niveau mip inférieur à 2,0f.

État [out]

Type : uint

État de l'opération. Vous ne pouvez pas accéder directement à l’état ; au lieu de cela, transmettez l’état à la fonction intrinsèque CheckAccessFullyMapped . CheckAccessFullyMapped retourne TRUE si toutes les valeurs de l’opération Sample, Collect ou Load correspondante ont accédé aux vignettes mappées dans une ressource en mosaïque. Si des valeurs ont été extraites d’une vignette non mise en forme, CheckAccessFullyMapped retourne 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

Exemples de méthodes