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.