Sombreado
El proyecto ShaderDoc busca proporcionar una fuente independiente de documentación para el formato de paquete ShadersMod / Optifine / Iris Shader. Aunque no documenta completamente el formato, busca proporcionar un alto nivel de detalle en las áreas que documenta.
Hay dos propósitos de este proyecto:
- Proporcionar documentación de alta calidad para desarrolladores de paquetes de sombreadores que buscan desarrollar paquetes de sombreadores para Iris.
- Proporcionar una descripción relativamente inequívoca de elementos críticos pero complejos del formato de sombreador que de otro modo solo se describen brevemente (¡o incorrectamente!) En la documentación oficial de optifina, para facilitar la implementación de estos elementos en el iris sin infringir derechos de autor.
Recopilando información para ShaderDoc
Hay algunas formas de recopilar información para agregar una nueva documentación a ShaderDoc:
- Uso de la documentación de optifina como referencia. Tenga en cuenta que la documentación oficial de Optifine para Shaders no tiene licencia, lo que hace que todo sea reservado. Esto significa que está prohibido copiar directamente el texto de la documentación de Optifine a ShaderDoc. Sin embargo, se le permite leer la documentación de Optifine y luego usarla para escribir una descripción de un tema en sus propias palabras. Tenga en cuenta que la documentación de optifina no es necesariamente una fuente de verdad: hay muchos lugares donde es incorrecto. Úselo con cierta precaución.
- Otra documentación de terceros. Los desarrolladores de Shader Pack también han creado sus propios recursos para documentar el formato Shaders. Se aplican reglas y directrices similares para trabajar con la documentación de Optifine.
- Experiencia trabajando con el formato de paquete sombreador. Trabajar con el formato de paquete de sombreador en Optifine es una forma decente de recopilar conocimiento general sobre el formato.
- Ingeniería inversa. Aunque es algo arriesgado, este método puede ser la forma más precisa de encontrar o confirmar información. El código fuente de ShadersMod v2.7.0 para Minecraft 1.12 está disponible aquí: http://www.karyonix.net/shadersmod/files/smc-2.7.0-mc1.12-src.7z. Se debe evitar la descomposición de la optifina cuando sea posible.
Contribuyendo a shaderdoc
Si desea contribuir a ShaderDoc, no dude en abrir una solicitud de extracción. Tenga en cuenta que los PR pueden tardar mucho en fusionarse, ya que solo se fusionan una vez que han sido completamente verificados, y cada vez que tengo tiempo para mirarlos.
Licencia
LGPLV3 o posterior
