Compartilhar via


Função SampleGrad::SampleGrad(S,float,float,float,int,float) para Texture1D

Amostra uma textura, usando um gradiente para influenciar a maneira como o local de exemplo é calculado, com um valor opcional para fixar valores lod (nível de detalhe) de exemplo.

Sintaxe

DXGI_FORMAT SampleGrad(
  in SamplerState S,
  in float        Location,
  in float        DDX,
  in float        DDY,
  in int          Offset,
  in float        Clamp
);

Parâmetros

S [in]

Tipo: SamplerState

Um estado sampler. Esse é um objeto declarado em um arquivo de efeito que contém atribuições de estado.

Localização [in]

Tipo: float

As coordenadas de textura. O tipo de argumento depende do tipo de objeto de textura.

Tipo de Texture-Object Tipo de parâmetro
Texture1D FLOAT
Texture1DArray, Texture2D float2
Texture2DArray, Texture3D, TextureCube float3
TextureCubeArray float4

 

DDX [in]

Tipo: float

A taxa de alteração da geometria da superfície na direção x. O tipo de argumento depende do tipo de objeto de textura.

Tipo de Texture-Object Tipo de parâmetro
Texture1D, Texture1DArray FLOAT
Texture2D, Texture2DArray float2
Texture3D, TextureCube, TextureCubeArray float3
Texture2DMS, Texture2DMSArray sem suporte

 

DDY [in]

Tipo: float

A taxa de alteração da geometria da superfície na direção y. O tipo de argumento depende do tipo de objeto de textura.

Tipo de Texture-Object Tipo de parâmetro
Texture1D, Texture1DArray FLOAT
Texture2D, Texture2DArray float2
Texture3D, TextureCube, TextureCubeArray float3
Texture2DMS, Texture2DMSArray sem suporte

 

Deslocamento [in]

Tipo: int

Um deslocamento de coordenada de textura opcional, que pode ser usado para qualquer tipo de objeto de textura; o deslocamento é aplicado ao local antes da amostragem. Use um deslocamento somente em um miplevel inteiro; caso contrário, você poderá obter resultados que não se traduzem bem em hardware. O tipo de argumento depende do tipo de objeto de textura. Para obter mais informações, consulte Aplicando deslocamentos inteiros.

Tipo de Texture-Object Tipo de parâmetro
Texture1D, Texture1DArray INT
Texture2D, Texture2DArray int2
Texture3D int3
TextureCube, TextureCubeArray sem suporte

 

Clamp [in]

Tipo: float

Um valor opcional para fixar valores LOD de exemplo. Por exemplo, se você passar 2,0f para o valor de fixação, verifique se nenhum exemplo individual acessa um nível de mip menor que 2,0f.

Valor retornado

Tipo: DXGI_FORMAT

O formato de textura, que é um dos valores tipados listados em DXGI_FORMAT.

Confira também

Métodos SampleGrad