Referência de anotação e semântica padrão do DirectX

As anotações padrão e a semântica (DXSAS) fornecem um método de uso de sombreadores de maneira padrão que permite que sombreadores sejam usados com ferramentas, aplicativos e mecanismos de jogos. O DXSAS define um conjunto de semânticas e anotações que são anexadas a valores de aplicativo host e parâmetros de efeito para fins de compartilhamento de efeitos. Para que essas anotações e semântica sejam úteis, elas devem ser implementadas no aplicativo host e no arquivo de efeito. Este documento descreve o padrão DXSAS que aproveita o poder do DirectX Effect Framework para permitir que aplicativos host e ferramentas compartilhem efeitos DirectX (arquivos .fx) programaticamente, bem como para projetar a interação com a interface do usuário.

Informações em segundo plano

Anotações padrão e semântica são projetadas para associar o efeito e os parâmetros de arquivo X para hospedar valores de aplicativo. A Estrutura de Efeito D3DX (ou efeitos) encapsula o estado de renderização. Encapsulando o estado de renderização (incluindo vértice, textura e estado de processamento de pixels) em um efeito, você pode criar uma biblioteca de efeitos que abrange uma ampla gama de opções de renderização. Isso pode incluir opções como renderização em diferentes tipos de hardware ou renderização com mesclagem única ou de várias passões. Para obter mais informações sobre a estrutura de efeito, consulte Effect Reference. O DXSAS se baseia nessa estrutura, permitindo uma experiência mais consistente para os desenvolvedores. Depois que a configuração de renderização é encapsulada em um efeito, o padrão DXSAS permite que o desenvolvedor de efeito exponha a intenção dos parâmetros de efeito por meio de anotações. Essas anotações podem então ser lidas por qualquer aplicativo ou ferramenta host (não apenas aquele que foi projetado para usar o efeito) que esteja em conformidade com o padrão entenderá como usar o efeito da maneira que foi projetada.

Padronizar o conjunto de semânticas de efeito e anotações que dão suporte a aplicativos host permitem que os autores de efeito criem efeitos que podem ser usados em vários projetos e, portanto, promovam uma comunidade mais ampla de usuários de efeito. O padrão DXSAS torna os arquivos legíveis por desenvolvedores, trocáveis entre ferramentas e permite que os desenvolvedores aproveitem ferramentas de terceiros para criar efeitos para seu pipeline.

Este documento descreve o padrão DXSAS que usa anotações para expressar a intenção de parâmetros de efeito, bem como definir uma coleção de valores de aplicativo host que os aplicativos host concordam em disponibilizar para um efeito.

Criando efeitos com anotações padrão e semântica

Como você pode ver no diagrama a seguir, o padrão DXSAS requer anotações em um arquivo de efeito, bem como um aplicativo host que segue as diretrizes descritas aqui para trabalhar com o arquivo.

O aplicativo host deve implementar a lógica da interface do usuário e o ambiente do host. Para implementar efeitos em conformidade com DXSAS, leia os seguintes tópicos:

• O parâmetro global define informações pertinentes ao efeito, como a versão ou o autor do efeito.
• data binding define a coleção de parâmetros (bem como seu tipo e estrutura) que podem ser usados por um efeito que pode ser definido pelo aplicativo host exposto a efeitos.
• Para associar um controle de interface do usuário a um parâmetro de efeito, use um de anotação de interface do usuário. Essas anotações incluem: SasUiMax, SasUiMin, SasUiSteps, SasUiStepsPowere SasUiStride.
• Para inicializar um parâmetro de efeito com dados contidos em um arquivo externo, use uma anotação de inicialização de parâmetro .
• Quando os dados são transferidos entre o aplicativo host e um efeito (ou vice-versa), conversão e conversão ocorrerá quando os tipos não corresponderem exatamente. Esta seção especifica como os dados são gravados quando os tipos de origem e destino diferem. Além disso, use ParameterValueModifiers para modificar como o aplicativo host deve interpretar os dados lidos do parâmetro de efeito. Essas anotações incluem: SasNormalize e SasUnits.

Diferenciação de maiúsculas e minúsculas

Todos os valores de identificador, semântica e anotação não diferenciam maiúsculas de minúsculas. Nomes de anotação (não valores) diferenciam maiúsculas de minúsculas. Os nomes de anotação são reconhecidos pelo sistema de efeitos D3DX e, portanto, os nomes de anotação SAS também são.

Tópicos relacionados

de referência de efeito