Referensi Anotasi dan Semantik Standar DirectX
Anotasi dan semantik standar (DXSAS) menyediakan metode penggunaan shader dengan cara standar yang memungkinkan shader digunakan dengan alat, aplikasi, dan mesin game. DXSAS mendefinisikan sekumpulan semantik dan anotasi yang dilampirkan ke nilai aplikasi host dan parameter efek untuk tujuan berbagi efek. Agar anotasi dan semantik ini berguna, anotasi dan semantik ini harus diimplementasikan dalam aplikasi host dan file efek. Dokumen ini menjelaskan standar DXSAS yang memanfaatkan kekuatan Kerangka Kerja Efek DirectX untuk memungkinkan aplikasi dan alat host berbagi efek DirectX (file.fx) secara terprogram, serta untuk merancang interaksi dengan UI.
Informasi Latar Belakang
Anotasi dan semantik standar dirancang untuk mengikat efek dan parameter X-file untuk menghosting nilai aplikasi. Kerangka Kerja Efek D3DX (atau efek) merangkum status penyajian. Dengan merangkum status penyajian (termasuk status puncak, tekstur, dan pemrosesan piksel) sebagai efeknya, Anda dapat membuat pustaka efek yang mencakup berbagai opsi penyajian. Ini mungkin termasuk opsi seperti penyajian pada berbagai jenis perangkat keras, atau penyajian dengan campuran tunggal atau multi-pass. Untuk informasi selengkapnya tentang kerangka kerja efek, Anda harus merujuk ke Referensi Efek. DXSAS dibangun di atas kerangka kerja ini yang memungkinkan pengalaman yang lebih konsisten bagi pengembang. Setelah pengaturan penyajian dienkapsulasi dalam efek, standar DXSAS memungkinkan pengembang efek untuk mengekspos niat parameter efek melalui anotasi. Anotasi ini kemudian dapat dibaca oleh aplikasi atau alat host apa pun (bukan hanya yang dirancang untuk menggunakan efeknya) yang sesuai dengan standar akan memahami cara menggunakan efek dengan cara yang dirancang.
Menstandarkan semantik efek dan anotasi yang mendukung aplikasi host memungkinkan penulis efek membuat efek yang dapat digunakan dalam beberapa proyek dan dengan demikian mempromosikan komunitas pengguna efek yang lebih luas. Standar DXSAS membuat file dapat dibaca oleh pengembang, dapat dipertukarkan antar alat, dan memungkinkan pengembang memanfaatkan alat pihak ke-3 untuk menulis efek untuk alur mereka.
Dokumen ini menjelaskan standar DXSAS yang menggunakan anotasi untuk mengekspresikan niat parameter efek, serta menentukan kumpulan nilai aplikasi host yang menghosting aplikasi setuju untuk tersedia.
Efek Penulisan dengan Anotasi dan Semantik Standar
Seperti yang Anda lihat dari diagram berikut, standar DXSAS memerlukan anotasi dalam file efek, serta aplikasi host yang mengikuti panduan yang dijelaskan di sini untuk bekerja dengan file.
Aplikasi host harus menerapkan logika antarmuka pengguna dan lingkungan host. Untuk menerapkan efek yang mematuhi DXSAS, baca topik berikut:
- Parameter Global mendefinisikan informasi yang berkaitan dengan efek, seperti versi, atau penulis efek.
- Pengikatan Data mendefinisikan pengumpulan parameter (serta jenis dan strukturnya) yang dapat digunakan oleh efek yang dapat diatur oleh aplikasi host yang diekspos ke efek.
- Untuk mengaitkan kontrol antarmuka pengguna dengan parameter efek, gunakan Anotasi UI. Anotasi ini meliputi: SasUiMax, SasUiMin, SasUiSteps, SasUiStepsPower, dan SasUiStride.
- Untuk menginisialisasi parameter efek dengan data yang terkandung dalam file eksternal, gunakan Anotasi Inisialisasi Parameter.
- Ketika data ditransfer antara aplikasi host dan efek (atau sebaliknya), Casting dan Konversi akan terjadi ketika jenis tidak sama persis. Bagian ini menentukan bagaimana data ditulis ketika jenis sumber dan target berbeda. Selain itu, gunakan ParameterValueModifiers untuk memodifikasi bagaimana aplikasi host harus menginterpretasikan data yang dibaca dari parameter efek. Anotasi ini meliputi: SasNormalize dan SasUnits.
Sensitivitas Huruf Besar/Kecil
Semua pengidentifikasi, semantik, dan nilai anotasi tidak peka huruf besar/kecil. Nama anotasi (bukan nilai) peka huruf besar/kecil. Nama anotasi dikenali oleh sistem efek D3DX dan oleh karena itu nama anotasi SAS juga.
Topik terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk