Threejs源码系列- WebGLRenderer (3)projectObject函数

WebGLRender - projectObject函数

projectObject函数,作用是递归遍历场景中的 3D 对象,筛选出需要渲染的对象并将其添加到渲染列表(currentRenderList)中。

js 复制代码
function projectObject( object, camera, groupOrder, sortObjects ) {
 // ...
}

参数说明

  • object:当前处理的 3D 对象(可能是模型、灯光、组等)。
  • camera:当前渲染使用的相机,用于可见性判断和深度计算。
  • groupOrder:当前对象所属组的排序值,用于控制渲染顺序。
  • sortObjects:是否需要计算对象深度以用于排序(影响透明/不透明对象的渲染顺序)。

关键逻辑解析

可见性过滤
js 复制代码
// 对象自身不可见,直接跳过
if (object.visible === false) return; 
// 检查对象层级是否在相机可见层级内
const visible = object.layers.test(camera.layers);
Group类型
js 复制代码
   
    if (object.isGroup) {
        // 更新组排序值,子对象继承该排序
        groupOrder = object.renderOrder; 
    } 
LOD类型
js 复制代码
 if ( object.isLOD ) {
    // 根据相机距离更新显示的细节层级
    if (object.autoUpdate === true) object.update(camera); 
} 
Light类型
js 复制代码
if ( object.isLight ) {
    // 将光源加入渲染状态,用于后续光照计算
    currentRenderState.pushLight( object );
    // 若光源投射阴影,加入阴影列表
    if ( object.castShadow ) {
        currentRenderState.pushShadow( object );
    }
}
Sprite类型
js 复制代码
 if ( object.isSprite ) {
    // 未开启视锥体剔除,或精灵在相机视锥体内
    if ( ! object.frustumCulled || _frustum.intersectsSprite( object ) ) {
        if ( sortObjects ) {
            // 计算精灵在屏幕空间的 z 坐标(用于排序)
            _vector4.setFromMatrixPosition( object.matrixWorld ).applyMatrix4( _projScreenMatrix );
        }
        // 更新精灵的几何数据
        const geometry = objects.update( object );
        const material = object.material;
        if (material.visible) {
            // 将精灵加入渲染列表
            currentRenderList.push(object, geometry, material, groupOrder, _vector4.z,null);
        }
    }
}
Mesh类型、Line类型、Points类型
js 复制代码
// 未开启视锥体剔除,或对象在相机视锥体内
if ( ! object.frustumCulled || _frustum.intersectsObject( object ) ) {
    // 更新几何体数据(如缓冲、绑定等)
    const geometry = objects.update(object); 
    const material = object.material;

    if ( sortObjects ) {
        // 计算对象在屏幕空间的 z 坐标(用于排序)
        if ( object.boundingSphere !== undefined ) {
            // 优先使用对象自身的包围球
            if ( object.boundingSphere === null ) object.computeBoundingSphere();
            _vector4.copy( object.boundingSphere.center );
        } else {
            // 否则使用几何体的包围球
            if ( geometry.boundingSphere === null ) geometry.computeBoundingSphere();
            _vector4.copy( geometry.boundingSphere.center );
        }

        // 转换到屏幕空间
        _vector4.applyMatrix4( object.matrixWorld ).applyMatrix4( _projScreenMatrix );
    }

    // 处理多材质情况(几何体分组对应不同材质)     
    if ( Array.isArray( material ) ) {

        const groups = geometry.groups;

        for ( let i = 0, l = groups.length; i < l; i ++ ) {

            const group = groups[ i ];
            const groupMaterial = material[ group.materialIndex ];

            if ( groupMaterial && groupMaterial.visible ) {

                currentRenderList.push( object, geometry, groupMaterial, groupOrder, _vector4.z, group );

            }

        }

    } else if ( material.visible ) {
        // 单一材质,直接加入渲染列表
        currentRenderList.push( object, geometry, material, groupOrder, _vector4.z, null );
    }
}
处理子元素
js 复制代码
const children = object.children;

for ( let i = 0, l = children.length; i < l; i ++ ) {

    projectObject( children[ i ], camera, groupOrder, sortObjects );

}
相关推荐
Flynt17 小时前
AI 写的 Three.js 大屏,为什么越跑越卡?我在 Node 里复现了它的内存曲线
前端·ai编程·three.js
福狼1 天前
The Expanse:让风沙成为世界的一部分
前端·three.js
西伯利亚小火龙7 天前
我以为是流体解算,结果只是一张贴图:复刻 Lusion 的屏幕流体特效
webgl·three.js
浪浪山_大橙子8 天前
被1.4 MB的射击游戏震撼后,我认真拆了一遍Fable的实现
ai编程·游戏开发·three.js
魂断蓝桥6669 天前
如何用 three.js 把 3D 消防演练落到一栋楼里——第一课:场景搭建与火情定位
webgl·three.js·3d建筑·物联网3d·、3d工厂、3d工业园区、智慧制造、智慧工业、智慧工厂·3d定位、三维室内定位、3d建筑·3d消防
莪_幻尘9 天前
4 个 3D 游戏,总体积 3.82MB:拆解 Claude 的 one-shot 工程链路
前端·ai编程·three.js
誰在花里胡哨11 天前
Qoder + Blender MCP:对话建模到网页渲染
ai编程·three.js·mcp
Chen73215 天前
WebGPU 性能优化:Three.js 千万级点云调度与渲染实践
性能优化·three.js
柳杉15 天前
没有写一行代码:我用 Codex 制作 了一个 3D 智慧展厅可视化大屏
前端·ai编程·three.js
只睡四小时16 天前
Three.js Sub-tick:漏判 60.7%→0
开发语言·javascript·性能优化·ecmascript·游戏开发·three.js·碰撞检测