CameraHelper

CameraHelper——相机辅助助手，用于模拟相机视锥体的辅助渲染组件，如下图所示：

投射投影相机辅助助手

正交投影相机辅助助手

重要

• 在添加 CameraHelper 组件前请务必确保实体已经添加任一相机组件（PerspectiveCamera 或 OrthographicCamera）；
• CameraHelper 组件由 @fantasy3d/addons 包提供。

创建

import { Vector3, Vector4 } from 'three';
import { CameraHelper } from '@fantasy3d/addons';

// 创建一个透视投影相机
const perspectiveCamera = scene.createPerspectiveCamera( {

  // 相机实体方位属性
  transform: {

    position: new Vector3( 0.0, 5.0, 5.0 ),
    lookAt: new Vector3( 0.0, 0.0, 0.0 )

  },

  // 相机属性
  camera: { 
    
    near: 0.1,                          // 近裁剪面距离
    far: 1000.0,                        // 远裁剪面距离
    viewport: new Vector3( 0, 0, 1, 1 ) // 相机单位化渲染视口范围，xy视口左上角坐标，zw视口宽高，且所有值均在[ 0~1 ]区间内
  
  }

} );

// 添加相机助手组件
perspectiveCamera.addComponent( CameraHelper );

// 创建一个正交投影相机
const orthographicCamera = scene.createOrthographicCamera( {

    // 相机实体方位属性
    transform: { position: new Vector3( 0.0, 10.0, 40.0 ) },

    // 相机属性
    camera: {

        near: 1.0,                          // 近裁剪面距离
        far: 150.0,                         // 远裁剪面距离
        frustumSize: 50.0,                  // 相机视口尺寸
        viewport: new Vector4( 0, 0, 1, 1 ) // 相机单位化渲染视口范围，xy视口左上角坐标，zw视口宽高，且所有值均在[ 0~1 ]区间内

    }

} );

// 添加相机助手组件
orthographicCamera.addComponent( CameraHelper );