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 la 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 estándar y la semántica están diseñadas para enlazar los parámetros de efecto y 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 abarque 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 combinación de una o varias pasadas. Para obtener más información sobre el marco de efecto, debe consultar Referencia de efectos. 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. Después, 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 admiten aplicaciones host 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 efectos. 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.

Efectos de creación 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 siga 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 la aplicación host pueda establecer en los 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, SasUiStepsPowery sasUiStride.
• Para inicializar un parámetro de efecto con los datos contenidos en un archivo externo, use un anotación de inicialización de parámetros.
• Cuando los datos se transfieren entre la aplicación host y un efecto (o viceversa), de conversión y 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 valores) distinguen mayúsculas de minúsculas. El sistema de efectos D3DX reconoce los nombres de anotación y, por tanto, los nombres de anotación SAS también.

Temas relacionados

de referencia de efecto de