Partilhar via

Sintaxe de declaração da função

  • Artigo

As funções HLSL são declaradas com a sintaxe a seguir.

[StorageClass] [clipplanes()] [preciso] Return_Value Name ( [ArgumentList] ) [: Semântico] { [StatementBlock] };

 

Parâmetros

StorageClass

Modificador que redefine uma declaração de função. embutido atualmente é o único valor modificador. O valor do modificador deve estar embutido porque também é o valor padrão. Portanto, uma função está embutida independentemente de você especificar embutido e todas as funções no HLSL estão embutidas. Uma função embutida gera uma cópia do corpo da função (ao compilar) para cada chamada de função. Isso é feito para diminuir a sobrecarga de chamar a função.

Recortes

Lista opcional de planos de clipe, que é de até 6 planos de clipe especificados pelo usuário. Esse é um mecanismo alternativo para SV_ClipDistance que funciona no nível do recurso 9_x e superiores.

Nome

Uma cadeia de caracteres ASCII que identifica exclusivamente o nome da função de sombreador.

Argumentlist

Lista de argumentos opcionais, que é uma lista separada por vírgulas de argumentos passados para uma função.

Semântica

Cadeia de caracteres opcional que identifica o uso pretendido dos dados de retorno (consulte Semântica (DirectX HLSL)).

StatementBlock

Instruções opcionais que compõem o corpo da função. Uma função definida sem um corpo é chamada de protótipo de função; o corpo de uma função de protótipo deve ser definido em outro lugar antes que a função possa ser chamada.

Valor Retornado

O tipo de retorno pode ser qualquer um desses tipos de HLSL.

Comentários

A sintaxe nesta página descreve quase todos os tipos de função HLSL, incluindo sombreadores de vértice, sombreadores de pixel e funções auxiliares. Embora um sombreador de geometria também seja implementado com uma função, sua sintaxe é um pouco mais complicada, portanto, há uma página separada que define uma declaração de função de sombreador geometry (consulte Objeto Geometry-Shader (DirectX HLSL)).

Uma função pode ser sobrecarregada desde que seja dada uma combinação exclusiva de tipos de parâmetro e/ou ordem de parâmetro. O HLSL também implementa várias funções internas ou intrínsecas.

Você pode especificar planos de clipe específicos do usuário com o atributo clipplanes . O Windows aplica esses planos de clipe a todos os primitivos desenhados. O atributo clipplanes funciona como SV_ClipDistance mas funciona em todos os 9_x de nível de recurso de hardware e superior. Para obter mais informações, consulte Planos de clipe de usuário no hardware de nível 9 do recurso.

Exemplos

Este exemplo é de BasicHLSL10.fx do Exemplo BasicHLSL10.

struct VS_OUTPUT
{
    float4 Position   : SV_POSITION; 
    float4 Diffuse    : COLOR0;
    float2 TextureUV  : TEXCOORD0;
};

VS_OUTPUT RenderSceneVS( float4 vPos : POSITION,
                         float3 vNormal : NORMAL,
                         float2 vTexCoord0 : TEXCOORD,
                         uniform int nNumLights,
                         uniform bool bTexture,
                         uniform bool bAnimate )
{
    VS_OUTPUT Output;
    ...
    return Output;    
}

Este exemplo de AdvancedParticles.fx do AdvancedParticles Sample ilustra o uso de uma semântica para o tipo de retorno.

//
// PS for particles
//
float4 PSPointSprite(PSSceneIn input) : SV_Target
{   
    return g_txDiffuse.Sample( g_samLinear, input.tex ) * input.color;
}

Funções (DirectX HLSL)