Compartilhar via


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 para e retorna 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 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

 

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

 

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 de exemplo