Compartilhar via


Função SampleGrad::SampleGrad(S, float, float, float,float,uint) para TextureCubeArray

Amostra uma textura, usando um gradiente para influenciar a forma como o local de exemplo é calculado, com um valor opcional para fixar valores lod (nível de detalhe) de exemplo. Retorna status sobre a operação.

Sintaxe

DXGI_FORMAT SampleGrad(
  in  SamplerState S,
  in  float        Location,
  in  float        DDX,
  in  float        DDY,
  in  float        Clamp,
  out uint         Status
);

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 texture-object.

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 texture-object.

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 texture-object.

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

 

Pinçar [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.

Status [out]

Tipo: uint

O status da operação. Você não pode acessar o status diretamente; em vez disso, passe o status para a função intrínseca CheckAccessFullyMapped. CheckAccessFullyMapped retornará TRUE se todos os valores da operação correspondente Amostra, Coleta ou Carga acessarem blocos mapeados em um recurso em bloco. Se algum valor tiver sido obtido de um bloco não mapeado, CheckAccessFullyMapped retornará FALSE.

Valor retornado

Tipo: DXGI_FORMAT

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

Confira também

Métodos SampleGrad

TextureCubeArray