Celestia/SSC 文件

简介

Celestia 使用目录来定义其对象。它只在启动时加载一次 SSC 目录。首先按字母顺序加载其 data 目录中的目录，然后按字母顺序加载 extras 目录中的目录。

什么是 SSC 文件？

"Solar System Catalog" 文件主要用于定义恒星系统中可以找到的对象，例如行星、卫星、小行星、彗星和航天器。它们还有其他四种用途：它们可以定义替代表面纹理、物体上的位置以及轨道参考点。 SSC 文件还可以编辑在其他 SSC 目录文件中定义的对象。

对象通过指定一个带引号的名称、指向对象的带引号的路径以及参数列表来定义。对象类型由其参数中的 Class 语句指定，或者将从为其指定的半径推断出来。
替代表面通过在对象名称前加上关键字 AltSurface 来定义。它们的定义可以包含与表面纹理相关的任何参数。
位置标签通过在对象名称前加上关键字 Location 来定义。它们的定义使用特殊关键字。
轨道参考点仅在 Celestia v1.5.0 或更高版本中可用。它们通过在对象名称前加上关键字 ReferencePoint 来定义。它们的定义可以包含与轨道或轨迹相关的任何参数。
要编辑以前定义的对象，可以在对象名称前加上关键字 Modify 或 Replace 之一。修改后的定义可以包含用于定义对象的任何参数。

SSC 目录文件位于 Celestia 根目录的 "data" 目录或附加组件的根子目录（位于 Celestia 的 extras 目录中）中。

Celestia 的目录文件是纯文本文件，因此可以使用您最喜欢的文本编辑器进行修改。与其他代码一样，文本必须使用直引号（“哑”引号），而不是弯引号（“智能”引号）；对于某些文本编辑器，您需要禁用智能引号。

Celestia 使用文件 Celestia/data/solarsys.ssc 来定义我们自己太阳系中的大多数天体。

对象定义的结构

“物体名称” “物体路径” { ...参数... }

SSC 物体定义中的第一个元素是它的名称和它的“路径”。

物体名称 = 物体的名称，用引号括起来（例如，“水星”）。临时命名（例如，“S/2006 S 5”）是可以的，但不能有卫星（见下文："/" 字符会导致混淆）。从 Celestia 1.6.0 开始，允许多个名称用冒号分隔（“Eris:2003 UB313”）。

物体路径 = 指向该物体的中心天体的序列；换句话说，就是它绕行的天体。路径从恒星开始，然后向下延伸。

路径分隔符是斜杠 (“/”)。例如，“水星” 的路径只是 “太阳”。“罗慕路斯” 和 “瑞摩斯” 的路径，它们是小行星 “(87) 西尔维娅” 的卫星，都是 “太阳/(87) 西尔维娅”。月球着陆舱 (LEM) 在月球表面的路径将是 “太阳/地球/月球”。路径也用于 Celestia 的浏览器菜单。

由于 Celestia 使用了路径分隔符，所以只有临时命名知道的物体的名称可能需要以不同的方式表示，如果它们有卫星的话。或者，可以用“分数斜杠”（HTML "&frasl;" 或 "⁄" : "⁄"）或竖线 (“|”) 来表示斜杠 (“/”)。

物体的描述性参数位于大括号（“花括号”或“波浪括号”：{}）中。

表示颜色

颜色 [ R G B ]

颜色使用 RGB（红绿蓝）约定表示。0.0 到 1.0 范围内的三个数字中的每一个都代表该颜色分量的饱和度。[0.0 0.0 0.0] 是黑色，[1.0 1.0 1.0] 是白色，[1.0 0.0 0.0] 是纯红色，等等。

注释

#

井号（“十字交叉”或“井号”）开始注释：此符号后的任何内容直到下一个行终止符都会被 Celestia 忽略。

物体参数

下面是用于定义 SSC 物体的参数的字母顺序列表。其中一些参数本身需要在 {} 中使用另一个参数列表。

反照率 `f`

在 1.7 中已弃用

