Compartilhar via


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

Amostra uma textura somente no nível de mipmap 0 e compara o resultado com um valor de comparação. Retorna status sobre a operação.

Sintaxe

DXGI_FORMAT SampleCmpLevelZero(
  in  SamplerState S,
  in  float        Location,
  in  float        CompareValue,
  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

 

CompareValue [in]

Tipo: float

Um valor de ponto flutuante a ser usado como um valor de comparação.

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 SampleCmpLevelZero