Celestia/Celx 脚本/CELX Lua 方法/CEL 命令集

设置

set { name <string> value <valuenumber> }

-- 或者 --

set { name <string> value <valuestring> }

将下面列出的项目之一设置为 value 参数中指定的值。

参数

name <string>

无默认值。必须是以下值之一

• MinOrbitSize
  当 Celestia 的渲染轨道选项打开时，此值将被使用。
  通常，当物体距离很远时，其轨道路径将不会显示。MinOrbitSize 是轨道路径必须覆盖的最小半径（以像素为单位），Celestia 才会绘制它。
• AmbientLightLevel
  等同于 setambientlight { brightness <valuenumber> } 命令。
  将环境光的亮度级别设置为指定的 <valuenumber>。必须在 0.0（最小值）到 1.0（最大值）范围内。默认值为 0。
  指定的值超出有效范围将被调整为最接近的有效值。
  为了真实感，这应该设置为 0.0。将其设置为 1.0 将导致远离太阳的星球的一侧看起来与亮的一侧一样亮。
• FOV
  视场。Celestia 计算此值相对于显示窗口的大小（以像素为单位）。
• StarDistanceLimit
  Celestia 显示恒星的最远距离。
  默认值为 1,000,000，但是，从 1.3.1 版本开始，Celestia 仅使用到 16,000 光年的距离。

value <valuenumber>

您想要分配给 name <string> 参数的数字值。默认值为 0.0。

-- 或者 --

参数

name <string>

无默认值。必须是以下值之一

• StarStyle
  这允许您设置 Celestia 在屏幕上显示恒星的方式。
  StarStyle 值必须是以下值之一
  • Fuzzypoints
  • Points
  • scaleddiscs

value <valuestring>

您想要分配给 name <string> 参数的字符串值。默认值为 ""。

CELX 等价物

基于五种不同的 Celestia 方法。

• 设置要渲染的轨道的最小尺寸。
  给定的 <valuenumber> 是轨道以像素为单位的最小尺寸。

celestia:setminorbitsize( <valuenumber> )

• 设置环境光的级别。
  给定的 <valuenumber> 是新的环境光级别，必须在 0 到 1 之间。

celestia:setambient( <valuenumber> )

• 设置此观察者的 FOV（视场）。
  将 <valuenumber> 从度数转换为弧度，方法是将 <valuenumber> 乘以 math.pi (= 3.14159265) 并除以 180，然后存储在 "fov_radians" 中。
  Lua 的 math.rad( <valuenumber> ) 函数也可以用于此。
  然后获取活动视图的观察者实例并设置 FOV。

fov_radians = math.rad( <valuenumber> )
obs = celestia:getobserver()
obs:setfov(fov_radians)

• 设置要渲染的恒星的最大距离。
  给定的 <valuenumber> 是最大距离。

celestia:setstardistancelimit( <valuenumber> )

• 设置恒星的渲染样式。
  给定的 <valuestring> 必须是 "fuzzy"、"point" 或 "disc" 之一。

celestia:setstarstyle( <valuestring> )

示例

CEL

set { name "MinOrbitSize" value 3 }
set { name "AmbientLightLevel" value 0.15 }           setambientlight { brightness 0.15 } 
set { name "FOV" value 35.5 }
set { name "StarDistanceLimit" value 2000000 }
set { name "StarStyle" value "points" }

CELX 使用 5 种不同的 Celestia 方法

celestia:setminorbitsize(3)
celestia:setambient(0.15)
celestia:getobserver():setfov(math.rad(35.5))
celestia:setstardistancelimit(2000000)
celestia:setstarstyle("points")

返回 CEL 命令索引