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.

-help

Print help information.

-Version

Print the version number.

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

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

Hardcopy: NCAR Graphics Fundamentals, UNIX Version

This documentation is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This software is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this software; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.