1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
4
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=ibm437">
5
<TITLE>Magick++</TITLE>
6
<META NAME="GENERATOR" CONTENT="StarOffice 6.0 (Solaris Sparc)">
7
<META NAME="AUTHOR" CONTENT="Bob Friesenhahn">
8
<META NAME="CREATED" CONTENT="20020805;13455306">
9
<META NAME="CHANGEDBY" CONTENT="Bob Friesenhahn">
10
<META NAME="CHANGED" CONTENT="20030528;11224400">
11
<META NAME="DESCRIPTION" CONTENT="C++ API for GraphicsMagick">
16
BLOCKQUOTE { color: #000000 }
17
A:link { color: #0000ee }
18
A:visited { color: #551a8b }
22
<BODY LANG="en-US" TEXT="#000000" LINK="#0000ee" VLINK="#551a8b" BGCOLOR="#ffffff">
23
<P ALIGN=CENTER><IMG SRC="Magick++.png" NAME="Graphic1" ALIGN=BOTTOM WIDTH=464 HEIGHT=134 BORDER=0></P>
24
<P>Magick++ is the object-oriented C++ API to the <A HREF="http://www.graphicsmagick.org/">GraphicsMagick</A>
25
image-processing library, the most comprehensive open-source image
26
processing package available. Read the latest <A HREF="NEWS.html">NEWS</A>
27
and <A HREF="ChangeLog.html">ChangeLog</A> for Magick++.
29
<P><IMG SRC="gm-188x120t.png" NAME="Graphic2" ALIGN=RIGHT WIDTH=188 HEIGHT=120 BORDER=0>Magick++
30
supports an object model which is inspired by <A HREF="http://www.graphicsmagick.org/www/perl.html">PerlMagick</A>.
31
Images support implicit reference counting so that copy constructors
32
and assignment incur almost no cost. The cost of actually copying an
33
image (if necessary) is done just before modification and this copy
34
is managed automatically by Magick++. De-referenced copies are
35
automatically deleted. The image objects support value (rather than
36
pointer) semantics so it is trivial to support multiple generations
37
of an image in memory at one time.
39
<P>Magick++ provides integrated support for the <A HREF="http://www.sgi.com/tech/stl/">Standard
40
Template Library</A> (STL) so that the powerful containers available
41
(e.g. <A HREF="http://www.sgi.com/tech/stl/Deque.html">deque</A>,
42
<A HREF="http://www.sgi.com/tech/stl/Vector.html">vector</A>, <A HREF="http://www.sgi.com/tech/stl/List.html">list</A>,
43
and <A HREF="http://www.sgi.com/tech/stl/Map.html">map</A>) can
44
be used to write programs similar to those possible with PERL &
45
PerlMagick. STL-compatible template versions of GraphicsMagick's
46
list-style operations are provided so that operations may be
47
performed on multiple images stored in STL containers.
49
<H3>Documentation</H3>
50
<P>Detailed <A HREF="Documentation.html">documentation</A> are
51
provided for all Magick++ classes, class methods, and template
52
functions which comprise the API.
54
<H3>Obtaining Magick++</H3>
55
<P>Magick++ is included as part of <A HREF="../../index.html">GraphicsMagick</A>
56
source releases and may be retrieved via <A HREF="http://www.graphicsmagick.org/www/download.html">ftp</A>
57
or <A HREF="http://www.graphicsmagick.org/www/cvs.html">CVS.</A>
60
<P>Once you have the sources available, follow these detailed
61
<A HREF="Install.html">installation instructions</A> for UNIX and
64
<P><B><FONT SIZE=4>Usage</FONT></B>
66
<P>A helper script named <I>GraphicsMagick++-config</I> is installed
67
under Unix which assists with recalling compilation options required
68
to compile and link programs which use Magick++. For example, the
69
following command will compile and link the source file <I>example.cpp</I>
70
to produce the executable <I>example</I> (notice that quotes are
73
<BLOCKQUOTE><TT><FONT SIZE=2>c++ -o example example.cpp
74
`GraphicsMagick++-config --cppflags --cxxflags --ldflags --libs`</FONT></TT></BLOCKQUOTE>
75
<P>Windows users may get started by manually editing a project file
76
for one of the Magick++ demo programs.
78
<P><B>Please note that under Windows (and possibly the Mac) it is
79
necessary to initialize the GraphicsMagick library prior to using the
80
Magick++ library</B>. This initialization is performed by passing the
81
path to the GraphicsMagick DLLs (assumed to be in the same directory
82
as your program) to the InitializeMagick() function call. This is
83
commonly performed by providing the path to your program (argv[0]) as
84
shown in the following example:
86
<BLOCKQUOTE><TT><FONT COLOR="#663366">int main( int /*argc*/, char **
87
argv)</FONT></TT> <BR><TT><FONT COLOR="#663366">{</FONT></TT> <BR><TT><FONT COLOR="#663366">
88
InitializeMagick(*argv);</FONT></TT></BLOCKQUOTE>
89
<P>This initialization step is not required under Unix, Linux,
90
Cygwin, or any other operating environment that supports the notion
91
of "installing" GraphicsMagick in a known location.
93
<H3>Reporting Bugs</H3>
94
<P>Please report any bugs via the <A HREF="http://www.simplesystems.org/Magick++/bugs">Magick++
95
Bug Tracking System</A>. Questions regarding usage should be directed
96
to <A HREF="mailto:bfriesen@simple.dallas.tx.us">Bob Friesenhahn
97
<bfriesen@simple.dallas.tx.us></A>.
99
<H3>Related Packages</H3>
100
<P>Users who are interested in displaying their images at video game
101
rates on a wide number of platforms and graphic environments (e.g.
102
Windows, X11, BeOS, and Linux/CGI) may want to try <A HREF="http://www.simplesystems.org/PtcMagick/">PtcMagick</A>,
103
which provides a simple interface between Magick++ and <A HREF="http://www.gaffer.org/ptc/">OpenPTC</A>.
added
removed
www/Magick++/index.html
