Vamos Logo Caelum

Caelum is a program to help make seamless sky boxes from panoramic photos.

Sky Caelum Sky


caelum [options] image-file.png

The image file is mapped onto a sphere and six views are shown. The views are from the center of the sphere looking up (top row), down (bottom row), front, right, back, and left (middle row). When these images are mapped to the faces of a cube and viewed from the center of the cube, the view in any direction is indistinguishable from the view from the center of the sphere. The images for the sky box are extracted by taking a screenshot.


To install, copy .libs/lt-caelum to /usr/local/bin/caelum. Caelum requires libvamos-geometry and libsigc++. If you install Vamos first, you should be ready to go.


-d DIV
Specify the number of latitude divisions. The number of longitude divisions is twice DIV. The default value is 16.

Specify the height of the window in pixels. The height of each view entire window will be HEIGHT/2. The default is 1.5 times the height of the source image.

Specify the width of the window in pixels. The width of each view window will be WIDTH/4. The default is twice the width of the source image.

Display a help message and exit successfully.

Display version information and exit successfully.


Left Arrow
Right Arrow
Rotate the image about the vertical axis.

Up Arrow
Down Arrow
Shift the image vertically.

Page Up
Page Down
Scale the image vertically.


Load the sky image from the textures directory. ./caelum ../data/textures/sky.ppm This image comes from the Sky collection at Free Game Textures. It does not include the poles. As a result, the top is pinched in the center. Using the cursor keys, Page Up, and Page Down you can change the position of the horizon and make the mountains appear taller or shorter. When you're satisfied, take a screenshot and chop it up with an image manipulation program such as the GIMP. For Vamos, you need three images, the top view, the bottom view, and the entire strip of side views. The sky box images are specified in the XML track files.

Possible Enhancements

Caelum comes with ABSOLUTELY NO WARRANTY. You may redistribute copies of Caelum under the terms of the GNU General Public License. For more information about these matters, see the file named COPYING.

Report bugs to snick dash a dash doo at comcast dot net