Axmol v3 的跨平台渲染工作流迎来了一次基础性升级引擎 Shader 已从以 GLSL 为源的旧流程迁移到HLSL-first。开发者现在可以维护一份 HLSL 源码再由全新的 Axmol 专用 Shader 编译器axslcc 3.99为 D3D11、D3D12、Vulkan、Metal、OpenGL 和 OpenGL ES 生成目标代码与运行时反射信息。这次迁移并不只是把.vert、.frag改写成.hlsl。它同时重新梳理了 Shader 编译、资源反射、顶点输入、采样器和各 RHI 后端之间的契约让跨平台 Shader 的行为更统一也让后续渲染功能能够建立在更清晰、可维护的基础之上。一份 HLSL覆盖全部 RHI新的 CMake Shader 流程会根据项目启用的 RHI 自动选择编译目标。顶点、像素与计算 Shader 使用_vs.hlsl、_fs.hlsl/_ps.hlsl和_cs.hlsl命名并由axslcc一次生成所需后端的代码包。构建系统还加入了 Shader variant 支持可为同一份源码组合不同的预处理定义。Axmol 内置 Shader、3D 渲染、VR以及 ImGui、Live2D、Spine、Box2D Testbed 和 cpp-tests 中的 Shader 已一并迁移。过去用于 GLSL 转换和生成静态 Shader 信息的旧流程也随之退出。顶点输入改用语义匹配旧工作流通常依赖a_position、a_texCoord这样的变量名。HLSL-first 工作流改为使用 HLSL semantic 的名称与索引匹配顶点数据例如struct VSInput { float3 position : POSITION; float2 uv : TEXCOORD0; float4 color : COLOR0; };变量可以叫position、pos或任何其他名字真正的绑定契约是POSITION0、TEXCOORD0和COLOR0。除了引擎内置语义新的运行时模型也支持自定义 semantic为扩展渲染路径和实例数据提供了更自然的表达方式。统一的采样器模型采样器是这次重构的另一项重点。base.hlsli提供 22 个稳定的内置 preset包括LinearClamp、PointWrap、AnisoClamp和阴影比较采样器等常用组合#include base.hlsli Texture2D u_tex0; float4 main(float2 uv : TEXCOORD0) : SV_Target0 { return u_tex0.Sample(LinearClamp, uv); }如果内置 preset 无法满足需求也可以声明具名的自定义SamplerState并在创建Program之前通过SamplerRegistry注册对应状态。Shader 反射记录的是稳定的逻辑绑定各后端再将其映射为 D3D sampler slot、D3D12 descriptor、Vulkan descriptor set、Metal sampler 或 GL/ES combined sampler。新的Program校验会在自定义采样器未注册或 Shader 模块编译失败时将程序标记为无效避免错误悄悄进入绘制阶段。新的反射与资源绑定契约axslcc 3.99的 Shader 包和反射 ABI 已针对 Axmol RHI 重新设计。运行时现在可以直接获得顶点输入的 semantic 名称、索引与后端位置texture、sampler、uniform buffer 和 storage resource 的最终绑定信息内置 sampler preset 与 Program-local 自定义 sampler 的明确区分各目标代码是文本还是原生字节码等必要元数据。Shader 作者无需手写register(...)。资源按统一规则声明由编译器分配确定性的逻辑绑定再由 RHI 完成后端翻译。D3D11、D3D12、Vulkan、Metal 与 OpenGL/ES 的实现均已适配这一模型其中也包括 Vulkan 的独立 image/sampler descriptor set以及 D3D12 的 descriptor heap 分配更新。迁移时需要注意什么新的 Shader 建议包含base.hlsli使用 HLSL semantic并让axslcc自动处理资源绑定。Uniform 与 texture 的名称仍是 C 侧查找契约因此不能随意修改。OpenGL/ES 最终使用 combined sampler。为了保持所有后端行为一致同一个 Shader 中不要让同一 texture 同时使用多个 sampler需要不同采样方式时应使用不同 texture binding。UV 的 Y 翻转也不应因为“从 GLSL 迁移到 HLSL”而机械添加。1.0 - uv.y表示数据空间转换AX_Y_UP()表示后端相关坐标转换应根据输入数据本身的含义选择。完整规则、常见问题与迁移指南可参考HLSL Shader 规范HLSL 常见问题Shaders in Axmol 3验证情况本次迁移已使用新的 HLSL Shader 集完成全部 RHI cpp-tests 验证。合并前依赖版本将从候选版切换为正式发布的axslcc 3.99.0。HLSL-first 让 Axmol 的 Shader 源码、编译器反射和多后端运行时第一次建立在同一套清晰契约上。它不仅减少了重复 Shader 与后端特例也为 Axmol v3 后续的渲染演进打下了更稳固的基础。
原理与性能优化实践)
