LogoArcartX Doc

自定义相机

ArcartX自定义相机配置指南

理性和信仰如同两翼,助人飞向真理

相机系统

ArcartX提供了全面的自定义相机,包括自定义相机位置、八向移动相机、场景相机以及ALT巡视相机等功能。本文将详细介绍相机系统的配置和使用方法。

自定义相机位置

配置位置

相机预设配置位于ArcartX根目录中的 camera/preset 目录下。你可以创建多个yml配置文件来定义不同的相机预设。

每个预设配置文件都需要遵循特定的格式。配置项名将作为预设的唯一标识符(ID)。

预设配置示例

idle:
  # 相机偏移量设置
  offsetX: -0.7  # X轴偏移
  offsetY: 0     # Y轴偏移
  offsetZ: 10    # Z轴偏移
  
  # 八向移动相机开关
  enableFree: true
  
  # 过渡动画设置
  bezier:        # 贝塞尔曲线参数
    x1: 0.1
    y1: 0.25
    x2: 0.1
    y2: 0.25
  transition: 1000  # 过渡时间(毫秒)

默认设置

相机系统的默认设置位于 camera/setting.yml

# 相机功能总开关
enable: true
 
# 强制第三人称视角
force: true
 
# 默认使用的预设ID
default: "idle"

场景相机

场景相机用于实现复杂的相机运镜效果,通过配置多个步骤来实现相机的平移和旋转。

配置位置

场景相机配置位于ArcartX根目录中的 camera/scene 目录下。

配置示例

example:
  # 位置参数
  x: 0.0
  y: 0
  z: 10
  
  # 旋转参数
  yaw: 0.0
  pitch: 45
  
  # 动画参数
  bezier:
    x1: 0.1
    y1: 0.25
    x2: 0.1
    y2: 0.25
  transition: 1000  # 过渡时间(毫秒)
  keep: 5000       # 保持时间(毫秒)
  
  # 位置模式
  mode: 0          # 0=相对坐标,1=绝对坐标
 
example2:
  x: 0.0
  y: 0
  z: 20
  yaw: 0.0
  pitch: 45
  bezier:
    x1: 0.1
    y1: 0.25
    x2: 0.1
    y2: 0.25
  transition: 1000
  keep: 5000
  mode: 0

场景相机配置中的步骤会按照从上到下的顺序依次执行。每个步骤的名称可以自定义,但建议使用有意义的名称以便于管理。

其他功能

ALT巡视相机

ALT巡视相机功能默认开启,无需额外配置。玩家可以通过按住ALT键来自由查看周围环境。

API支持

你可以通过API或脚本来动态切换玩家的相机预设,实现更复杂的相机控制效果。

On this page