Texture1D :: Sample (S, float, int, float, uint), fonction
Échantillonne une texture avec une valeur facultative pour fixer des valeurs d’exemple de niveau de détail (LOD) à 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
-
[ 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 -
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.
-
État [ à]
-
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 la valeur true si toutes les valeurs de l' exemple, de regroupement ou d’opération de chargement correspondant 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 retourne false.
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.