Here's how to structure a "cel" addon so that the script and
necessary files are kept together.
1. Create a folder for the Addon.
2. Put the script and all its catalog files into that folder.
3. Within the Addon folder, create the folder "textures"
4. Within the textures folder, create the folder "medres"
5. Put your textures into the medres folder.
6. Add readme.txt to explain how to run the script.
7. Create a Zip archive.
8. Post it on a Web site.
That's all there is to it.
The complication is in the contents of one of the catalog files
and the names of the textures.
As an example, I'll use Bob's Jupiter Tour script and textures.
1. Within Celestia's extras folder create the folder "JupiterTour"
(Note that I try to avoid spaces in all names. They require quoting.
Quoting does NOT always work. In particular, Celestia does not remove
the quotes. It just complains about invalid commands.)
2a. copy the existing Gipul.ssc, JupiterTour.cel, and jupmoons.ssc
into the folder JupiterTour
2b. Create an SSC file which defines the version of Jupiter
that is needed by the script:
This SSC file must specify Rings and a high contrast surface texture.
Copy the description of Jupiter that's in solarsys.ssc into this new
SSC and add the new features.
I deleted unnecessary lines in order to keep this example short.
I renamed the jupiter surface texture image to make sure that
it was unambiguous. This was so I could be sure that Celestia wouldn't
load the first jupiter.jpg it found -- the low contrast texture
that comes with the program.
Celestia will happily draw this new Jupiter on top of the Jupiter that's
specified in the original solarsys.ssc. You just have to make sure that
the diameter of this Jupiter is slightly larger than Celestia's version.
Note that the EllipticalOrbit definition is irrelevant:
Celestia uses the CustomOrbit if it has one.
This Jupiter needs to follow *exactly* the same CustomOrbit path
as Celestia's Jupiter follows
so that it always hides Celestia's version.
A minor problem is that you'll see Jupiter listed twice
in the Solar System browser.
I can't get too excited about that, but some people might.
Both take you to the same place.
Code: Select all
"Jupiter" "Sol"
{
Texture "high-contrast-jupiter.*"
CustomOrbit "vsop87-jupiter"
Radius 71500 # equatorial diameter that's a trifle larger
Oblateness 0.0649
Rings {
Inner 92000
Outer 221000
Texture "JupiterRings.*"
}
RotationPeriod 9.927953 # System II (for GRS)
Obliquity 2.222461 # 1.82246 # 2.22246
EquatorAscendingNode -22.203 # -1.87785 # -22.203
RotationOffset 16 # for correct location of GRS
Albedo 0.51
}
3. Within the Addon folder, create the folder "textures"
4. Within the textures folder, create the folder "medres"
5. copy high-contrast-jupiter.jpg and JupiterRings.png into the folder medres.
Or instead you can create high resolution DDS files for them both.
6. Add readme.txt to explain how to install and run the script.
You might want to include something about how to create a desktop shortcut.
(See my previous post just above this one.)
You can't include one to be dragged to the desktop
because you can't be sure where Celestia will be.
7. Create a Zip archive which contains the folder JupiterTour,
not just the text files and textures directories.
8. Post it on a Web site.
9. Announce it to the Forum.
Here's a screenshot showing the directory layout and the files in them.
Does this help?
