----- file created by xop_makedoc on: Fri Mar  7 13:26:15 2003
----- Documentation for /scisoft/XRayOptics/xop2.1/src_idl/Embedded/RSI-SRC/xloadct.pro -----

 NAME:
       XLOADCT
 PURPOSE:
       A graphical interface to the LOADCT user library procedure.
       XLOADCT displays the current color map and provides
       an array of buttons, one per availible predefined color
       table. Using the mouse to press these buttons causes
       the corresponding color map to be loaded.
 CATEGORY:
       Widgets
 CALLING SEQUENCE:
       XLOADCT
 INPUTS:
       None.
 KEYWORDS:
	FILE:	If this keyword is set, the file by the given name is used
		instead of the file colors1.tbl in the IDL directory.  This
		allows multiple IDL users to have their own color table file.
       GROUP = The widget ID of the widget that calls XLoadct.  When
               this ID is specified, a death of the caller results in a
               death of XLoadct
	NCOLORS = number of colors to use.  Use color indices from BOTTOM
		to the smaller of !D.TABLE_SIZE-1 and NCOLORS-1.
		Default = !D.TABLE_SIZE = all available colors.
	BOTTOM = first color index to use. Use color indices from BOTTOM to
		BOTTOM+NCOLORS-1.  Default = 0.
       SILENT - Normally, no informational message is printed when
               a color map is loaded. If this keyword is present and
               zero, this message is printed.
	USE_CURRENT: If set, use the current color tables, regardless of
		the contents of the COMMON block COLORS.
       MODAL:  If set, then XLOADCT runs in "modal" mode, meaning that
               all other widgets are blocked until the user quits XLOADCT.
               A group leader must be specified (via the GROUP keyword)
               for the MODAL keyword to have any effect.   The default
               is to not run in modal mode.
	BLOCK:  Set this keyword to have XMANAGER block when this
		application is registered.  By default the Xmanager
               keyword NO_BLOCK is set to 1 to provide access to the
               command line if active command 	line processing is available.
               Note that setting BLOCK for this application will cause
		all widget applications to block, not only this
		application.  For more information see the NO_BLOCK keyword
		to XMANAGER.
       UPDATECALLBACK: Set this keyword to a string containing the name of
               a user-supplied procedure that will be called when the color
               table is updated by XLOADCT.  The procedure may optionally
               accept a keyword called DATA, which will be automatically
               set to the value specified by the optional UPDATECBDATA
               keyword.
       UPDATECBDATA: Set this keyword to a value of any type. It will be
               passed via the DATA keyword to the user-supplied procedure
               specified via the UPDATECALLBACK keyword, if any. If the
               UPDATECBDATA keyword is not set the value accepted by the
               DATA keyword to the procedure specified by UPDATECALLBACK
               will be undefined.

 OUTPUTS:
       None.
 COMMON BLOCKS:
       None.
 SIDE EFFECTS:
       One of the predefined color maps may be loaded.
 RESTRICTIONS:
       This routine uses the LOADCT user library procedure to
       do the actual work.
 MODIFICATION HISTORY:
       24, August, 1990, Written by AB, RSI.
       March 1, 1992  Mark Rivers added Reverse Table to options menu.
	7/92, DMS, Added new color tables (allows more than 16).
	9/92, ACY, Add FILE keyword.
	10/1/96, AB, Removed the PICK_ONE keyword. It was broken for 4 years
		without anyone noticing, and the idea doesn't really fit
		XLOADCT anymore.
       1/10/97, DJC - Fixed color bar display bug, and added "MODAL" keyword.
	1/13/96, AB, Improved the saving and restoring of the current
		graphics window to prevent other applications from drawing
		on this applications windows.
       1/17/97, DJC - Moved group_leader keyword from "XManager" to
               "WIDGET_BASE".   Added check to ignore "MODAL" keyword
               if a group leader is not specified.
       8/20/98, ACY - Added UPDATECALLBACK and UPDATECBDATA keywords.

