Udostępnij za pośrednictwem

Odwołania do adnotacji i semantyki standardu DirectX

  • Artykuł

Standardowe adnotacje i semantyka (DXSAS) zapewniają metodę używania cieniowania w standardowy sposób, który umożliwia cieniowanie do użycia z narzędziami, aplikacjami i aparatami gier. DXSAS definiuje zestaw semantyki i adnotacji dołączonych do wartości aplikacji hosta i parametrów efektów w celu udostępniania efektów. Aby te adnotacje i semantyka były przydatne, należy je zaimplementować zarówno w aplikacji hosta, jak i w pliku efektu. W tym dokumencie opisano standard DXSAS, który wykorzystuje możliwości struktury efektu DirectX w celu umożliwienia hostowania aplikacji i narzędzi do programowego udostępniania efektów DirectX (plików fx), a także do projektowania interakcji z interfejsem użytkownika.

Informacje podstawowe

Standardowe adnotacje i semantyka mają na celu powiązanie parametrów efektu i pliku X z wartościami aplikacji hosta. Struktura efektu D3DX (lub efekty) hermetyzuje stan renderowania. Hermetyzując stan renderowania (w tym wierzchołek, teksturę i stan przetwarzania pikseli), możesz utworzyć bibliotekę efektów obejmujących szeroką gamę opcji renderowania. Może to obejmować opcje, takie jak renderowanie na różnych typach sprzętu, lub renderowanie z mieszaniem pojedynczego lub wieloprzepustowego. Aby uzyskać więcej informacji na temat struktury wpływu, zapoznaj się z Effect Reference. Usługa DXSAS opiera się na tej strukturze, co zapewnia bardziej spójne środowisko dla deweloperów. Gdy konfiguracja renderowania zostanie hermetyzowana w efekcie, standard DXSAS umożliwia deweloperowi efektu uwidocznienie intencji parametrów efektu za pomocą adnotacji. Te adnotacje można następnie odczytywać za pomocą dowolnej aplikacji hosta lub narzędzia (nie tylko tej, która została zaprojektowana do korzystania z efektu), która jest zgodna ze standardem, zrozumie, jak używać efektu w sposób, który został zaprojektowany.

Standaryzacja zestawu semantyki efektów i adnotacji, które obsługują aplikacje hostujące, umożliwiają autorom efektu tworzenie efektów, które mogą być używane w wielu projektach, a tym samym promowanie szerszej społeczności użytkowników efektów. Standard DXSAS sprawia, że pliki są czytelne przez deweloperów, wymieniane między narzędziami i umożliwiają deweloperom korzystanie z narzędzi innych firm do tworzenia efektów dla potoku.

W tym dokumencie opisano standard DXSAS, który używa adnotacji do wyrażania intencji parametrów efektu, a także definiowania kolekcji wartości aplikacji hosta, które hostuje aplikacje zgadzają się udostępnić efekt.

Tworzenie efektów z adnotacjami standardowymi i semantykami

Jak widać na poniższym diagramie, standard DXSAS wymaga adnotacji w pliku efektowym, a także aplikacji hosta, która jest zgodna z wytycznymi opisanymi tutaj, aby pracować z plikiem.

diagram standardu dxsas dla aplikacji hosta i plików efektów

Aplikacja hosta musi implementować logikę interfejsu użytkownika i środowisko hosta. Aby zaimplementować efekty zgodne z usługą DXSAS, przeczytaj następujące tematy:

  • Globalny parametr definiuje informacje istotne dla efektu, takiego jak wersja, lub autor efektu.
  • powiązanie danych definiuje kolekcję parametrów (a także ich typ i strukturę), które mogą być używane przez efekt, który można ustawić przez aplikację hosta uwidocznianą na efekty.
  • Aby skojarzyć kontrolkę interfejsu użytkownika z parametrem efektu, użyj adnotacji interfejsu użytkownika . Te adnotacje obejmują: SasUiMax, SasUiMin, SasUiSteps, SasUiStepsPoweri SasUiStride.
  • Aby zainicjować parametr efektu z danymi zawartymi w pliku zewnętrznym, użyj adnotacji inicjowania parametrów .
  • Gdy dane są przesyłane między aplikacją hosta a efektem (lub odwrotnie), rzutowania i konwersji wystąpią, gdy typy nie są dokładnie zgodne. W tej sekcji opisano sposób zapisywania danych w przypadku różnic między typami źródłowymi i docelowymi. Ponadto użyj ParameterValueModifiers, aby zmodyfikować sposób interpretowania danych odczytywanych przez aplikację hosta z parametru efektu. Te adnotacje obejmują: SasNormalize i SasUnits.

Ważność wielkości liter

Wszystkie identyfikatory, semantyka i wartości adnotacji są bez uwzględniania wielkości liter. W nazwach adnotacji (a nie wartości) jest rozróżniana wielkość liter. Nazwy adnotacji są rozpoznawane przez system efektów D3DX i dlatego nazwy adnotacji SAS są również.

efektu