Função SampleGrad::SampleGrad(S,float,float,float,int,float,uint) para Texture1D
Amostra uma textura, usando um gradiente para influenciar a maneira como o local de exemplo é calculado, com um valor opcional para fixar valores lod (nível de detalhe) de exemplo. Retorna status sobre a operação.
Sintaxe
DXGI_FORMAT SampleGrad(
in SamplerState S,
in float Location,
in float DDX,
in float DDY,
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 -
DDX [in]
-
Tipo: float
A taxa de alteração da geometria da superfície na direção x. O tipo de argumento depende do tipo de objeto de textura.
Tipo de Texture-Object Tipo de parâmetro Texture1D, Texture1DArray FLOAT Texture2D, Texture2DArray float2 Texture3D, TextureCube, TextureCubeArray float3 Texture2DMS, Texture2DMSArray sem suporte -
DDY [in]
-
Tipo: float
A taxa de alteração da geometria da superfície na direção y. O tipo de argumento depende do tipo de objeto de textura.
Tipo de Texture-Object Tipo de parâmetro Texture1D, Texture1DArray FLOAT Texture2D, Texture2DArray float2 Texture3D, TextureCube, TextureCubeArray float3 Texture2DMS, Texture2DMSArray sem suporte -
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