Read this manual in English

摄像机

Defold 的摄像机组件控制游戏世界的视口与映射. 摄像机组件定义了透视和平视的视口与映射矩阵用于渲染脚本进行渲染.

透视摄像机一般服务于 3D 游戏, 摄像机视口与物体透视基于视锥体, 摄像机到游戏物体的距离和视角.

平视摄像机一般服务于 2D 游戏. 摄像机视口不是基于视锥体, 而是基于视立方体. 平视摄像机中的物体不因距离远近而缩放. 1000米远的物体和摄像机面前的物体是等大的.

创建摄像机

要创建摄像机, 在游戏对象上 右键点击 选择 Add Component ▸ Camera. 或者先创建组件文件再链接到游戏对象上.

摄像机有以下属性用以建立 视锥:

Id

组件id

Aspect Ratio

(透视摄像机可用) - 视锥宽高比. 1.0 代表正方形视口. 4:3 显示器 1024x768 这样的分辨率用 1.33. 16:9 的显示器用 1.78. 如果设置了 Auto Aspect Ratio 则此属性无效.

Fov

(透视摄像机可用) - 以 弧度 表示的摄像机 垂直 视域. 视域越宽, 摄像机看到的内容越多. 注意目前默认值 (45) 有点误导. 要 45 度的视域, 要设置值为 0.785 (π / 4).

Near Z

近端裁剪平面z值.

Far Z

远端裁剪平面z值.

Auto Aspect Ratio

(透视摄像机可用) - 自动设置宽高比.

Orthographic Projection

切换摄像机为平视摄像机 (见下文).

Orthographic Zoom

(基于平视摄像机) - 正交透视倍数 (> 1 = 放大, < 1 = 缩小).

使用摄像机

通过调用 camera.acquire_focus 函数或者向组件发送 acquire_camera_focus 消息, 激活摄像机并填充视口同时向渲染脚本提供映射矩阵:

camera.acquire_focus("#camera")

或者

msg.post("#camera", "acquire_camera_focus")

被激活的摄像机, 会在每一帧向 “@render” 接口发送 set_view_projection 消息, 也就是说渲染脚本会接收此消息:

-- builtins/render/default.render_script
--
function on_message(self, message_id, message)
    if message_id == hash("set_view_projection") then
        self.view = message.view                    -- [1]
        self.projection = message.projection
    end
end

1. 这个消息中包含一个视口矩阵和一个映射矩阵.

摄像机组件支持基于摄像机属性 Orthographic Projection 的, 使用透视或者平视透视矩阵的渲染脚本. 投射矩阵还参考了定义好的远近裁切平面和摄像机的视角及宽高比.

摄相机提供的视图矩阵定义了摄相机的位置和方向. Orthographic Projection 的摄像机基于其父游戏对象的位置居中视口, 而 Perspective Projection 的摄像机会基于其父游戏对象的位置确定视口左下角的位置.

可以用以下代码告诉渲染脚本使用摄像机提供的透视:

msg.post("@render:", "use_camera_projection")

摄像机平移

平移摄像机所在游戏对象就相当于平移摄像机. 摄像机会根据当前x和y坐标更新视口矩阵.

摄像机缩放

延 z 轴移动透视摄像机所在游戏对象就相当于缩放摄像机. 摄像机会根据当前z坐标更新视口矩阵.

可以通过设置平视摄像机的 Orthographic Zoom 属性来进行缩放:

go.set("#camera", "orthographic_zoom", 2)

摄像机跟随

把摄像机对象放在要跟随的游戏对象子级就能实现摄像机跟随:

或者自己写脚本每帧更新摄像机位置也可以.

鼠标位置转换为世界坐标

摄像机平移缩放后 on_input() 函数提供的鼠标位置就不再与世界坐标匹配了. 此时需要进行手动矫正. 把鼠标/屏幕坐标转换到世界坐标的代码如下:

-- 从屏幕坐标变换到世界坐标
-- @param sx 屏幕 x
-- @param sy 屏幕 y
-- @param sz 屏幕 z
-- @param window_width 窗口宽度 (使用 render.get_width() 或 window.get_size().x)
-- @param window_height 窗口高度 (使用 render.get_height() 或 window.get_size().y)
-- @param projection Camera/render 映射 (使用 go.get("#camera", "projection"))
-- @param view Camera/render 视口 (使用 go.get("#camera", "view"))
-- @return wx 世界 x
-- @return wy 世界 y
-- @return wz 世界 z
local function screen_to_world(sx, sy, sz, window_width, window_height, projection, view)
	local inv = vmath.inv(projection * view)
	sx = (2 * sx / window_width) - 1
	sy = (2 * sy / window_height) - 1
	sz = (2 * sz) - 1
	local wx = sx * inv.m00 + sy * inv.m01 + sz * inv.m02 + inv.m03
	local wy = sx * inv.m10 + sy * inv.m11 + sz * inv.m12 + inv.m13
	local wz = sx * inv.m20 + sy * inv.m21 + sz * inv.m22 + inv.m23
	return wx, wy, wz
end

参见 示例页面 的屏幕坐标到世界坐标转换实例. 还有一个 实例项目 介绍了屏幕坐标到世界坐标的转换.

运行时控制

可以通过一些消息和属性控制运行时的摄像机 (用法参考 API 文档).

摄像机的一些属性可以通过 go.get() 和 go.set() 控制:

fov

摄像机视野 (number).

near_z

摄像机近端Z值 (number).

far_z

摄像机远端Z值 (number).

orthographic_zoom

平视摄像机缩放 (number).

aspect_ratio

自从 Defold 1.4.8 加入. 视口宽高比. 在计算透视摄像机投射时使用. (number).

view

自从 Defold 1.4.8 加入. 摄像机视口矩阵值. 只读. (matrix4).

projection

自从 Defold 1.4.8 加入. 摄像机投射矩阵值. 只读. (matrix4).

第三方摄像机解决方案

社区制作了一些摄像机插件实现了屏幕抖动, 对象跟随, 屏幕与世界坐标转换等摄像机功能. 可以在 Defold 资源大厅找到:

• Ortographic camera (仅 2D) 由 Björn Ritzl 开发.
• Defold Rendy (2D 和 3D) 由 Klayton Kowalski 开发.