Função SampleCmp::SampleCmp(S,float,float,int,float,uint) para Texture1D
Amostra uma textura, usando um valor de comparação para rejeitar amostras, com um valor opcional para fixar valores lod (nível de detalhe) de exemplo. Retorna status sobre a operação.
Sintaxe
DXGI_FORMAT SampleCmp(
in SamplerState S,
in float Location,
in float CompareValue,
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 de objeto de textura.
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 de objeto de textura. 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 -
Clamp [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. Não é possível 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 de Exemplo, Coleta ou Carga correspondente acessarem blocos mapeados em um recurso lado a lado. 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