1  Overview
=TITLE Overview
=TITLE Overview of XGLOBE
=INCLUDE About
 XGLOBE displays a spinning world globe.  The user
 can control the direction and speed of rotation,
 but not size or angle.

 For information about using XGLOBE, double click on
 an item from the list of additional topics below.

 For information about using help, choose USING HELP
 from the Help menu above.

2  DECBasics
=TITLE DECBasics
=TITLE DECwindows Basics
=INCLUDE Overview
 Information about using DECwindows, such as how to use
 windows, dialog boxes, and scroll bars, is available
 from Session Manager help. A glossary of DECwindows
 terms is also available. To get Session Manager help:

 1. Move the pointer to the Session Manager icon (the
    icon with your user name and the name of your
    system) in the Icon Box.

 2. Press mouse button 1 (MB1) twice quickly to display
    the Session Manager window.

 3. Move the pointer to the Help menu; press and hold
    MB1 to pull down this menu.

 4. Move the pointer to the Overview menu item and
    release MB1 to display information about using
    DECwindows.

2  Start/Stop
=TITLE Start/Stop
=INCLUDE Overview
 The START button starts the globe spinning in
 a counterclockwise direction.  STOP stops it.
 Note that counterclockwise is the natural
 direction of the earth's rotation.

2  Speed
=TITLE Speed
=INCLUDE Overview
 You can control the speed of rotation by moving
 the scale to the left or right. Negative numbers
 represent a clockwise rotation while positive
 numbers represent a counterclockwise rotation.
 Larger absolute values represent greater speed.
 The relationship between these numbers and the
 speed of rotation is left as an exersize to the user.

2  Frames
=TITLE Frame
=INCLUDE Overview
 XGLOBE works by flipping through 128 precomputed
 frames.  You can flip forward through the frames
 by stopping pressing the STOP button, then clicking
 on the globe with the left mouse button.  Doing the
 same with the right mouse button flips backwards
 through the frames.

2  Customization
=TITLE Customization
=INCLUDE Overview
 The class name for XGLOBE is "XGlobe".

 Check the app-defaults file for things you can
 customize.

 The globe widget has name "globe" and class "Flip".
 Required resources for the globe are:

 *filePrefix:  pointer to data files
     The files must be in X bitmap format and named
     with this prefix and a number, beginning with 0.
 *maxFrames:  number of frames

 Some optional resources are:
 *foreground:  color of globe's land features
 *flipBackground:  color of globe's water features
 *background:  color of area around globe
 *clipmask:  an X bitmap file containing the clipmask
     through which the globe will be drawn.  It should
     be the same size as the globe bitmaps.
 *sample:  frame sampling rate
     By default, all 128 globe data frames are used.
     These are downloaded to the X server and use 
     approximately 1.5MB of memory.  Changing *sample
     to 2 and *maxFrames to 64 halves the memory
     requirement, at the expense of some animation
     smoothness.
 *borderTop and *borderLeft:  drawing offset
 *shadowThickness:  Motif 3D shadow width
 *growShadow:  if this *growShadow is True and the
     globe is resized, the Motif shadow is modified to
     fit.  Otherwise, *borderTop and *borderLeft are
     modified.
