Referencia semántica y anotaciones estándar de DirectX

Las anotaciones estándar y la semántica (DXSAS) proporcionan un método de uso de sombreadores de forma estándar que permite usar sombreadores con herramientas, aplicaciones y motores de juegos. DXSAS define un conjunto de semánticas y anotaciones que se adjuntan a los valores de aplicación host y los parámetros de efecto con el fin de compartir efectos. Para que estas anotaciones y semántica sean útiles, deben implementarse tanto en la aplicación host como en el archivo de efecto. En este documento se describe el estándar DXSAS que aprovecha la eficacia de DirectX Effect Framework para permitir que las aplicaciones host y las herramientas compartan efectos DirectX (archivos.fx) mediante programación, así como para diseñar la interacción con la interfaz de usuario.

Información general

Las anotaciones y la semántica estándar están diseñadas para enlazar el efecto y los parámetros de archivo X para hospedar los valores de la aplicación. El marco de efecto D3DX (o efectos) encapsula el estado de representación. Al encapsular el estado de representación (incluido el estado de procesamiento de vértices, texturas y píxeles) en un efecto, puede crear una biblioteca de efectos que abarquen una amplia gama de opciones de representación. Esto puede incluir opciones como la representación en diferentes tipos de hardware o la representación con mezcla de una o varias pasadas. Para obtener más información sobre el marco de efecto, debe consultar Referencia de efecto. DXSAS se basa en este marco, lo que permite una experiencia más coherente para los desarrolladores. Una vez que la configuración de representación se encapsula en un efecto, el estándar DXSAS permite al desarrollador de efectos exponer la intención de los parámetros de efecto a través de anotaciones. A continuación, cualquier aplicación o herramienta host puede leer estas anotaciones (no solo la que se diseñó para usar el efecto) que sea compatible con el estándar comprenderá cómo usar el efecto de la manera que se diseñó.

La estandarización del conjunto de semánticas de efectos y anotaciones que hospedan aplicaciones admiten permiten a los autores de efectos crear efectos que se pueden usar en varios proyectos y, por tanto, promover una comunidad más amplia de usuarios de efecto. El estándar DXSAS hace que los desarrolladores puedan leer archivos, intercambiables entre herramientas y permite a los desarrolladores aprovechar las herramientas de terceros para crear efectos para su canalización.

En este documento se describe el estándar DXSAS que usa anotaciones para expresar la intención de los parámetros de efecto, así como definir una colección de valores de aplicación host que las aplicaciones host aceptan poner a disposición de un efecto.

Creación de efectos con anotaciones estándar y semántica

Como puede ver en el diagrama siguiente, el estándar DXSAS requiere anotaciones en un archivo de efecto, así como una aplicación host que sigue las directrices descritas aquí para trabajar con el archivo.

La aplicación host debe implementar la lógica de la interfaz de usuario y el entorno de host. Para implementar efectos compatibles con DXSAS, lea los temas siguientes:

• El parámetro global define información pertinente para el efecto, como la versión o el autor del efecto.
• Enlace de datos define la colección de parámetros (así como su tipo y estructura) que puede usar un efecto que puede establecer la aplicación host expuesta a efectos.
• Para asociar un control de interfaz de usuario con un parámetro de efecto, use una anotación de interfaz de usuario. Estas anotaciones incluyen: SasUiMax, SasUiMin, SasUiSteps, SasUiStepsPower y SasUiStride.
• Para inicializar un parámetro de efecto con los datos contenidos en un archivo externo, use una anotación de inicialización de parámetros.
• Cuando los datos se transfieren entre la aplicación host y un efecto (o viceversa), la conversión y la conversión se producirán cuando los tipos no coincidan exactamente. En esta sección se especifica cómo se escriben los datos cuando los tipos de origen y de destino difieren. Además, use ParameterValueModifiers para modificar cómo la aplicación host debe interpretar los datos leídos del parámetro effect. Estas anotaciones incluyen: SasNormalize y SasUnits.

Distinción entre mayúsculas y minúsculas

Todos los identificadores, la semántica y los valores de anotación no distinguen mayúsculas de minúsculas. Los nombres de anotación (no los valores) distinguen mayúsculas de minúsculas. El sistema de efectos D3DX reconoce los nombres de anotación y, por tanto, también son nombres de anotación SAS.

Temas relacionados

Referencia de efecto