这是本文档旧的修订版！

---

📚 Client/Camera

📒 Property

📘 Camera.Target

设置一个相机跟随对象（Entity），通常用于跟随Character\Vehicle，多数情况下应该优先使用此属性。

设置为null时则不跟随任何对象，转而跟随Camera.TargetPos坐标。

let target = Character.Find(0);
if(target != null) Camera.Target = target;

📘 Camera.TargetPos

设置一个相机目标位置坐标（Entity），如果TargetPos被激活设置，Camera.Target将会被自动置空（因为两个属性不能同时跟随兼容）。

如果Camera.Target存在对象，即使TargetPos属性不为空，也仍然只会跟随Camera.Target而不是Camera.TargetPos。

Camera.TargetPos = Vector(0, 0, 0);

📘 Camera.Offset

设置相机跟随对象的本地坐标偏移，默认为Vector(0, 0, 0)，可用于调整相机方向偏移。

Camera.Offset = Vector(0, 2, 0); //相机高度偏上2.0

📘 Camera.ForwardMode

设置相机向前跟随模式开关，激活后相机将始终向Target正前角度靠近。

注意：此选项需要Camera.Target存在目标才有意义。

Camera.ForwardMode = false; //bool

📘 Camera.VAngle

设置相机跟随的上下角度，默认为50.0（举例：设置90.0则为鸟瞰2D视角）。

Camera.VAngle = 50.0;

📘 Camera.HAngle

设置相机跟随的横向角度，默认为0.0。

Camera.HAngle = 0.0;

📘 Camera.Distance

设置相机跟随对象的距离，默认为10.0。

Camera.Distance = 10.0;

📘 Camera.DistanceSpeed

设置相机跟随对象距离的差值速度，默认为1.0。

（设置新的Distance值后多久到达新距离）。

Camera.DistanceSpeed = 1;

📘 Camera.SmoothTime

设置相机跟随对象的平滑（移动）间隔速度，默认为0.2（数值越小，速度越快）。

Camera.SmoothTime = 0.2;

📘 Camera.Sway

设置相机漫游摇晃幅度，默认为1.0。

Camera.Sway = 1.0;

📘 Camera.SwaySpeed

设置相机漫游摇晃速度，默认为0.1。

Camera.SwaySpeed = 0.1;

📘 Camera.Vignette

设置相机镜头边缘阴影（强度），默认范围0.0~1.0。

Camera.Vignette = 0.4;

📘 Camera.VignetteColor

设置相机镜头边缘阴影颜色，默认为黑色Color(0, 0, 0)。

Camera.VignetteColor = Color(0, 0, 0);

📘 Camera.LensLUT

设置相机镜头调色主题，默认范围0~10，设置为0则表示默认主题。

Camera.LensLUT = 0;

📘 Camera.IsInWater

获取相机是否在水中（水底状态）。

Camera.IsInWater: bool

📒 Static Function

📘 Camera.SetImageEffectActive()

设置指定屏幕后处理效果开关，详情参考《相机后处理效果》。

function Camera.SetImageEffectActive( id: int, active: bool )

📘 Camera.GetImageEffectActive()

获取指定屏幕后处理效果开关，详情参考《相机后处理效果》。

function Camera.GetImageEffectActive( id: int ): bool

📘 Camera.SetImageEffectProperty()

设置指定屏幕后处理效果属性配置（强度、偏移等），详情参考《相机后处理效果》。

function Camera.SetImageEffectProperty( id: int, option: int, value: any )

//设置模糊等级为3（比较模糊）的Blur屏幕高斯模糊效果。
Camera.SetImageEffectActive(0, true);
Camera.SetImageEffectProperty(0, 0, 3); //option0（表示设置的是【强度Intensity】），value3（表示设置值为3，越高越模糊）

📘 Camera.GetImageEffectProperty()

获取指定屏幕后处理效果属性配置（强度、偏移等），详情参考《相机后处理效果》。

function Camera.GetImageEffectProperty( id: int, option: int ): any | float