Selden's 3DS Billboard Meshes for Celestia

0.0: Introduction.
1.0: Flat Billboards.
2.0: Using Flat Billboards.

2.1: Using "billboard.png".
2.2: Making a Different Flat Billboard.
2.3: Creating a Flat Billboard for Carina.

3.0: Problems with the Flat Billboard.
4.0: Some Background.
5.0: Some Flat Examples.

5.1: Hoag's Object.
5.2: Eta Carina Nebula.
5.3: NGC 3372.
5.4: Horsehead Nebula Region.
5.5: Some Planetary Nebulae.

6.0: Aligning Pictures and Objects.

6.1: An Alignment Procedure.
6.2: Axis and Angle adjustment details

7.0: Some 3D Billboards.

7.1: A Pie-Plate Galaxy.
7.2: A Sphere to map the Sky.

7.2.1: The Infra-Red Milky Way
7.2.2: The H-alpha Sky

8.0: Acknowledgements.
Appendices.

A.1: Signature.
A.2: Admonishment.
A.3: Disclaimer.


---

See also:
• Selden's List of Resources for Celestia
• Billboards in CMOD text format

---

This technique is obsolete. Please use CMOD models instead, as described in billboard-cmod.html

---

From Webster's Revised Unabridged Dictionary (1913)

Billboard \Bill"board`\, n.
   1. (Naut.) A piece of thick plank, armed with iron plates,
      and fixed on the bow or fore channels of a vessel, for the
      bill or fluke of the anchor to rest on. --Totten.

   2. A flat surface, as of a panel or of a fence, on which
      bills are posted; a bulletin board.

Here are some simple 3DS object models. By changing their surface texture image maps, you can use them to show colorful pictures of deep space objects in Celestia. They're billboards in space!

Simple ASCII CMOD models also are available. Unlike 3DS models, they can be modified using any text editor. See billboard-cmod.html

Celestia v1.3 and later let you create Deep Space Catalogs (.DSC files). You can use them to define the locations of Nebulae. They consist of 3D models with appropriate shapes and surface textures.

Unfortunately, making three dimensional Nebulae that look right from all directions can be rather difficult. We only know what most nebulae look like from here on Earth. We really don't know what their other sides look like. Radio telescopes have provided hints about some of their shapes, though.

These "billboards" let you display a photograph instead of a three dimensional shape. The pictures will only look right in Celestia when seen from the vicinity of the Earth, of course. If you travel far away from the Earth, they'll be distorted.

• billboard.3ds (1KB, 5April2003)
  This 3DS model is a flat, square object that can hold any square picture you want to display in Celestia.

• billboard2.3ds (1KB, 6Dec03)
  Provided by "Jim" Jens, this is a rectangular, flat billboard, proportioned 2x1. You can use it with images that are twice as long as they are wide. Right now it specifies the surface texture name "NGC4594.jpg". You'll probably want to change that. See Section 2.2 below.

  The zip archive below includes the square 3DS billboard object and a sample billboard image. The 3DS object itself is less than 1KB. The ZIP file is much larger because of the size of the sample image and its alpha channel.

