Sky3D 2.0 by Corvus Software
======================================================
Copyright 1997-1998 Eduardo Nunes All Rights Reserved.

A. Command Line Options
B. Console Commands
C. Markers
D. Planet Textures

               * * * * *

A. Command Line Options

Syntax: sky3d [-{d|g|c|p|r<path>|l<path>|f|v{m<num>|w<flag>|b<flag>}}]

Syntax:    Description:
-d         Run in debug mode (Bug Reporting).
-g         Disable GUI.
-c         Disable startup window.
-p         Disable plugins.
-r         <path> Change register path 
         (default: HKEY_LOCAL_MACHINE\SOFTWARE\Corvus Software\Sky3D\2.00)
-l<path>   Change loading path (default: current directory)
-f         Reset to factory (reset all Sky3D settings to default)
-vm<num>   Change screen resolution.
-vw<flag>  Wait for vertical retrace sync (1=TRUE,0=FALSE)
-vb<flag>  Back buffer in system memory (1=TRUE,0=FALSE)


B. Console Commands

Introduction to the Console
Throughout this document, examples of commands are given, all of which are
typed in at the console.
To bring up/down the console, press the F12 key.

About Cameras
Syntax:                 Description:
camera <1..8>          Change current camera.
                       All other camera commands are related to the current
                       camera.

camera lock <id>       Locks an object.
camera vlock <id>      Visual lock (-1 none).
camera start           Start moving to locked object.
camera stop            Stops.
camera lookAt <id>     Look at an object.
camera zoom <factor>   Change zoom.
camera speed <num>     Change interstellar velocity (Ly/frame).
camera sspeed <num>    Change star system velocity (Km/frame).
camera back            Look back.
camera mode <num>      Change view mode.
(0=Sky View, 1=Local Space, 2=Star systems)

camera vradius <num>   Change Local Space radius (Ly).
camera zclip <num>     Change sky sphere Z clip.
camera load            Load from registry.
camera save            Save to registry.
camera tree <0|1>      Change scan tree speed factor. 
(0= more accurate/slower performance, 1= less accurate/faster performance)

camera Ipos <pos>      Change camera interstellar position.
(See Marker references for syntax position.)

camera Spos <pos>      Change camera star system position.

About Stars
Syntax:                Description:
stars on               Enable stars
stars off              Disable stars
stars magLimit <mag>   Change stars magnitude limit.

About Deep-sky objects
Syntax:                 Description:
deepsky on              Enable deep-sky object
deepsky off             Disable deep-sky object
deepsky flags <num>     Change deep-sky flags (1=OC,2=GC,4=Psr,8=Neb) in hex
deepsky all             Change deep-sky flag to all (== deepsky flag F)
deepsky magLimit <mag>  Change deep-sky magnitude limit
deepsky simple          Disable textures (lines only)
deepsky texture         Enable textures

About Markers
Syntax:              Description:
marker on            Enable markers
marker off           Disable markers
marker list          Lists all available markers in marker directory
marker load <fname>  Load a marker
marker clear         Clear all markers (unload)
marker draw <cmd>    Execute/draw a marker primitive
(See Marker references)

About Galaxy
Syntax:              Description:
galaxy on            Enable galaxy
galaxy off           Disable galaxy
galaxy simple        Disable textures (circles only)
galaxy texture       Enable textures

About Star systems
Syntax:              Description:
ssys on              Enable star system orbit lines
ssys off             Disable star systems orbit lines
ssys time <num>      Sets time (in days)
ssys timeStep <num>  Sets time step (in days)
ssys simple          Disable textures in planets (flat shade mode)
ssys texture         Enable textures

About Labels
Syntax:                 Description:
labels on               Enable labels
labels off              Disable labels
labels magLimit <num>   Labels magnitude limit

About Macros
From the console you can adjust your controls, this is done by 
"binding" keys to commands. The format for macros keys is as follows:

macros bind <char>=<str> 
Bind a keyboard shortkey (Ctrl + key) to a command string (sep by ';').

Example:
To bind the S key to the 'deepsky simple' and 'galaxy simple' command, you would type:
macros bind S=deepsky simple;galaxy simple 
and press enter.

macros unbind <char>    Clear the shortkey bound to the keyboard.
macros load             Load macros from registry.
macros save             Save macros to registry.
macros list             Lists all macros.

Show
show ver                Show Sky3D version,legal status,serial number.
show fps                Show FramesPerSecond status.
show rstat              Show render status

Miscelaneous
plugin con              Lists all console plugins.
exit                    Exits Sky3D.


C. Markers

1- Arguments type:

position type:
o(<id>)              position of object <id>
n(<name>)            position of object with <name>
p(<x>,<y>,<z>)          direct position

color type:
rgb(<24bits in hex>) a rgb value (HTML style)

string type:
"<string>"     a string

shape type:
flag                     
cross

2- Marker draw primitives

line{<from position>;<to position>;<color>}

Example:
line{ n(Sol); p(23,-23,4); rgb(ff80c0) }

arrow{<from position>;<to position>;<color>}

Example:
arrow{ o(f43c4); o(11112); rgb(ffff80)}

text{<position>;<color>;<string>}
Example:
text{n(Alp CMa); rgb(808080); "Sirius"}

marker{<position>;<color>;<shape>}

Example:
marker{p(-1,2,3); rgb(ffffff); flag}

3- Marker file

Any file in marker directory with ".map" extension.
file format:
a primitive per line
lines started with // are ignored (comments)

D. Planet Textures
00000000 Generic Rocky Planet
00000001 Generic Gas Planet
00000002 Mercury
00000003 Venus
00000004 Earth
00000005 Moon
00000006 Mars
00000007 Jupiter
00000008 Io
00000009 Europa
0000000A Ganymede
0000000B Callisto
0000000C Saturn
0000000D Uranus 
0000000E Neptune
0000000F Pluto 

00000010  Blue "jupiter"
00000011  Orange haze (Titan)
00000012  Green gas
00000013  Green/blue
00000014  Red ice
00000015  Red clouds
00000016  Red gas giant
00000017  Fire moon
00000018  Brown dwarf
00000019  Red moon
0000001A  Dark blue
0000001B  Florest planet
0000001C  Light red moon
0000001D  Green ice
0000001E  Blue ice
0000001F  Dark brown clouds
