SarEngine2D

Document

SarEngine2D Camera

Camera

摄像机，用于捕获场景内一定范围内的图像并渲染到指定的输出接口。一个场景内至少应该有一个摄像机，可以在一个场景中添加多个摄像机，一个摄像机可以输出到多个输出接口，但一个输出接口只能与一个摄像机连接。

Syntax

//from global
var camera = new Camera(x, y);
//from SarEngine
var camera = new SarEngine.Camera(x, y);

Parameters

Number x
摄像机初始位置的横坐标。
Number y
摄像机初始位置的纵坐标

Properties

center
Position 表示该摄像机的中心所在的位置。
coordinate
Coordinate 表示该摄像机所在的坐标系。
outputList
Array 连接到该摄像机的输出接口的集合
position
Position 表示该摄像机的位置坐标。
rotation
Number 表示该摄像机的旋转弧度。
scene
Scene 表示该摄像机所在的场景。
viewCoordinate
Coordinate 表示该摄像机输出视图的坐标系，该坐标系相对屏幕静止，以输出屏幕的中心为原点，向右为x轴正方向，向下为y轴正方向，1单位对应1像素。
zoom
Number 表示该摄像机的缩放倍率。

Methods

addOutput(output)
向该摄像机添加输出接口。
applyTransform(graphics)
将摄像机视图变换应用到指定的Graphics绘图接口，以确保使用默认坐标系坐标进行绘图时呈现正确的位置。该函数由Scene在渲染前自动调用，如果需要手动强制渲染，必须在渲染到指定的绘图接口以前应用摄像机视图变换。
clear(bgColor)
清空摄像机的所有输出画面，并填充以指定的背景颜色。
copy()
复制一个相同的摄像机实例。
linkTo(linkableObject)
将摄像机连接到一个对象，这个对象可以是一个GameObject，也可以是另一个摄像机，链接后该摄像机将跟随目标移动和旋转。如果需要让摄像机盯着某个对象的话，这是个不错的方法。
map(x, y, output, coordinate)
将指定的输出视图上的点的坐标映射到指定的坐标系。
moveTo(x, y)
将摄像机移动至指定的位置。
removeOutput(output)
将指定的输出接口从该摄像机移除。
render(dt)
指定曝光时间捕获图像并渲染输出到该摄像机的所有输出接口。
renderTo(output, dt)
指定曝光时间捕获图像并渲染输出到指定的输出接口，该输出接口可以未连接到该摄像机。
resetTranform(graphics)
重设指定Graphics绘图接口的变换，等效于graphics.resetTransform()。
rotrate(rad, x, y)
将该摄像机绕定点旋转指定的弧度，若指定x和y，将默认绕中心旋转。
rotateTo(rotation, x, y)
将该摄像机绕定点旋转到指定的弧度，若指定x和y，将默认绕中心旋转。
unLink(linkableObject)
断开摄像机与指定对象之间的连接，在这之前，该摄像机必须曾调用linkTo连接到该指定的对象。
zoomTo(zoom, x, y)
将摄像机沿指定的缩放中心缩放到指定的倍率，若未指定x和y，将默认沿中心缩放。