 
Celestia's Keyboard-Mouse-Joystick Assignments (as of Feb 21, 2004)
===================================================================

This list of Celestia keystrokes, mouse and joystick control
assignments is intended for any developer who may need to add
a new control assignment. When you add a new assignment, PLEASE
make a note of it in this file. Thank you.

NOTE: Christophe is currently (Jan 14, 2004) attempting to match
      the 1.3.1 KDE keystrokes to the Windows keystrokes for
      version 1.3.2.


FUNCTION KEYS
-------------
F1.......... Stop from current velocity
F2.......... Set velocity to 1 km/s
F3.......... Set velocity to 1,000 km/s
F4.......... Set velocity to speed of light (1 c/s)
F5.......... Set velocity to 10x the speed of light.
F6.......... Set velocity to 1 AU/s
F7.......... Set velocity to 1 ly/s
F8.......... Enable joystick
F9.......... 
F10......... Non-KDE: Capture image to file
F11......... While in Movie Capture mode: Start/Pause capture
F12......... While in Movie Capture mode: Stop capture

Shift+F1.... DUP Stop from current velocity
Shift+F2.... DUP Set velocity to 1 km/s
Shift+F3.... DUP Set velocity to 1,000 km/s
Shift+F4.... DUP Set velocity to speed of light (1 c/s)
Shift+F5.... DUP Set velocity to 10x the speed of light.
Shift+F6.... DUP Set velocity to 1 AU/s
Shift+F7.... DUP Set velocity to 1 ly/s
Shift+F8.... DUP Enable joystick
Shift+F9.... 
Shift+F10... Capture video to file
Shift+F11... 
Shift+F12... 

Ctrl+F1..... DUP Stop from current velocity
Ctrl+F2..... DUP Set velocity to 1 km/s
Ctrl+F3..... DUP Set velocity to 1,000 km/s
Ctrl+F4..... DUP Set velocity to speed of light (1 c/s)
Ctrl+F5..... DUP Set velocity to 10x the speed of light.
Ctrl+F6..... DUP Set velocity to 1 AU/s
Ctrl+F7..... DUP Set velocity to 1 ly/s
Ctrl+F8..... DUP Enable joystick
Ctrl+F9..... 
Ctrl+F10.... Select File menu (does not activate drop-down)
Ctrl+F11.... 
Ctrl+F12.... 


NUMBER KEYS
-----------
1  Select planet #1 around nearby star
2  Select planet #2 around nearby star
3  Select planet #3 around nearby star
4  Select planet #4 around nearby star
5  Select planet #5 around nearby star
6  Select planet #6 around nearby star
7  Select planet #7 around nearby star
8  Select planet #8 around nearby star
9  Select planet #9 around nearby star
0  Select parent star of current planet or system


LOWERCASE LETTERS (NO SHIFT KEY)
--------------------------------
a  Increase velocity
b  Toggle star labels
c  Center on selected object
d  Run demo script (demo.cel)
e  Toggle galaxy labels
f  Follow selected object
g  Go to selected object
h  Select our sun (Home)
i  Toggle cloud textures
j  Toggle Forward/Reverse time
k  Time 10x slower
l  Time 10x faster
m  Toggle moon labels
n  Non-GLUT: Toggle spacecraft labels
n  GLUT: planet/moon (not certain of function)
o  Toggle planet orbits
p  Toggle planet labels
q  Reverse direction
r  Lower texture resolution
s  Stop motion
t  Track selected object (keep selected object centered in view)
u  Toggle galaxy rendering
v  Toggle verbosity of information text
w  Toggle asteroid labels
x  Set movement direction toward center of screen
y  Sync Orbit the selected object, at a rate synced to its rotation
z  Decrease velocity


UPPERCASE LETTERS (SHIFT+KEY)
-----------------------------
A  
B  DUP Toggle star labels
C  Center/orbit--center the selected object without changing the position
   of the reference object.
D  DUP Run demo script (demo.cel)
E  DUP Toggle galaxy labels
F  DUP Follow selected object
G  DUP Go to selected object
H  DUP Select our sun (Home)
I  DUP Toggle cloud textures
J  DUP Toggle Forward/Reverse time
K  DUP Time 10x slower
L  DUP Time 10x faster
M  DUP Toggle moon labels
N  DUP Toggle spacecraft labels
O  DUP Toggle planet orbits
P  DUP Toggle planet labels
Q  DUP Reverse direction
R  Raise texture resolution
S  DUP Stop motion
T  DUP Track selected object (keep selected object centered in view)
U  DUP Toggle galaxy rendering
V  DUP Toggle verbosity of information text
W  Toggle comet labels
X  DUP Set movement direction toward center of screen
Y  DUP Sync Orbit the selected object, at a rate synced to its rotation
Z  


