<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
<TITLE>Tools: GraphicsMagick - Image Processing and Display Package</TITLE>
<META NAME="GENERATOR" CONTENT="StarOffice 7 (Solaris Sparc)">
<META NAME="CREATED" CONTENT="20040418;19175700">
<META NAME="CHANGEDBY" CONTENT="Robert Friesenhahn">
<META NAME="CHANGED" CONTENT="20040418;19181700">
<META NAME="DESCRIPTION" CONTENT="GraphicsMagick is a robust collection of tools and libraries to read, write, and manipulate an image in any of the more popular image formats including GIF, JPEG, PNG, PDF, and Photo CD. With GraphicsMagick you can create GIFs dynamically making it suitable for Web applications. You can also resize, rotate, sharpen, color reduce, or add special effects to an image and save your completed work in the same or differing image format.">
<META NAME="KEYWORDS" CONTENT="GraphicsMagick, Image Magick, Image Magic, PerlMagick, Perl Magick, Perl Magic, CineMagick, PixelMagick, Pixel Magic, WebMagick, Web Magic, visualization, image processing, software development, simulation, image, software, AniMagick, Animagic, Magick++">
<STYLE>
<!--
TD P { color: #000000; font-family: "Verdana", "Arial", "Helvetica", sans-serif; font-size: 14pt }
P { color: #000000; font-family: "Verdana", "Arial", "Helvetica", sans-serif; font-size: 14pt }
DD { color: #000000; font-family: "Verdana", "Arial", "Helvetica", sans-serif; font-size: 14pt }
PRE { color: #000000 }
A:link { color: #0085c0 }
A:visited { color: #800080 }
-->
</STYLE>
</HEAD>
<BODY LANG="en-US" TEXT="#000000" LINK="#0085c0" VLINK="#800080" BGCOLOR="#ffffff" DIR="LTR">
<P ALIGN=CENTER><IMG SRC="../images/gm-188x120t.png" NAME="Graphic1" ALIGN=BOTTOM WIDTH=114 HEIGHT=118 BORDER=0></P>
<P><BR><BR>
</P>
<P STYLE="margin-bottom: 0in">
</P>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=2>
<TR>
<TD BGCOLOR="#52799e">
<P ALIGN=LEFT><IMG SRC="../images/right_triangle.png" NAME="Graphic2" ALT=">" ALIGN=BOTTOM WIDTH=15 HEIGHT=14 BORDER=0><B><FONT SIZE=4><FONT FACE="Helvetica, Arial"><FONT COLOR="#ffffff">Display</FONT></FONT></FONT></B></P>
</TD>
</TR>
</TABLE>
<DL>
<DD><A HREF="display.html">Display</A> is a machine architecture
independent image processing and display program. It can display an
image on any workstation display running an <I>X</I> server. The
image can be displayed as background image of any window.
</DD><DD>
<B>Display</B> first determines the hardware capabilities of your
workstation. If the number of unique colors in an image is less than
or equal to the number the workstation can support, the image is
displayed in an <I>X window</I>. Otherwise the number of colors in
the image is first reduced to match the color resolution of the
workstation before it is displayed.
</DD><DD STYLE="margin-bottom: 0.2in">
This means that a continuous-tone 24 bits/pixel image can display on
a 8 bit pseudo-color device or monochrome device. In most instances
the reduced color image closely resembles the original.
Alternatively, a monochrome or pseudo-color image sequence can
display on a continuous-tone 24 bits/pixels device.
</DD></DL>
<P STYLE="margin-bottom: 0in">
</P>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=2>
<TR>
<TD BGCOLOR="#52799e">
<P ALIGN=LEFT><IMG SRC="../images/right_triangle.png" NAME="Graphic3" ALT=">" ALIGN=BOTTOM WIDTH=15 HEIGHT=14 BORDER=0><B><FONT SIZE=4><FONT FACE="Helvetica, Arial"><FONT COLOR="#ffffff">Import</FONT></FONT></FONT></B></P>
</TD>
</TR>
</TABLE>
<DL>
<DD><A HREF="import.html">Import</A> reads an image from any visible
window on an <I>X server</I> and outputs it as an image file. You
can capture a single window, the entire screen, or any rectangular
portion of the screen. You can use the <B>display</B> utility for
redisplay, printing, editing, formatting, archiving, image
processing, etc. of the captured image. <BR>
</DD><DD STYLE="margin-bottom: 0.2in">
The target window can be specified by id, name, or may be selected
by clicking the mouse in the desired window. If you press a button
and then drag, a rectangle will form which expands and contracts as
the mouse moves. To save the portion of the screen defined by the
rectangle, just release the button. The keyboard bell is rung once
at the beginning of the screen capture and twice when it completes.
</DD></DL>
<P STYLE="margin-bottom: 0in">
</P>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=2>
<TR>
<TD BGCOLOR="#52799e">
<P ALIGN=LEFT><IMG SRC="../images/right_triangle.png" NAME="Graphic4" ALT=">" ALIGN=BOTTOM WIDTH=15 HEIGHT=14 BORDER=0><B><FONT SIZE=4><FONT FACE="Helvetica, Arial"><FONT COLOR="#ffffff">Animate</FONT></FONT></FONT></B></P>
</TD>
</TR>
</TABLE>
<DL>
<DD STYLE="margin-bottom: 0.2in"><A HREF="animate.html">Animate</A>
displays a sequence of images on any workstation display running an
<I>X server</I>. <B>Animate</B> first determines the hardware
capabilities of the workstation. If the number of unique colors in
an image is less than or equal to the number the workstation can
support, the image is displayed in an <I>X window</I>. Otherwise the
number of colors in the image is first reduced to match the color
resolution of the workstation before it is displayed. <BR>This means
that a continuous-tone 24 bits/pixel image can display on a 8 bit
pseudo-color device or monochrome device. In most instances the
reduced color image closely resembles the original. Alternatively, a
monochrome or pseudo-color image sequence can display on a
continuous-tone 24 bits/pixels device.</DD></DL>
<P STYLE="margin-bottom: 0in">
</P>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=2>
<TR>
<TD BGCOLOR="#52799e">
<P ALIGN=LEFT><IMG SRC="../images/right_triangle.png" NAME="Graphic5" ALT=">" ALIGN=BOTTOM WIDTH=15 HEIGHT=14 BORDER=0><B><FONT SIZE=4><FONT FACE="Helvetica, Arial"><FONT COLOR="#ffffff">Montage</FONT></FONT></FONT></B></P>
</TD>
</TR>
</TABLE>
<DL>
<DD STYLE="margin-bottom: 0.2in"><A HREF="montage.html">Montage</A>
creates a composite by combining several separate images. The images
are tiled on the composite image with the name of the image
optionally appearing just below the individual tile.
</DD></DL>
<P STYLE="margin-bottom: 0in">
</P>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=2>
<TR>
<TD BGCOLOR="#52799e">
<P ALIGN=LEFT><IMG SRC="../images/right_triangle.png" NAME="Graphic6" ALT=">" ALIGN=BOTTOM WIDTH=15 HEIGHT=14 BORDER=0><B><FONT SIZE=4><FONT FACE="Helvetica, Arial"><FONT COLOR="#ffffff">Convert</FONT></FONT></FONT></B></P>
</TD>
</TR>
</TABLE>
<DL>
<DD STYLE="margin-bottom: 0.2in"><A HREF="convert.html">Convert</A>
converts an input file using one image format to an output file with
a differing image format. By default, the image format is determined
by its magic number. To specify a particular image format, precede
the filename with an image format name and a <B>colon</B> (i.e.
ps:image) or specify the image type as the filename <B>suffix</B>
(i.e. image.ps). Specify file as - for <B>standard input</B> or
<B>output</B>. If file has the extension .Z, the file is decoded
with uncompress.
</DD></DL>
<P STYLE="margin-bottom: 0in">
</P>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=2>
<TR>
<TD BGCOLOR="#52799e">
<P ALIGN=LEFT><IMG SRC="../images/right_triangle.png" NAME="Graphic7" ALT=">" ALIGN=BOTTOM WIDTH=15 HEIGHT=14 BORDER=0><B><FONT SIZE=4><FONT FACE="Helvetica, Arial"><FONT COLOR="#ffffff">Mogrify</FONT></FONT></FONT></B></P>
</TD>
</TR>
</TABLE>
<DL>
<DD STYLE="margin-bottom: 0.2in"><A HREF="mogrify.html">Mogrify</A>
transforms an image or a sequence of images. These transforms
include <B>image scaling</B>, <B>image rotation</B>, <B>color
reduction</B>, and others. The transmogrified image <B>overwrites</B>
the original image.
</DD></DL>
<P STYLE="margin-bottom: 0in">
</P>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=2>
<TR>
<TD BGCOLOR="#52799e">
<P ALIGN=LEFT><IMG SRC="../images/right_triangle.png" NAME="Graphic8" ALT=">" ALIGN=BOTTOM WIDTH=15 HEIGHT=14 BORDER=0><B><FONT SIZE=4><FONT FACE="Helvetica, Arial"><FONT COLOR="#ffffff">Identify</FONT></FONT></FONT></B></P>
</TD>
</TR>
</TABLE>
<DL>
<DD STYLE="margin-bottom: 0.2in"><A HREF="identify.html">Identify</A>
describes the format and characteristics of one or more image files.
It will also report if an image is incomplete or corrupt. The
information displayed includes the scene number, the file name, the
width and height of the image, whether the image is colormapped or
not, the number of colors in the image, the number of bytes in the
image, the format of the image (JPEG, PNM, etc.), and finally the
number of seconds it took to read and process the image.
</DD></DL>
<P STYLE="margin-bottom: 0in">
</P>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=2>
<TR>
<TD BGCOLOR="#52799e">
<P ALIGN=LEFT><IMG SRC="../images/right_triangle.png" NAME="Graphic9" ALT=">" ALIGN=BOTTOM WIDTH=15 HEIGHT=14 BORDER=0><B><FONT SIZE=4><FONT FACE="Helvetica, Arial"><FONT COLOR="#ffffff">Composite</FONT></FONT></FONT></B></P>
</TD>
</TR>
</TABLE>
<DL>
<DD STYLE="margin-bottom: 0.2in"><A HREF="composite.html">Composite</A>
composites images to create new images.
</DD></DL>
<P STYLE="margin-bottom: 0in">
</P>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=2>
<TR>
<TD BGCOLOR="#52799e">
<P ALIGN=LEFT><IMG SRC="../images/right_triangle.png" NAME="Graphic10" ALT=">" ALIGN=BOTTOM WIDTH=15 HEIGHT=14 BORDER=0><B><FONT SIZE=4><FONT FACE="Helvetica, Arial"><FONT COLOR="#ffffff">Conjure</FONT></FONT></FONT></B></P>
</TD>
</TR>
</TABLE>
<DL>
<DD><A HREF="conjure.html">Conjure</A> interprets and executes
scripts in the Magick Scripting Language (MSL).
</DD><DD STYLE="margin-bottom: 0.2in">
The Magick scripting language (MSL) will primarily benefit those
that want to accomplish custom image processing tasks but do not
wish to program, or those that do not have access to a Perl
interpreter or a compiler. The interpreter is called conjure and
here is an example script:
</DD></DL>
<PRE> <?xml version="1.0" encoding="UTF-8"?>
<image size="400x400" >
<read filename="image.gif" />
<get width="base-width" height="base-height" />
<resize geometry="%[dimensions]" />
<get width="width" height="height" />
<print output=
"Image sized from %[base-width]x%[base-height]
to %[width]x%[height].\n" />
<write filename="image.png" />
</image></PRE>
<DL>
<DD STYLE="margin-bottom: 0.2in">
invoked with
</DD></DL>
<PRE STYLE="margin-bottom: 0.2in"> conjure -dimensions 400x400 incantation.msl</PRE>
<DL>
<DD STYLE="margin-bottom: 0.2in">
All operations will closely follow the key/value pairs defined in
PerlMagick, unless otherwise noted.
</DD><HR>
</DL>
<P ALIGN=CENTER><A HREF="Copyright.html">Copyright</A> <FONT FACE="Abadi Mt Condensed Extra Bold">©</FONT>
GraphicsMagick Group 2002, 2003, 2004</P>
</BODY>
</HTML>
