This translation is community contributed and may not be up to date. We only maintain the English version of the documentation. Read this manual in English
Defold 的摄像机组件控制游戏世界的视口与映射. 摄像机组件定义了透视和平视的视口与映射矩阵用于渲染脚本进行渲染.
透视摄像机一般服务于 3D 游戏, 摄像机视口与物体透视基于视锥体, 摄像机到游戏物体的距离和视角.
平视摄像机一般服务于 2D 游戏. 摄像机视口不是基于视锥体, 而是基于视立方体. 平视摄像机中的物体不因距离远近而缩放. 1000米远的物体和摄像机面前的物体是等大的.
要创建摄像机, 在游戏对象上 右键点击 选择 Add Component ▸ Camera. 或者先创建组件文件再链接到游戏对象上.
摄像机有以下属性用以建立 视锥:
π / 4
).通过调用 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
摄像机组件支持基于摄像机属性 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
number
).far_z
number
).orthographic_zoom
number
).aspect_ratio
number
).view
matrix4
).projection
matrix4
).社区制作了一些摄像机插件实现了屏幕抖动, 对象跟随, 屏幕与世界坐标转换等摄像机功能. 可以在 Defold 资源大厅找到:
Did you spot an error or do you have a suggestion? Please let us know on GitHub!
GITHUB