Fonction SampleGrad :: SampleGrad (S, float, float, float, int, float, uint) pour Texture2D
Échantillonne un Texture2Dà l’aide d’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) à. Retourne l’état de l’opération.
Syntaxe
DXGI_FORMAT SampleGrad(
in SamplerState S,
in float Location,
in float DDX,
in float DDY,
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 -
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.
-
É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.