Compartilhar via


Função SampleLevel::SampleLevel(S,float, float,int,uint) para Texture2D

Amostra um Texture2D no nível de mipmap especificado e retorna status sobre a operação.

Sintaxe

DXGI_FORMAT SampleLevel(
  in  SamplerState S,
  in  float        Location,
  in  float        LOD,
  in  int          Offset,
  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

 

LOD [in]

Tipo: float

[in] Um número que especifica o nível de mipmap. Se o valor for ≤ 0, mipmap nível 0 (mapa maior) será usado. O valor fracionário (se fornecido) é usado para interpolar entre dois níveis de mipmap.

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

 

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 SampleLevel