DirectX Standard-aantekeningen en semantiekreferenties

Standaardaantekeningen en semantiek (DXSAS) bieden een methode voor het gebruik van shaders op een standaard manier waarmee shaders kunnen worden gebruikt met hulpprogramma's, toepassingen en game-engines. DXSAS definieert een set semantiek en aantekeningen die zijn gekoppeld aan hosttoepassingswaarden en effectparameters voor het delen van effecten. Om deze aantekeningen en semantiek nuttig te kunnen maken, moeten ze worden geïmplementeerd in zowel de hosttoepassing als het effectbestand. In dit document wordt de DXSAS-standaard beschreven die gebruikmaakt van de kracht van het DirectX-effectframework om hosttoepassingen en hulpprogramma's in staat te stellen Om DirectX-effecten (.fx-bestanden) programmatisch te delen, en om interactie met de gebruikersinterface te ontwerpen.

Achtergrondinformatie

Standaardaantekeningen en semantiek zijn ontworpen om effect- en X-bestandparameters te binden om toepassingswaarden te hosten. Het D3DX-effectframework (of effecten) bevat de renderingstatus. Door de renderingstatus (inclusief hoekpunt, textuur en pixelverwerkingsstatus) in een effect in te kapselen, kunt u een bibliotheek met effecten maken die een breed scala aan renderingopties behandelen. Dit kan opties zijn, zoals rendering op verschillende soorten hardware, of rendering met één of meerdere pass-blending. Raadpleeg effectverwijzingvoor meer informatie over het effectframework. DXSAS bouwt voort op dit framework voor een consistentere ervaring voor ontwikkelaars. Zodra de rendering-instelling is ingekapseld in een effect, kan de DXSAS-standaard de effectontwikkelaar de intentie van de effectparameters beschikbaar maken via aantekeningen. Deze aantekeningen kunnen vervolgens worden gelezen door elke hosttoepassing of elk hulpprogramma (niet alleen het hulpprogramma dat is ontworpen om het effect te gebruiken) die compatibel is met de standaard, begrijpt hoe het effect moet worden gebruikt op de manier die is ontworpen.

Door de set effectsemantiek en aantekeningen die hosttoepassingen ondersteunen te standaardiseren, kunnen auteurs van effecten die kunnen worden gebruikt in meerdere projecten maken en zo een bredere community van effectgebruikers bevorderen. De DXSAS-standaard maakt bestanden leesbaar door ontwikkelaars, wisselbaar tussen hulpprogramma's en stelt ontwikkelaars in staat gebruik te maken van hulpprogramma's van derden voor het ontwerpen van effecten voor hun pijplijn.

In dit document wordt de DXSAS-standaard beschreven die aantekeningen gebruikt om de intentie van effectparameters uit te drukken en een verzameling hosttoepassingswaarden te definiëren waarmee hosttoepassingen akkoord gaan om beschikbaar te maken voor een effect.

Ontwerpeffecten met standaardaantekeningen en semantiek

Zoals u in het volgende diagram kunt zien, vereist de DXSAS-standaard aantekeningen in een effectbestand, evenals een hosttoepassing die volgt op de richtlijnen die hier worden beschreven om met het bestand te werken.

De hosttoepassing moet de logica van de gebruikersinterface en de hostomgeving implementeren. Als u DXSAS-compatibele effecten wilt implementeren, leest u de volgende onderwerpen:

• De Globale parameter definieert informatie die relevant is voor het effect, zoals de versie of de auteur van het effect.
• gegevensbinding definieert de verzameling parameters (evenals hun type en structuur) die kunnen worden gebruikt door een effect dat kan worden ingesteld door de hosttoepassing die wordt blootgesteld aan effecten.
• Als u een besturingselement voor de gebruikersinterface wilt koppelen aan een effectparameter, gebruikt u een ui-aantekening. Deze aantekeningen zijn onder andere: SasUiMax, SasUiMin, SasUiSteps, SasUiStepsPoweren SasUiStride.
• Als u een effectparameter wilt initialiseren met gegevens in een extern bestand, gebruikt u een parameteraantekening.
• Wanneer gegevens worden overgedragen tussen de hosttoepassing en een effect (of omgekeerd), treden cast- en conversie- op wanneer de typen niet exact overeenkomen. In deze sectie wordt aangegeven hoe gegevens worden geschreven wanneer de bron- en doeltypen verschillen. Gebruik bovendien ParameterValueModifiers om te wijzigen hoe de hosttoepassing gegevens moet interpreteren die worden gelezen uit de effectparameter. Deze aantekeningen zijn onder andere: SasNormalize- en SasUnits.

Hoofdlettergevoeligheid

Alle id's, semantiek en annotatiewaarden zijn niet hoofdlettergevoelig. Namen van aantekeningen (geen waarden) zijn hoofdlettergevoelig. Namen van aantekeningen worden herkend door het D3DX-effectensysteem en daarom zijn ook SAS-aantekeningennamen.

Verwante onderwerpen

effectreferentie