Função Texture2DArray::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 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]
-
Um estado sampler. Esse é um objeto declarado em um arquivo de efeito que contém atribuições de estado.
-
Localização [in]
-
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 -
Deslocamento [in]
-
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]
-
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]
-
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
O formato de textura, que é um dos valores tipados listados em DXGI_FORMAT.
Confira também