Função SampleGrad::SampleGrad(S, float, float, float, int,float,uint) para Texture2DArray
Amostra uma textura, usando um gradiente para influenciar a forma 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 texture-object.
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 texture-object.
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 texture-object.
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 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 -
Pinçar [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. 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