% @(#)get_lut.hlq	19.1 (ESO-IPG) 02/25/03 14:03:23 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      get_lut.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, GET/LUT
%.PURPOSE    On-line help file for the command: GET/LUT
%.VERSION    1.0  23-JUL-1990 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./LUT
\es\co
GET/LUT					              10-JAN-1995  KB
\oc\su
GET/LUT out_specs [get_specs] [ITT] [format] [range]
	read currently active LUT\ from image display
\us\pu
Purpose:
           Read currently active LUT from image display.
\up\sy
Syntax: 
           GET/LUT out_specs [get_specs] [ITT] [format] [range]
\ys\pa
           out_specs = table  or  image,descr
\\
              (a) table - table name where the currently active LUT will be
              stored
\\
              (b) image,descr - name of frame and descriptor where the
              currently active LUT will be stored
\\
               (c) ASCII file name - each line will contain the red, green and
               blue LUT component separated by a blank
\ap\pa
           get_specs = section, no. of values - defaulted to 0,256
\\
               this parameter was only applicable to DeAnza displays 
               (in case you still remember those prehistoric beasts),
               it is currently ignored, but should NOT be omitted (!)
\ap\pa
           ITT = optional ITT_flag, if given, the LUT values are mapped via
               the current ITT;
\ap\pa
           format = TABLE or ASCII, for output to Midas binary table or ASCII;
\\
               defaulted to TABLE
\ap\pa
           range = interval for LUT values if output to ASCII file,
\\
               either 0,1 or 0,255 is supported; defaulted to 0,1
\ap\sa
See also:
           GET/ITT, LOAD/LUT, LOAD/ITT, TUTORIAL/LUT, MODIFY/LUT
\as\no
Note:     
           The LUT file will be stored in your current working directory.
           For option (b), the image has to be resident in your current 
           directory (the data directory for MIDAS).
\on\exs
Examples:
\ex
           GET/LUT gordo,MIDAS_LUT
             Get current LUT and store it in descriptor MIDAS_LUT of frame
             `gordo.bdf' in your current directory.
\xe\ex
           GET/LUT beautiful
             Get current LUT and store it in table `beautiful.lut' in the
             current working directory.
\xe\ex
           GET/LUT doubtful.mmm ? ? ASCII 0,255
             Get current LUT and store it in the ASCII file `doubtful.mmm' in
             the current working directory. The LUT values are integers in the 
             interval [0,255].
\xe \sxe
