Função Texture1DArray::Sample(S, float, int,float,uint)

Amostra uma textura com um valor opcional para fixar valores lod (nível de detalhe) de exemplo e retorna o status da operação.

Sintaxe

DXGI_FORMAT Sample(
  in  SamplerState S,
  in  float        Location,
  in  int          Offset,
  in  float        Clamp,
  out uint         Status
);

Parâmetros

S [in]

Tipo: SamplerState

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

Local [in]

Tipo: float

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

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

 

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 textura-objeto. Para obter mais informações, consulte Aplicar deslocamentos inteiros.

Tipo 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 o qual fixar valores LOD de exemplo. Por exemplo, se você passar 2,0f para o valor do grampo, 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 dos blocos mapeados de amostra, coletaou carga correspondentes acessarem a operação 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 de exemplo