物体的邦德反照率：介于 0.0 到 1.0 之间的数字（从黑到白，从完美吸收体到完美反射体）。这决定了当物体太小而无法绘制时，用于表示物体的点的亮度。如果设置为 0，则永远不会绘制该物体。

1.7 之前版本中的实际计算将此参数视为几何反照率，因此在 1.7 中它被弃用并替换为 GeomAlbedo，旧的 Albedo 是 GeomAlbedo 的别名。为了表示邦德反照率，添加了一个新参数 BondAlbedo。

大气层 { ...参数... }

定义物体的环境。这不是 SSC 物体表面纹理的一部分。它被绘制在物体周围。大括号（“{ }”）中的可能参数如下（部分文本来自此论坛主题）

CloudMap “`文件名`”

云纹理（一个透明的 png 或 dds）。

有关更多信息，请参见页面 Celestia/纹理。

CloudNormalMap “`文件名`”

此功能需要 Celestia v1.5.0 或更高版本。

CloudNormalMap 为云图像的表面添加阴影，使其看起来凹凸不平。

有关更多信息，请参见页面 Celestia/纹理#云层法线贴图。

云高度 `f`

云层的海拔高度，以公里为单位。

云速度 `f`

云的速度，以公里/小时为单位（在直接旋转方向？）。

高度 `f`

大气的厚度，以公里为单位。此参数不会影响米氏/瑞利大气的渲染，但该值决定了 Celestia 是否费心渲染大气的垂直剖面。因此，较高的值使大气即使在很远的距离也能正确显示出来。

米氏 `f`

米氏散射光的量。它使大气呈现朦胧的外观，但我并不了解米氏理论。将值提高得太高会导致大气变得疯狂，而不是呈现厚实的外观。低值不能完全呈现稀薄大气的理想外观，例如冥王星。

米氏标高 `f`

几乎就是它说的意思。但似乎较高的值也会使大气变得疯狂地厚实，而不是仅仅在垂直方向上缩放它。

米氏不对称性 `f`

确定前向和后向散射光的量。

瑞利 [ `R G B` ]

由瑞利散射散射的红、绿、蓝光的量。实际上，它与 (1/波长)^4 成正比。使用 r=630nm、g=540nm 和 b=450nm，我得到相对强度 r:g:b = 0.260:0.482:1。此外，瑞利散射似乎使用 MieScaleHeight 参数作为标高。

吸收 [ `R G B` ]

吸收的红、绿、蓝光的量。

以下参数在 Celestia v1.5.0 及更高版本中已弃用。应该使用米氏和瑞利散射参数。

下层 [ `R G B` ]

接近地表的层大气颜色。

上层 [ `R G B` ]

接近顶部的层大气颜色。

天空 [ `R G B` ]

从内部大气看天空的颜色。

日落 [ `R G B` ]

日落颜色。

开始 `f` 或 "`YYYY MM DD HH:MM:SS`"

指定物体不存在的时间。

开始时间可以是一个浮点数，在这种情况下，它被解释为天文儒略日，或者它可以是一个带引号的字符串，在这种情况下，它被解释为公历日期。

如果它是一个带引号的公历日期，YYYY MM DD = 年、月、日（整数）；HH:MM:SS = 时、分、秒（整数）。从 1.3.1 版本开始，Celestia 在内部将这些时间戳转换为儒略日。一个日期到儒略日和回溯转换器可以在美国海军天文台找到。

BondAlbedo `f`

仅在 v1.7.0 或更高版本中可用。

物体的邦德反照率：0.0 到 1.0 之间的数字（黑色到白色，完美吸收器到完美反射器）。这决定了物体的温度。

BumpHeight `f`

默认值为 2.0，f 参数定义了Bumpmap 的垂直比例。

BumpMap "`文件名`"

用于生成浮雕的纹理文件（JPG、PNG 或 DDS）。

有关更多信息，请参见页面 Celestia/纹理。

BlendTexture `布尔值`

"布尔值" 参数为 true 或 false。BlendTexture 与"Color" 一起使用，对表面纹理图像进行着色。纹理的各个颜色通道乘以相应的颜色值。

类 "`类`"

