---
title: "镜头 Camera"
description: "镜头控制、偏移、淡入与结构地址"
---
---
title: 镜头 Camera
description: 镜头控制、偏移、淡入与结构地址
---
`sa` · 扩展 `CLEO+` · 需 CLEO + CLEO+
写法见 [Lua](/docs/cleo/syntax) / [Redux](/docs/cleo/syntax-redux)。
## 控制开关
开/关镜头旋转控制。
```text
0E60 SET_CAMERA_CONTROL
in: state
```
```lua
setCameraControl(true)
```
```js
Camera.setCameraControl(state)
```
## 当前模式
当前镜头模式。
```text
0E64 GET_CURRENT_CAMERA_MODE
out: mode
```
```lua
local mode = getCurrentCameraMode()
```
```js
const mode = Camera.getCurrentMode()
```
## 本地偏移 → 世界
镜头本地偏移 → 世界坐标。
```text
0EB2 GET_OFFSET_FROM_CAMERA_IN_WORLD_COORDS
in: offsetX, offsetY, offsetZ
out: x, y, z
```
```lua
local x, y, z = getOffsetFromCameraInWorldCoords(0.0, 1.0, 0.0)
```
```js
const { x, y, z } = Camera.getOffsetFromCameraInWorldCoords(offsetX, offsetY, offsetZ)
```
## 距离判定
镜头是否在坐标半径内。用在 `if` 里。
```text
0EBE LOCATE_CAMERA_DISTANCE_TO_COORDINATES
in: x, y, z, radius
```
```lua
if locateCameraDistanceToCoordinates(x, y, z, 10.0) then
end
```
```js
if (Camera.locateDistanceToCoordinates(x, y, z, radius)) {
}
```
## 淡入 alpha
当前淡入淡出 alpha（通常小于 255）。
```text
0EC7 GET_FADE_ALPHA
out: alpha
```
```lua
local a = getFadeAlpha()
```
```js
const alpha = Camera.getFadeAlpha()
```
## 第三人称目标线
第三人称镜头目标线：起点/终点（给定 range 与 source）。
```text
0F0E GET_THIRD_PERSON_CAMERA_TARGET
in: range, sourceX, sourceY, sourceZ
out: startX, startY, startZ, endX, endY, endZ
```
```lua
local sx, sy, sz, ex, ey, ez = getThirdPersonCameraTarget(range, x, y, z)
```
```js
const { startX, startY, startZ, endX, endY, endZ } =
Camera.getThirdPersonTarget(range, sourceX, sourceY, sourceZ)
```
## 活动旋转
活动镜头旋转。
```text
0F10 GET_ACTIVE_CAMERA_ROTATION
out: x, y, z
```
```lua
local rx, ry, rz = getActiveCameraRotation()
```
```js
const { x, y, z } = Camera.getActiveRotation()
```
## 结构地址
`TheCamera`（CCamera）与 ActiveCam（CCam）地址。
```text
0F12 GET_CAMERA_STRUCT
out: cCamera, activeCCam
```
```lua
local cam, active = getCameraStruct()
```
```js
const { cCamera, activeCCam } = Camera.getStruct()
```
## 旋转输入
镜头旋转输入值。
```text
0F14 GET_CAMERA_ROTATION_INPUT_VALUES
out: x, y
```
```lua
local ix, iy = getCameraRotationInputValues()
```
```js
const { x, y } = Camera.getRotationInputValues()
```
写镜头旋转输入。
```text
0F15 SET_CAMERA_ROTATION_INPUT_VALUES
in: x, y
```
```lua
setCameraRotationInputValues(ix, iy)
```
```js
Camera.setRotationInputValues(x, y)
```