Annotazioni standard DirectX e riferimenti semantici

Le annotazioni e la semantica standard (DXSAS) forniscono un metodo per l'uso di shader in modo standard che consente l'uso di shader con strumenti, applicazioni e motori di gioco. DXSAS definisce un set di semantiche e annotazioni associate ai valori dell'applicazione host e ai parametri di effetto allo scopo di condividere gli effetti. Affinché queste annotazioni e semantica siano utili, devono essere implementate sia nell'applicazione host che nel file di effetto. Questo documento descrive lo standard DXSAS che sfrutta la potenza di DirectX Effect Framework per consentire alle applicazioni host e agli strumenti di condividere gli effetti DirectX (file con estensione fx) a livello di codice, nonché per progettare l'interazione con l'interfaccia utente.

Informazioni di base

Le annotazioni e la semantica standard sono progettate per associare gli effetti e i parametri del file X ai valori dell'applicazione host. D3DX Effect Framework (o effetti) incapsula lo stato di rendering. Incapsulando lo stato di rendering (incluso vertice, trama e stato di elaborazione pixel) in un effetto, è possibile creare una libreria di effetti che coprono un'ampia gamma di opzioni di rendering. Ciò può includere opzioni come il rendering in diversi tipi di hardware o il rendering con fusione a passaggio singolo o multipasso. Per altre informazioni sul framework degli effetti, fare riferimento a Riferimento agli effetti. DXSAS si basa su questo framework che consente un'esperienza più coerente per gli sviluppatori. Dopo aver incapsulato l'installazione del rendering in un effetto, lo standard DXSAS consente allo sviluppatore dell'effetto di esporre la finalità dei parametri dell'effetto tramite annotazioni. Queste annotazioni possono quindi essere lette da qualsiasi applicazione o strumento host (non solo da quello progettato per usare l'effetto) conforme allo standard comprenderà come usare l'effetto nel modo progettato.

La standardizzazione del set di semantiche degli effetti e annotazioni che ospitano applicazioni supportano consentono agli autori di effetti di creare effetti che possono essere usati in più progetti e quindi promuovere una community più ampia di utenti di effetti. Lo standard DXSAS rende i file leggibili dagli sviluppatori, scambiabili tra gli strumenti e consente agli sviluppatori di sfruttare gli strumenti di terze parti per la creazione di effetti per la pipeline.

Questo documento descrive lo standard DXSAS che usa le annotazioni per esprimere la finalità dei parametri di effetto, nonché la definizione di una raccolta di valori dell'applicazione host che ospitano le applicazioni accettano di rendere disponibili per un effetto.

Creazione di effetti con annotazioni standard e semantica

Come si può vedere dal diagramma seguente, lo standard DXSAS richiede annotazioni in un file di effetto, nonché un'applicazione host che segue le linee guida descritte qui per lavorare con il file.

L'applicazione host deve implementare la logica dell'interfaccia utente e l'ambiente host. Per implementare effetti conformi a DXSAS, leggere gli argomenti seguenti:

• Il parametro globale definisce le informazioni pertinenti all'effetto, ad esempio la versione o l'autore dell'effetto.
• Il data binding definisce la raccolta di parametri (nonché il tipo e la struttura) che possono essere usati da un effetto che può essere impostato dall'applicazione host esposta agli effetti.
• Per associare un controllo dell'interfaccia utente a un parametro di effetto, usare un'annotazione dell'interfaccia utente. Queste annotazioni includono: SasUiMax, SasUiMin, SasUiSteps, SasUiStepsPower e SasUiStride.
• Per inizializzare un parametro di effetto con i dati contenuti in un file esterno, usare un'annotazione di inizializzazione dei parametri.
• Quando i dati vengono trasferiti tra l'applicazione host e un effetto (o viceversa), il cast e la conversione si verificheranno quando i tipi non corrispondono esattamente. In questa sezione viene specificato il modo in cui i dati vengono scritti quando i tipi di origine e di destinazione differiscono. Inoltre, usare ParameterValueModifiers per modificare il modo in cui l'applicazione host deve interpretare i dati letti dal parametro dell'effetto. Queste annotazioni includono : SasNormalize e SasUnits.

Maiuscole/minuscole

Tutti gli identificatori, la semantica e i valori di annotazione non fanno distinzione tra maiuscole e minuscole. I nomi delle annotazioni (non i valori) fanno distinzione tra maiuscole e minuscole. I nomi delle annotazioni vengono riconosciuti dal sistema di effetti D3DX e pertanto anche i nomi delle annotazioni sas.

Argomenti correlati

Riferimento all'effetto