15-mini版WebGLMaterials

源码:github.com/buglas/thre...

1-WebGLMaterialsMini的代码

src\renderers\webgl\WebGLMaterialsMini.js

scss 复制代码
/**
 * 将 JS 侧 Material 属性同步到 shader uniform 对象。
 * Mini 版仅处理 MeshMiniMaterial 的 diffuse(纯色)颜色。
 */
function WebGLMaterialsMini() {
    // 刷新材质的uniforms,uniforms 是WebGLUniformsMini的实例
    function refreshMaterialUniforms( uniforms, material ) {
        if ( material.isMeshMiniMaterial ) {
            uniforms.diffuse.value.copy( material.color );
        }
    }
    return {
        refreshMaterialUniforms: refreshMaterialUniforms
    };
}
​
export { WebGLMaterialsMini };

2-WebGLMaterialsMini的功能定位

WebGLMaterials 是WebGL 渲染管线中的"Material → Uniform 桥接层"。

WebGLMaterials 不负责编译 shader、也不直接上传 GPU,而是把 JavaScript 侧的 Material 属性,同步到 shader 对应的 uniforms 对象里,供 WebGLRenderer 后续调用 WebGLUniforms.upload() 上传到 GPU。

shader 对应的 uniforms 对象指的是在js里预定义的uniforms,这种uniforms是ShaderLib 中的uniforms 的深拷贝。

整体流程:

scss 复制代码
Material 属性变化
    ↓
WebGLMaterials.refreshMaterialUniforms()  更新js里预定义的uniforms
    ↓
WebGLUniforms.upload() 上传到 GPU

WebGLMaterialsMini 比较简单,只保留了其核心功能。

3-代码详解

WebGLMaterialsMini 只向外暴露了一个refreshMaterialUniforms 方法。

refreshMaterialUniforms 方法负责把 JavaScript 侧材质属性 同步到 shader uniform 对象,再交给 WebGLUniformsMini.upload() 上传到 GPU。

WebGLMaterialsMini 只处理MeshMiniMaterial 材质。

判断条件是 material.isMeshMiniMaterial,目前只同步一个属性:

  • JS 侧:MeshMiniMaterial.color
  • Shader 侧:uniform vec3 diffuse(见 meshmini.glsl.js)
ini 复制代码
uniform vec3 diffuse;
void main() {
    pc_fragColor = vec4( diffuse, 1.0 );
}

Uniform 的初始定义在 ShaderLibMini.js:

css 复制代码
mini: {
    uniforms: {
        diffuse: { value: /*@__PURE__*/ new Color( 0xffffff ) }
    },

所以当你写 new MeshMiniMaterial({ color: 0xff0000 }) 时,这个模块会在每帧绘制前把红色同步到 GPU,片元着色器就能输出纯色。

4-与完整版 WebGLMaterials.js 的对比

对比项 WebGLMaterialsMini WebGLMaterials(完整版)
材质类型 仅 MeshMiniMaterial Basic、Lambert、Phong、Standard、Node 等
同步内容 仅 color → diffuse 贴图、光照、雾、透明度、环境贴图等
额外参数 无 pixelRatio、height、transmissionRenderTarget 等

完整版里类似逻辑在 refreshUniformsCommon 等函数中,Mini 版把这一层砍到最小,只保留「纯色网格」所需的一条路径。

总结

WebGLMaterialsMini.js 是 Mini 渲染器里的 材质 uniform 同步器:

在 setProgram 阶段把 MeshMiniMaterial.color 写入 diffuse uniform,让 meshmini 片元着色器能按材质颜色绘制纯色三角形。

功能很少,但它是「用户改 material.color → 屏幕变色」这条链路上不可缺少的一环。

相关推荐
kyriewen2 小时前
编辑弹窗点了取消,列表里的数据怎么还是变了?
前端·javascript·人工智能
Karl_fang2 小时前
🥳 再也不用拿起手机抄验证码!我做了一个 Android → Mac 的「验证码接力」工具
前端·macos·ai编程
谭光志3 小时前
如何让 AI 高效工作
前端·后端·ai编程
FRing034 小时前
vue2干货总结11(短信验证、登录功能、统一处理错误(响应拦截器)、将token信息存入vuex、vuex持久化处理)
开发语言·前端·javascript·vue.js·vue2
泯泷4 小时前
改一个字,整段都红了?——中文内容差异对比的算法与协议设计
前端·javascript·typescript
再吃一根胡萝卜4 小时前
DSH plugin 开发示例:五种插件形态完整代码整理
前端
Yk酱228405 小时前
A2UI随笔-demo-01
前端
云起SAAS5 小时前
本地生活同城多商户商城系统源码源码 合伙人分红加区域代理加排队返现
前端·javascript·后端
奶油话梅糖5 小时前
3 天 1,705 Star:DeepSeek 开源官方聊天前端——零后端纯静态,浏览器直连 API
前端·开源
Linye5 小时前
HTML 流程图连线交叉看不清?聊聊画布避障折线与跳弧实现
前端·人工智能