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/紋理。