• billboard.zip (1.1MB, updated 21May2003 with a more accurate orientation for Hoag's Object)

  ---

  Archive:  billboard.zip
    Length     Date   Time    Name
   --------    ----   ----    ----
        365  06-18-03 10:47   billboard/billboard.dsc
      55215  06-18-03 10:46   billboard/billboard.html
          0  05-21-03 20:16   billboard/models/
          0  05-21-03 20:16   billboard/textures/
        710  04-05-03 13:01   billboard/models/billboard.3ds
          0  05-21-03 20:16   billboard/textures/medres/
    2375783  04-11-03 23:03   billboard/textures/medres/billboard.png
   --------                   -------
    2432073                   7 files
  

  ---

2.1: Using "billboard.png".

As an example,
1. billboard.dsc defines a nebula named "Billboard".
2. The "Billboard" Nebula definition specifies the 3D model "billboard.3ds".
3. Inside the 3D model file billboard.3ds it specifies the name of the surface texture map billboard.png. This is the picture you want to see.

Here's billboard.dsc:
This was updated on 18Jun03 with revised Axis, Angle and InfoURL values provided by Grant Hutchison.

---

---

#Hoag's Object
Nebula "Billboard" {
    Mesh     "billboard.3ds"
    Axis  [-0.235944 0.829369 0.343357]
    Angle  152.350
    Distance 6.0e+8
    RA  15.3208  # 15h 17m 17s
    Dec  21.57917 # 21deg 34' 45"
    Radius  60000
    InfoURL  "http://heritage.stsci.edu/2002/21/fast_facts.html"

}

---

The name "Billboard" is just being used as an example. There is no real nebula with that name.

2.2: Making a Different Flat Billboard.

In order to use this 3DS model for different objects in Celestia, ones not called "Billboard", you have to copy the model file, creating a new .3ds file in a models directory. Each copy of the model must be given a different name.

You also have to edit the new 3DS file to change the name of the texture image file that it looks for. Currently it specifies billboard.png. You cannot use most text editors to make this change because of the binary codes in the model file. A binary editor like HexEdit can be used, but I found that Emacs works quite well.

Simple ASCII CMOD models also are available. Unlike 3DS models, they can be modified using any text editor. See billboard-cmod.html

The image filename in the 3DS model file is a null-terminated string. When using Emacs, I found that I could use any length filename I wanted. If you use this object only with Celestia, the texture name doesn't have to be exactly the same length as in the original file. Apparently, however, most 3D programs can't decode this model unless the name is precisely 8.3 characters. Note that "billboard.png" is 9.3.

You don't have to specify a PNG image file, of course. Celestia will happily render a .JPG or .DDS file just as well. However, the image file does need to be in a directory named textures/medres.

2.3: Creating a Flat Billboard for Carina.

For example, if you wanted to display an image of a portion of the Eta Carina nebula, do the following:
1. Acquire a picture of the Carina Nebula.
2. Using your favorite picture editor, create a new version of the picture that is square and a power of two on a side. For example, create a picture that is 1024x1024.
3. Save your new picture of the Carina Nebula in your directory textures/medres as carina.jpg
4. Create a DSC file named carina.dsc in your extras directory, containing the following Nebula definition:

   carina.dsc:

   ---

   
   # Eta Carina Nebula (detail)
   #
   # the "billboard" picture used with this definition is derived from
   # a NASA/STScI image found on the Web (see below)
   #
   Nebula "Carina" {
       Mesh     "carina.3ds"
   	Axis [ 0.517248 -0.0448043 0.854662 ]
   	Angle 149.296
       Distance   8000
       RA        10.7454 # 10h 44m 46s
       Dec      -59.6487 #-59deg 38' 56"
       Radius     4.55
       InfoURL "http://hubblesite.org/newscenter/archive/2000/06/fastfacts"
   }
   

   ---

5. Copy the file billboard.3ds to carina.3ds in your models directory.
6. Using your favorite binary file editor, change the filename inside carina.3ds from billboard.png to carina.jpg
7. Start Celestia and GoTo Carina
8. Enjoy the sight!

Bear in mind that this .DSC file provides the coordinates of a tiny portion of the Carina Nebula, corresponding to the picture taken by the Hubble telescope. You'll have to use different coordinates if you use a different picture. See below for the coordinates used for a picture of the whole nebula.

Note:

If you use both Carina Nebula definitions, combine both .DSC files into one. Make sure that NGC 3372 is defined first, before Carina. That will ensure that the larger image is drawn first, behind the smaller one.

1. This billboard model file cannot be read by 3D modelling programs unless the filename is 8.3 characters: 8 letters in the name of the file, 3 letters in the filetype, with a dot between them.

2. A problem in Celestia is that Nebula models are not depth sorted. Instead, they are drawn on your screen in the order that you define them or in the order that Celestia happens to read their .DSC files. If overlapping Nebula models are declared in separate files. often they are drawn in the wrong order. When they overlap, you may not be able to see the one that is supposed to be closest to you. However, when you declare them in the same .DSC file, the model that is declared first in that .DSC file is drawn first, the second one is drawn on top of the first one, etc. At least that way you have some control over which ones are visible from a particular viewpoint.

3. When you GoTo a Billboard object, Celestia often overshoots. I suspect the extreme aspect ratio (100x100x1) may be confusing it. If it thinks you are inside the object, various parts of the billboard get clipped off. In some cases, the whole thing will be invisible. Typing a "C" (center) or "T" (track) command and then backing away from it usually makes the billboard visible again.

4. In the past, another difficulty for me has been getting the correct values for the Axis and Angle directives so the billboard is properly oriented and face-on to the line-of-sight from Earth. A recent insight made it much easier, though. The details are a little too complicated to go into right here. See 6.0: Aligning Pictures and Objects below.

The 3DS model that I've created for use as a billboard is a flattened cube, 100x100x1 units on a side. The Z dimension is minimized to eliminate the X and Y faces. The Z faces are the ones where Celestia draws the surface texture. Only the pixels at the edges of the texture image are drawn on the X and Y faces. The actual size the billboard object doesn't matter, only its proportions. Celestia scales it to match the radius you specify in the .DSC file. The 3DS model could just as well have been 1000x1000x10.

When seen from the front, the image on the positive Z face is upright. The image is reversed on the back of the billboard object. As a result, the picture seems to be embedded inside the billboard. The billboard object is thin enough that it's effectively invisible when seen from the sides.

The example surface texture file billboard.png that I've supplied happens to be an image of Hoag's Object. The image that Celestia renders is somewhat fainter than it should be. The greyscale alpha channel is transparent where there should be dark obscuring dust clouds, since the conversion software cannot distinguish between darkness due to obscuration and darkness due to the lack of stars. Producing a proper alpha channel for Hoag's Object is left as an exercise for the artist. If someone does produce a good transparency channel, I'll be glad to include it here.

Below are pictures of the billboard in use. Each of the pictures is a link to much larger image.

5.1: Hoag's Object

Image	Comments
Billboard Image: Hoag's Object	Note that this image is slightly fainter than the primary layer of the texture below. Cel:// URL for this viewpoint Hoag's Object
Billboard Surface Texture: Hoag's Object	These texture maps were derived from a Hubble picture. See the acknowledgements below. billboard.png (1024x1024, 2.4MB) billboard-1k.jpg (1024x1024, 100KB) hoag-1k.dds (1024x1024, 1.4MB, DXT3) hoag-2k.dds (2048x2048, 5.5MB, DXT3) These PNG and DDS files include an Alpha transparency channel, but the JPG file does not.

• billboard.3ds (1KB)
  This is the 100x100x1 "billboard" mesh described above. Its texture has not been changed. It specifies the texture map billboard.png. Rename an appropriate PNG image or edit this mesh file to use a different picture.

• billboard.dsc

  ---

  #Hoag's Object
  Nebula "Billboard" {
      Mesh     "billboard.3ds"
          Axis [-0.293399 0.89844 0.326684 ]
          Angle 165.499
      Distance   6.0e+8
      RA          15.3208  # 15h 17m 17s
      Dec         21.57917 # 21deg 34' 45"
      Radius     60000
      InfoURL   "http://heritage.stsci.edu/2002/21/table.html"
  }
  

  ---

  After you've installed these, your directory structure should look something like this:

  ---

  [-] Celestia130
      --- data
      [-] extras
       |  [-] addons
       |      [-] billboard
       |           -- billboard.dsc
       |          --- models
       |               -- billboard.3ds
       |          [-] textures
       |              --- medres
       |                   -- billboard.png
      --- models
      [+] textures
  

  ---

  For an explanation of why your directories should be organized like this, please see
• A (not so) Brief Introduction to Add-Ons (2nd edition)

---

5.2: Eta Carina Nebula (detail)

Image	Comments
Earth in the Carina Nebula	This image was not generated by cheating, as a previous version was. To see this and similar dramatic views, one only has to find the right combination of viewpoint and telescopic magnification. Aye, there's the rub. Unfortunately, adjusting Celestia's viewpoint is extremely difficult at high magnifications. This image was finally acquired by first aligning the Earth's orbit and then letting the planet drift across the field of view. Cel:// URLs for Earth and the Nebula Each is progressively closer to the detailed Hubble picture. This looks best if you also install the definition below for NGC 3372. Earth in the constellation of Carina NGC 3372 in Carina Keyhole Eta Car Carina Nebula (detail) Earth in the Carina Nebula
Carina Nebula Detail	This texture map was derived from a Hubble image showing details of a portion of the nebula. See the acknowledgements below. carina-1k.jpg (1024x1024, 84KB) carina-2k.jpg (2048x2048, 333KB) carina-2k.dds (2048x2048, 5.5MB, DXT3) The DXT3 file includes an alpha channel to trim off the black borders.

• carina.3ds (1KB)
  This is the same 100x100x1 "billboard" mesh described above. Only its texture has been changed. It specifies the texture map carina.jpg. Rename an appropriate JPEG image or edit this mesh file to use a different picture.

• carina.dsc (1KB, updated 21May2003 with a more accurate orientation for the detailed picture)

  ---

  
  # Eta Carina Nebula (detail)
  #
  # the "billboard" picture used with this definition is derived from
  # a NASA/STScI image found on the Web (see below)
  #
  Nebula "Carina" {
      Mesh     "carina.3ds"
  	Axis [ 0.517248 -0.0448043 0.854662 ]
  	Angle 149.296
      Distance   8000
      RA        10.7454 # 10h 44m 46s
      Dec      -59.6487 #-59deg 38' 56"
      Radius     4.55
      InfoURL "http://hubblesite.org/newscenter/archive/2000/06/fastfacts"
  }
  

  ---

  After you've installed these, your directory structure should look something like this:

  ---

  [-] Celestia130
      --- data
      [-] extras
       |  [-] addons
       |      [+] billboard
       |      [-] Carina
       |           -- carina.dsc
       |          --- models
       |               -- carina.3ds
       |          [-] textures
       |              --- medres
       |                   -- carina.jpg
      --- models
      [+] textures
  

  ---

  For an explanation of why your directories should be organized like this, please see
• A (not so) Brief Introduction to Add-Ons (2nd edition)

---

5.3: Eta Carina Nebula: NGC 3372

Image	Comments
Earth in NGC 3372	Cel:// URL for this viewpoint: Earth in NGC 3372
NGC 3372	This texture was derived from the image 02192.tiff. Credit: NOAO/AURA/NSF. For details, see the acknowledgements below. ngc3372-1k.jpg (241KB) ngc3372-2k.dds (5.5MB DXT3) The dds texture includes an Alpha channel to trim off the black borders.

• ngc3372.3ds (1KB)
  This is the same 100x100x1 "billboard" mesh described above. Only its texture has been changed. It specifies the texture map ngc3372.jpg. Rename an appropriate JPEG image or edit this mesh file to use a different picture.

• ngc3372.dsc (1KB, updated 21May2003 with a more accurate orientation for NGC 3372)

  ---

  # NGC 3372
  #
  # The accompanying images of NGC3372 were derived from 02192.TIFF
  # at http://www.noao.edu/image_gallery/html/im0061.html
  # Original tiff image credit:
  # "National Optical Astronomy Observatory/
  # Association of Universities for Research in Astronomy/
  # National Science Foundation" 
  #
  # According to http://www.noao.edu/image_gallery/copyright.html
  # their images may be used freely for
  # educational outreach activities composed by amateur astronomers.
  # 
  Nebula "NGC 3372" {
      Mesh     "ngc3372.3ds"
   	Axis [-0.206916 0.153726 0.966206]
  	Angle 154.5
  	Distance   8500
  	RA      10.7345 
  	Dec      -59.752
  	Radius     219
  	InfoURL "http://www.noao.edu/image_gallery/html/im0061.html"    
  }
  
  

  ---

  After you've installed these, your directory structure should look something like this:

  ---

  [-] Celestia130
      --- data
      [-] extras
       |  [-] addons
       |      [+] billboard
       |      [+] Carina
       |      [-] NGC3372
       |           -- ngc3372.dsc
       |          --- models
       |               -- ngc3372.3ds
       |          [-] textures
       |              --- medres
       |                   -- ngc3372.jpg
      --- models
      [+] textures
  

  ---

  For an explanation of why your directories should be organized like this, please see
• A (not so) Brief Introduction to Add-Ons (2nd edition)

  Note:

  If you use both Carina Nebula definitions, combine both .DSC files into one. Make sure that NGC 3372 is defined first, before Carina. That will ensure that the larger image is drawn first, behind the smaller one.

• carina.zip (4MB, 21May2003)

  The file carina.dsc in this zip archive includes the declarations for both NGC 3372 and the detailed Hubble picture of Carina.

  ---

  Archive:  carina.zip
    Length     Date   Time    Name
   --------    ----   ----    ----
          0  05-21-03 22:24   carina/
          0  05-21-03 22:24   carina/models/
        711  04-13-03 19:27   carina/models/carina.3ds
        712  05-21-03 22:29   carina/models/ngc3372.3ds
          0  05-21-03 22:24   carina/textures/
          0  05-21-03 22:24   carina/textures/medres/
    5592560  04-13-03 19:28   carina/textures/medres/carina-2k.dds
    5592560  04-13-03 15:00   carina/textures/medres/ngc3372-2k.dds
       1315  05-21-03 22:15   carina/carina.dsc
   --------                   -------
   11187858                   9 files
  

  ---

---

5.4: Horsehead Nebula Region

Image	Comments
Seeing Barnard 33 past Pan	Cel:// URLs for Pan and the Nebula: Pan and Orion Barnard 33 (vertical: North up) Barnard 33 (horizontal: West up) Closeup of Barnard 33 Barnard 33 is also known as the Horsehead Nebula. The following are points-of-view to help align the other nebulae in Orion. UKS 23 M42
Horsehead Region	These textures were derived from an astrophotograph taken by Walter Koprolin. They are provided here with his kind permission for use with Celestia. For details, see the acknowledgements below. horsehead_region-1k.jpg (1024x1204, 120KB) horsehead_region-2k.dds (2048x2048, 2.5MB) horsehead_region-4k.dds (4096x4096, 11MB) NOTE: Your graphics card must have a 4K texture buffer in order to be able to display this image. My understanding is that only Nvidia cards have 4K buffers. ATI cards do not. These DDS files are in DXT1c format. They do not contain an Alpha channel.

• b33.3ds (1KB)
  This is the same 100x100x1 "billboard" mesh described above. Only its texture has been changed. It specifies the texture map b33.jpg. Rename an appropriate JPEG image or edit this mesh file to use a different picture.

• b33.dsc (1KB; updated 22May03 to improve its orientation.)

  ---

  #Horsehead Nebula in Orion
  #
  # the "billboard" picture used with this definition is derived from
  #a photograph of the Horsehead Nebula Region taken by Walter Koprolin,
  # Austria, Europe: http://www.nightsky.at/
  #
  Nebula "Barnard 33" {
      Mesh     "b33.3ds"
  	Axis [ -0.641856 0.38352 -0.664029 ]
  	Angle 132.636
      Distance   1600
      RA          5.69
      Dec        -2.35
      Radius     40.3
  }
  

  ---

  After you've installed these, your directory structure should look something like this:

  ---

  [-] Celestia130
      --- data
      [-] extras
       |  [-] addons
       |      [+] billboard
       |      [+] Carina
       |      [+] NGC3372
       |      [-] B33
       |           -- b33.dsc
       |          --- models
       |               -- b33.3ds
       |          [-] textures
       |              --- medres
       |                   -- b33.jpg
      --- models
      [+] textures
  

  ---

  For an explanation of why your directories should be organized like this, please see
• A (not so) Brief Introduction to Add-Ons (2nd edition)

---

5.5: Some Planetary Nebulae.

Image	Comments
Four Planetary Nebulae	Cel:// URLs for these viewpoints: NGC 2346 NGC 2392 NGC 2440 NGC 6369

pn.zip (300KB, update: 25May03)

This ZIP archive contains pn.dsc and four billboard models and their associated pictures. They provide the planetary nebulae images shown above. It was updated on May 25th to precisely align the images of the nebulae.

After you've installed this archive, your directory structure should look something like this:

---

[-] Celestia130
    --- data
    [-] extras
     |  [-] addons
     |      [+] billboard
     |      [+] Carina
     |      [+] NGC3372
     |      [+] B33
     |      [-] pn
     |           -- pn-readme.txt
     |           -- pn.dsc
     |          --- models
     |               -- ngc2346.3ds
     |               -- ngc2392.3ds
     |               -- ngc2440.3ds
     |               -- ngc6369.3ds
     |          [-] textures
     |              --- medres
     |               -- ngc2346.jpg
     |               -- ngc2392.jpg
     |               -- ngc2440.jpg
     |               -- ngc6369.jpg
    --- models
    [+] textures

---

For an explanation of why your directories should be organized like this, please see
• A (not so) Brief Introduction to Add-Ons (2nd edition)

This only works for DSC objects, not for objects defined in an SSC file.

One way to get the orientation and position correct for a remote astronomical object being represented by a Nebula is to properly orient a photograph and then match your model to the picture.

These adjustments are needed because the accepted astronomical coordinates of an object usually are nowhere near the centroid either of its photograph or of the model that you've designed.

6.1: An Alignment Procedure.

In summary:

1. Place a photograph of the nebula, including the surrounding stars, within Celestia.
2. Observe the photograph from a viewpoint near the Earth
3. Align the picture face-on to the viewpoint.
4. Adjust your object's size and position to match the starry background
5. Repeat steps 3 and 4 as necessary.

In detail:

1. Place a photograph of the nebula, including the surrounding stars, within Celestia.

   My "Billboard" object can be used for this, or you can construct one of your own. See above.

2. Observe the photograph from a viewpoint near the Earth

   Use a telescopic viewpoint from the vicinity of the Solar System to look at your picture. E.g.: Goto Earth, Track object, increase magnification with the "," command until the object fills your field of view appropriately.

3. Align the picture face-on to the viewpoint.

   You'll need to set the Axis and Angle of the picture's DSC definition so the image is face-on to the solar viewpoint. Then you'll have to rotate it into the correct position against the background stars. You can use Celestia's builtin positioning tool to do the initial alignment or you can use a spreadsheet provided by Grant Hutchison. This spreadsheet is much more accurate for setting the initial orientation, but you'll probably need to use Celestia's builtin positioning tool to set the final rotation angle. Too many astronomical pictures are not aligned north-south.

   Here's the procedure using Celestia's builtin positioning tool:

   • Run Celestia so it creates a log file:
     .\celestia --verbose > align.log
     • Type the key pair "Shift-~" to enable edit mode (Celestia v1.3.1pre9 or older)
       or
     • Type the key pair "Shift-2" (@) to enable edit mode (Celestia v1.3.1pre10 or newer)
     • Hold down Control-Shift Left-Mouse-Button and use the mouse to adjust the object's x-y orientation.
     • Hold down Control-Shift Right-Mouse-Button and use the mouse to adjust the object's Z-axis rotation orientation.
     • Type the key pair "Shift-!" to save your final Axis and Angle values to align.log
   • Exit Celestia
   • Type align.log
   • Put the Axis and Angle values you see there into your object's .DSC file.

   If these instructions are too cryptic, please take a look at the 6.2: Axis and Angle adjustment details below.

4. Adjust your object's size and position to match the starry background

   Edit the object's DSC file. Restart Celestia after each edit. Change the RA, Dec and Radius values until the stars of the photograph precisely match those which Celestia draws in that region. There's no reason to adjust the distance. That's the least well known of any of the parameters. Once the distance has been set to a reasonable value, changing the radius of the object is all that's needed to make the object's size appropriate.

   You have to exit and restart Celestia each time you modify the DSC file. I usually use a Cel://URL to restart Celestia with the appropriate viewpoint, with the object selected and centered.

5. Repeat steps 3 and 4 as necessary.

   Sometimes moving the object will change its location enough that it no longer directly faces the solar system. This makes it harder to line up with the stars around it. Realigning the object's Z axis may help.

Sometimes there simply aren't enough stars in Celestia near the object you're trying to align. In some cases I've had to install Pascal's 2 million star database in order to have enough stars nearby. This extended database is available at http://perso.wanadoo.fr/celestia.stars/index.html.

Another way to get enough alignment stars is to use a larger picture of the area which includes many stars.

One source of pictures of large or small areas of the northern sky is http://virtualsky.org/. You can center the sky map on the object you're working with and then zoom in until you get a reference image of the right size.

Align the larger picture to Celestia's stars, then align the smaller picture on the larger one. This is easiest if you use a translucent image: a PNG or DDS image with an alpha channel.

I've found that using an alpha channel that's a greyscale version of the image being aligned works quite weil. The stars are white, so they're opaque, while the darker spaces between the stars become more or less transparent. As a result, it's easy to see the stars of the background picture through the picture being aligned.

When working with more than one picture billboard, put the ones that cover a larger area first in the DSC file. Pictures that cover a smaller area should be later in the same DSC file. This ensures that larger pictures are drawn before smaller ones. The ones drawn last will seem to be in front of the earlier ones. This is necessary because Celestia does not yet depth-sort Nebula objects. If it did, you could just declare them at appropriate distances and the order wouldn't matter.

Once you've managed to get your photograph(s) oriented correctly, add your 3D model as the final object in that same DSC file. This makes Celesia draw your Nebula model last, in front of the pictures.

Then use the same procedures as above to change the model's orientation and position (Axis, Angle, RA, Dec and Radius) until it precisely matches the photograph.

Finally, you can comment out the DSC entry for the photograph and your model will be shown at the right location in space.

6.2 Axis and Angle adjustment details

Although mouse movements can be used to adjust an object's orientation, trying to align the object to properly face the earth can be quite frustrating. Not only does the object often rotate in quite unexpected directions, but finding exactly the right direction for the object to face sometimes can be difficult.

If you've created your models similarly to the way I created the Billboard, then the Z face is the one you want facing toward the Solar System. Celestia's rotational adjustment assumes this is the case.

To orient your object properly, you need to point the normal vector of the positive Z surface toward the viewpoint.

Although this jargon sounds complicated, thinking about it in these terms can be used to simplify how one does the alignment. Below is a solution that I came up with after thinking about it this way.

You can avoid this this manual Z-axis adjustment, at least for setting the initial orientation of your object, if you use the spreadsheet provided by Grant Hutchison.

Briefly, you should align a long, skinny object instead of the relatively flat or round object that you've designed. It will be properly aligned when you've positioned the the object's Marker in the center of the relatively small front (Z) surface of that long, skinny object while you're looking at it from the solar system. The resulting Axis and Angle values can then be used to properly orient the real object.

The alignz.zip archive below contains a 3DS model of a long, skinny box which has a small Z surface covered by an alignment pattern.

• alignz.zip (23KB, updated 8Jun03: new alignment pattern)

  ---

  Archive: alignz.zip
    Length     Date   Time    Name
   --------    ----   ----    ----
          0  06-08-03 14:53   alignz/
        425  06-08-03 17:22   alignz/alignz.dsc
          0  06-08-03 14:53   alignz/models/
        710  05-20-03 05:40   alignz/models/alignz.3ds
          0  06-08-03 14:53   alignz/textures/
          0  06-08-03 14:53   alignz/textures/medres/
      18382  06-08-03 15:16   alignz/textures/medres/12345678.jpg
       8392  06-08-03 17:32   alignz/alignz-readme.txt
   --------                   -------
      27909                   8 files
  

  ---

You can follow the following steps to simplify positioning of your object:
• Modify the file alignz.dsc to contain the desired position of the object you're creating for Celestia.
• Run Celestia so it creates a log file:
  .\celestia --verbose > align.log
  In other words:
  • Open a command window (sometimes misnamed a DOS window)
  • cd to the directory where you put Celestia
  • type the command
    .\celestia --verbose > align.log

    .\celestia
    means "run the program in this directory that's named celestia"

    --verbose
    means "create a log of debugging messages"

    >
    means "send the log output to the file name which follows"

    align.log
    is the name of the log file that you want Celestia to create. You can use any file name you want. I chose "align.log"

  ---

  Here's an example of what I see in the command window when doing this for one of the add-ons I'm working on. For clarity, what Windows types is shown in green, what I type is in black. Windows doesn't actually use different colors.

  ---

  Microsoft Windows XP [Version 5.1.2600] 
  (C) Copyright 1985-2001 Microsoft Corp. 
  
  C:\Documents and Settings\Selden>e: 
  
  E:\>cd "Program Files\Celestia131p5" 
  
  E:\Program Files\Celestia131p5>.\celestia --verbose > align.log 
  
  E:\Program Files\Celestia131p5> 
  

  ---

  ---

• Wait for Celestia to open its window
• Enable Markers with the Control-K command.
• Select alignz and view it telescopically from the solar system
• Use Celestia's builtin alignment controls to center alignz's Marker on its alignment grid.
  • Type the key pair "Shift-~" to enable edit mode (Celestia v1.3.1pre9 or older)
    or
  • Type the key pair "Shift-2" (@) to enable edit mode (Celestia v1.3.1pre10 or newer)
  • Hold down Control-Shift Left-Mouse-Button and use the mouse to adjust the object's x-y orientation until the Marker is centered on the grid.
  • Hold down Control-Shift Right-Mouse-Button and use the mouse to adjust the object's rotation orientation until the object is correctly aligned with the Celestial coordinate system. (Requires Celestia v1.3.1pre3 or later.)
  • Type the key pair "Shift-!" to save your final Axis and Angle values to align.log
• Exit Celestia
• Type align.log
• Put the Axis and Angle values you see there into your object's .DSC file.

  ---

  ---

  E:\Program Files\Celestia131p5>type align.log 
  Opened registry key 
  Using joystick: Microsoft PC-joystick driver 
  nStars: 112523 
  . 
  . 
  Parent body 'TYC 5503-946-1' of 'b' not found. 
  . 
  . 
  Initializing ARB vertex programs . . . 
  Loading ARB vertex program: shaders/diffuse_arb.vp 
  Loading ARB vertex program: shaders/specular_arb.vp 
  Loading ARB vertex program: shaders/haze_arb.vp 
  Loading ARB vertex program: shaders/bumpdiffuse_arb.vp 
  Loading ARB vertex program: shaders/bumphaze_arb.vp 
  Loading ARB vertex program: shaders/shadowtex_arb.vp 
  Loading ARB vertex program: shaders/diffuse_texoff_arb.vp 
  Loading ARB vertex program: shaders/rings_arb.vp 
  Loading ARB vertex program: shaders/ringshadow_arb.vp 
  Loading ARB vertex program: shaders/night_arb.vp 
  Loading ARB vertex program: shaders/glossmap_arb.vp 
  All ARB vertex programs loaded successfully. 
  render path: 5 
  Trying DDS: ./extras/seb/lmc/textures/medres/lmc-2123.dds 
  Trying DDS: ./extras/seb/lmc/textures/medres/phot-05a.dds 
  Trying DDS: ./extras/seb/lmc/textures/medres/30dor_hst_big.dds 
  lmc-2123 
  Orientation: [0.0625254,0.0255321,0.997717], 182.961 
  Saving preferences . . . 
  Opened registry key 
  
  E:\Program Files\Celestia131p5> 
  

  ---

  The line starting with "Orientation" is the one to be inserted into the .DSC file. The line above it shows the name of the object. The Orientation has to be edited to become

  ---

  Axis  [0.0625254 0.0255321 0.997717] 
  Angle 182.961 

  ---

  In words: replace "Orientation" by "Axis", replace the commas "," by spaces " ", and insert "Angle" before the last number. Putting the "Angle" on a separate line is optional.

7.1: A Pie-Plate Galaxy.

Here's a simple pie-plate billboard model that can be used to hold pictures of your favorite spiral galaxies. Deapite the name, it works just as well for other images.

Image	Comments
NGC 4622	Cel:// URL: NGC 4622 as seen from the Solar System
NGC 4622 closeup	The DDS texture map used for this image was derived from a Hubble image of NGC 4622. See the acknowledgements below. Cel:// URL: Visiting NGC 4622 ngc4622.dds (1.5MB)
NGC 4622 using a specific 3D model.	The 3d model specifically for NGC 4622: ngc4622-4.3ds (2.2MB) Cel:// URL: NGC 4622 closeup

• ngc4622.3ds (crude pie-plate: 440KB, 10May03)

• ngc4622.zip (1.1MB)

  ---

  Archive: ngc4622.zip
    Length     Date   Time    Name
   --------    ----   ----    ----
          0  05-10-03 09:01   ngc4622/
          0  05-10-03 09:02   ngc4622/models/
     442386  05-10-03 12:50   ngc4622/models/ngc4622.3ds
        710  05-01-03 19:30   ngc4622/models/ngc4622-c.3ds
          0  05-10-03 09:02   ngc4622/textures/
          0  05-10-03 09:02   ngc4622/textures/medres/
    1398256  05-10-03 12:37   ngc4622/textures/medres/ngc4622.dds
      38762  05-01-03 19:33   ngc4622/textures/medres/ngc4622-c.jpg
        727  05-10-03 13:38   ngc4622/ngc4622.dsc
        449  05-10-03 12:58   ngc4622/ngc4622-sat.sscno
        867  05-10-03 13:31   ngc4622/ngc4622.html
   --------                   -------
    1882157                   11 files
  

  ---

---

7.2: A Sphere to map the Sky.

This add-on requires Celestia v1.3.1 prerelease 3 or later. It doesn't work with earlier versions of the program. In particular, it does not work with v1.3.0. Sorry.

Here is a sphere with its surface normal vectors reversed, which can be used to as a screen on which to project maps of the sky. It's like having a planetarium within Celestia.

• mw-msx.3ds (26K, updated 16Jun03)
  (this is a sphere which specifies the surface texture mw-msx-2k.png)

  3D display systems only draw surfaces if their surface normal vectors point toward the observer. Usually a sphere's surface normals point outward, so 3D display programs seem to draw an image of the outside of the sphere. With the normals reversed, you see the inside of the sphere instead. The side closest to you, which normally would be opaque, is now transparent because its normals are pointed away from you. The far side of the interior, which normally would not be drawn, both because it would have been hidden by the front surface and because its normals point away from you, is now visible.

  7.2.1: The Infra-Red Milky Way

  Here's an example showing a map of galactic Infrared emissions against the Milky Way.

  Image	Comments
  The MSX IR Mosaic Map of the Milky Way	Cel:// URL: The MSX IR Mosaic Map of the Milky Way
  The fire this time: MSX IR map of the Milky Way	Cel:// URL: The fire this time: MSX IR map of the Milky Way
  The MSX IR Mosaic Map surface texture	mw-msx-2k.png (360KB, 16Jun03) The PNG texture map used for this image was derived from a mosaic of the infrared sky produced by the Midcourse Space Experiment. See the acknowledgements below. There are several things to note about this surface texture. The surface texture map is a mirror image of the original. This is because it's to be shown on the inside of the sphere instead of the outside. This left-to-right reflection is needed for all texture maps used with this model. This is a PNG file with an alpha channel. It's transparent everywhere you see black in the thumbnail image. It's square in order to preserve resolution in the vertical direction. The original mosaic was 4Kx120. That's not much resolution. The surface texture map should have 0 degrees of longitude in the center in order to align with the center of the Milky Way.

  These files were updated on 16Jun03 with a correctly oriented model of the sphere and with a new map which corresponds to that orientation.

• mw-msx.3ds (26K, updated 16Jun03)
  (this is a sphere which specifies the surface texture mw-msx-2k.png)

• mw-msx.zip (350KB, updated 16Jun03)

  ---

  Archive:  mw-msx.zip
    Length     Date   Time    Name
   --------    ----   ----    ----
          0  06-14-03 17:15   mw-msx/
        907  06-14-03 17:19   mw-msx/mw-msx.html
       1978  06-16-03 20:05   mw-msx/mw-msx-readme.txt
          0  06-14-03 17:15   mw-msx/models/
      26103  06-16-03 19:28   mw-msx/models/mw-msx.3ds
          0  06-14-03 17:15   mw-msx/textures/
          0  06-14-03 17:15   mw-msx/textures/medres/
     359778  06-16-03 19:46   mw-msx/textures/medres/mw-msx-2k.png
        873  06-16-03 19:49   mw-msx/mw-msx.dsc
   --------                   -------
     389639                   9 files
  

  ---

  Here's the contents of mw-msx.dsc:

  ---

  Nebula "mw-msx" {
  	Mesh "mw-msx.3ds"
   	Axis [-0.409897 0.623875 0.665406]
  	Angle 217.369
  	RA 17.76033
  	Dec -28.936172
  	Distance 2
  	Radius 10000
  	InfoURL "http://irsa.ipac.caltech.edu/applications/MSX/galplane.html"
  }

  ---

  These Axis, Angle and position values precisely align the sphere with the galactic plane. The center of the sphere is slightly offset from the solar system in order to avoid numeric problems. 2 LY out of 10,000 isn't noticable at all.

---

7.2.2: The H-alpha Sky

Here's another example showing the all-sky distribution of ionized Hydrogen gas clouds by the light of the Hydrogen-alpha line.
• h-alpha_v1.zip (3.3MB, 19Sep03)

  Image	Comments
  Various H-alpha regions Sorry: the large version of this picture had o be taken down. MySpace doesn't seem to understand the concept of "theft of bandwidth". Contact me if you'd like a copy of the full-sized image.	Celestia multi-view image showing several H-alpha regions Top half: Sagittarius region, including several Messier objects to the left. Bottom left: the Large Magellenic cloud Bottom right: The Orion Nebula and its surroundings. The sky map surface texture used for this image is a translucent "4K" DDS/DXT3 image (11MB) NOTE: Your graphics card must have a 4K texture buffer in order to be able to display this image. My understanding is that only Nvidia cards have 4K buffers. ATI cards do not.
  H-alpha all-sky map	An opaque jpeg map of H-alpha regions h-alpha-a.jpg (316KB, 19Sep03) Note: this "-a" image is a "4K" surface texture map. 4Kx2Kx4 = 32MB. In order to use this, you'll need to have a graphics card with more than 32MB of memory. NOTE: Your graphics card must have a 4K texture buffer in order to be able to display this image. My understanding is that only Nvidia cards have 4K buffers. ATI cards do not. h-alpha-2k.jpg (128KB, 24Sep03) "2K" = 8MB. h-alpha-1k.jpg (45KB, 24Sep03) "1K" = 2MB.
  H-alpha in Orion	Looking at the opaque map of H-alpha in the Orion region, showing how extensive the Orion Nebula complex is. M42/M43 is just a tiny portion of it. They're buried in the lower of the two white spots which are just below the center of this picture. They're centered between the horns of the crescent (Barnard's Loop).

• h-alpha_v1.zip (3.3MB, 19Sep03)

  ---

  Archive:  h-alpha_v1.zip
  
    Length     Date   Time    Name
   --------    ----   ----    ----
          0  09-19-03 18:18   h-alpha_v1/
          0  09-19-03 18:18   h-alpha_v1/models/
      26267  09-19-03 22:01   h-alpha_v1/models/h-alpha.3ds
      26269  09-19-03 22:23   h-alpha_v1/models/h-alpha-a.3ds
          0  09-19-03 18:18   h-alpha_v1/textures/
          0  09-19-03 18:18   h-alpha_v1/textures/medres/
   11184976  09-19-03 21:43   h-alpha_v1/textures/medres/h-alpha.dds
     316998  09-19-03 22:20   h-alpha_v1/textures/medres/h-alpha-a.jpg
        734  09-19-03 22:22   h-alpha_v1/h-alpha.dsc
       1133  09-19-03 22:30   h-alpha-readme.txt
   --------                   -------
   11556377                   10 files
  

  ---

• The billboard objects were created by Selden Ball using Anim8or. Anim8or was written by Steve Glanville.

• The "Hoag's Object", "Carina" and "NGC 4622" images used with the billboards above were derived from pictures published on the Web at http://hubblesite.org/newscenter/archive/2000/06/ (Carina Nebula), http://heritage.stsci.edu/2002/21/table.html (Hoag's Object), and http://hubblesite.org/newscenter/archive/2002/03/image/a (NGC 4622). Credit for the original images goes to NASA and the Hubble Heritage Team ( AURA / STScI).

• The texture for NGC 3372 was derived from the image 02192.TIFF, available at http://www.noao.edu/image_gallery/html/im0061.html. The credit for this picture goes to "National Optical Astronomy Observatory/ Association of Universities for Research in Astronomy/ National Science Foundation." According to the NOAO copyright page at http://www.noao.edu/image_gallery/copyright.html, their images may be used freely for "educational outreach activities composed by amateur astronomers". That's what this is.

• The image of the Horsehead Nebula Region was taken by Walter Koprolin, Austria, Europe: http://www.nightsky.at/ For exposure data, a short description and some observing hints for this object, see his Horsehead's page at http://www.nightsky.at/Photo/Neb/B33_WN.html

• Credit for the original Planetary Nebulae images goes to NASA and the Hubble Heritage Team ( AURA / STScI).

• The mw-msx map was taken from an MSX (Midcourse Space Experiment) mosaic which can be seen on the Web at http://irsa.ipac.caltech.edu/applications/MSX/MSX/galplane.html

  Creation of the mw-msx map made use of data products from the Midcourse Space Experiment. Their processing of the data was funded by the Ballistic Missile Defense Organization with additional support from NASA Office of Space Science.

  This creation has also made use of the NASA/ IPAC Infrared Science Archive, which is operated by the Jet Propulsion Laboratory, California Institute of Technology, under contract with the National Aeronautics and Space Administration.

• The H-alpha map was derived from the combined Virginia Tech Spectral line Survey (VTSS) and the Southern H-Alpha Sky Survey Atlas (SHASSA) by Douglas Finkbeiner et al. For more information, see http://astro.princeton.edu/~dfink/halpha/.

  According to the NASA SkyView Web site, the original map is in the public domain. (See http://skyview.gsfc.nasa.gov/cgi-bin/survey.pl#halpha_co.) I could find no copyright statements on the H-alpha site. mentioned above.

Contents

0.0: Introduction.
1.0: Flat Billboards.
2.0: Using Flat Billboards.

2.1: Using "billboard.png".
2.2: Making a Different Flat Billboard.
2.3: Creating a Flat Billboard for Carina.

3.0: Problems with the Flat Billboard.
4.0: Some Background.
5.0: Some Flat Examples.

5.1: Hoag's Object.
5.2: Eta Carina Nebula.
5.3: NGC 3372.
5.4: Horsehead Nebula Region.
5.5: Some Planetary Nebulae.

6.0: Aligning Pictures and Objects.

6.1: An Alignment Procedure.
6.2: Axis and Angle adjustment details

7.0: Some 3D Billboards.

7.1: A Pie-Plate Galaxy.
7.2: A Sphere to map the Sky.

7.2.1: The Infra-Red Milky Way
7.2.2: The H-alpha Sky

8.0: Acknowledgements.
Appendices.

A.1: Signature.
A.2: Admonishment.
A.3: Disclaimer.


---

See also:
• Selden's List of Resources for Celestia
• Billboards in CMOD text format

A.1: Signature.

This Web page is maintained by Selden Ball at Wilson Lab.

A.2: Admonishment.

Please send any questions, comments or corrections to seb@lepp.cornell.edu
Alternatively, you can post a message (anonymously or otherwise) on Celestia's Web Forum or use its Private Message page.

If you don't tell me that something's missing, unclear or wrong, I can't improve it.

A.3: Disclaimer.

The author disclaims all liability and endorsement.
Copyrights may apply.
For details, please read the full text of his disclaimer.