# CubeCamera组件

使用CubeCamera组件可以动态生成立方体贴图用于环境贴图或其它场景效果。

import { CubeCamera } from '@tx3d/core';

// 创建一个空实体
const entity = engine.createEntity();

// 添加CubeCamera组件
const cubeCamera = entity.addComponent( CubeCamera, {

    resolution: 256,                // 立方体贴图分辨率,可选,默认256
    near: 0.1,                      // 立方体相机近裁剪面距离,可选,默认0.1,
    far: 100.0,                     // 立方体相机远裁剪面距离,可选,默认1000
    frames: 5,                      // 立方体相机可渲染的次数,默认Infinity
    syncEnviroment: true,           // 是否将渲染结果同步为当前激活场景的环境贴图,可选,默认false
    scene: othrerScene.transform,   // 立方体相机渲染使用的场景,可选,默认使用当前激活的场景
    preUpdate: () => {              // 立方体相机渲染更新前回调,可选

        // TODO:

    },
    postUpdate: () => {             // 立方体相机渲染更新后回调,可选

        // TODO:

    }

} );
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

注意

frames的值越大对性能的影响越大,除非是为了构建实时环境贴图,否则不要将frames设置为无限大!

提示

CubeCamera组件的初始化参数,详见CubeCameraParameters

# 属性

🌏 texture 获取立方相机渲染结果纹理,只读。

提示

有关CubeCamera组件的应用案例,请查看示例水泵场景车展场景

Last Updated: 7/4/2023, 11:28:27 AM