SPECIAL CHARACTERS
------------------
`  Show frames rendered per second
~  Display file loading info
!  Set time to current date and time
@  Edit Mode
#  
$  
%  
^  
&  Toggle location labels
*  Look back
(  
)  
-  (hyphen) Subtract light-travel delay from current simulation time
_  (underscore) 
=  Toggle constellation labels
+  Switch between artistic and limit of knowledge planet textures
[  If autoMag OFF: Decrease limiting magnitude (fewer stars visible)
[  If autoMag ON : Decrease limiting magnitude at 45 deg field of view 
]  If autoMag OFF: Increase limiting magnitude (more stars visible)
]  If autoMag ON : Increase limiting magnitude at 45 deg field of view 
{  Decrease ambient illumination
}  Increase ambient illumination
;  Show an earth-based equatorial coordinate sphere
:  Lock two objects together as one (select #1, "f", select #2, ":")
'  
"  Chase selected object (orientation is based on selection's velocity)
,  Narrow field of view (FOV--also Shift+Left Drag)
.  Widen field of view (FOV--also Shift+Left Drag)
/  Toggle constellation diagrams
<  
>  
?  Display light-travel delay between observer and selected object
\  Real time (cancels x factors and backward time)
|  


OTHER KEYS
----------
Esc............... Cancels: motion, scripts, Follow, Track, Lock, Sync,
                   object entry mode
Spacebar.......... Pause/Restart time and scripts
Spacebar+Shift.... Pause/Restart time only
Backspace......... If the selection is a star, clears the selection
                   If the selection is a body, selects the parent body or star
                   If the selection is a location, selects the parent body
Tab............... Cycle through currently active views (Multi-View)
Shift+Tab......... DUP Single View (Multi-View--also Ctrl+d)
Enter............. Select a star or planet by typing its name

Alt+Enter......... Non-KDE: Toggle between full-screen and windowed mode

Insert............ 
Delete............ Delete active view (Multi-View)
Home.............. Move closer to object
End............... Move further from object
Page Up........... 
Page Down......... 

Ctrl+Insert....... Non KDE: Copy location URL to clipboard (also Ctrl+c)
Ctrl+Delete....... DUP Delete active view (Multi-View)
Ctrl+Home......... DUP Move closer to object
Ctrl+Home......... KDE: Go to Sol (Home-Sun)
Ctrl+End.......... DUP Move further from object
Ctrl+Page Up...... 
Ctrl+Page Down.... 


ARROW KEYS
----------
Left.............. Roll left
Right............. Roll right
Up................ Change Camera Pitch
Down.............. Change Camera Pitch

Shift+Left........ Orbit object
Shift+Right....... Orbit object
Shift+Up.......... Orbit object
Shift+Down........ Orbit object

Ctrl+Left......... DUP Roll camera
Ctrl+Right........ DUP Roll camera
Ctrl+Up........... DUP Change Camera Pitch
Ctrl+Down......... DUP Change Camera Pitch

Alt+Left.......... KDE: Back (Prev in history)
Alt+Right......... KDE: Forward (Next in history)


CONTROL KEY COMBINATIONS
------------------------
Ctrl+a  (BROKEN--increases velocity--see Ctrl+A) Toggle atmospheres
Ctrl+b  Toggle constellation boundaries
Ctrl+c  Copy location URL to clipboard (also Ctrl+Ins)
Ctrl+d  Single View (Multi-View--also Shift+Tab)
Ctrl+e  Toggle eclipse shadow rendering
Ctrl+f  Non-KDE: Toggle Alt-Azimuth mode (used with Ctrl-g Go to surface)
                 Changes Left and Right Arrow keys to Yaw Left / Right
Ctrl+f  KDE: Toggle Full-screen / Windowed mode
Ctrl+g  Non-KDE: Go to surface of selected object
Ctrl+g  KDE: Capture image
Ctrl+h  DUP (h and H) Select our sun (Home)
Ctrl+i  
Ctrl+j  DUP Select a star or planet by typing it's name
Ctrl+k  Toggle display of object markers
Ctrl+l  Toggle night side planet maps (light pollution)
Ctrl+m  DUP Select a star or planet by typing it's name
Ctrl+m  KDE: Toggle display of Menu Bar
Ctrl+n  
Ctrl+o  Non-KDE: Display the Select Object dialog box
Ctrl+o  KDE: menu-File/Open Script
Ctrl+p  Non-GLUT: Mark selected object (Marker display must be active)
Ctrl+p  GLUT:Per-pixel lighting
Ctrl+q  KDE: menu-File/Quit
Ctrl+r  Split view vertically
Ctrl+s  Cycle the star style between fuzzy discs, points, and scaled discs
Ctrl+t  Toggle rendering of comet tails
Ctrl+u  Split view horizontally
Ctrl+v  Cycle between supported OpenGL render paths
Ctrl+w  Toggle wireframe mode
Ctrl+x  Toggle antialias lines
Ctrl+y  Toggle AutoMag = auto adaptation of star visibility to field of view
Ctrl+z  

Ctrl+A  Toggle atmospheres
Ctrl+B  DUP Toggle constellation boundaries
Ctrl+C  DUP Copy location URL to clipboard (also Ctrl+Ins)
Ctrl+D  DUP Single View (Multi-View--also Shift+Tab)
Ctrl+E  DUP Toggle eclipse shadow rendering
Ctrl+F  DUP Toggle Alt-azimuth mode (used with Ctrl-G--Go to surface)
             Changes Left and Right Arrow keys to Yaw Left / Right
Ctrl+G  DUP Go to surface of selected object
Ctrl+H  DUP If the selection is a star, clears the selection
            If the selection is a body, selects the parent body or star
            If the selection is a location, selects the parent body
Ctrl+I  
Ctrl+J  DUP Select a star or planet by typing it's name
Ctrl+K  DUP Toggle display of object markers
Ctrl+L  DUP Toggle night side planet maps (light pollution)
Ctrl+M  DUP Select a star or planet by typing it's name
Ctrl+N  
Ctrl+O  DUP Display the Select Object dialog box
Ctrl+P  DUP Mark selected object (Marker display must be active)
Ctrl+Q  
Ctrl+R  DUP Split Horizontally (Multi-View)
Ctrl+S  
Ctrl+T  DUP Toggle rendering of comet tails
Ctrl+U  DUP Split Vertically (Multi-View)
Ctrl+V  DUP Cycle between supported OpenGL render paths
Ctrl+W  DUP Toggle wireframe mode
Ctrl+X  DUP Toggle antialias lines
Ctrl+Y  DUP Toggle AutoMag = auto adaptation of star visibility to field of view
Ctrl+Z  

Ctrl++  KDE: Zoom In (Decrease Field of View)
Ctrl+-  KDE: Zoom Out (Increase Field of View)


ALT KEY COMBINATIONS
--------------------
Alt+b   KDE: Add Bookmark
Alt+c   KDE: Open Celestial Browser dialog
Alt+e   KDE: Open Eclipse Finder dialog
Alt+f   KDE: Alt-Azimuth mode
Alt+g   KDE: Open Go to URL dialog
Alt+l   KDE: Open Go to Long/Lat dialog
Alt+r   KDE: Add Relative Bookmark
Alt+s   KDE: Go to Surface
Alt+t   KDE: Open Set Time dialog
Alt+u   KDE: Toggle Local/UTC Time display


CTRL+ALT KEY COMBINATIONS
-------------------------
Ctrl+Alt+s  KDE: Add Settings Bookmark


NUMBER PAD KEYS (NUMLOCK ACTIVE)
--------------------------------
1  
2  Pitch up (also Up arrow)
3  
4  Yaw left
5  Stop rotation
6  Yaw right
7  Roll left (also Left arrow)
8  Pitch down (also Down arrow)
9  Roll right (also Right arrow)


MOUSE OPERATIONS
----------------
Left Click.............. (on an object) Select object
Left Click.............. (on no object) Deselect currently selected object
Right Click............. (on object) Display context menu if one is available
Left Double Click....... (on an object) Select and Center object
Middle Button........... Toggle field of view between 45 degrees and the previous
                         field (ie. telescopic view)
Scroll Wheel............ Adjust distance to selection

Shift+Left Click........ DUP (on an object) Select object
Shift+Left Click........ DUP (on no object) Deselect currently selected object
Shift+Right Click....... DUP (on object) Display context menu if one is available
Shift+Left Dbl Click.... (on an object) DEselect and Center object
Shift+Middle Button..... DUP Toggle field of view between 45 degrees and the
                         previous field (ie. telescopic view)
Shift+Scroll Wheel...... 

Ctrl+Left Click......... DUP (on an object) Select object
Ctrl+Left Click......... DUP (on no object) Deselect currently selected object
Ctrl+Right Click........ DUP (on object) Display context menu if one is available
Ctrl+Left Dbl Click..... DUP (on an object) Select and Center object
Ctrl+Middle Button...... DUP Toggle field of view between 45 degrees and the
                         previous field (ie. telescopic view)
Ctrl+Scroll Wheel....... DUP Adjust distance to selection

Alt+Left Click.......... DUP (on an object) Select object
Alt+Left Click.......... DUP (on no object) Deselect currently selected object
Alt+Right Click......... DUP (on an object) Select object
Alt+Left Dbl Click...... DUP (on an object) DEselect and Center object
Alt+Middle Button....... DUP Toggle field of view between 45 degrees and the
                         previous field (ie. telescopic view)
Alt+Scroll Wheel........ DUP Adjust distance to selection

Left Drag............... Orient camera (Up/Down arrows, 2/8/4/6 on Number Pad)
Right Drag.............. Orbit the selected object (also Shift+Arrow keys)
Left+Right Drag......... (up/down) Adjust distance to selection (Home and End)
Left+Right Drag......... (left/right) Roll left/right (Left/Right Arrow keys)

Shift+Left Drag......... Narrow/Widen field of view (FOV--also "." and ",")
Shift+Right Drag........ DUP Orbit the selected object
Shift+Left+Right Drag... DUP (up/down) Adjust distance to selection
Shift+Left+Right Drag... DUP (left/right) Roll left/right

Ctrl+Left Drag.......... Adjust distance to selection (also Home and End)
Ctrl+Right Drag......... DUP Orbit the selected object
Ctrl+Left+Right Drag.... DUP (up/down) Adjust distance to selection
Ctrl+Left+Right Drag.... DUP (left/right) Roll left/right


JOYSTICK CONTROLS
-----------------
X axis...... Yaw
Y axis...... Pitch
L trigger... Roll left
R trigger... Roll right
Button 1.... Slower
Button 2.... Faster


USER INTERFACE FUNCTIONS NOT CURRENTLY ASSIGNED TO KEYSTROKES
=============================================================
File Menu
---------
  * Open Script (KDE: Ctrl+o)
  * Exit/Quit   (KDE: Ctrl+q)


Navigation Menu
---------------
  * Tour Guide dialog
  * Select Object dialog (assigned Ctrl+o but not shown)
  * Go to Object dialog
  * Solar System Browser dialog (KDE: Alt+c)
  * Star Browser dialog (KDE: Alt+c)
  * Eclipse Finder dialog (KDE: Alt+e)


Time Menu
---------
  * Set Time dialog (KDE: Alt+t)
  * Toggle Local/UTC Time (KDE: Alt+u)


Render Menu
-----------
  * Select Display Mode dialog

  * View Options dialog
    - Toggle Celestial Grid
    - Toggle Asteroid Orbits
    - Toggle Comet Orbits
    - Toggle Moon Orbits
    - Toggle Spacecraft Orbits

  * Locations dialog
    - Toggle City Location text
    - Toggle Observatory Location text
    - Toggle Landing Site Location text
    - Toggle Mountains Location text
    - Toggle Seas Location text
    - Toggle Craters Location text
    - Toggle Valleys Location text
    - Toggle Land Masses Location text
    - Toggle Other Features Location text
    - Toggle Mark Features
    - Minimum Labeled Feature Size adjust (+ / -)


View Menu
---------
  * Toggle Show Frames
  * Toggle Synchronize Time


Bookmarks Menu
--------------
  * Add Bookmark dialog (KDE: Alt+b)
  * Organize Bookmarks dialog
  * Links to any listed Bookmarks
  * KDE: Add Relative Bookmark (Alt+r)
  * KDE: Add Settings Bookmark (Ctrl+Alt+s)


Help Menu
---------
  * Controls display
  * OpenGL Info display


KDE: Settings
-------------
  * Toggle Menu Bar (Ctrl+m)


---< end of file >---
