NAME

       rasgetpal - extract the color palette of a rasterfile and write it to standard output

SYNOPSIS

       rasgetpal [-Version] srcfile [dstfile]

DESCRIPTION

       Given  srcfile  and  no dstfile, rasgetpal will extract the color palette from srcfile and
       print it in textual form to standard output. Given srcfile  and  dstfile,  rasgetpal  will
       extract  the  color  palette from srcfile and save it in file dstfile. If the extension of
       dstfile is ".txt", the color palette is saved in  textual  form.  If  it  is  ".pal",  the
       palette is saved in a binary HDF-compatible format.

       Once  you  have  a  ".pal"  color  palette  you can use it with NCSA's XImage or any other
       application that uses this format of color palette. A textual color palette can be  edited
       using  a  standard text editor and then fed back to ctrans, rasview, or rascat in order to
       get a modified color palette. It's also useful when you simply want to know what's in your
       color palette. See "man ras_palette" for more information on these different formats.

OPTIONS

       -help  Print help information.

       -Version
              Print the version number.

EXAMPLE

       Let's suppose you have an X Window Dump rasterfile called window.xwd and you'd like to get
       a textual copy of the color palette.

          % rasgetpal window.xwd window.txt
          % vi window.txt /* edit the color table */
          % rasview -pal window.txt window.xwd

       You could also use the command below to get the same palette file:

          % rasgetpal window.xwd >window.txt

       Now suppose you'd like to get an HDF-compatible binary palette from "window.xwd":

          % rasgetpal window.xwd new.pal

CAVEATS

       A color  map  can  be  extracted  from  indexed  rasterfiles  but  not  from  direct-color
       rasterfiles.

SEE ALSO

       rasview(1NCARG),  rascat(1NCARG),  rasls(1NCARG),  rassplit(1NCARG),  ras_formats(5NCARG),
       ras_palette(5NCARG)

       Hardcopy: NCAR Graphics Fundamentals, UNIX Version

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research

       The use of this Software is governed by a License Agreement.