物体类别：planet moon spacecraft comet asteroid invisible 之一。默认情况下，Celestia 会根据物体的半径来分配类别。它由 Celestia 的“视图选项”菜单使用，并确定为此天体绘制的轨道路径的颜色。您可以将人造卫星分配给“moon”类别，以便其轨道与真实卫星的轨道一起显示。类别为 invisible 的物体不会被绘制。它可以用作轨道重心，一个或多个可见物体绕其运行。

1.6.0 Celestia 1.6.0 添加了几个新的物体类别。物体类型的完整列表为

行星
卫星
矮行星
小行星卫星
小行星
彗星
航天器
表面特征
组件
漫射
不可见

Celestia 将行星、卫星、矮行星、小行星卫星和小行星视为相同，除非在 3D 窗口中显示标签和轨道路径，以及在太阳系浏览器中显示物体类别。物体是行星还是矮行星，可以根据国际天文联合会 2006 年关于行星定义的决议中规定的标准来决定。最终，这在 Celestia 中并没有太大的区别：天体的轨道和标签可以被不同地着色，但仅此而已。小行星不是国际天文联合会正式定义的类别，但在 Celestia 中，此类用于任何绕恒星运行的自然固体物体，其尺寸太小而不能成为矮行星（即它没有足够的质量来形成椭圆形），并且不是彗星。

卫星是绕行星运行的自然物体。卫星和小行星卫星之间的区别是任意的：火星的两颗小型卫星都被归类为卫星，而绕外行星运行的数十个类似大小的物体是小行星卫星。小行星卫星类别是为了消除绕太阳系外行星运行的岩石群的轨道带来的干扰；用户现在可以选择是否显示绕木星、土星、天王星和海王星运行的岩石群的轨道。

彗星与小行星非常相似，但在足够靠近太阳时会用尘埃尾部绘制，并用不同的颜色标记。太阳系中的一些物体既有彗星又有小行星的名称，例如 Chiron。这种双重分类在 Celestia 中是不可能的。

在太空中穿行的由人类制造的物体应被分配到航天器类别。除了影响标签和轨道颜色外，与自然物体相比，航天器显示的信息略有不同。表面特征类别应用于固定在行星、卫星或小行星表面的建筑物和其他地标。当物体在屏幕上占据的像素少于一个像素时，漂浮在太空中的物体被渲染为光点。这种效果对于行星表面的物体来说看起来不现实，因此默认情况下，它对表面特征被禁用。组件类别用于表面特征或航天器的部分，它们在 ssc 文件中被定义为单独的物体。与表面特征一样，它们在远处不会显示为光点。

漫射类别应用于气体云、尘埃羽流等。默认情况下，漫射物体无法通过点击选择。它们也无法在远处被标记或显示为光点。

类	可见	可见作为点	标记	可点击	行星光
行星	是	是	是	是	是
卫星	是	是	是	是	是
矮行星	是	是	是	是	是
小行星卫星	是	是	是	是	是
小行星	是	是	是	是	是
彗星	是	是	是	是	是
航天器	是	是	是	是	否
表面特征	是	否	是	是	否
组件	是	否	是	是	否
漫射	是	否	否	否	否
不可见	否	否	否	否	否

警告：LongLat 在 Celestia v1.5.0 及更高版本中与Class "surfacefeature" 一起使用时，无法正确放置物体。请改用FixedPosition [ x y z ] 或FixedPosition { Planetographic [ Long Lat Alt ] }。

颜色 [ `R G B` ]

当没有纹理时，对物体进行着色。还指定了当物体太小而无法解析时的反照率点的颜色。

R、G 和 B 的值应在 0 到 1 之间（含）。

自定义轨道 "`轨道名称`"

调用内置的高精度轨道计算，例如 "vsop87-mercury"。CustomOrbit 覆盖了 EllipticalOrbit。如果提供了无效的轨道名称，则忽略 CustomOrbit。

有关详细信息，请参阅 Celestia/Trajectories，CustomOrbit 部分。

EllipticalOrbit { ...参数... }

定义一个椭圆轨道（通用情况）。

