Fonction SampleLevel::SampleLevel(S,float,float,int,uint) pour Texture3D
Échantillonne une texture au niveau mipmap spécifié et retourne status sur l’opération.
Syntaxe
DXGI_FORMAT SampleLevel(
in SamplerState S,
in float Location,
in float LOD,
in int Offset,
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.
type Texture-Object Type de paramètre Texture1D float Texture1DArray, Texture2D float2 Texture2DArray, Texture3D, TextureCube float3 TextureCubeArray float4 -
LOD [in]
-
Type : float
[in] Nombre qui spécifie le niveau mipmap. Si la valeur est ≤ 0, le niveau mipmap 0 (plus grande carte) est utilisé. La valeur fractionnaire (si fournie) est utilisée pour interpoler entre deux niveaux mipmap.
-
Décalage [in]
-
Type : int
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. Utilisez un décalage uniquement à un miplevel entier ; sinon, vous pouvez obtenir des résultats qui ne se traduisent pas bien en matériel. Le type d’argument dépend du type texture-objet. Pour plus d’informations, consultez Application de décalages d’entiers.
type Texture-Object Type de paramètre Texture1D, Texture1DArray int Texture2D, Texture2DArray int2 Texture3D int3 TextureCube, TextureCubeArray non pris en charge -
État [out]
-
Type : uint
L’état de l’opération. Vous ne pouvez pas accéder directement au status; au lieu de cela, passez 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