# Camera组件
Camera组件是相机实体的必须组件,Camera组件不需要手动添加,创建相机实体时引擎会自动添加一个Camera组件。可以使用实体的isCamera属性判断是否是相机实体,使用实体的camera属性访问Camera组件。
注意
Camera组件和Transform组件无法同时添加到同一个实体。
# 属性
🌏 autoClippingDistance 是否自动更新远近裁剪面,只读。
// 获取是否自动更新远近裁剪面
const autoClippingDistance = entity.camera.autoClippingDistance;
1
2
2
🌏 cameraNode 关联的相机结点,只读。
// 获取THREE相机对象
const camera = entity.camera.cameraNode;
1
2
2
🌏 fov 视锥体垂直视野角度,单位:度。
// 获取fov角度
const fov = entity.camera.fov;
// 设置fov角度
entity.camera.fov = 45.0;
1
2
3
4
5
2
3
4
5
🌏 aspect 视锥体宽高比
// 获取视锥体宽高比
const aspect = entity.camera.aspect;
// 设置视锥体宽高比
entity.camera.aspect = 1.5;
1
2
3
4
5
2
3
4
5
🌏 near 近裁剪面距离
// 获取近裁剪面距离
const near = entity.camera.near;
// 设置近裁剪面距离
entity.camera.near = 0.1;
1
2
3
4
5
2
3
4
5
🌏 far 远裁剪面距离
// 获取远裁剪面距离
const far = entity.camera.far;
// 设置远裁剪面距离
entity.camera.far = 1500.0;
1
2
3
4
5
2
3
4
5
🌏 position 位置
// 获取位置
const position = entity.camera.position;
// 设置位置
entity.camera.position = [ 100.0, 0.0, 0.0 ];
1
2
3
4
5
2
3
4
5
🌏 rotation 旋转量
// 获取旋转量
const rotation = entity.camera.rotation;
// 设置旋转量
entity.camera.rotation = [ 0.0, Math.PI * 0.5, 0.0 ];
1
2
3
4
5
2
3
4
5
🌏 quaternion 旋转四元数
// 获取旋转四元数
const quaternion = entity.camera.quaternion;
// 设置旋转四元数
entity.camera.quaternion = [ 0.0, 0.0, 0.0, 1.0 ];
1
2
3
4
5
2
3
4
5
🌏 worldDirection 世界朝向,只读。
// 获取世界朝向
const worldDirection = entity.camera.worldDirection;
1
2
2
# 接口
🌏 isActive 判断相机组件是否已激活
// 判断相机组件是否已激活
const isActive = entity.camera.isActive();
1
2
2
🌏 lookAt 设置相机朝向
// 设置相机朝向
entity.camera.lookAt( [ 0.0, 0.0, 0.0 ] );
1
2
2
🌏 createViewpoint 创建视点
// 创建视点
const viewpoint = entity.camera.createViewpoint( '视点' );
1
2
2
🌏 goto 视点跳转
// 视点跳转
entity.camera.goto( viewpoint );
1
2
2