EllipticalOrbit 参数对应于传统的开普勒轨道参数。这些参数的描述可以在 Astrodynamics WikiBook 中找到，在关于 Classical Orbit Elements 的章节中。

有关更多信息，请参阅 Celestia/Trajectories，EllipticalOrbit 部分。

离心率 `f`

可选地确定轨道的形状。事实上，EllipticalOrbit 这个名称有点误导，因为轨道可能是圆形、椭圆形、抛物线形或双曲线形，具体取决于离心率。

- 离心率 = 0 -- 圆形
- 0 < 离心率 < 1 -- 椭圆形
- 离心率 = 1 -- 抛物线形
- 离心率 > 1 -- 双曲线形

注意：在 Celestia 中，离心率恰好为 1 并不起作用。

如果没有提供离心率，则假定为圆形。

历元 `f` 或 "`YYYY MM DD HH:MM:SS`"

可选，轨道要素的历元 (f，它们有效的时间，可以使用数字指定，表示天文儒略日，也可以使用带引号的字符串指定，表示传统的格里高利日期。如果省略历元，则假定为 2000 年 1 月 1 日。

例如，
2452583.763194445 # 2002 年 11 月 5 日 06:19 UT（伽利略相遇）
与以下历元值相同：
"2002 11 5 6:19:00"

从 Celestia v1.5.0 开始，历元必须以 TDB 指定。有关 TDB 和 UTC 的更多信息，请参阅 Celestia/Time Scales。

半长轴 `f`

需要半长轴或近日点距离之一。对于绕恒星或质心运行的天体，轨道半长轴以天文单位 (AU) 为单位，对于其他所有天体，以公里为单位。

注意：双曲线轨道的半长轴为负值。

近日点距离 `f`

半长轴的替代项，以天文单位 (AU) 为单位，对于绕恒星或质心运行的天体，以公里为单位，对于其他所有天体，以公里为单位。

近日点幅角 `f`

可选，轨道的近日点幅角，以度为单位（从升交点测量）。指定 LongOfPericenter 或 ArgOfPericenter 之一，而不是两者都指定。如果两者都指定，则使用 ArgOfPericenter。

近日点经度 `f`

可选，轨道的近日点经度，以度为单位。这是近日点幅角和升交点经度的总和。指定 LongOfPericenter 或 ArgOfPericenter 之一，而不是两者都指定。如果两者都指定，则使用 ArgOfPericenter。

升交点 `f`

可选地定义轨道上运行天体“向上”或“向北”穿过参考平面的点的经度。它以度为单位从基本方向测量。如果未指定升交点，则假定值为 0 度。

倾角 `f`

可选轨道倾角，以度为单位。对于太阳系的行星，它是相对于黄道的，对于其他所有天体，它是相对于主星赤道的。从 Celestia v1.5.0 开始，可以指定许多不同的参考平面。有关详细信息，请参阅 Reference Frames。如果未指定倾角，则假定值为 0 度。

平近点角 `f`

可选，天体在历元的平近点角，以度为单位。这是自近日点以来经过的时间，除以轨道周期，再乘以 360 度。指定 MeanLongitude 或 MeanAnomaly 之一，而不是两者都指定。如果两者都指定，则使用 MeanAnomaly。

平黄经 `f`

可选，天体的平黄经，以度为单位。这是近日点经度和平近点角的总和。指定 MeanLongitude 或 MeanAnomaly 之一，而不是两者都指定。如果两者都指定，则使用 MeanAnomaly。

周期 `f`

必需，轨道周期以地球年为单位，对于绕恒星或质心运行的天体，以地球太阳日为单位，对于其他所有天体，以地球太阳日为单位。

对于绕我们太阳运行的封闭的椭圆轨道，

$P={\sqrt {(q/(1-e))^{3}}}$
或
$P=a^{1.5}$

在定义绕太阳运行的双曲线轨道时，将周期设置为

$P={\sqrt {(q/(e-1))^{3}}}$

其中

P

是以年为单位的周期，

q

是以 AU 为单位的近日点距离，

e

是偏心率，并且

a

是轨道长半轴，也以天文单位为单位测量，对于双曲线轨道则为负值。

Emissive `boolean`

指定物体是否应该发光 (true) 或被光源照亮 (false)。默认值为 false。

Emissive true 物体很亮，但不是光源。它们不会为其他物体提供任何照明，也不会导致它们投下阴影。

Ending `f` 或 "`YYYY MM DD HH:MM:SS`"

设置物体不再存在的时间。

Ending 时间可以是浮点数，在这种情况下它被解释为天文儒略日，也可以是带引号的字符串，在这种情况下它被解释为格里高利日期。

如果它是一个带引号的公历日期，YYYY MM DD = 年、月、日（整数）；HH:MM:SS = 时、分、秒（整数）。从 1.3.1 版本开始，Celestia 在内部将这些时间戳转换为儒略日。一个日期到儒略日和回溯转换器可以在美国海军天文台找到。

EquatorAscendingNode `f`

物体赤道平面升交点的度数。

此物体旋转参数在 Celestia v1.5.0 及更高版本中已弃用。

FixedPosition [ `f f f` ]

仅在 v1.5.0 或更高版本中可用。

轨道规范，将物体固定在相对于其 OrbitFrame 的固定位置。有关更多信息，请参阅有关轨道和轨迹的页面。

GeomAlbedo `f`

仅在 v1.7.0 或更高版本中可用。

物体的几何反照率。这决定了当物体太小而无法绘制时用来表示物体的点的亮度。如果设置为 0，则永远不会绘制物体。

HazeColor [ `R G B` ]

在 1.7 中删除

大气雾霾颜色。仅适用于 Nvidia 显卡。在 Celestia v1.5.0 中，可以使用 Atmosphere Mie 和 Rayleigh 散射参数，这些参数适用于所有支持 OpenGL v2.0 的显卡。

HazeDensity `f`

在 1.7 中删除

大气雾霾密度，介于 0.0 到 1.0 之间的数字。仅适用于 Nvidia 显卡。在 Celestia v1.5.0 中，可以使用 Atmosphere Mie 和 Rayleigh 散射参数，这些参数适用于所有支持 OpenGL v2.0 的显卡。

InfoURL "`URL`"

描述物体的网页的 URL。

LongLat [ `Long Lat Alt` ]

已过时 Celestia v1.5.0 及更高版本中已弃用

以前用于定义物体参考系中位置的位置。 Long 是东经（以度为单位），Lat 是纬度，Alt 是海拔（以公里为单位）。经度向东测量。西经可以指定为负值。

警告： 在 Celestia v1.5.0 及更高版本中，LongLat 与 OrbitFrame、SurfaceObject 或 Object "Surfacefeature" 一起使用时无法正确放置物体。使用 FixedPosition [ x y z ] 或 FixedPosition { Planetographic [ Long Lat Alt ] } 代替。

LunarLambert `f`

增加此值会改变光散射的方式。较高的值会导致更多光向前散射。参见右侧的图片以了解示例。

更准确地说，它对应于 Buratti 盘函数中的 $A$ 常数： $I/F=A{\frac {\mu _{0}}{\mu +\mu _{0}}}f(\alpha )+(1-A)\mu _{0}$ .^[1] 当 $A=0$ 时，此函数简化为朗伯散射定律，而 $A=1$ 对应于 Lommel-Seeliger（即月球状）散射。

默认值为 0。

Mesh "`filename`"

描述非球形物体的 3D 模型文件（cmod、cms 或 3ds）。如果未指定 **Mesh**，则假定该物体为球形。这些文件必须位于名为“\models”的目录中。**Texture** 可以覆盖到网格上。有关更多信息，请参见关于 3D 模型的页面。

MeshCenter [ `x y z` ]

网格相对于其中心的偏移量。

MeshScale `scaleFactor`

只有当物体具有网格文件且 NormalizeMesh 设置为 false 时，才会使用 MeshScale。它指定将网格的内部单位转换为公里的比例因子。例如，如果网格文件以米为单位给出坐标，则 MeshScale 应设置为 0.001。

MeshScale 0.001

当 NormalizeMesh 为 true（默认值）时，MeshScale 将被忽略，Celestia 会自动缩放网格以适合半径等于物体 Radius 属性值的球体内部。

NightTexture "`filename`"

物体的夜侧纹理（JPG、PNG 或 DDS；使用 PNG 或 DDS 以实现透明度）。

有关更多信息，请参见页面 Celestia/纹理。

NormalMap "`filename`"

用于描述表面不规则性的表面法线向量图。

有关更多信息，请参见页面 Celestia/纹理。

NormalizeMesh `boolean`

指定 Celestia 是否应将自动缩放和居中应用于网格文件。此属性默认情况下为 true。

在创建具有不同网格文件中的零件的多部件航天器时，覆盖网格的自动缩放很有用。Celestia 的自动缩放和居中会使组件相互对齐变得非常困难。当 NormalizeMesh 为 false 时，网格将按 MeshScale 属性指定的值进行缩放。Radius 属性不会影响网格的大小；它实际上只是给出物体的包围球的半径。插件创建者必须确保 Radius 足够大以包含缩放后的网格，否则 Celestia 可能会跳过渲染网格，即使它实际上处于视图中也是如此。

Oblateness `f`

未指定 **Mesh** 时，球形物体的扁率。扁率定义为 1 减去极径与赤道径之比。

Obliquity `f`

物体的旋转倾角，以度为单位。此属性的名称具有误导性：倾角是旋转轴与平均轨道平面法线之间的角度，但在 Celestia 中，此量是旋转轴与物体 *参考平面* 法线之间的角度，通常是行星的黄道。与“EquatorAscendingNode”一起，定义了旋转轴。

此物体旋转参数在 Celestia v1.5.0 及更高版本中已弃用。应改用新的旋转模型语法。

OrbitColor [ `R G B` ]

更改物体的轨道颜色。

OrbitFrame { ...parameters... }

仅在 v1.5.0 或更高版本中可用。

**OrbitFrame** 定义了 SSC 对象其他轨道参数的参考坐标系。有关详细信息，请参见关于轨道和轨迹的页面。

警告：在 Celestia v1.5.0 及更高版本中，**LongLat** 在与 **OrbitFrame** 一起使用时无法正确放置物体。请改用 **FixedPosition [ x y z ]** 或 **FixedPosition { Planetographic [ Long Lat Alt ] }**。

Orientation [ `angle x y z` ]

以角度-轴格式指定的网格方向。

**Orientation** 在应用旋转模型之前应用于模型。它通常用于将网格转换为不同的坐标系。与旋转模型不同，**Orientation** 不会影响物体的本体固定坐标系。

角度以度为单位（正或负）

x、y、z：1 或 0（1 表示相关的轴）

例如：Orientation [90 1 0 0] 表示绕 x 轴旋转 90°。

OverlayTexture "`filename`"

叠加在主纹理上的纹理（PNG 或 DDS 以实现透明度）。

有关更多信息，请参见页面 Celestia/纹理。

注意：Celestia v1.4.1 中存在一个错误，导致在选择 OpenGL 2.0 渲染路径时 OverlayTexture 不会被绘制。它们由其他渲染路径绘制。此问题在 Celestia v1.5.0 中已修复。

PrecessionRate `f`

旋转轴的岁差率，以弧度/天为单位。

此物体旋转参数在 Celestia v1.5.0 及更高版本中已弃用。应改用新的旋转模型语法。

Radius `f`

球形物体的赤道半径，以公里为单位。还会将 3D 模型缩放至指定大小。

SemiAxes [ `x y z` ]

指定椭球三个维度的尺寸。如果未指定 Radius 属性，则这些是物体的尺寸，如果指定了 Radius 属性，则为相对尺寸（SemiAxes 值乘以 Radius 值）。Celestia 中显示的半径是最长轴，而不是平均值。

Rings { ...parameters... }

描述物体的环。

Inner `f`

环的内缘，以公里为单位，从物体的中心算起。

Outer `f`

环的外边缘，以公里为单位，从物体中心算起。

纹理 "`filename`"

环的纹理（PNG 或 DDS 用于透明度）。

有关更多信息，请参见页面 Celestia/纹理。