From dcca3fa3bc535a40a90c681bf07f2379fc2f3f76 Mon Sep 17 00:00:00 2001 From: cristy Date: Wed, 29 Dec 2010 21:50:07 +0000 Subject: [PATCH] --- ImageMagick.spec | 2 +- config/configure.xml | 4 +- index.html | 50 +- libtool | 2 +- magick/version.h | 4 +- version.sh | 2 +- www/ImageMagickObject.html | 40 +- www/advanced-unix-installation.html | 58 +- www/advanced-windows-installation.html | 50 +- www/animate.html | 53 +- www/api.html | 168 +++--- www/api/animate.html | 34 +- www/api/annotate.html | 34 +- www/api/attribute.html | 34 +- www/api/blob.html | 36 +- www/api/cache-view.html | 34 +- www/api/cache.html | 36 +- www/api/cipher.html | 36 +- www/api/color.html | 36 +- www/api/colormap.html | 36 +- www/api/compare.html | 34 +- www/api/composite.html | 36 +- www/api/constitute.html | 36 +- www/api/decorate.html | 34 +- www/api/deprecate.html | 36 +- www/api/display.html | 36 +- www/api/distort.html | 36 +- www/api/draw.html | 36 +- www/api/drawing-wand.html | 36 +- www/api/effect.html | 36 +- www/api/enhance.html | 36 +- www/api/exception.html | 36 +- www/api/feature.html | 34 +- www/api/fx.html | 34 +- www/api/histogram.html | 36 +- www/api/image-view.html | 34 +- www/api/image.html | 34 +- www/api/layer.html | 36 +- www/api/list.html | 36 +- www/api/magick-deprecate.html | 36 +- www/api/magick-image.html | 36 +- www/api/magick-property.html | 36 +- www/api/magick-wand.html | 36 +- www/api/magick.html | 36 +- www/api/memory.html | 36 +- www/api/module.html | 36 +- www/api/mogrify.html | 36 +- www/api/monitor.html | 36 +- www/api/montage.html | 34 +- www/api/morphology.html | 34 +- www/api/paint.html | 34 +- www/api/pixel-iterator.html | 36 +- www/api/pixel-wand.html | 36 +- www/api/profile.html | 36 +- www/api/property.html | 36 +- www/api/quantize.html | 34 +- www/api/registry.html | 36 +- www/api/resize.html | 36 +- www/api/resource.html | 36 +- www/api/segment.html | 36 +- www/api/shear.html | 36 +- www/api/signature.html | 36 +- www/api/statistic.html | 36 +- www/api/stream.html | 36 +- www/api/transform.html | 34 +- www/api/version.html | 36 +- www/api/wand-view.html | 36 +- www/architecture.html | 87 ++- www/binary-releases.html | 96 +-- www/changelog.html | 43 +- www/cipher.html | 47 +- www/color.html | 44 +- www/command-line-options.html | 779 ++++++++++++++----------- www/command-line-processing.html | 65 ++- www/command-line-tools.html | 113 ++-- www/compare.html | 42 +- www/compose.html | 44 +- www/composite.html | 42 +- www/conjure.html | 42 +- www/contact.html | 41 +- www/convert.html | 42 +- www/display.html | 40 +- www/download.html | 44 +- www/escape.html | 50 +- www/examples.html | 40 +- www/exception.html | 36 +- www/export.html | 36 +- www/formats.html | 58 +- www/fx.html | 42 +- www/high-dynamic-range.html | 40 +- www/identify.html | 42 +- www/import.html | 42 +- www/index.html | 50 +- www/install-source.html | 42 +- www/jp2.html | 36 +- www/license.html | 70 ++- www/links.html | 201 +++---- www/magick++.html | 285 +++++++++ www/magick-core.html | 45 +- www/magick-vector-graphics.html | 178 +++--- www/magick-wand.html | 47 +- www/miff.html | 45 +- www/mogrify.html | 42 +- www/montage.html | 42 +- www/motion-picture.html | 44 +- www/perl-magick.html | 66 ++- www/quantize.html | 45 +- www/resources.html | 125 ++-- www/search.html | 39 +- www/sitemap.html | 98 ++-- www/sponsors.html | 65 ++- www/stream.html | 42 +- www/subversion.html | 39 +- www/t-shirt.html | 36 +- 114 files changed, 3419 insertions(+), 2679 deletions(-) diff --git a/ImageMagick.spec b/ImageMagick.spec index 24bceb1c1..02acb54ae 100644 --- a/ImageMagick.spec +++ b/ImageMagick.spec @@ -1,5 +1,5 @@ %global VERSION 6.6.6 -%global Patchlevel 8 +%global Patchlevel 9 Name: ImageMagick Version: %{VERSION} diff --git a/config/configure.xml b/config/configure.xml index d97b822a4..dd9ef959f 100644 --- a/config/configure.xml +++ b/config/configure.xml @@ -8,8 +8,8 @@ - - + + diff --git a/index.html b/index.html index faad7e0c8..2875097d3 100644 --- a/index.html +++ b/index.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
@@ -167,11 +171,15 @@
-

About ImageMagick

+

Create, Edit, Compose, or Convert Bitmap Images

[Introduction to ImageMagick • Features and Capabilities • Books About ImageMagick • User Community]

-

ImageMagick® is a software suite to create, edit, or compose bitmap images. It can read, convert and write images in a variety of formats (over 100) including DPX, EXR, GIF, JPEG, JPEG-2000, PDF, PhotoCD, PNG, Postscript, SVG, and TIFF. Use ImageMagick to scale, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves.

+
+ + +
+

ImageMagick® is a software suite to create, edit, compose, or convert bitmap images. It can read and write images in a variety of formats (over 100) including DPX, EXR, GIF, JPEG, JPEG-2000, PDF, PhotoCD, PNG, Postscript, SVG, and TIFF. Use ImageMagick to scale, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves.

The functionality of ImageMagick is typically utilized from the command line or you can use the features from programs written in your favorite programming language. Choose from these interfaces: G2F (Ada), MagickCore (C), MagickWand (C), ChMagick (Ch), ImageMagickObject (COM+), Magick++ (C++), JMagick (Java), L-Magick (Lisp), NMagick (Neko/haXe), MagickNet (.NET), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP (PHP), IMagick (PHP), PythonMagick (Python), RMagick (Ruby), or TclMagick (Tcl/TK). With a language interface, use ImageMagick to modify or create images dynamically and automagically.

@@ -185,7 +193,7 @@
-

Features and Capabilities

+

Features and Capabilities

Here are just a few examples of what ImageMagick can do:

@@ -220,7 +228,7 @@
-

Books About ImageMagick

+

Books About ImageMagick

Definitive Guide to ImageMagick An open source project backed by years of continual development, ImageMagick supports about 100 image formats and can perform impressive operations such as creating images from scratch; changing colors; stretching, rotating, and overlaying images; and overlaying text on images. Whether you use ImageMagick to manage the family photos or to embark on a job involving millions of images, this book provides you with the knowledge to manage your images with ease.

The Definitive Guide to ImageMagick explains all of these capabilities and more in a practical, learn-by-example fashion. You'll get comfortable using ImageMagick for any image-processing task. Through the book's coverage of the ImageMagick interfaces for C, Perl, PHP, and Ruby, you'll learn how to incorporate ImageMagick features into a variety of applications.


@@ -229,7 +237,7 @@
-

User Community

+

User Community

To join the ImageMagick user community, try the discourse server. You can review questions or comments (with informed responses) posed by ImageMagick users or ask your own questions.

diff --git a/libtool b/libtool index b8d5b3acb..56dc11f40 100755 --- a/libtool +++ b/libtool @@ -1,7 +1,7 @@ #! /bin/sh # libtool - Provide generalized library-building support services. -# Generated automatically by config.status (ImageMagick) 6.6.6-8 +# Generated automatically by config.status (ImageMagick) 6.6.6-9 # Libtool was configured on host magick.imagemagick.org: # NOTE: Changes made to this file will be lost: look at ltmain.sh. # diff --git a/magick/version.h b/magick/version.h index 4b8833e70..06797d6ae 100644 --- a/magick/version.h +++ b/magick/version.h @@ -30,10 +30,10 @@ extern "C" { #define MagickLibVersion 0x666 #define MagickLibVersionText "6.6.6" #define MagickLibVersionNumber 4,0,1 -#define MagickLibAddendum "-8" +#define MagickLibAddendum "-9" #define MagickLibInterface 4 #define MagickLibMinInterface 4 -#define MagickReleaseDate "2010-12-28" +#define MagickReleaseDate "2010-12-29" #define MagickChangeDate "20101226" #define MagickAuthoritativeURL "http://www.imagemagick.org" #if defined(MAGICKCORE_OPENMP_SUPPORT) diff --git a/version.sh b/version.sh index f86c034a1..2110c3529 100644 --- a/version.sh +++ b/version.sh @@ -12,7 +12,7 @@ PACKAGE_NAME='ImageMagick' # PACKAGE_NAME (e.g. "1.0.0"). PACKAGE_VERSION='6.6.6' PACKAGE_LIB_VERSION="0x666" -PACKAGE_RELEASE="8" +PACKAGE_RELEASE="9" PACKAGE_LIB_VERSION_NUMBER="6,6,6,${PACKAGE_RELEASE}" PACKAGE_RELEASE_DATE=`date +%F` PACKAGE_STRING="$PACKAGE_NAME $PACKAGE_VERSION" diff --git a/www/ImageMagickObject.html b/www/ImageMagickObject.html index 76aa4f707..aad2a3a68 100644 --- a/www/ImageMagickObject.html +++ b/www/ImageMagickObject.html @@ -1,7 +1,7 @@ - - + + @@ -10,7 +10,7 @@ - + @@ -22,12 +22,25 @@ - + + + + + @@ -90,7 +103,7 @@ PerlMagick
- Magick++ + Magick++
@@ -128,7 +141,7 @@
@@ -171,7 +175,7 @@

ImageMagick COM+ Compatible Component

[Introduction to the ImageMagickObject COM+ Object • Build ImageMagickObject From Source]

-

Introduction to the ImageMagickObject COM+ Object

+

Introduction to the ImageMagickObject COM+ Object

The ImageMagickObject is a COM+ compatible component that can be invoked from any language capable of using COM objects. The intended use is for Windows Scripting Host VBS scripts and Visual Basic, but it is also available from to C++, ASP, and other languages like Delphi, Perl and PHP.

@@ -197,7 +201,7 @@
-

Build ImageMagickObject From Source

+

Build ImageMagickObject From Source

The source code for ImageMagickObject is available from the ImageMagick subversion repository, or as part of the Windows source distribution. Once the source code has been retrieved and extracted, the source for ImageMagickObject is the directory ImageMagick\contrib\win32\ATL7ImageMagickObject, however, ImageMagick itself must be built using the static-multithread (VisualStaticMT) build configuration. Building ImageMagickObject requires Microsoft Visual C++ 7.0 as delivered with Microsoft's Visual Studio .NET package. See the Windows compilation instructions to get ImageMagick itself built before building the ImageMagick COM+ component.

diff --git a/www/advanced-unix-installation.html b/www/advanced-unix-installation.html index 26aa1807a..1e1c5fe8a 100644 --- a/www/advanced-unix-installation.html +++ b/www/advanced-unix-installation.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
@@ -175,7 +179,7 @@

It's possible you don't want to concern yourself with advanced installation under Unix or Linux systems. If so, you also have the option of installing a pre-compiled binary release or if you still want to install from source without all the fuss see the simple Install From Source instructions. However, if you want to customize the configuration and installation of ImageMagick under Unix or Linux systems, lets begin.

-

Download & Unpack

+

Download & Unpack

ImageMagick builds on a variety of Unix and Unix-like operating systems including Linux, Solaris, FreeBSD, Mac OS X, and others. A compiler is required and fortunately almost all modern Unix systems have one. Download ImageMagick.tar.gz from ftp.imagemagick.org or its mirrors and verify the distribution against its message digest.

@@ -187,12 +191,12 @@
-

Configure

+

Configure

The configure script looks at your environment and decides what it can cobble together to get ImageMagick compiled and installed on your system. This includes finding a compiler, where your compiler header files are located (e.g. stdlib.h), and if any delegate libraries are available for ImageMagick to use (e.g. JPEG, PNG, TIFF, etc.). If you are willing to accept configure's default options, and build from within the source directory, you can simply type:

-

$magick> cd ImageMagick-6.6.6-7 $magick> ./configure

+

$magick> cd ImageMagick-6.6.6-8 $magick> ./configure

Watch the configure script output to verify that it finds everything that you think it should. Pay particular attention to the last lines of the script output. For example, here is a recent report from our system:

@@ -457,7 +461,7 @@ Options used to compile and link:
-

Build

+

Build

Once ImageMagick is configured, these standard build targets are available from the generated make files:

@@ -484,7 +488,7 @@ Options used to compile and link:

Once built, you can optionally install ImageMagick on your system as discussed below.

-

Install

+

Install

Now that ImageMagick is configured and built, type:

@@ -512,7 +516,7 @@ Options used to compile and link:
-

Linux-specific Build instructions

+

Linux-specific Build instructions

Download ImageMagick.src.rpm from ftp.imagemagick.org or its mirrors and verify the distribution against its message digest.

@@ -525,7 +529,7 @@ Options used to compile and link:

$magick> rpm -ivh ImageMagick-6.6.6-?.*.rpm

-

Mac OS X-specific Build instructions

+

Mac OS X-specific Build instructions

Perform these steps as an administrator or with the sudo command:

@@ -546,7 +550,7 @@ Options used to compile and link:

Download the ImageMagick source distribution and verify the distribution against its message digest.

Unpack and change into the top-level ImageMagick directory:

-

$magick> tar xvfz ImageMagick-6.6.6-7.tar.gz $magick> cd ImageMagick-6.6.6-7

Configure ImageMagick:

+

$magick> tar xvfz ImageMagick-6.6.6-8.tar.gz $magick> cd ImageMagick-6.6.6-8

Configure ImageMagick:

$magick> ./configure --prefix=/opt --with-quantum-depth=16 \
--disable-dependency-tracking --with-x=yes \
--x-includes=/usr/X11R6/include --x-libraries=/usr/X11R6/lib/ \
@@ -561,14 +565,14 @@ Options used to compile and link:

-

MinGW-specific Build instructions

+

MinGW-specific Build instructions

Although you can download and install delegate libraries yourself, many are already available in the GnuWin32 distribution. Download and install whichever delegate libraries you require such as JPEG, PNG, TIFF, etc. Make sure you specify the development headers when you install a package. Next type,

-

$magick> tar jxvf ImageMagick-6.6.6-?.tar.bz2 $magick> cd ImageMagick-6.6.6-7 $magick> export CPPFLAGS="-Ic:/Progra~1/GnuWin32/include" $magick> export LDFLAGS="-Lc:/Progra~1/GnuWin32/lib" $magick> ./configure --without-perl $magick> make $magick> sudo make install

+

$magick> tar jxvf ImageMagick-6.6.6-?.tar.bz2 $magick> cd ImageMagick-6.6.6-8 $magick> export CPPFLAGS="-Ic:/Progra~1/GnuWin32/include" $magick> export LDFLAGS="-Lc:/Progra~1/GnuWin32/lib" $magick> ./configure --without-perl $magick> make $magick> sudo make install

-

Dealing with Unexpected Problems

+

Dealing with Unexpected Problems

Chances are the download, configure, build, and install of ImageMagick went flawlessly as it is intended, however, certain systems and environments may cause one or more steps to fail. We discuss a few problems we've run across and how to take corrective action to ensure you have a working release of ImageMagick

diff --git a/www/advanced-windows-installation.html b/www/advanced-windows-installation.html index 4b7d9172d..2d73ee071 100644 --- a/www/advanced-windows-installation.html +++ b/www/advanced-windows-installation.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -138,15 +151,6 @@ - - -
@@ -175,7 +179,7 @@

It's possible you don't want to concern yourself with advanced installation under Windows. If so, you also have the option of installing a self-installing binary release or if you still want to install from source without all the fuss see the simple Install From Source instructions. However, if you want to customize the configuration and installation of ImageMagick under Windows, lets begin.

-

Download & Unpack

+

Download & Unpack

Building ImageMagick source for Windows requires a modern version of Microsoft Visual Studio IDE. Users have reported success with the Borland C++ compiler as well. If you don't have a compiler you can still install a self-installing binary release.

@@ -189,7 +193,7 @@
-

Configure

+

Configure

These instructions are specific to building ImageMagick with the Visual Studio under Windows XP, Win2K, or Windows 98. ImageMagick does not include any workspace (DSW) or project files (DSP) except for those included with third party libraries. Instead, there is a configure program that must be built and run which creates the Visual Studio workspaces for ImageMagick. The Visual Studio system provides four different types of runtime environments that must match across all application, library, and dynamic-library (DLL) code that is built. The configure program creates a set of build files that are consistent for a specific runtime selection listed here:

@@ -234,7 +238,7 @@
-

Build

+

Build

After creating your build environment, proceed to open the DSW (or SLN) workspace in the VisualMagick folder. In the DSW file choose the All project to make it the active project. Set the build configuration to the desired one (Debug, or Release) and clean and build:

@@ -380,7 +384,7 @@
-

Install

+

Install

You can run ImageMagick command line utilities directly from the VisualMagick\bin folder, however, in most cases you may want the convenience of an installer script. ImageMagick provides Inno Setup scripts for this purpose. Note, you must define MAGICKCORE_INSTALLED_SUPPORT at configure time to utilize the installer scripts.

@@ -389,7 +393,7 @@
-

Create a Self-Installing Binary Distribution

+

Create a Self-Installing Binary Distribution

Prerequisites

@@ -444,7 +448,7 @@
  1. Double-click on - VisualMagick/bin/ImageMagick-6.6.6-7-Q16-windows-dll.exe + VisualMagick/bin/ImageMagick-6.6.6-8-Q16-windows-dll.exe to launch the ImageMagick binary distribution.
  2. Complete the installer screens to install ImageMagick on your system.
@@ -467,7 +471,7 @@
-

Dealing with Unexpected Problems

+

Dealing with Unexpected Problems

Chances are the download, configure, build, and install of ImageMagick went flawlessly as it is intended, however, certain systems and environments may cause one or more steps to fail. We discuss a few problems we've run across and how to take corrective action to ensure you have a working release of ImageMagick.

@@ -476,7 +480,7 @@
-

Building Your Custom Project

+

Building Your Custom Project

The Windows binary distribution includes a number of demo projects that you can use as a template for your own custom project. For example, start with the Button project, generally located in the c:/Program Files/ImageMagick-6.5.5-0/Magick++_demos folder. If not, be sure to select Configuration Properties->C/C++->Preprocessor and set these definitions:

diff --git a/www/animate.html b/www/animate.html index 57f1509c8..e12770f0e 100644 --- a/www/animate.html +++ b/www/animate.html @@ -1,7 +1,7 @@ - - + + @@ -10,7 +10,7 @@ - + @@ -22,12 +22,25 @@ - + + + + + @@ -90,7 +103,7 @@ PerlMagick
- Magick++ + Magick++
@@ -128,7 +141,7 @@
@@ -168,27 +172,29 @@
-

ImageMagick Animate Command-line Utility

+

ImageMagick Animate Command-line Tool

[Example Usage • Option Summary]

+

Use the animate program to animate an image sequence on any X server. See Command Line Processing for advice on how to structure your animate command or see below for example usages of the command.

- -
-

Example Usage

+

Example Usage

+ +

We list a few examples of the animate command here to illustrate its usefulness and ease of use. To get started, lets animate an image sequence in the GIF format:

$magick> animate movie.gif

To animate a directory of JPEG images, use:

$magick> animate *.jpg

-

You can find additional examples of using animate in Graphics from the Command Line. Further discussion is available in More Graphics from the Command Line and Examples of ImageMagick Usage.

+

You can find additional examples of using animate in Examples of ImageMagick Usage.

-
-

Option Summary

+

Option Summary

+
+

The animate command recognizes these options. Click on an option to get more details about how that option works.

@@ -621,6 +627,7 @@ transparent, extract, background, or shape the alpha channel
+
diff --git a/www/api.html b/www/api.html index 6d56e5084..7330a580a 100644 --- a/www/api.html +++ b/www/api.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
@@ -167,134 +171,104 @@
-

ImageMagick Program Interfaces

+

Create or Modify Images From Your Favorite Programming Language

+ +

[Ada • C • Ch • COM+ • C++ • Java • LabVIEW • Lisp • Neko • .NET • Pascal • Perl • PHP • Python • Realbasic • Ruby • Tcl/TK • XML RPC] -

[Ada • C • Ch • COM+ • C++ • Java • LabVIEW • Lisp • Neko • .NET • Pascal • Perl • PHP • Python • Realbasic • Ruby • Tcl/TK • XML RPC]

+ +

ImageMagick includes a number of ready-made ImageMagick interfaces. This makes it possible to modify or create images automagically and dynamically.

-
-

Ada

-
+
+
Ada
-

G2F implements an Ada 95 binding to a subset of the low-level MagickCore library.

+
G2F implements an Ada 95 binding to a subset of the low-level MagickCore library.
-
-

C

-
+
C
-

Use MagickWand to convert, compose, and edit images from the C language. There is also the low-level MagickCore library for wizard-level developers.

+
Use MagickWand to convert, compose, and edit images from the C language. There is also the low-level MagickCore library for wizard-level developers.
-
-

Ch

-
+
Ch
-

ChMagick is a Ch binding to the MagickCore and MagickWand API. Ch is an embeddable C/C++ interpreter for cross-platform scripting.

+
ChMagick is a Ch binding to the MagickCore and MagickWand API. Ch is an embeddable C/C++ interpreter for cross-platform scripting.
-
-

COM+

-
+
COM+
-

Use ImageMagickObject to convert, compose, and edit images from a Windows COM+ compatible component.

+
Use ImageMagickObject to convert, compose, and edit images from a Windows COM+ compatible component.
-
-

C++

-
+
C++
-

Magick++ provides an object-oriented C++ interface to ImageMagick. See A Gentle Introduction to Magick++ for an introductory tutorial to Magick++. We include the source if you want to correct, enhance, or expand the tutorial.

+
Magick++ provides an object-oriented C++ interface to ImageMagick. See A Gentle Introduction to Magick++ for an introductory tutorial to Magick++. We include the source if you want to correct, enhance, or expand the tutorial.
-
-

Java

-
+
Java
-

JMagick provides an object-oriented Java interface to ImageMagick. Im4java is a pure-java interface to the ImageMagick command-line.

+
JMagick provides an object-oriented Java interface to ImageMagick. Im4java is a pure-java interface to the ImageMagick command-line.
-
-

LabVIEW

-
+
LabVIEW
-

LVOOP ImageMagick is an object-oriented LabVIEW interface to ImageMagick.

+
LVOOP ImageMagick is an object-oriented LabVIEW interface to ImageMagick.
-
-

Lisp

-
+
Lisp
-

CL-Magick provides a Common Lisp interface to the ImageMagick library.

+
CL-Magick provides a Common Lisp interface to the ImageMagick library.
-
-

Neko

-
+
Neko
-

NMagick is a port of the ImageMagick library to the haXe and Neko platforms. It provides image manipulation capabilities to both web and desktop applications using Neko.

+
NMagick is a port of the ImageMagick library to the haXe and Neko platforms. It provides image manipulation capabilities to both web and desktop applications using Neko.
-
-

.NET

-
+
.NET
-

Use MagickNet to convert, compose, and edit images from Windows .NET.

+
Use MagickNet to convert, compose, and edit images from Windows .NET.
-

ImageMagickApp is a .NET application written in C# that utilizes the ImageMagick command line to allow conversion of multiple image formats to different formats.

+
ImageMagickApp is a .NET application written in C# that utilizes the ImageMagick command line to allow conversion of multiple image formats to different formats.
-
-

Pascal

-
+
Pascal
-

PascalMagick a Pascal binding for the MagickWand API and also the low-level MagickCore library. It works with Free Pascal / Lazarus and Delphi.

+
PascalMagick a Pascal binding for the MagickWand API and also the low-level MagickCore library. It works with Free Pascal / Lazarus and Delphi.
-
-

Perl

-
+
Perl
-

Use PerlMagick to convert, compose, and edit images from the Perl language.

+
Use PerlMagick to convert, compose, and edit images from the Perl language.
-
-

PHP

-
+
PHP
-

MagickWand for PHP a native PHP-extension to the ImageMagick MagickWand API.

+
MagickWand for PHP a native PHP-extension to the ImageMagick MagickWand API.
-

IMagick is a native PHP extension to create and modify images using the ImageMagick API. Documentation for the extension is available here.

+
IMagick is a native PHP extension to create and modify images using the ImageMagick API. Documentation for the extension is available here.
-

phMagick is a wrapper class for ImageMagick, wrapping the most common web image manipulation actions in easy to use functions, but allowing full access to ImageMagick's power by issuing system calls to it's command-line programs.

+
phMagick is a wrapper class for ImageMagick, wrapping the most common web image manipulation actions in easy to use functions, but allowing full access to ImageMagick's power by issuing system calls to it's command-line programs.
-
-

Python

-
+
Python
-

PythonMagickWand is an object-oriented Python interface to MagickWand based on ctypes.

+
PythonMagickWand is an object-oriented Python interface to MagickWand based on ctypes.
-

PythonMagick is an object-oriented Python interface to ImageMagick.

+
PythonMagick is an object-oriented Python interface to ImageMagick.
-
-

REALbasic

-
+
REALbasic
-

The MBS Realbasic ImageMagick is a plugin that utilizes the power of ImageMagick from within the RealBasic environment.

+
The MBS Realbasic ImageMagick is a plugin that utilizes the power of ImageMagick from within the RealBasic environment.
-
-

Ruby

-
+
Ruby
-

RMagick is an interface between the Ruby programming language and the MagickCore image processing libraries. Get started with RMagick by perusing the documentation.

+
RMagick is an interface between the Ruby programming language and the MagickCore image processing libraries. Get started with RMagick by perusing the documentation.
-

MagickWand for Ruby is an interface between the Ruby programming language and the MagickWand image processing libraries. Get started with MagickWand for PHP by perusing the documentation.

+
MagickWand for Ruby is an interface between the Ruby programming language and the MagickWand image processing libraries. Get started with MagickWand for PHP by perusing the documentation.
-

MiniMagick is a Ruby wrapper for ImageMagick command line. MiniMagick gives you convenient access to all the command line options ImageMagick supports.

+
MiniMagick is a Ruby wrapper for ImageMagick command line. MiniMagick gives you convenient access to all the command line options ImageMagick supports.
-

QuickMagick is a gem for easily accessing ImageMagick command line tools from Ruby programs.

+
QuickMagick is a gem for easily accessing ImageMagick command line tools from Ruby programs.
-
-

Tcl/Tk

-
+
Tcl/Tk
-

TclMagick a native Tcl-extension to the ImageMagick MagickWand API.

+
TclMagick a native Tcl-extension to the ImageMagick MagickWand API.
-
-

XML RPC

-
+
XML RPC
-

RemoteMagick is an XML-RPC web service that creates image thumbnails.

+
RemoteMagick is an XML-RPC web service that creates image thumbnails.
+
+
diff --git a/www/api/animate.html b/www/api/animate.html index 9371198f4..6d5be26b3 100644 --- a/www/api/animate.html +++ b/www/api/animate.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -138,15 +151,6 @@ - - -
diff --git a/www/api/annotate.html b/www/api/annotate.html index 1da8e11f4..80797c3ec 100644 --- a/www/api/annotate.html +++ b/www/api/annotate.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -138,15 +151,6 @@ - - -
diff --git a/www/api/attribute.html b/www/api/attribute.html index 2c2ed6f6b..be70b0a6b 100644 --- a/www/api/attribute.html +++ b/www/api/attribute.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -138,15 +151,6 @@ - - -
diff --git a/www/api/blob.html b/www/api/blob.html index 8ef21872d..2de611683 100644 --- a/www/api/blob.html +++ b/www/api/blob.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/cache-view.html b/www/api/cache-view.html index 64be9f498..23c2400ee 100644 --- a/www/api/cache-view.html +++ b/www/api/cache-view.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -138,15 +151,6 @@ - - -
diff --git a/www/api/cache.html b/www/api/cache.html index 6227151d7..50b9369c1 100644 --- a/www/api/cache.html +++ b/www/api/cache.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/cipher.html b/www/api/cipher.html index 742424407..dc8f6f9d7 100644 --- a/www/api/cipher.html +++ b/www/api/cipher.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/color.html b/www/api/color.html index 7ae89e3c1..444a4d998 100644 --- a/www/api/color.html +++ b/www/api/color.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/colormap.html b/www/api/colormap.html index 4cef4bb48..0bba5367e 100644 --- a/www/api/colormap.html +++ b/www/api/colormap.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/compare.html b/www/api/compare.html index 8df040525..18ff42685 100644 --- a/www/api/compare.html +++ b/www/api/compare.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -138,15 +151,6 @@ - - -
diff --git a/www/api/composite.html b/www/api/composite.html index 83d83639c..33c7b0f65 100644 --- a/www/api/composite.html +++ b/www/api/composite.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/constitute.html b/www/api/constitute.html index af0b0e1c7..ff0f49e9a 100644 --- a/www/api/constitute.html +++ b/www/api/constitute.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/decorate.html b/www/api/decorate.html index 76c3e414d..af2a953e6 100644 --- a/www/api/decorate.html +++ b/www/api/decorate.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -138,15 +151,6 @@ - - -
diff --git a/www/api/deprecate.html b/www/api/deprecate.html index a44014363..906c4e414 100644 --- a/www/api/deprecate.html +++ b/www/api/deprecate.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/display.html b/www/api/display.html index 0da58ba53..93fcf6397 100644 --- a/www/api/display.html +++ b/www/api/display.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/distort.html b/www/api/distort.html index 531e8eabf..cf03d4e1d 100644 --- a/www/api/distort.html +++ b/www/api/distort.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/draw.html b/www/api/draw.html index 38de95b95..7548e4a52 100644 --- a/www/api/draw.html +++ b/www/api/draw.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/drawing-wand.html b/www/api/drawing-wand.html index 93ccd5f8d..9f2843873 100644 --- a/www/api/drawing-wand.html +++ b/www/api/drawing-wand.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/effect.html b/www/api/effect.html index c670fe282..9812e8b22 100644 --- a/www/api/effect.html +++ b/www/api/effect.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/enhance.html b/www/api/enhance.html index 63b672086..724ff939e 100644 --- a/www/api/enhance.html +++ b/www/api/enhance.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/exception.html b/www/api/exception.html index a81e98241..18bfaa8b8 100644 --- a/www/api/exception.html +++ b/www/api/exception.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/feature.html b/www/api/feature.html index 527507d77..7d69b6c5e 100644 --- a/www/api/feature.html +++ b/www/api/feature.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -138,15 +151,6 @@ - - -
diff --git a/www/api/fx.html b/www/api/fx.html index 36aaf9068..11cd808da 100644 --- a/www/api/fx.html +++ b/www/api/fx.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -138,15 +151,6 @@ - - -
diff --git a/www/api/histogram.html b/www/api/histogram.html index 566acdd00..def78f907 100644 --- a/www/api/histogram.html +++ b/www/api/histogram.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/image-view.html b/www/api/image-view.html index 5de5ecebe..67e633a87 100644 --- a/www/api/image-view.html +++ b/www/api/image-view.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -138,15 +151,6 @@ - - -
diff --git a/www/api/image.html b/www/api/image.html index 1a48dfe50..3ce91912c 100644 --- a/www/api/image.html +++ b/www/api/image.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -138,15 +151,6 @@ - - -
diff --git a/www/api/layer.html b/www/api/layer.html index 12c6db164..a74c30d48 100644 --- a/www/api/layer.html +++ b/www/api/layer.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/list.html b/www/api/list.html index e04881b9f..4dc41a863 100644 --- a/www/api/list.html +++ b/www/api/list.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/magick-deprecate.html b/www/api/magick-deprecate.html index 57752d3f0..97e4ac064 100644 --- a/www/api/magick-deprecate.html +++ b/www/api/magick-deprecate.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/magick-image.html b/www/api/magick-image.html index c40625cb7..e430c94b5 100644 --- a/www/api/magick-image.html +++ b/www/api/magick-image.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/magick-property.html b/www/api/magick-property.html index e7a7a9b9c..faeca5d06 100644 --- a/www/api/magick-property.html +++ b/www/api/magick-property.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/magick-wand.html b/www/api/magick-wand.html index 5fd3df7aa..aaa92e7ff 100644 --- a/www/api/magick-wand.html +++ b/www/api/magick-wand.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/magick.html b/www/api/magick.html index b44cfbf55..858724f36 100644 --- a/www/api/magick.html +++ b/www/api/magick.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/memory.html b/www/api/memory.html index 2b9af18e1..154f2a23a 100644 --- a/www/api/memory.html +++ b/www/api/memory.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/module.html b/www/api/module.html index b7c58afbc..577d70ae0 100644 --- a/www/api/module.html +++ b/www/api/module.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/mogrify.html b/www/api/mogrify.html index 851e71fd8..f4248893c 100644 --- a/www/api/mogrify.html +++ b/www/api/mogrify.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/monitor.html b/www/api/monitor.html index 3305984de..ef40b3dc3 100644 --- a/www/api/monitor.html +++ b/www/api/monitor.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/montage.html b/www/api/montage.html index 90a162ec4..5e6ff9311 100644 --- a/www/api/montage.html +++ b/www/api/montage.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -138,15 +151,6 @@ - - -
diff --git a/www/api/morphology.html b/www/api/morphology.html index 2de1b5152..93c74c0f1 100644 --- a/www/api/morphology.html +++ b/www/api/morphology.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -138,15 +151,6 @@ - - -
diff --git a/www/api/paint.html b/www/api/paint.html index a8225bbe5..1e0d67a69 100644 --- a/www/api/paint.html +++ b/www/api/paint.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -138,15 +151,6 @@ - - -
diff --git a/www/api/pixel-iterator.html b/www/api/pixel-iterator.html index 2577576d4..360afa9ca 100644 --- a/www/api/pixel-iterator.html +++ b/www/api/pixel-iterator.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/pixel-wand.html b/www/api/pixel-wand.html index cc0484dc1..a484b4f56 100644 --- a/www/api/pixel-wand.html +++ b/www/api/pixel-wand.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/profile.html b/www/api/profile.html index aa3c9b6a7..e2e2d3c2b 100644 --- a/www/api/profile.html +++ b/www/api/profile.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/property.html b/www/api/property.html index 6babb55c3..936ec772e 100644 --- a/www/api/property.html +++ b/www/api/property.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/quantize.html b/www/api/quantize.html index 2f0eb3edb..f127ed39c 100644 --- a/www/api/quantize.html +++ b/www/api/quantize.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -138,15 +151,6 @@ - - -
diff --git a/www/api/registry.html b/www/api/registry.html index 0d0a2298a..5291dc3d8 100644 --- a/www/api/registry.html +++ b/www/api/registry.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/resize.html b/www/api/resize.html index 64fcedea4..b89709002 100644 --- a/www/api/resize.html +++ b/www/api/resize.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/resource.html b/www/api/resource.html index 0e6579334..186b239d0 100644 --- a/www/api/resource.html +++ b/www/api/resource.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/segment.html b/www/api/segment.html index 58d48e3dd..ec78f1faf 100644 --- a/www/api/segment.html +++ b/www/api/segment.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/shear.html b/www/api/shear.html index 2393ce6e1..fb023cf6c 100644 --- a/www/api/shear.html +++ b/www/api/shear.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/signature.html b/www/api/signature.html index 08ffc0101..ae77ec103 100644 --- a/www/api/signature.html +++ b/www/api/signature.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/statistic.html b/www/api/statistic.html index d106066b6..e49b24895 100644 --- a/www/api/statistic.html +++ b/www/api/statistic.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/stream.html b/www/api/stream.html index a7ab85f75..e2b9cc147 100644 --- a/www/api/stream.html +++ b/www/api/stream.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/transform.html b/www/api/transform.html index d060c9859..df1878306 100644 --- a/www/api/transform.html +++ b/www/api/transform.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -138,15 +151,6 @@ - - -
diff --git a/www/api/version.html b/www/api/version.html index 3c39d2e0e..3a913c1df 100644 --- a/www/api/version.html +++ b/www/api/version.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/api/wand-view.html b/www/api/wand-view.html index 5b445b316..0f8e64207 100644 --- a/www/api/wand-view.html +++ b/www/api/wand-view.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/architecture.html b/www/architecture.html index 76f1062c6..39ce8a364 100644 --- a/www/architecture.html +++ b/www/architecture.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
@@ -169,7 +173,7 @@ -

ImageMagick Architecture

+

The Magick Behind ImageMagick

[Architecture Overview • The Pixel Cache • Streaming Pixels • Image Properties and Profiles • Large Image Support • Threads of Execution • Heterogeneous Distributed Processing • Custom Image Coders • Custom Image Filters]

@@ -177,7 +181,7 @@

The citizens of Oz were quite content with their benefactor, the all-powerful Wizard. They accepted his wisdom and benevolence without ever questioning the who, why, and where of his power. Like the citizens of Oz, if you feel comfortable that ImageMagick can help you convert, edit, or compose your images without knowing what goes on behind the curtain, feel free to skip this section. However, if you want to know more about the software and algorithms behind ImageMagick, read on. To fully benefit from this discussion, you should be comfortable with image nomenclature and be familiar with computer programming.

-

Architecture Overview

+

Architecture Overview

An image typically consists of a rectangular region of pixels and metadata. To convert, edit, or compose an image in an efficient manner we need convenient access to any pixel anywhere within the region (and sometimes outside the region). And in the case of an image sequence, we need access to any pixel of any region of any image in the sequence. However, there are hundreds of image formats such JPEG, TIFF, PNG, GIF, etc., that makes it difficult to access pixels on demand. Within these formats we find differences in:

@@ -220,7 +224,7 @@
-

The Pixel Cache

+

The Pixel Cache

The ImageMagick pixel cache is a repository for image pixels with up to 5 channels. The first 4 channels are stored contiguously and an optional second area follows with 1 channel. The channels are at the depth specified when ImageMagick was built. The channel depths are 8 bits-per-pixel component for the Q8 version of ImageMagick, 16 bits-per-pixel component for the Q16 version, and 32 bits-per-pixel component for the Q32 version. By default pixel components are unsigned quantities, however, if you use the high dynamic-range version of ImageMagick, the components are 32-bit floating point. The primary 4 channels can hold any value but typically contain red, green, blue, and alpha intensities or cyan, magenta, yellow, and alpha intensities. The optional fifth channel contains the colormap indexes for colormapped images or the black channel for CMYK images. The pixel cache storage may be heap memory, anonymous memory mapped memory, disk-backed memory mapped, or on disk. The pixel cache is reference-counted. Only the cache properties are copied when the cache is cloned. The cache pixels are subsequently copied only when you signal your intention to update any of the pixels.

@@ -256,11 +260,11 @@

When the pixel cache is initialized, pixels are scaled from whatever bit depth they originated from to that required by the pixel cache. For example, a 1-channel 1-bit monochrome PBM image is scaled to a 4 channel 8-bit RGBA image, if you are using the Q8 version of ImageMagick, and 16-bit RGBA for the Q16 version. You can determine which version you have with the ‑version option:

-

$magick> identify -versionVersion: ImageMagick 6.6.6-7 2010-12-25 Q16 http://www.imagemagick.org

+

$magick> identify -versionVersion: ImageMagick 6.6.6-8 2010-12-25 Q16 http://www.imagemagick.org

As you can see, the convenience of the pixel cache sometimes comes with a trade-off in storage (e.g. storing a 1-bit monochrome image as 16-bit RGBA is wasteful) and speed (i.e. storing the entire image in memory is generally slower than accessing one scanline of pixels at a time). In most cases, the benefits of the pixel cache typically outweigh any disadvantages.

-

Access the Pixel Cache

+

Access the Pixel Cache

Once the pixel cache is associated with an image, you typically want to get, update, or put pixels into it. We refer to pixels inside the image region as authentic pixels and outside the region as virtual pixels. Use these methods to access the pixels in the cache:

@@ -274,7 +278,6 @@

Here is a typical MagickCore code snippet for manipulating pixels in the pixel cache. In our example, we copy pixels from the input image to the output image and decrease the intensity by 10%:

-
   const PixelPacket
     *p;
 
@@ -309,7 +312,6 @@
   }
   if (y < (ssize_t) source->rows)
     { /* an exception was thrown */ }
-

When we first create the destination image by cloning the source image, the pixel cache pixels are not copied. They are only copied when you signal your intentions to modify the pixel cache by calling GetAuthenticPixels() or QueueAuthenticPixels(). Use QueueAuthenticPixels() if you want to set new pixel values rather than update existing ones. You could use GetAuthenticPixels() to set pixel values but it is slightly more efficient to use QueueAuthenticPixels() instead. Finally, use SyncAuthenticPixels() to ensure any updated pixels are pushed to the pixel cache.

@@ -342,7 +344,7 @@

gives you the pixels you asked for without complaint, even though some are not within the confines of the image region.

-

Virtual Pixels

+

Virtual Pixels

There are a plethora of image processing algorithms that require a neighborhood of pixels about a pixel of interest. The algorithm typically includes a caveat concerning how to handle pixels around the image boundaries, known as edge pixels. With virtual pixels, you do not need to concern yourself about special edge processing other than choosing which virtual pixel method is most appropriate for your algorithm.

@@ -392,11 +394,12 @@

To determine the current setting of these limits, use this command:

-

$magick> identify -list resource

File         Area       Memory          Map         Disk    Thread         Time
+
 $magick> identify -list resource
+File         Area       Memory          Map         Disk    Thread         Time
 -------------------------------------------------------------------------------
  768     1.0386GB    3.8692GiB    7.7384GiB    unlimited         4    unlimited
-

+
+

You can set these limits either as a policy (see policy.xml), with an environment variable, with the -limit command line option, or with the SetMagickResourceLimit() MagickCore API method. As an example, our online web interface to ImageMagick, ImageMagick Studio, has an area limit of 64 megabytes, a memory limit of 128 mebibytes and a map limit of 256 mebibytes and a disk limit of 1 gigabytes. Since we process multiple simultaneous sessions, we don't want any one session consuming all the available memory. Instead large images are cached to disk. If the image is too large and exceeds the pixel cache disk limit, the program exits. In addition, we place a 60 second time limit to prevent any run-away processing tasks.

Note, the cache limits are global, meaning if you create several images, the combined resource requirements are compared to the limit to determine the pixel cache storage disposition.

@@ -471,7 +474,7 @@
-

Streaming Pixels

+

Streaming Pixels

ImageMagick provides for streaming pixels as they are read from or written to an image. This has several advantages over the pixel cache. The time and resources consumed by the pixel cache scale with the area of an image, whereas the pixel stream resources scale with the width of an image. The disadvantage is the pixels must be consumed as they are streamed so there is no persistence.

@@ -491,11 +494,11 @@ static size_t StreamHandler(const Image *image,const void *pixels, image=ReadStream(image_info,&StreamHandler,exception); -

We also provide a lightweight tool, stream, to stream one or more pixel components of the image or portion of the image to your choice of storage formats. It writes the pixel components as they are read from the input image a row at a time making stream desirable when working with large images or when you require raw pixel components.

+

We also provide a lightweight tool, stream, to stream one or more pixel components of the image or portion of the image to your choice of storage formats. It writes the pixel components as they are read from the input image a row at a time making stream desirable when working with large images or when you require raw pixel components.

-

Image Properties and Profiles

+

Image Properties and Profiles

Images have metadata associated with them in the form of properties (e.g. width, height, description, etc.) and profiles (e.g. EXIF, IPTC, color management). ImageMagick provides convenient methods to get, set, or update image properties and get, set, update, or apply profiles. Some of the more popular image properties are associated with the Image structure in the MagickCore API. For example:

@@ -535,7 +538,7 @@ image=ReadStream(image_info,&StreamHandler,exception);
-

Large Image Support

+

Large Image Support

ImageMagick can read, process, or write mega-, giga-, or tera-pixel image sizes. An image width or height can range from 1 to 2 giga-pixels on a 32 bit OS and up to 9 exa-pixels on a 64-bit OS. Note, that some image formats have restrictions on image size. For example, Photoshop images are limited to 300,000 pixels for width or height. Here we resize an image to a quarter million pixels square:

@@ -553,7 +556,7 @@ image=ReadStream(image_info,&StreamHandler,exception);

$magick> convert -monitor -define registry:temporary-path=/data/tmp -limit area 0 \
logo: -resize 250000x250000 logo.miff

-

Threads of Execution

+

Threads of Execution

Many of ImageMagick's internal algorithms are threaded to take advantage of speed-ups offered by the multicore processor chips. However, you are welcome to use ImageMagick algorithms in your threads of execution with the exception of the MagickCore's GetVirtualPixels(), GetAuthenticPixels(), QueueAuthenticPixels(), or SyncAuthenticPixels() pixel cache methods. These methods are intended for one thread of execution only with the exception of an OpenMP parallel section. To access the pixel cache with more than one thread of execution, use a cache view. We do this for the CompositeImage() method, for example. Suppose we want to composite a single image over a different image in each thread of execution. If we use GetVirtualPixels(), the results are unpredictable because multiple threads would likely be asking for different areas of the pixel cache simultaneously. Instead we use GetCacheViewVirtualPixels() which creates a unique view for each thread of execution ensuring our program behaves properly regardless of how many threads are invoked. The other program interfaces, such as the MagickWand API, are completely thread safe so there are no special precautions for threads of execution.

@@ -561,7 +564,6 @@ image=ReadStream(image_info,&StreamHandler,exception);

Here is an example of how ImageMagick can take advantage of threads of execution with the OpenMP programming paradigm:

-
 {
   CacheView
     *image_view;
@@ -612,7 +614,6 @@ image=ReadStream(image_info,&StreamHandler,exception);
   if (status == MagickFalse)
     perror("something went wrong");
 }
-
@@ -636,7 +637,7 @@ image=ReadStream(image_info,&StreamHandler,exception);
-

Heterogeneous Distributed Processing

+

Heterogeneous Distributed Processing

ImageMagick includes support for heterogeneous distributed processing with the OpenCL framework. OpenCL kernels within ImageMagick permit image processing algorithms to execute across heterogeneous platforms consisting of CPUs, GPUs, and other processors. Depending on your platform, speed-ups can be an order of magnitude faster than the traditional single CPU.

@@ -651,7 +652,6 @@ image=ReadStream(image_info,&StreamHandler,exception);

Here is an example OpenCL kernel that convolves an image:

-
 static inline long ClampToCanvas(const long offset,const ulong range)
 {
   if (offset < 0L)
@@ -709,14 +709,13 @@ __kernel void Convolve(const __global CLPixelType *source,__constant double *fil
   destination[index].z=ClampToQuantum(gamma*sum.z);
   destination[index].w=ClampToQuantum(sum.w);
 };
-

See magick/accelerate.c for a complete implementation of image convolution with an OpenCL kernel.

-

Custom Image Coders

+

Custom Image Coders

An image coder (i.e. encoder / decoder) is responsible for registering, optionally classifying, optionally reading, optionally writing, and unregistering one image format (e.g. PNG, GIF, JPEG, etc.). Registering an image coder alerts ImageMagick a particular format is available to read or write. While unregistering tells ImageMagick the format is no longer available. The classifying method looks at the first few bytes of an image and determines if the image is in the expected format. The reader sets the image size, colorspace, and other properties and loads the pixel cache with the pixels. The reader returns a single image or an image sequence (if the format supports multiple images per file), or if an error occurs, an exception and a null image. The writer does the reverse. It takes the image properties and unloads the pixel cache and writes them as required by the image format.

@@ -724,7 +723,6 @@ __kernel void Convolve(const __global CLPixelType *source,__constant double *fil

Here is a listing of a sample custom coder. It reads and writes images in the MGK image format which is simply an ID followed by the image width and height followed by the RGB pixel values.

-
 /*
   Include declarations.
 */
@@ -911,7 +909,7 @@ static Image *ReadMGKImage(const ImageInfo *image_info,
       }
       if (SyncAuthenticPixels(image,exception) == MagickFalse)
         break;
-      if ((image->previous == (Image *) NULL) &&
+      if ((image->previous == (Image *) NULL) &&
           (SetImageProgress(image,LoadImageTag,y,image>>rows) == MagickFalse))
         break;
     }
@@ -1109,7 +1107,7 @@ static MagickBooleanType WriteMGKImage(const ImageInfo *image_info,Image *image)
         p++;
       }
       (void) WriteBlob(image,(size_t) (q-pixels),pixels);
-      if ((image->previous == (Image *) NULL) &&
+      if ((image->previous == (Image *) NULL) &&
           (SetImageProgress(image,SaveImageTag,y,image->rows) == MagickFalse))
         break;
     }
@@ -1126,7 +1124,6 @@ static MagickBooleanType WriteMGKImage(const ImageInfo *image_info,Image *image)
   (void) CloseBlob(image);
   return(MagickTrue);
 }
-

To invoke the custom coder from the command line, use these commands:

@@ -1136,7 +1133,7 @@ static MagickBooleanType WriteMGKImage(const ImageInfo *image_info,Image *image)
-

Custom Image Filters

+

Custom Image Filters

ImageMagick provides a convenient mechanism for adding your own custom image processing algorithms. We call these image filters and they are invoked from the command line with the -process option or from the MagickCore API method ExecuteModuleProcess().

@@ -1144,7 +1141,6 @@ static MagickBooleanType WriteMGKImage(const ImageInfo *image_info,Image *image)

Here is a listing of a sample custom image filter. It computes a few statistics such as the pixel brightness and saturation mean and standard-deviation.

-
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
@@ -1152,7 +1148,7 @@ static MagickBooleanType WriteMGKImage(const ImageInfo *image_info,Image *image)
 #include <assert.h>
 #include <math.h>
 #include "magick/MagickCore.h"
-
+
 /*
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %                                                                             %
@@ -1343,7 +1339,6 @@ ModuleExport unsigned long analyzeImage(Image **images,const int argc,
   }
   return(MagickImageFilterSignature);
 }
-

To invoke the custom filter from the command line, use this command:

diff --git a/www/binary-releases.html b/www/binary-releases.html index 1bbbda14f..e80bbadca 100644 --- a/www/binary-releases.html +++ b/www/binary-releases.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
@@ -168,14 +172,14 @@
-

ImageMagick Binary Releases

+

Download Binary Releases

[Unix Binary Release • Mac OS X Binary Release • Windows Binary Release]

You can install ImageMagick from source. However, if don't have a proper development environment or if you're anxious to get started, download a ready-to-run Unix or Windows executable. Before you download, you may want to review recent changes to the ImageMagick distribution.

-

Unix Binary Release

+

Unix Binary Release

These are the Unix variations that we support. If your system is not on the list, try installing from source. Although ImageMagick runs fine on a single core computer, it automagically runs in parallel on dual and quad-core systems reducing run times considerably.

@@ -190,16 +194,16 @@ - ImageMagick-6.6.6-7.i386.rpm - download - download + ImageMagick-6.6.6-8.i386.rpm + download + download CentOS 5.4 i386 RPM - ImageMagick-6.6.6-7.x86_64.rpm - download - download + ImageMagick-6.6.6-8.x86_64.rpm + download + download CentOS 5.4 x86_64 RPM @@ -229,7 +233,7 @@

ImageMagick RPM's are self-installing. Simply type the following command and you're ready to start using ImageMagick:

-

$magick> rpm -Uvh ImageMagick-6.6.6-7.i386.rpm

+

$magick> rpm -Uvh ImageMagick-6.6.6-8.i386.rpm

For other systems, create (or choose) a directory to install the package into and change to that directory, for example:

$magick> cd $HOME

@@ -253,7 +257,7 @@
-

Mac OS X Binary Release

+

Mac OS X Binary Release

We recommend MacPorts which custom builds ImageMagick in your environment. Download MacPorts and type:

@@ -305,7 +309,7 @@
-

Windows Binary Release

+

Windows Binary Release

ImageMagick runs on Windows XP (x86) with Service Pack 3, Windows Vista (x86 & x64) with Service Pack 2, Windows 7 (x86 & x64), Windows Server 2003 (x86 & x64) with Service Pack 2 (verify MSXML6 is present), Windows Server 2003 R2 (x86 & x64), Windows Server 2008 (x86 & x64) with Service Pack 2, and Windows Server 2008 R2 (x64).

@@ -313,7 +317,7 @@

The amount of memory can be an important factor, especially if you intend to work on large images. A minimum of 512 MB of RAM is recommended, but the more RAM the better. Although ImageMagick runs well on a single core computer, it automagically runs in parallel on multi-core systems reducing run times considerably.

The Windows version of ImageMagick is self-installing. Simply click on the appropriate version below and it will launch itself and ask you a few installation questions. Versions with Q8 in the name are 8 bits-per-pixel component (e.g. 8-bit red, 8-bit green, etc.), whereas, Q16 in the filename are 16 bits-per-pixel component. A Q16 version permits you to read or write 16-bit images without losing precision but requires twice as much resources as the Q8 version. Versions with dll in the filename include ImageMagick libraries as dynamic link libraries. If you are not sure which version is appropriate, choose -ImageMagick-6.6.6-7-Q16-windows-dll.exe.

+ImageMagick-6.6.6-8-Q16-windows-dll.exe.

@@ -325,44 +329,44 @@ - - - + + + - - - + + + - - - + + + - - - + + + - - - + + + - - - + + + diff --git a/www/changelog.html b/www/changelog.html index 8ec8a08e0..b9b75edcc 100644 --- a/www/changelog.html +++ b/www/changelog.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
@@ -167,7 +171,12 @@
-
    2010-12-21 6.6.6-7 Glenn Randers-Pehrson <glennrp@image...>
    +
      2010-12-26 6.6.6-8 Cristy <quetzlzacatenango@image...>
      +
    • -posterize fails with more than 40 levels (reference http://www.imagemagick.org/discourse-server/viewtopic.html?f=3&t=17741).
      • +
    • Add support for the MacPaint image format.
      • +
    • Eliminate spurios 'invalid colormap index' exception for 16-bit SGI images (bug report by steven.sittser@fligh...).
      • +
    • Fix user data length for the CIN image format.

      • +
      2010-12-21 6.6.6-7 Glenn Randers-Pehrson <glennrp@image...>
    • Use a clone instead of the main image in coders/png.c, so the image can still be used later on without being affected by changes made by the PNG encoder.
    • Added PNG:exclude-chunk and PNG:include-chunk defines.
    • Revised the -strip option so it behaves as though "-define PNG:include-chunk=none,gama" had appeared on the commandline.
      • diff --git a/www/cipher.html b/www/cipher.html index 67bfac51d..2ee16ee45 100644 --- a/www/cipher.html +++ b/www/cipher.html @@ -1,7 +1,7 @@ - - + + @@ -10,7 +10,7 @@ - + @@ -22,12 +22,25 @@ - + + + + + @@ -90,7 +103,7 @@ PerlMagick
- Magick++ + Magick++
@@ -128,7 +141,7 @@
@@ -168,10 +172,9 @@
-

ImageMagikc Enciphering and Deciphering Images

-

[Introduction to Enciphering and Deciphering Images • Encipher an Image • Decipher an Image • Encipher and Decipher Caveats]

+

Enciphering and Deciphering Images

+

[Encipher an Image • Decipher an Image • Encipher and Decipher Caveats]

-

Introduction to Enciphering and Deciphering Images

Most images, by design, are made to be viewed often and by many people. Web images, for example, may be viewed hundreds of times a day by a multitude of web vistors. However, in some cases, you may want to keep a particular image private so that only you or perhaps a select group of your friends or web visitors can view it. ImageMagick permits you to scramble your images such that unless someone knows your passphrase, they will be unable to view the original content.

@@ -180,7 +183,7 @@
-

Encipher an Image

+

Encipher an Image

Use the -encipher option to scramble your image so that it is unrecognizable. The option requires a filename that contains your passphrase. In this example we scramble an image and save it in the PNG format:

@@ -191,7 +194,7 @@

$magick> convert rose.jpg -encipher smiley.gif rose.png

-

Decipher an Image

+

Decipher an Image

Use the -decipher option to unscramble your image so that it is recognizable once again. The option requires a filename that contains your passphrase. In this example we unscramble an image and save it in the JPEG format:

@@ -199,7 +202,7 @@

$magick> convert rose.png -decipher passphrase.txt rose.jpg

-

Encipher and Decipher Caveats

+

Encipher and Decipher Caveats

Some formats do not support enciphered pixels-- the JPEG or GIF format, for diff --git a/www/color.html b/www/color.html index ffd3487eb..ca63852e8 100644 --- a/www/color.html +++ b/www/color.html @@ -1,7 +1,7 @@ - - + + @@ -10,7 +10,7 @@ - + @@ -22,12 +22,25 @@ - + + + + + @@ -90,7 +103,7 @@ PerlMagick

- Magick++ + Magick++
@@ -128,7 +141,7 @@
@@ -175,7 +179,7 @@

A number of ImageMagick options and methods take a color as an argument. The color can then be given as a color name (there is a limited but large set of these; see below) or it can be given as a set of numbers (in decimal or hexadecimal), each corresponding to a channel in an RGB or RGBA color model. HSL, HSLA, HSB, HSBA, CMYK, or CMYKA color models may also be specified. These topics are briefly described in the sections below.

-

Interactive Color Converter

+

Interactive Color Converter

Use the @@ -185,7 +189,7 @@ color swatch of that color and to convert to all the other color models.

-

Example Usage

+

Example Usage

Each of the following commands produces the same lime border around the image. (Use "double quotes" for Windows.)

@@ -195,7 +199,7 @@ color swatch of that color and to convert to all the other color models.
-

Color Model Specification

+

Color Model Specification

The RGB, CMYK, HSL and HSB color models are used in numerical color specifications. These examples all specify the same red RGB color:

@@ -291,7 +295,7 @@ color swatch of that color and to convert to all the other color models.
-

List of Color Names

+

List of Color Names

The table below provides a list of named colors recognized by ImageMagick:

diff --git a/www/command-line-options.html b/www/command-line-options.html index 8e821c5c5..117598ceb 100644 --- a/www/command-line-options.html +++ b/www/command-line-options.html @@ -2,18 +2,18 @@ - - + + - ImageMagick: Command-line Options + ImageMagick: Command-line Options - + @@ -25,12 +25,25 @@ - + + + + + @@ -93,7 +106,7 @@ PerlMagick
- Magick++ + Magick++
@@ -120,10 +133,10 @@
- Site Map + Site Map
- Links + Links
@@ -142,15 +155,6 @@ - - -
@@ -171,9 +175,12 @@
+

Create, Edit, or Compose Bitmap Images With These Command-line Options

[ ‑adaptive‑blur  • ‑adaptive‑resize  • ‑adaptive‑sharpen  • ‑adjoin  • ‑affine  • ‑alpha  • ‑annotate  • ‑antialias  • ‑append  • ‑attenuate  • ‑authenticate  • ‑auto‑gamma  • ‑auto‑level  • ‑auto‑orient  • ‑backdrop  • ‑background  • ‑bench  • ‑bias  • ‑blackpoint‑compensation  • ‑black‑threshold  • ‑blend  • ‑blue‑primary  • ‑blue‑shift  • ‑blur  • ‑border  • ‑bordercolor  • ‑borderwidth  • ‑brightness‑contrast  • ‑cache  • ‑caption  • ‑cdl  • ‑channel  • ‑charcoal  • ‑chop  • ‑clamp  • ‑clip  • ‑clip‑mask  • ‑clip‑path  • ‑clone  • ‑clut  • ‑coalesce  • ‑colorize  • ‑colormap  • ‑color‑matrix  • ‑colors  • ‑colorspace  • ‑combine  • ‑comment  • ‑compose  • ‑composite  • ‑compress  • ‑contrast  • ‑contrast‑stretch  • ‑convolve  • ‑crop  • ‑cycle  • ‑debug  • ‑decipher  • ‑deconstruct  • ‑define  • ‑delay  • ‑delete  • ‑density  • ‑depth  • ‑descend  • ‑deskew  • ‑despeckle  • ‑direction  • ‑displace  • ‑display  • ‑dispose  • ‑dissimilarity‑threshold  • ‑dissolve  • ‑distort  • ‑dither  • ‑draw  • ‑edge  • ‑emboss  • ‑encipher  • ‑encoding  • ‑endian  • ‑enhance  • ‑equalize  • ‑evaluate  • ‑evaluate‑sequence  • ‑extent  • ‑extract  • ‑family  • ‑features  • ‑fft  • ‑fill  • ‑filter  • ‑flatten  • ‑flip  • ‑floodfill  • ‑flop  • ‑font  • ‑foreground  • ‑format  • ‑format[identify]  • ‑frame  • ‑frame[import]  • ‑function  • ‑fuzz  • ‑fx  • ‑gamma  • ‑gaussian‑blur  • ‑geometry  • ‑gravity  • ‑green‑primary  • ‑hald‑clut  • ‑help  • ‑highlight‑color  • ‑iconGeometry  • ‑iconic  • ‑identify  • ‑ift  • ‑immutable  • ‑implode  • ‑insert  • ‑intent  • ‑interlace  • ‑interpolate  • ‑interline‑spacing  • ‑interword‑spacing  • ‑kerning  • ‑label  • ‑lat  • ‑layers  • ‑level  • ‑level‑colors  • ‑limit  • ‑linear‑stretch  • ‑linewidth  • ‑liquid‑rescale  • ‑list  • ‑log  • ‑loop  • ‑lowlight‑color  • ‑magnify  • ‑map  • ‑map[stream]  • ‑mask  • ‑mattecolor  • ‑median  • ‑metric  • ‑mode  • ‑modulate  • ‑monitor  • ‑monochrome  • ‑morph  • ‑morphology  • ‑mosaic  • ‑motion‑blur  • ‑name  • ‑negate  • ‑noise  • ‑normalize  • ‑opaque  • ‑ordered‑dither  • ‑orient  • ‑page  • ‑paint  • ‑path  • ‑pause[animate]  • ‑pause[import]  • ‑pen  • ‑ping  • ‑pointsize  • ‑polaroid  • ‑posterize  • ‑precision  • ‑preview  • ‑print  • ‑process  • ‑profile  • ‑quality  • ‑quantize  • ‑quiet  • ‑radial‑blur  • ‑raise  • ‑random‑threshold  • ‑red‑primary  • ‑regard‑warnings  • ‑region  • ‑remap  • ‑remote  • ‑render  • ‑repage  • ‑resample  • ‑resize  • ‑respect‑parentheses  • ‑reverse  • ‑roll  • ‑rotate  • ‑sample  • ‑sampling‑factor  • ‑scale  • ‑scene  • ‑screen  • ‑seed  • ‑segment  • ‑selective‑blur  • ‑separate  • ‑sepia‑tone  • ‑set  • ‑shade  • ‑shadow  • ‑shared‑memory  • ‑sharpen  • ‑shave  • ‑shear  • ‑sigmoidal‑contrast  • ‑silent  • ‑size  • ‑sketch  • ‑snaps  • ‑solarize  • ‑sparse‑color  • ‑splice  • ‑spread  • ‑stegano  • ‑stereo  • ‑stretch  • ‑strip  • ‑stroke  • ‑strokewidth  • ‑style  • ‑subimage‑search  • ‑swap  • ‑swirl  • ‑synchronize  • ‑taint  • ‑text‑font  • ‑texture  • ‑threshold  • ‑thumbnail  • ‑tile  • ‑tile‑offset  • ‑tint  • ‑title  • ‑transform  • ‑transparent  • ‑transparent‑color  • ‑transpose  • ‑transverse  • ‑treedepth  • ‑trim  • ‑type  • ‑undercolor  • ‑unique‑colors  • ‑units  • ‑unsharp  • ‑update  • ‑verbose  • ‑version  • ‑view  • ‑vignette  • ‑virtual‑pixel  • ‑visual  • ‑watermark  • ‑wave  • ‑weight  • ‑white‑point  • ‑white‑threshold  • ‑window  • ‑window‑group  • ‑write ]

+
+

Below is list of command-line options recognized by the ImageMagick command-line tools. If you want a description of a particular option, click on the @@ -181,14 +188,14 @@ option name in the navigation bar above and you will go right to it. Unless otherwise noted, each option is recognized by the commands convert, mogrify.

-

-adaptive-blur radius[xsigma]

+

-adaptive-blur radius[xsigma]

ImageMagick-6.6.6-7-Q16-windows-dll.exedownloaddownloadImageMagick-6.6.6-8-Q16-windows-dll.exedownloaddownload Win32 dynamic at 16 bits-per-pixel
ImageMagick-6.6.6-7-Q16-windows-x64-dll.exedownloaddownloadImageMagick-6.6.6-8-Q16-windows-x64-dll.exedownloaddownload Win64 dynamic at 16 bits-per-pixel
ImageMagick-6.6.6-7-Q8-windows-dll.exedownloaddownloadImageMagick-6.6.6-8-Q8-windows-dll.exedownloaddownload Win32 dynamic at 8 bits-per-pixel
ImageMagick-6.6.6-7-Q16-windows-static.exedownloaddownloadImageMagick-6.6.6-8-Q16-windows-static.exedownloaddownload Win32 static at 16 bits-per-pixel
ImageMagick-6.6.6-7-Q16-windows-x64-static.exedownloaddownloadImageMagick-6.6.6-8-Q16-windows-x64-static.exedownloaddownload Win64 static at 16 bits-per-pixel
ImageMagick-6.6.6-7-Q8-windows-static.exedownloaddownloadImageMagick-6.6.6-8-Q8-windows-static.exedownloaddownload Win32 static at 8 bits-per-pixel
Adaptively blur pixels, with decreasing effect near edges.

A Gaussian operator of the given radius and standard deviation (sigma) is used. If sigma is not given it defaults to 1.

-

-adaptive-resize geometry

+

-adaptive-resize geometry

Resize the image using data-dependent triangulation.
@@ -196,7 +203,7 @@ otherwise noted, each option is recognized by the commands Image Geometry for complete details about the geometry argument. The -adaptive-resize option defaults to data-dependent triangulation. Use the -filter to choose a different resampling algorithm. Offsets, if present in the geometry string, are ignored, and the -gravity option has no effect.

-

-adaptive-sharpen radius[xsigma]

+

-adaptive-sharpen radius[xsigma]

Adaptively sharpen pixels, with increasing effect near edges.
@@ -204,7 +211,7 @@ otherwise noted, each option is recognized by the commands sigma) is used. If sigma is not given it defaults to 1.

-

-adjoin

+

-adjoin

Join images into a single multi-image file.
@@ -228,14 +235,14 @@ per file (for example, GIF, MIFF, and TIFF).

In summary, ImageMagick tries to write all images to one file, but will use -multiple files if either
- (1) the output image's file format does not allow multi-image files,
- (2) the +adjoin option is given, or
- (3) a C-style integer format string is present in the output filename.

+multiple files if either
+ (1) the output image's file format does not allow multi-image files,
+ (2) the +adjoin option is given, or
+ (3) a printf() integer format string (eg: "%d") is present in the output filename.

-

-affine sx,rx,ry,sy,tx,ty
+

-affine sx,rx,ry,sy,tx,ty
-affine sx,rx,ry,sy

@@ -282,7 +289,7 @@ The size of the resulting image is that of the smallest rectangle that contains

An attempt is made to detect near-singular transformation matrices. If the matrix determinant has a sufficiently small absolute value it is rejected.

-

-alpha type

+

-alpha type

Gives control of the alpha/matte channel of an image.
@@ -376,7 +383,7 @@ Set" and not "-alpha On".

-

+

-annotate degrees text
-annotate XdegreesxYdegrees text
-annotate XdegreesxYdegrees {+-}tx{+-}ty text

@@ -399,7 +406,7 @@ Set" and not "-alpha On".

Text is any UTF-8 encoded character sequence. If text is of the form '@mytext.txt', the text is read from the file mytext.txt. Text in a file is taken literally; no embedded formatting characters are recognized.

-

-antialias

+

-antialias

Enable/Disable of the rendering of anti-aliasing pixels when @@ -412,7 +419,7 @@ an image to just the colors being directly drawn. That is, no mixed colors are added when drawing such objects.

-

-append

+

-append

Join current images vertically or horizontally.
@@ -428,14 +435,14 @@ href="#gravity">-gravity setting.

-

-attenuate value

+

-attenuate value

Lessen (or intensify) when adding noise to an image.
-

-authenticate password

+

-authenticate password

Decrypt a PDF with a password.
@@ -447,7 +454,7 @@ href="#gravity">-gravity setting.

-

-auto-gamma

+

-auto-gamma

Automagically adjust gamma level of image.
@@ -464,15 +471,15 @@ dark shadows. It also does not work well for diagrams or cartoon like images.

It uses the -channel setting, (including the -'sync' flag for channel syncronization), to determine which color +'sync' flag for channel syncronization), to determine which color values is used and modified. As the default -channel setting is 'RGB,sync', channels are modified +>-channel setting is 'RGB,sync', channels are modified together by the same gamma value, preserving colors.

-

-auto-level

+

-auto-level

Automagically adjust color levels of image.
@@ -496,16 +503,16 @@ problems that these operators may have. That is -auto-level is the perfect or ideal version these operators.

It uses the -channel setting, (including the -special 'sync' flag for channel syncronization), to determine +special 'sync' flag for channel syncronization), to determine which color values are used and modified. As the default +channel setting is 'RGB,sync', the -'sync' ensures that the color channels will are modified +href="#channel" >+channel setting is 'RGB,sync', the +'sync' ensures that the color channels will are modified together by the same gamma value, preserving colors, and ignoring transparency.

-

-auto-orient

+

-auto-orient

Automagically orient (rotate) an image created by a digital camera.
@@ -523,7 +530,7 @@ href="#auto-orient" >-auto-orient operator will do nothing.

-

-average

+

-average

Average a set of images.
@@ -532,7 +539,7 @@ href="#auto-orient" >-auto-orient operator will do nothing.

-

-backdrop

+

-backdrop

Display the image centered on a backdrop.[animate, display]
@@ -540,7 +547,7 @@ href="#auto-orient" >-auto-orient operator will do nothing.

This backdrop covers the entire workstation screen and is useful for hiding other X window activity while viewing the image. The color of the backdrop is specified as the background color. The color is specified using the format described under the -fill option.

-

-background color

+

-background color

Set the background color.
@@ -548,7 +555,7 @@ href="#auto-orient" >-auto-orient operator will do nothing.

The color is specified using the format described under the -fill option. The default background color (if none is specified or found in the image) is white.

-

-bench iterations

+

-bench iterations

Measure performance.
@@ -559,7 +566,7 @@ href="#auto-orient" >-auto-orient operator will do nothing.

In this example, 5 iterations were completed at 0.875657 iterations per second, using 6.88 seconds of the user's allotted time, for a total elapsed time of 5.71 seconds.

-

-bias value{%}

+

-bias value{%}

Add bias when convolving an image.
@@ -577,13 +584,13 @@ negative results without clipping to the color value range

-

-black-point-compensation

+

-black-point-compensation

Use black point compensation.
-

-black-threshold value{%}

+

-black-threshold value{%}

Force to black all pixels below the threshold while leaving all pixels at or above the threshold unchanged.
@@ -593,7 +600,7 @@ negative results without clipping to the color value range
-

-blend geometry

+

-blend geometry

blend an image into another by the given absolute value or percent.[composite]
@@ -607,13 +614,13 @@ the background image is weighted by the exact opposite amount. That is a
-

-blue-primary x,y

+

-blue-primary x,y

Set the blue chromaticity primary point.
-

-blue-shift factor

+

-blue-shift factor

simulate a scene at nighttime in the moonlight. Start with a factor of 1.5
@@ -621,7 +628,7 @@ the background image is weighted by the exact opposite amount. That is a
-

-blur radius
-blur radiusxsigma

+

-blur radius
-blur radiusxsigma

Reduce image noise and reduce detail levels.
@@ -658,7 +665,7 @@ pixels which are outside the image proper are blurred into the final result.
-

-blur Width[xHeight[+Angle]]

+

-blur Width[xHeight[+Angle]]

Variably blur and image according to the overlay mapping.[composite]
@@ -679,7 +686,7 @@ pixels which are outside the image proper are blurred into the final result.
-

-border geometry

+

-border geometry

Surround the image with a border of color.
@@ -702,7 +709,7 @@ be replaced by the current -bordercolor setting.

functionality.

-

-bordercolor color

+

-bordercolor color

Set the border color.
@@ -712,13 +719,13 @@ functionality.

The default border color is #DFDFDF, this shade of gray.

-

-borderwidth geometry

+

-borderwidth geometry

Set the border width.[animate, display]
-

-brightness-contrast brightness
-brightness-contrast brightness{xcontrast}{%}}

+

-brightness-contrast brightness
-brightness-contrast brightness{xcontrast}{%}}

Adjust the brightness and/or contrast of the image.
@@ -756,13 +763,13 @@ totally black.

symbol is no different than leaving it off.

-

-cache threshold

+

-cache threshold

(This option has been replaced by the -limit option.)
-

-caption string

+

-caption string

Assign a caption to an image.
@@ -797,7 +804,7 @@ that the image bird.miff has a width of 512 and a height of
-

-cdl filename

+

-cdl filename

color correct with a color decision list.
@@ -821,7 +828,7 @@ that the image bird.miff has a width of 512 and a height of
-

-channel type

+

-channel type

Specify those image color channels to which subsequent operators are limited.
@@ -851,7 +858,7 @@ special channel type All. Not all operators are 'channel capable', but generally any operators that are generally 'grey-scale' image operators, will understand this setting. See individual operator documentation.

-
+

On top of the normal channel selection a extra flag can be specified, 'Sync'. This is turned on by default and if set means that @@ -867,14 +874,14 @@ together in exactly the same way so that colors will remain in-sync. Without it being set, then each channel is modified separately and independently, which may produce color distortion.

-

The -morphology 'Convolve' method +

The -morphology 'Convolve' method and the -compose mathematical methods, also understands the 'Sync' flag to modify the behaviour of pixel colors according to the alpha channel (if present). That is to say it will modify the image processing with the understanding that fully-transparent colors should not contribute to the final result.

-Basically, by default, operators work with color channels in syncronous, and +

Basically, by default, operators work with color channels in syncronous, and treats transparency as special, unless the -channel setting is modified so as to remove the effect of the 'Sync' flag. How each operator does this depends on that operators current implementation. @@ -884,7 +891,7 @@ Not all operators understands this flag at this time, but that is changing.

To print a complete list of channel types, use -list channel.

-
+

By default, ImageMagick sets -channel to the value 'RGBK,sync', which specifies that operators act on all color @@ -951,19 +958,19 @@ href="#clut">-clut operator is a good example of this.

-

-clamp

+

-clamp

Restrict image colors from 0 to the quantum depth.
-

-charcoal factor

+

-charcoal factor

Simulate a charcoal drawing.
-

-chop geometry

+

-chop geometry

Remove pixels from the interior of an image.
@@ -978,8 +985,19 @@ a -gravity setting, if present.

The -chop option removes entire rows and columns, and moves the remaining corner blocks leftward and upward to close the gaps.

+

While it can remove internal rows and columns of pixels, it is more typically +used with as -gravity setting and a '+0+0' offset +so as to remove a single edge from an image. Compare this to -shave whcih removes equal numbers of pixels from oppisite sides of the image. +

+ +

Using -chop will effectivally undo the results of a +-splice that was given the same geometry +and -gravity settings.

+ +
-

-clip

+

-clip

Apply the clipping path if one is present.
@@ -994,34 +1012,42 @@ and moves the remaining corner blocks leftward and upward to close the gaps.

The -clip feature requires the XML library. If the XML library is not present, the option is ignored.

-

-clip-mask

+

-clip-mask

Clip the image as defined by this mask.
-

-clip-path id

+

-clip-path id

Clip along a named path from the 8BImageMagick profile.
-

-clone index(s)

+

-clone index(s)

Make a copy of an image (or images).
+

Inside parenthesis (where the operator is normally used) it will make a +clone of the images from the last 'pushed' image sequence, and adds them to +the end of the current image sequence. Outside parenthesis +(not recommended) it clones the images from the current image sequence.

+

Specify the image by its index in the sequence. The first image is index 0. Negative indexes are relative to the end of the sequence; for -example, −1 +example, −1 represents the last image of the sequence. Specify a range of images with a -dash (e.g. 0−4). Separate multiple indexes with commas but no -spaces (e.g. 0,2,5). Use +clone make a copy of the last image in the image -sequence.

+dash (e.g. 0−4). Separate multiple indexes with commas but no +spaces (e.g. 0,2,5). A value of '0−−1 will +effectivally clone all the images.

+ +

The +clone will simply make a copy of the last image +in the image sequence, and is thus equivelent to using a argument of +'−1'.

-

-clut

+

-clut

Replace the channel values in the first image using each @@ -1069,7 +1095,7 @@ of a 3D color cube.

-

-coalesce

+

-coalesce

Fully define the look of each frame of an GIF animation sequence, to form a 'film strip' animation.
@@ -1089,7 +1115,7 @@ better than the original.

-

-colorize value

+

-colorize value

Colorize the image by an amount specified by value using the color specified by the most recent -fill setting.
@@ -1100,7 +1126,7 @@ a comma-delimited list of colorization values (e.g., -colorize 0,0,50).

-

-colormap type

+

-colormap type

Define the colormap type.[animate, display]
@@ -1118,7 +1144,7 @@ as they are defined. However, other clients may go technicolor when the image colormap is installed.

-

-colors value

+

-colors value

Set the preferred number of colors in the image.
@@ -1134,7 +1160,7 @@ the color reduction algorithm for more details.

-

-color-matrix matrix

+

-color-matrix matrix

apply color correction to the image.
@@ -1158,7 +1184,7 @@ convert kittens.jpg -color-matrix \ 0.0 0.0 0.0 0.0, 0.0, 1.0" kittens.png
-

-colorspace value

+

-colorspace value

Set the image colorspace.
@@ -1292,7 +1318,7 @@ convert kittens.jpg -color-matrix \
-

-combine

+

-combine

Combine one or more images into a single image.
@@ -1304,7 +1330,7 @@ convert kittens.jpg -color-matrix \

$magick> convert original.png -channel RGB -separate sepimage.png $magick> convert sepimage-0.png sepimage-1.png sepimage-2.png -channel RGB \
-combine imagecopy.png

-

-comment string

+

-comment string

Embed a comment in an image.
@@ -1338,7 +1364,7 @@ that the image bird.miff has a width of 512 and a height of 480.

-

-compose operator

+

-compose operator

Set the type of image composition.
@@ -1362,7 +1388,7 @@ command.

-

-composite

+

-composite

Perform alpha composition on two images and an optional mask
@@ -1391,7 +1417,7 @@ to 'false'.

-

-compress type

+

-compress type

Use pixel compression specified by type when writing the image.
@@ -1409,7 +1435,7 @@ to 'false'.

Use the -quality option to set the compression level to be used by JPEG, PNG, MIFF, and MPEG encoders. Use the -sampling-factor option to set the sampling factor to be used by JPEG, MPEG, and YUV encoders for down-sampling the chroma channels.

-

-contrast

+

-contrast

Enhance or reduce the image contrast.
@@ -1420,7 +1446,7 @@ to 'false'.

$magick> convert rose: -contrast -contrast rose_c2.png

-

-contrast-stretch black-point
-contrast-stretch black-point{xwhite-point}{%}}

+

-contrast-stretch black-point
-contrast-stretch black-point{xwhite-point}{%}}

Increase the contrast in an image by stretching the range of intensity values.
@@ -1461,7 +1487,7 @@ normalization of mathematical images.

-

-convolve kernel

+

-convolve kernel

Convolve an image with a user-supplied convolution kernel.
@@ -1492,7 +1518,7 @@ entry.

-

-crop geometry

+

-crop geometry

Cut out one or more rectangular regions of the image.
@@ -1518,7 +1544,7 @@ missed' warning given.

It might be necessary to +repage the image prior to cropping the image to ensure the crop coordinate frame is relocated to the upper-left corner of the visible image.

-

-cycle amount

+

-cycle amount

displace image colormap by amount.
@@ -1528,7 +1554,7 @@ colormap entry is shifted.

-

-debug events

+

-debug events

enable debug printout.
@@ -1551,7 +1577,7 @@ colormap entry is shifted.

-

-decipher filename

+

-decipher filename

Decipher and restore pixels that were previously transformed by -encipher.
@@ -1562,7 +1588,7 @@ colormap entry is shifted.

-

-deconstruct

+

-deconstruct

find areas that has changed between images
@@ -1575,7 +1601,7 @@ colormap entry is shifted.

-

-define key{=value}...

+

-define key{=value}...

- + @@ -2269,7 +2337,7 @@ the case in ImageMagick's implementation.

-

-dither method

+

-dither method

add specific global settings generally used to control @@ -1608,34 +1634,33 @@ is case-dependent.

The following definitions are just some of the artifacts that are available:

-
    - +
    dcm:display-range=reset
    Set the display range to the minimum and maximum pixel values for the - DCM image format.

    + DCM image format.
    dot:layout-engine=value
    Set the specify the layout engine for the DOT image format (e.g. - neato).

    + neato).
    jpeg:extent=value
    Restrict the maximum JPEG file size, for example -define - jpeg:extent=400kb.

    + jpeg:extent=400kb.
    jpeg:size=geometry
    Set the size hint of a JPEG image, for example, -define jpeg:size=128x128. It is most useful for increasing performance and reducing the memory - requirements when reducing the size of a large JPEG image.

    + requirements when reducing the size of a large JPEG image.
    jp2:rate=value
    Specify the compression factor to use while writing JPEG-2000 files. The compression factor is the reciprocal of the compression ratio. The valid range is 0.0 to 1.0, with 1.0 indicating lossless compression. If defined, this value overrides the -quality setting. A quality setting of 75 - results in a rate value of 0.06641.

    + results in a rate value of 0.06641.
    mng:need-cacheoff
    -
    turn playback caching off for streaming MNG.

    +
    turn playback caching off for streaming MNG.
    png:bit-depth=value
    png:color-type=value
    @@ -1652,12 +1677,55 @@ available:

    reduce the image quality prior to using the PNG encoder. Note that in indexed PNG files, "bit-depth" refers to the number of bits per index, which can be 1, 2, 4, or 8. In such files, the color samples always have - 8-bit depth.
    + 8-bit depth. + +
    png:exclude-chunk=value
    +
    png:include-chunk=value
    +
    ancillary chunks to be excluded from or included in PNG output. + +

    Thevalue can be the name of a PNG chunk-type such + as bKGD, a comma-separated list of chunk-types, + or the word all or + the word none. There must be no spaces in the + list. Although PNG chunk-names are case-dependent, you can use + all lowercase names if you prefer.

    + +

    As a special case, if the sRGB chunk is excluded and + the gAMA chunk is included, the gAMA chunk will + only be written if gamma is not 1/2.2, since most decoders assume + sRGB and gamma=1/2.2 when no colorspace information is included in + the PNG file. Because the list is processed from left to right, you + can achieve this with a single define:

    + +
    +    -define png:include-chunk=none,gAMA
+
    + +

    The critical PNG chunks IHDR, PLTE, + IDAT, and IEND cannot be excluded. Any of + these entries appearing in the list will be ignored.

    + +

    If the ancillary PNG tRNS chunk is excluded and the + image has transparency, the PNG colortype is forced to be 4 or 6 + (GRAY_ALPHA or RGBA). If the image is not transparent, then the + tRNS chunk isn't written anyhow, and there is no effect + on the PNG colortype of the output image.

    + +

    The -strip option does the equivalent of the + following for PNG output:

    + +
    +    -define png:include-chunk=none,gama
+
    + +

    The default behavior is to include all known PNG ancillary chunks + plus ImageMagick's private vpAg ("virtual page") chunk.

    +
    ps:imagemask
    If the ps:imagemask flag is defined, the PS3 and EPS3 coders will create Postscript files that render bilevel images with the Postscript imagemask - operator instead of the image operator.

    + operator instead of the image operator.
    quantum:format=type
    Set the type to floating-point to specify a floating-point @@ -1667,7 +1735,7 @@ available:

    If -depth 32 is included, the result is double precision floating point format.
    -
+

For example, to create a postscript file that will render only the black pixels of a bilevel image, use:

@@ -1684,7 +1752,7 @@ use:

-

-delay ticks
-delay ticksxticks-per-second {<} {>}

+

-delay ticks
-delay ticksxticks-per-second {<} {>}

display the next image after pausing.
@@ -1695,7 +1763,7 @@ use:

-

-delete index

+

-delete index

delete the image, specified by its index, from the image sequence.
@@ -1704,7 +1772,7 @@ use:

-

-density width
-density widthxheight

+

-density width
-density widthxheight

Set the horizontal and vertical resolution of an image for rendering to devices.
@@ -1718,7 +1786,7 @@ use:

The -density option sets an attribute and does not alter the underlying raster image. It may be used to adjust the rendered size for desktop publishing purposes by adjusting the scale applied to the pixels. To resize the image so that it is the same size at a different resolution, use the -resample option.

-

-depth value

+

-depth value

depth of the image.
@@ -1726,13 +1794,13 @@ use:

This the number of bits in a color sample within a pixel. Use this option to specify the depth of raw images whose depth is unknown such as GRAY, RGB, or CMYK, or to change the depth of any image after it has been read.

-

-descend

+

-descend

obtain image by descending window hierarchy.
-

-deskew threshold

+

-deskew threshold

straighten an image. A threshold of 40% works for most images.
@@ -1740,19 +1808,19 @@ use:

Use -set option:deskew:auto-crop width to auto crop the image. The set argument is the pixel width of the image background (e.g 40).

-

-despeckle

+

-despeckle

reduce the speckles within an image.
-

-direction type

+

-direction type

render text right-to-left or left-to-right.
-

-displace horizontal-scale
-displace horizontal-scalexvertical-scale

+

-displace horizontal-scale
-displace horizontal-scalexvertical-scale

shift image pixels as defined by a displacement map.[composite]
@@ -1812,7 +1880,7 @@ overlaid areas will not be effected.

-

-display host:display[.screen]

+

-display host:display[.screen]

Specifies the X server to contact.[animate, display]
@@ -1820,7 +1888,7 @@ overlaid areas will not be effected.

This option is used with convert for obtaining image or font from this X server. See X(1).

-

-dispose method

+

-dispose method

define the GIF disposal image setting for images that are being created or read in.
@@ -1851,14 +1919,14 @@ resetting the layer disposal methods of images being read in.

disposal method for images already in memory.

-

-dissimilarity-threshold value

+

-dissimilarity-threshold value

maximum RMSE for subimage match (default 0.2).[compare]
-

-dissolve src_percent[xdst_percent]

+

-dissolve src_percent[xdst_percent]

dissolve an image into another by the given percent.[composite]
@@ -1874,7 +1942,7 @@ are given, each image are dissolved to the percentages given.

images, you would need to use dissolve values of '50,100'.

-

-distort method arguments

+

-distort method arguments

distort an image, using the given method and its required arguments.
@@ -1910,7 +1978,7 @@ class="arg">method being used.

#  arguments meaning
1:Angle_of_Rotation
2:Scale   Angle
3:ScaleX,ScaleY   Angle
3:X,Y     Angle
4:X,Y   Scale   Angle
5: X,Y   ScaleX,ScaleY   Angle
Apply a Riemersma or Floyd-Steinberg error diffusion dither to images when general color reduction is applied via an option, or automagically when saving to specific formats. This enabled by default.
@@ -2290,7 +2358,7 @@ href="#monochrome">-monochrome, -remap, and -

-draw string

+

-draw string

Annotate an image with one or more graphic primitives.
@@ -2439,19 +2507,19 @@ matrix.

-

-edge radius

+

-edge radius

detect edges within an image.
-

-emboss radius

+

-emboss radius

emboss an image.
-

-encipher filename

+

-encipher filename

Encipher pixels for later deciphering by -decipher.
@@ -2463,7 +2531,7 @@ matrix.

-

-encoding type

+

-encoding type

specify the text encoding.
@@ -2471,7 +2539,7 @@ matrix.

Choose from AdobeCustom, AdobeExpert, AdobeStandard, AppleRoman, BIG5, GB2312, Latin 2, None, SJIScode, Symbol, Unicode, Wansung.

-

-endian type

+

-endian type

Specify endianness (MSB or LSB) of the image.
@@ -2482,14 +2550,14 @@ matrix.

-

-enhance

+

-enhance

Apply a digital filter to enhance a noisy image.
-

-equalize

+

-equalize

perform histogram equalization on the image channel-by-channel.
@@ -2501,7 +2569,7 @@ matrix.

For YIQ, YUV and OHTA use the red channel. For example, OHTA is a principal components transformation that puts most of the information in the first channel. Here we have ... -colorspace OHTA -channel red -equalize -colorspace RGB ...

-

-evaluate operator value

+

-evaluate operator value

Alter channel pixels by evaluating an arithmetic, relational, or logical expression.
@@ -2615,23 +2683,23 @@ be generated over the input color range. For example, if the value is 1, the effective period is simply the QuantumRange; but if the value is 2, then the effective period is the half the QuantumRange. +class="QR">QuantumRange.

0.5 + 0.5 × cos(2 π u × value).
-See also the -function operator, which is a -multi-value version of evaluate.

+

See also the -function operator, which is a +multi-value version of evaluate.

-

-evaluate-sequence operator

+

-evaluate-sequence operator

Alter channel pixels by evaluating an arithmetic, relational, or logical expression over a sequence of images.
-

-extent geometry

+

-extent geometry

Set the image size and offset.
@@ -2647,7 +2715,7 @@ image is centered on an 800x600 black canvas:

See Image Geometry for complete details about the geometry argument.

-

-extract geometry

+

-extract geometry

Extract the specified area from image.
@@ -2664,7 +2732,7 @@ equivalent to:

See Image Geometry for complete details about the geometry argument.

-

-family fontFamily

+

-family fontFamily

Set a font family for text.
@@ -2676,20 +2744,20 @@ equivalent to:

-

-features distance

+

-features distance

display features for each channel in the image in each of four directions (horizontal, vertical, left and right diagonals) for the specified distance.
-

-fft

+

-fft

implements the forward discrete Fourier transform (DFT).
-

This option is new as of ImageMagick 6.5.4-3 (and now working for Windows users in ImageMagick 6.6.0-9). It transforms an image from the normal (spatial) domain to the frequency domain. In the frequency domain, an image is represented as a superposition of complex sinusoidal waves of varying amplitudes. The image x and y coordinates are the possible frequencies along the x and y directions, respectively, and the pixel intensity values are complex numbers that correspond to the sinusoidal wave amplitudes. See for example, Fourier Transform, Discrete Fourier Transform and Fast Fourier Transform.

+

This option is new as of ImageMagick 6.5.4-3 (and now working for Windows users in ImageMagick 6.6.0-9). It transforms an image from the normal (spatial) domain to the frequency domain. In the frequency domain, an image is represented as a superposition of complex sinusoidal waves of varying amplitudes. The image x and y coordinates are the possible frequencies along the x and y directions, respectively, and the pixel intensity values are complex numbers that correspond to the sinusoidal wave amplitudes. See for example, Fourier Transform, Discrete Fourier Transform and Fast Fourier Transform.

-

A single image name is provided as output for this option. However, the output result will have two components. It is either a two-frame image or two separate images, depending upon whether the image format specified supports multi-frame images. The reason that we get a dual output result is because the frequency domain represents an image using complex numbers, which cannot be visualized directly. Therefore, the complex values are automagically separated into a two-component image representation. The first component is the magnitude of the complex number and the second is the phase of the complex number. See for example, Complex Numbers.

+

A single image name is provided as output for this option. However, the output result will have two components. It is either a two-frame image or two separate images, depending upon whether the image format specified supports multi-frame images. The reason that we get a dual output result is because the frequency domain represents an image using complex numbers, which cannot be visualized directly. Therefore, the complex values are automagically separated into a two-component image representation. The first component is the magnitude of the complex number and the second is the phase of the complex number. See for example, Complex Numbers.

The magnitude and phase component images must be specified using image formats that do not limit the color or compress the image. Thus, MIFF, TIF, PFM, EXR and PNG are the recommended image formats to use. All of these formats, except PNG support multi-frame images. So for example,

@@ -2707,13 +2775,13 @@ equivalent to:

-evaluate log 1000 fft_image_spectrum.png

where the -contrast-stretch 0 is used to scale the image to full dynamic range, first. The argument to the -evaluate log typically is specified between 100 and 10,000, depending upon the amount of detail that one wants to bring out in the spectrum. Larger values produce more visible detail. Too much detail, however, may hide the important features.

-

The FFTW delegate library is required to use -fft. +

The FFTW delegate library is required to use -fft.

Use +fft to produce two output images that are the real and imaginary components of the complex valued Fourier transform.

However, as the real and imaginary components can contain negative values, this requires that IM be configured with HDRI enabled. In this case, you must use either MIFF, TIF or PFM formats for the real and imaginary component results, since they are formats that preserve both negative and fractional values without clipping them or truncating the fractional part.

-

The real and imaginary component images resulting from +fft is also square, even dimensioned images due to the same padding that was discussed above for the magnitude and phase component images. +

The real and imaginary component images resulting from +fft is also square, even dimensioned images due to the same padding that was discussed above for the magnitude and phase component images.

See the discussion on HDRI implementations of ImageMagick on the page High Dynamic-Range Images. For more about HDRI go the ImageMagick Usage pages or this Wikipedia entry. @@ -2721,7 +2789,7 @@ equivalent to:

-

-fill color

+

-fill color

color to use when filling a graphic primitive.
@@ -2747,7 +2815,7 @@ equivalent to:

To print a complete list of color names, use the -list color option.

-

-filter type

+

-filter type

Use this type of filter when resizing or @@ -2769,7 +2837,7 @@ generally useless on their own as they are infinite filters that are being clipped to the filters support size. Their direct use is not recommended except via expert settings (see below).

-Instead these special filter functions are typically windowed by a windowing +

Instead these special filter functions are typically windowed by a windowing function that the -filter setting defines. That is using these functions will define a 'Windowed' filter, appropriate to the operator involved. Windowed filters include:

@@ -2825,7 +2893,7 @@ href="#set" >-set):-

the Parzen Sinc windowing function. If only one of the values are defined, the other is set so as to generate a 'Keys' type cubic filter. Values meaning was defined by a research paper by - Mitchell-Netravali. + Mitchell-Netravali.
-define filter:filter=filter_function
Use this function directly as the scaling filter. This will allow @@ -2875,14 +2943,14 @@ likely to be detrimental to your image resizing.

-

-flatten

+

-flatten

This is a simple alias for the -layers method "flatten".
-

-flip

+

-flip

create a mirror image.
@@ -2890,13 +2958,13 @@ likely to be detrimental to your image resizing.

reflect the scanlines in the vertical direction.

-

-floodfill {+-}x{+-}y color

+

-floodfill {+-}x{+-}y color

floodfill the image with color at the specified offset. Using -fuzz to floodfill pixels which only change by a small amount.
-

-flop

+

-flop

create a mirror image.
@@ -2905,7 +2973,7 @@ likely to be detrimental to your image resizing.

-

-font name

+

-font name

set the font to use when annotating images with text, or creating labels.
@@ -2921,7 +2989,7 @@ is a TrueType font file, ps:helvetica is PostScript font, and
-

-foreground color

+

-foreground color

Define the foreground color.
@@ -2931,7 +2999,7 @@ is a TrueType font file, ps:helvetica is PostScript font, and

The default foreground color is black.

-

-format type

+

-format type

the image format type.
@@ -2941,7 +3009,7 @@ is a TrueType font file, ps:helvetica is PostScript font, and

By default the file is written to its original name. However, if the filename extension matches a supported format, the extension is replaced with the image format type specified with -format. For example, if you specify tiff as the format type and the input image filename is image.gif, the output image filename becomes image.tiff.

-

-format string

+

-format string

output formatted image characteristics.[identify]
@@ -2949,7 +3017,7 @@ is a TrueType font file, ps:helvetica is PostScript font, and

See Format and Print Image Properties for an explanation on how to specify the argument to this option.

-

-frame geometry

+

-frame geometry

Surround the image with a border or beveled frame.
@@ -2982,13 +3050,13 @@ affected by the -gravity option.

-

-frame

+

-frame

include the X window frame in the imported image.[import]
-

-function function parameters

+

-function function parameters

Apply a function to channel values.
@@ -3101,20 +3169,20 @@ affected by the -gravity option.

The ArcSin function generates the inverse curve of a Sinusoid, and can be used to generate cylindrical distortion and displacement maps. The curve can be adjusted relative to both the input values and output range -of values. +of values.

-
+

-function ArcSin width,[center,[range,[bias]]] -

+

with all values given in terms of noramlize color values (0.0 for black, 1.0 for white). Defaulting to values covering the full range from 0.0 to 1.0 for bout input (width), and output (width) values. '1.0,0.5,1.0,0.5'

-
+

range/π * asin( 2/width * ( u - center ) ) + bias -

+

@@ -3122,18 +3190,18 @@ class="arg">width) values. '1.0,0.5,1.0,0.5'

The ArcTan function generates a curve that smooth crosses from limit values at infinities, though a center using the given slope value. -All these values can be adjusted via the arguments. +All these values can be adjusted via the arguments.

-
+

-function ArcTan slope,[center,[range,[bias]]] -

+

Defaulting to '1.0,0.5,1.0,0.5'.

-
+

range/π * atan( slope*π * ( u - center ) ) + bias -

+

@@ -3141,7 +3209,7 @@ All these values can be adjusted via the arguments.
-

-fuzz distance{%}

+

-fuzz distance{%}

Colors within this distance are considered equal.
@@ -3152,7 +3220,7 @@ All these values can be adjusted via the arguments.
-

-fx expression

+

-fx expression

apply a mathematical expression to an image or image channels.
@@ -3163,7 +3231,7 @@ All these values can be adjusted via the arguments.
-

-gamma value

+

-gamma value

level of gamma correction.
@@ -3179,7 +3247,7 @@ All these values can be adjusted via the arguments.

Note that gamma adjustments are also available via the -level operator.

-

-gaussian-blur radius
-gaussian-blur radiusxsigma

+

-gaussian-blur radius
-gaussian-blur radiusxsigma

Blur the image with a Gaussian operator.
@@ -3215,7 +3283,7 @@ pixels which are outside the image proper are blurred into the final result.
-

-geometry geometry

+

-geometry geometry

Set the preferred size and location of the image.
@@ -3223,7 +3291,7 @@ pixels which are outside the image proper are blurred into the final result.

See Image Geometry for complete details about the geometry argument.

-

-gravity type

+

-gravity type

Sets the current gravity suggestion for various other settings and options.
@@ -3247,14 +3315,14 @@ installation.

-

-green-primary x,y

+

-green-primary x,y

green chromaticity primary point.
-

-hald-clut

+

-hald-clut

apply a Hald color lookup table to the image.
@@ -3282,19 +3350,19 @@ mapping.

-

-help

+

-help

print usage instructions.
-

-highlight-color color

+

-highlight-color color

when comparing images, emphasize pixel differences with this color.
-

-iconGeometry geometry

+

-iconGeometry geometry

specify the icon geometry.
@@ -3304,13 +3372,13 @@ mapping.

See Image Geometry for complete details about the geometry argument.

-

-iconic

+

-iconic

iconic animation.
-

-identify

+

-identify

identify the format and characteristics of the image.
@@ -3324,12 +3392,12 @@ amounts of image properties are displayed including image statistics, profiles, image histogram, and others.

-

-ift

+

-ift

implements the inverse discrete Fourier transform (DFT).
-

This option is new as of ImageMagick 6.5.4-3 (and now working for Windows users in ImageMagick 6.6.0-9). It transforms a pair of magnitude and phase images from the frequency domain to a single image in the normal or spatial domain. See for example, Fourier Transform, Discrete Fourier Transform and Fast Fourier Transform.

+

This option is new as of ImageMagick 6.5.4-3 (and now working for Windows users in ImageMagick 6.6.0-9). It transforms a pair of magnitude and phase images from the frequency domain to a single image in the normal or spatial domain. See for example, Fourier Transform, Discrete Fourier Transform and Fast Fourier Transform.

For example, depending upon the image format used to store the result of the -fft, one would use either

@@ -3338,26 +3406,26 @@ image histogram, and others.

$magick> convert fft_image-0.png fft_image-1.png -ift fft_image_ift.png

-

The resulting image may need to be cropped due to padding introduced when the original image, prior to the -fft or +fft, was not square or even dimensioned. Any padding is at the right and/or bottom sides of the image. +

The resulting image may need to be cropped due to padding introduced when the original image, prior to the -fft or +fft, was not square or even dimensioned. Any padding is at the right and/or bottom sides of the image.

-

The FFTW delegate library is required to use -ift. +

The FFTW delegate library is required to use -ift.

-

Use +ift (with HDRI enabled) to transform a pair of real and imaginary images from the frequency domain to a single image in the normal (spatial) domain. +

Use +ift (with HDRI enabled) to transform a pair of real and imaginary images from the frequency domain to a single image in the normal (spatial) domain.

-

-immutable

+

-immutable

make image immutable.
-

-implode factor

+

-implode factor

implode image pixels about the center.
-

-insert index

+

-insert index

insert the last image into the image sequence.
@@ -3367,7 +3435,7 @@ image histogram, and others.

The +insert option is equivalent to -insert -1. In other words, insert the last image, at the end of the current image sequence. Consequently this has no effect on the image sequence order.

-

-intent type

+

-intent type

use this type of rendering intent when managing the image color.
@@ -3379,7 +3447,7 @@ image histogram, and others.

To print a complete list of rendering intents, use -list intent.

-

-interlace type

+

-interlace type

the type of interlacing scheme.
@@ -3413,7 +3481,7 @@ image.

To print a complete list of interlacing schemes, use -list interlace.

-

-interpolate type

+

-interpolate type

Set the pixel color interpolation method to use when looking up a color based on a floating point or real value.
@@ -3446,25 +3514,25 @@ lookup for positions outside the boundaries of the image.

-

-interline-spacing value

+

-interline-spacing value

the space between two text lines.
-

-interword-spacing value

+

-interword-spacing value

the space between two words.
-

-kerning value

+

-kerning value

the space between two letters.
-

-label name

+

-label name

assign a label to an image.
@@ -3506,7 +3574,7 @@ formatting characters are recognized.

-

-lat width
-lat widthxheight{+-}offset{%}

+

-lat width
-lat widthxheight{+-}offset{%}

perform local adaptive threshold.
@@ -3524,7 +3592,7 @@ the local background color, from which to separate the forground color.

-

-layers method

+

-layers method

handle multiple images forming a set of image layers or animation frames.
@@ -3777,7 +3845,7 @@ href="#compose" >-compose setting, and the GIF -

-level black_point{,white_point}{%}{,gamma}

+

-level black_point{,white_point}{%}{,gamma}

adjust the level of image channels.
@@ -3814,7 +3882,7 @@ values (0 is opaque) and not as 'alpha' values (0 is transparent).

-

-level-colors {-level-colors {black_color}{,}{white_color}

@@ -3845,7 +3913,7 @@ color (+ form).

-

-limit type value

+

-limit type value

Set the pixel cache resource limit.
@@ -3860,10 +3928,12 @@ color (+ form).

Use -list resource to list the current limits. For example, our system shows these limits:

-

$magick> identify -list resource

File         Area       Memory          Map         Disk   Thread         Time
+
 $magick> identify -list resource
+File         Area       Memory          Map         Disk   Thread         Time
 ------------------------------------------------------------------------------
- 768     12.404GB    8.6642GiB    23.104GiB  18.446744EB        8    unlimited

-

+ 768     12.404GB    8.6642GiB    23.104GiB  18.446744EB        8    unlimited
+
+

Requests for pixel storage to keep intermediate images are satisfied by one of three resource categories: in-memory pool, memory-mapped files pool, and disk pool (in that order) depending on the ‑limit settings and whether the system honors a resource request. If the total size of allocated pixel storage in the given pool reaches the corresponding limit, the request is passed to the next pool. Additionally, requests that exceed the area limit automagically are allocated on disk.

To illustrate how ImageMagick utilizes resource limits, consider a typical image resource request. First, ImageMagick tries to allocate the pixels in memory. The request might be denied if the resource request exceeds the memory limit or if the system does not honor the request. If a memory request is not honored, the pixels are allocated to disk and the file is memory-mapped. However, if the allocation request exceeds the map limit, the resource allocation goes to disk. In all cases, if the resource request exceeds the area limit, the pixels are automagically cached to disk. If the disk has a hard limit, the program fails.

@@ -3891,7 +3961,7 @@ color (+ form).

-

-linear-stretch black-point
-linear-stretch black-point{xwhite-point}{%}}

+

-linear-stretch black-point
-linear-stretch black-point{xwhite-point}{%}}

Linear with saturation stretch.
@@ -3916,13 +3986,13 @@ normalization of mathematical images.

-

-linewidth

+

-linewidth

the line width for subsequent draw operations.
-

-liquid-rescale geometry

+

-liquid-rescale geometry

rescale image with seam-carving.
@@ -3930,7 +4000,7 @@ normalization of mathematical images.

See Image Geometry for complete details about the geometry argument.

-

-list type

+

-list type

Print a list of supported arguments for various options or settings. Choose from these list types:
@@ -4010,7 +4080,7 @@ available:

$magick> identify -list list

-

-log string

+

-log string

Specify format for debug log.
@@ -4042,7 +4112,7 @@ characters:

The default behavior is to print all of the components.

-

-loop iterations

+

-loop iterations

add Netscape loop extension to your GIF animation.
@@ -4052,20 +4122,20 @@ otherwise the animation repeats itself up to iterations times.

-

-lowlight-color color

+

-lowlight-color color

when comparing images, de-emphasize pixel differences with this color.
-

-magnify factor

+

-magnify factor

magnify the image.
-

-map type

+

-map type

Display image using this type.[animate, display]
@@ -4089,7 +4159,7 @@ class="arg">xstdcmap(1) for one way of creating Standard Colormaps.

-

-map components

+

-map components

pixel map.[stream]
@@ -4115,7 +4185,7 @@ bgr). The components can repeat as well (e.g. rgbr).

-

-mask +

-mask filename

@@ -4124,7 +4194,7 @@ bgr). The components can repeat as well (e.g. rgbr).

Use +mask to remove the image mask.

-

-mattecolor color

+

-mattecolor color

Specify the color to be used with the -frame option.
@@ -4135,19 +4205,19 @@ bgr). The components can repeat as well (e.g. rgbr).

style="background-color: #bdbdbd;">this shade of gray.

-

-maximum

+

-maximum

return the maximum intensity of an image sequence.
-

-median radius

+

-median radius

apply a median filter to the image.
-

-metric type

+

-metric type

Output to STDERR a measure of the differences between images according to the type given metric.
@@ -4182,14 +4252,14 @@ metrics option.

-

-minimum

+

-minimum

return the minimum intensity of an image sequence.
-

-mode value

+

-mode value

Mode of operation.[montage]
@@ -4203,7 +4273,7 @@ ImageMagick installation.

-

-modulate brightness[,saturation,hue]

+

-modulate brightness[,saturation,hue]

Vary the brightness, HSB, HSL (the default), or

$magick> convert image.png -set option:modulate:colorspace hsb -modulate 120,90 modulate.png

-

-monitor

+

-monitor

monitor progress.
-

-monochrome

+

-monochrome

transform the image to black and white.
-

-morph frames

+

-morph frames

morphs an image sequence.
@@ -4267,26 +4337,26 @@ argument determine how many images to interpolate between each image.

-

-morphology

-

-morphology method kernel

+

-morphology

+

-morphology method kernel

apply a morphology method to the image.
-Until I get around to writing a option summary for this, see IM Usage Examples, -Morphology.

+

Until I get around to writing a option summary for this, see IM Usage Examples, +Morphology.

-

-mosaic

+

-mosaic

an simple alias for the -layers method "mosaic"
-

-motion-blur radius
-motion-blur radiusxsigma+angle

+

-motion-blur radius
-motion-blur radiusxsigma+angle

simulate motion blur.
@@ -4303,12 +4373,12 @@ pixels which are outside the image proper are blurred into the final result.

-

-name

+

-name

name an image.
-

-negate

+

-negate

replace each pixel with its complementary color.
@@ -4316,7 +4386,7 @@ pixels which are outside the image proper are blurred into the final result.

The red, green, and blue intensities of an image are negated. White becomes black, yellow becomes blue, etc. Use +negate to only negate the grayscale pixels of the image.

-

-noise radius
+

-noise radius
+noise type

@@ -4346,7 +4416,7 @@ added to an image.

-

-normalize

+

-normalize

Increase the contrast in an image by stretching the range of intensity values.
@@ -4365,7 +4435,7 @@ preserve color integrity, when the default +channel setting is in use. Specifying any other -channel setting will normalize the RGB channels independently.

-

See -contrast-stretch for more details. +

See -contrast-stretch for more details. Also see -auto-level for a 'perfect' normalization that is better suited to mathematically generated images.

@@ -4373,7 +4443,7 @@ that is better suited to mathematically generated images.

-

-ordered-dither threshold_map{,level...}

+

-ordered-dither threshold_map{,level...}

dither the image using a pre-defined ordered dither
-

-opaque color

+

-opaque color

change this color to the fill color within the image.
@@ -4447,7 +4517,7 @@ href="#channel">-channel to enable alpha channel handling.

-

-orient image orientation

+

-orient image orientation

specify orientation of a digital camera image.
@@ -4471,7 +4541,7 @@ orientation option.

-

-page geometry
+

-page geometry
-page media[offset][{^!<>}]
+page

@@ -4548,7 +4618,7 @@ orientation option.

Use +page to remove the page settings for an image.

-

-paint radius

+

-paint radius

simulate an oil painting.
@@ -4556,12 +4626,12 @@ orientation option.

Each pixel is replaced by the most frequent color in a circular neighborhood whose width is specified with radius.

-

-path path

+

-path path

write images to this path on disk.
-

-pause seconds

+

-pause seconds

Pause between animation loops.[animate]
@@ -4569,7 +4639,7 @@ orientation option.

Pause for the specified number of seconds before repeating the animation.

-

-pause seconds

+

-pause seconds

Pause between snapshots.[import]
@@ -4577,19 +4647,19 @@ orientation option.

Pause for the specified number of seconds before taking the next snapshot.

-

-ping

+

-ping

efficiently determine image characteristics.
-

-pointsize value

+

-pointsize value

pointsize of the PostScript, OPTION1, or TrueType font.
-

-polaroid angle

+

-polaroid angle

simulate a Polaroid picture.
@@ -4597,19 +4667,19 @@ orientation option.

Use +polaroid to rotate the image at a random angle between -15 and +15 degrees.

-

-posterize levels

+

-posterize levels

reduce the image to a limited number of color levels.
-

-precision value

+

-precision value

set the maximum number of significant digits to be printed.
-

-preview type

+

-preview type

image preview type.
@@ -4653,13 +4723,13 @@ orientation option.

The default preview is JPEG.

-

-print string

+

-print string

interpret string and print to console.
-

-process command

+

-process command

process the image with a custom image filter.
@@ -4667,7 +4737,7 @@ orientation option.

The command arguments has the form "module arg1 arg2 arg3 ... argN" where module is the name of the module to invoke (e.g. "Analyze") and arg1 arg2 arg3 ... argN are an arbitrary number of arguments to pass to the process module.

-

-profile filename
+

-profile filename
+profile profile_name

@@ -4692,7 +4762,7 @@ CMYK profiles are often very asymmetric since they involve 3−>4 and 4&m

-

-quality value

+

-quality value

JPEG/MIFF/PNG compression level.
@@ -4726,7 +4796,7 @@ CMYK profiles are often very asymmetric since they involve 3−>4 and 4&m

For further information, see the PNG specification.

-

-quantize colorspace

+

-quantize colorspace

reduce colors using this colorspace.
@@ -4739,13 +4809,13 @@ GIF, and PNG8.

-

-quiet

+

-quiet

suppress all warning messages. Error messages are still reported.
-

-radial-blur angle

+

-radial-blur angle

Blur around the center of the image.
@@ -4759,7 +4829,7 @@ pixels which are outside the image proper are blurred into the final result.
-

-raise thickness

+

-raise thickness

Lighten or darken image edges.
@@ -4770,25 +4840,25 @@ pixels which are outside the image proper are blurred into the final result.

Unlike the similar -frame option, -raise does not alter the dimensions of the image.

-

-random-threshold lowxhigh

+

-random-threshold lowxhigh

Apply a random threshold to the image.
-

-red-primary x,y

+

-red-primary x,y

Set the red chromaticity primary point.
-

-regard-warnings

+

-regard-warnings

Pay attention to warning messages.
-

-remap filename

+

-remap filename

Reduce the number of colors in an image to the colors used by this image.
@@ -4818,7 +4888,7 @@ href="#colors">-colors or -ordered-dither to reduce the number of colors in an animated image sequence.

-

-region geometry

+

-region geometry

Set a region in which subsequent operations apply.
@@ -4828,7 +4898,7 @@ reduce the number of colors in an animated image sequence.

See Image Geometry for complete details about the geometry argument.

-

-remote

+

-remote

perform a remote operation.
@@ -4838,7 +4908,7 @@ reduce the number of colors in an animated image sequence.

If you have more than one display application running simultaneously, use the window option to specify which application to control.

-

-render

+

-render

render vector operations.
@@ -4846,7 +4916,7 @@ reduce the number of colors in an animated image sequence.

Use +render to turn off rendering vector operations. This useful when saving the result to vector formats such as MVG or SVG.

-

-repage geometry

+

-repage geometry

Adjust the canvas and offset information of the image.
@@ -4873,7 +4943,7 @@ directly assign virtual canvas meta-data.

-

-resample horizontalxvertical

+

-resample horizontalxvertical

Resample image to specified horizontal and vertical resolution.
@@ -4883,7 +4953,7 @@ directly assign virtual canvas meta-data.

Note that Photoshop stores and obtains image resolution from a proprietary embedded profile. If this profile exists in the image, then Photoshop will continue to treat the image using its former resolution, ignoring the image resolution specified in the standard file header.

-

-resize geometry

+

-resize geometry

Resize an image.
@@ -4896,20 +4966,20 @@ directly assign virtual canvas meta-data.

$magick> convert portrait.jpg -gamma .45455 -resize 25% -gamma 2.2 \
-quality 92 passport.jpg

-

-respect-parentheses

+

-respect-parentheses

settings remain in effect until parenthesis boundary.
-

-reverse

+

-reverse

Reverse the order of images in the current image list.
-

-roll {+-}x{+-}y

+

-roll {+-}x{+-}y

roll an image vertically or horizontally by the amount given.
@@ -4918,7 +4988,7 @@ directly assign virtual canvas meta-data.

-

-rotate degrees{<}{>}

+

-rotate degrees{<}{>}

Apply Paeth image rotation (using shear operations) to the image.
@@ -4933,7 +5003,7 @@ filled with the background color.

-

-sample geometry

+

-sample geometry

minify/magnify the image using pixel subsampling and pixel replication, respectively.
@@ -4956,7 +5026,7 @@ ignored, unlike -resize.

-

-sampling-factor horizontal-factorxvertical-factor

+

-sampling-factor horizontal-factorxvertical-factor

sampling factors used by JPEG or MPEG-2 encoder and YUV decoder/encoder.
@@ -4964,7 +5034,7 @@ ignored, unlike -resize.

This option specifies the sampling factors to be used by the JPEG encoder for chroma downsampling. If this option is omitted, the JPEG library will use its own default values. When reading or writing the YUV format and when writing the M2V (MPEG-2) format, use -sampling-factor 2x1 or -sampling-factor 4:2:2 to specify the 4:2:2 downsampling method.

-

-scale geometry

+

-scale geometry

minify/magnify the image using pixel block averaging and pixel replication, respectively.
@@ -4986,7 +5056,7 @@ light conditions.

-

-scene value

+

-scene value

set scene number.
@@ -4994,7 +5064,7 @@ light conditions.

This option sets the scene number of an image or the first image in an image sequence.

-

-screen

+

-screen

specify the screen to capture.
@@ -5002,13 +5072,13 @@ light conditions.

This option indicates that the GetImage request used to obtain the image should be done on the root window, rather than directly on the specified window. In this way, you can obtain pieces of other windows that overlap the specified window, and more importantly, you can capture menus or other popups that are independent windows but appear over the specified window.

-

-seed

+

-seed

seed a new sequence of pseudo-random numbers
-

-segment cluster-thresholdxsmoothing-threshold

+

-segment cluster-thresholdxsmoothing-threshold

segment the colors of an image.
@@ -5022,11 +5092,11 @@ of the color clusters is returned.

-

-selective-blur geometry

+

-selective-blur geometry

-

-selective-blur radius
-unsharp radiusxsigma{+threshold}

+

-selective-blur radius
-unsharp radiusxsigma{+threshold}

Selectively blur pixels within a contrast threshold.
@@ -5034,13 +5104,13 @@ of the color clusters is returned.

Blurs those pixels that are less than or equal to the threshold in contrast. The threshold may be expressed as a fraction of QuantumRange or as a percentage.

-

-separate

+

-separate

separate an image channel into a grayscale image. Specify the channel with -channel.
-

-sepia-tone threshold

+

-sepia-tone threshold

simulate a sepia-toned photo.
@@ -5052,8 +5122,8 @@ of the color clusters is returned.

-

-set key value

-

+set key

+

-set key value

+

+set key

- + @@ -220,6 +224,7 @@
sets image attributes and properties for images in the current @@ -5126,7 +5196,7 @@ with registry:.

-

-shade azimuthxelevation

+

-shade azimuthxelevation

shade the image using a distant light source.
@@ -5134,13 +5204,13 @@ with registry:.

Specify azimuth and elevation as the position of the light source. Use +shade to return the shading results as a grayscale image.

-

-shadow percent-opacity{xsigma}{+-}x{+-}y{%}

+

-shadow percent-opacity{xsigma}{+-}x{+-}y{%}

simulate an image shadow.
-

-shared-memory

@@ -5149,7 +5219,7 @@ id="shared-memory">-shared-memory

This option specifies whether the utility should attempt to use shared memory for pixmaps. ImageMagick must be compiled with shared memory support, and the display must support the MIT-SHM extension. Otherwise, this option is ignored. The default is True.

-

-sharpen radius{xsigma}

+

-sharpen radius{xsigma}

sharpen the image.
@@ -5157,7 +5227,7 @@ id="shared-memory">-shared-memory

Use a Gaussian operator of the given radius and standard deviation (sigma).

-

-shave geometry

+

-shave geometry

Shave pixels from the image edges.
@@ -5167,7 +5237,7 @@ id="shared-memory">-shared-memory

See Image Geometry for complete details about the geometry argument.

-

-shear Xdegrees[xYdegrees]

+

-shear Xdegrees[xYdegrees]

Shear the image along the x-axis and/or y-axis.
@@ -5185,7 +5255,7 @@ id="shared-memory">-shared-memory

$magick> convert logo: -shear 20x60 logo-sheared.png

-

-sigmoidal-contrast contrastxmid-point

+

-sigmoidal-contrast contrastxmid-point

increase the contrast without saturating highlights or shadows.
@@ -5193,13 +5263,13 @@ id="shared-memory">-shared-memory

Increase the contrast of the image using a sigmoidal transfer function without saturating highlights or shadows. Contrast indicates how much to increase the contrast (0 is none; 3 is typical; 20 is a lot); mid-point indicates where midtones fall in the resultant image (0 is white; 50% is middle-gray; 100% is black). By default the image contrast is increased, use +sigmoidal-contrast to decrease the contrast.

-

-silent

+

-silent

operate silently.
-

-size width[xheight][+offset]

+

-size width[xheight][+offset]

set the width and height of the image.
@@ -5217,7 +5287,7 @@ id="shared-memory">-shared-memory
-

-sketch radius
-sketch radiusxsigma+angle

+

-sketch radius
-sketch radiusxsigma+angle

simulate a pencil sketch.
@@ -5225,7 +5295,7 @@ id="shared-memory">-shared-memory

Sketch with the given radius, standard deviation (sigma), and angle. The angle given is the angle toward which the image is sketched. That is the direction people would consider the object is coming from.

-

-snaps value

+

-snaps value

Set the number of screen snapshots.[import]
@@ -5233,7 +5303,7 @@ id="shared-memory">-shared-memory

Use this option to grab more than one image from the X server screen, to create an animation sequence.

-

-solarize threshold

+

-solarize threshold

negate all pixels above the threshold level.
@@ -5243,7 +5313,7 @@ id="shared-memory">-shared-memory

This option produces a solarization effect seen when exposing a photographic film to light during the development process.

-

-sparse-color -sparse-color method 'x,y color ...'

@@ -5305,7 +5375,7 @@ default value.

-

-splice geometry

+

-splice geometry

Splice the current background color into the image.
@@ -5313,7 +5383,7 @@ default value.

See Image Geometry for complete details about the geometry argument. See -background to reset the background color.

-

-spread amount

+

-spread amount

displace image pixels by a random amount.
@@ -5321,7 +5391,7 @@ default value.

The argument amount defines the size of the neighborhood around each pixel from which to choose a candidate pixel to swap.

-

-stegano offset

+

-stegano offset

hide watermark within an image.
@@ -5329,7 +5399,7 @@ default value.

Use an offset to start the image hiding some number of pixels from the beginning of the image. Note this offset and the image size. You will need this information to recover the steganographic image (e.g. display -size 320x256+35 stegano:image.png).

-

-stereo +x{+y}

+

-stereo +x{+y}

composite two images to create a stereo anaglyph.[composite]
@@ -5337,7 +5407,7 @@ default value.

The left side of the stereo pair is saved as the red channel of the output image. The right side is saved as the green channel. Red-green stereo glasses are required to properly view the stereo image.

-

-storage-type type

+

-storage-type type

pixel storage type. Here are the valid types:
@@ -5356,7 +5426,7 @@ default value.

values range from 0 to the maximum value the storage type can support.

-

-stretch fontStretch

+

-stretch fontStretch

Set a type of stretch style for fonts.
@@ -5381,13 +5451,13 @@ values range from 0 to the maximum value the storage type can support.

For other settings that affect fonts, see the options -font, -family, -style, and -weight.

-

-strip

+

-strip

strip the image of any profiles or comments.
-

-stroke color

+

-stroke color

color to use when stroking a graphic primitive.
@@ -5397,7 +5467,7 @@ values range from 0 to the maximum value the storage type can support.

See -draw for further details.

-

-strokewidth value

+

-strokewidth value

set the stroke width.
@@ -5405,7 +5475,7 @@ values range from 0 to the maximum value the storage type can support.

See -draw for further details.

-

-style fontStyle

+

-style fontStyle

Set a font style for text.
@@ -5424,7 +5494,7 @@ the following.

For other settings that affect fonts, see the options -font, -family, -stretch, and -weight.

-

-subimage-search

+

-subimage-search

search for subimage.[compare]
@@ -5448,7 +5518,7 @@ sub-image the faster this search is.

-

-swap index,index

+

-swap index,index

Swap the positions of two images in the image sequence.
@@ -5458,7 +5528,7 @@ images in the current image sequence. Use +swap to switch the last two images in the sequence.

-

-swirl degrees

+

-swirl degrees

swirl image pixels about the center.
@@ -5466,19 +5536,19 @@ the last two images in the sequence.

Degrees defines the tightness of the swirl.

-

-synchronize

+

-synchronize

synchronize image to storage device.
-

-taint

+

-taint

Mark the image as modified.
-

-text-font name

+

-text-font name

font for writing fixed-width text.
@@ -5488,13 +5558,13 @@ the last two images in the sequence.

You can tag a font to specify whether it is a PostScript, TrueType, or OPTION1 font. For example, Courier.ttf is a TrueType font and x:fixed is OPTION1.

-

-texture filename

+

-texture filename

name of texture to tile onto the image background.
-

-threshold value{%}

+

-threshold value{%}

+ alaTest.com @@ -173,6 +177,8 @@

ImageMagick Command-line Processing

[The Anatomy of the Command Line • Input Filename • Image Setting • Image Operator • Image Sequence Operator • Image Geometry • Image Stack • Output Filename]

+
+

The ImageMagick command line can be as simple as this.

$magick> convert image.jpg image.png

@@ -185,12 +191,10 @@

Without knowing much about the ImageMagick command line, you can probably figure out that the first command above converts an image in the JPEG format to one in the PNG format. However, very few may realize the second, more complex command, gives a flat two-dimensional label a three-dimensional look with rich textures and simulated depth:

-

label ==> button -

[ A quick word about our formatting of commands: The second example above is long enough that the command must be written across several lines, so we formatted it for clarity by inserting backslashes (\). The backslash is the Unix line continuation character. In the Windows shell, use a carat character (^) for line continuation. We use the Unix style on these web pages, as above. Sometimes, however, the lines are wrapped by your browser if the browser window is small enough, but the command lines, shown in white, are still intended to be typed as one line. Line continuation characters need not be entered. The parentheses that are escaped above using the backslash are not escaped in Windows. There are some other differences between Windows and Unix (involving quotation marks, for instance), but we'll discuss some of those issues later, as they arise. ]

@@ -198,9 +202,7 @@

Here we show percent completion of a task as a shaded cylinder:

-

- Shaded Cylinder -

+ Shaded Cylinder

Given the complexity of the rendering, you might be surprised it is accomplished by a single command-line:

@@ -223,8 +225,10 @@ convert -size 320x90 xc:none -stroke snow4 -size 1x90 -tile gradient:white-snow4

In the next sections we dissect the anatomy of the ImageMagick command line. Hopefully, after carefully reading and better understanding how the command line works, you should be able to accomplish complex image-processing tasks without resorting to the sometimes daunting program interfaces.

See Examples of ImageMagick Usage for additional help when using ImageMagick from the command-line.

+
-

The Anatomy of the Command Line

+

The Anatomy of the Command Line

+

The ImageMagick command line consists of

    @@ -244,8 +248,9 @@ convert -size 320x90 xc:none -stroke snow4 -size 1x90 -tile gradient:white-snow4

You can find a detailed explanation of each of the constituent parts of the command line in the sections that follow.

+
-

Input Filename

+

Input Filename

ImageMagick extends the concept of an input filename to include:

@@ -279,7 +284,7 @@ of the image before it can be read and processed. Most formats have a signature within the image that uniquely identifies the format. Failing that, ImageMagick leverages the filename extension to determine the format. For example, image.jpg or image.JPG tells ImageMagick -it is reading an image in the JPEG format. +it is reading an image in the JPEG format.

In some cases the image may not contain a signature and/or the filename does not identify the image format. In these cases an @@ -425,7 +430,7 @@ the filename image-%d.jpg[1-5]. The command

-

Image Setting

+

Image Setting

An image setting persists as it appears on the command line and may affect @@ -442,7 +447,7 @@ is reset or the command line terminates. The image settings include:

$magick> convert -channel RGB wand.png wizard.png images.png

-

Image Operator

+

Image Operator

An image operator differs from a setting in that it affects the image @@ -461,7 +466,7 @@ include:

$magick> convert wand.png -negate wizard.png images.png

-

Image Sequence Operator

+

Image Sequence Operator

An image sequence operator differs from a setting in that it affects an @@ -472,7 +477,7 @@ these image sequence operators:

‑append  • ‑affinity  • ‑average  • ‑clut  • ‑coalesce  • ‑combine  • ‑composite  • ‑crop  • ‑debug  • ‑deconstruct  • ‑delete  • ‑evaluate‑seqence  • ‑fft  • ‑flatten  • ‑fx  • ‑hald‑clut  • ‑ift  • ‑identify  • ‑insert  • ‑layers  • ‑limit  • ‑map  • ‑maximum  • ‑minimum  • ‑morph  • ‑mosaic  • ‑optimize  • ‑print  • ‑process  • ‑quiet  • ‑separate  • ‑swap  • ‑write

-

Image Geometry

+

Image Geometry

Many command-line options take a geometry argument @@ -629,7 +634,7 @@ Here are some examples to illustrate the use of offsets in Image Stack +

Image Stack

In school, your teacher probably permitted you to work on problems on a scrap of paper and then copy the results to your test paper. An image stack is similar. It permits you to work on an image or image sequence in isolation and subsequently introduce the results back into the command line. The image stack is delineated with parenthesis. Image operators only affect images in the current stack. For example, we can limit the image rotation to just the wizard image like this:

@@ -655,7 +660,7 @@ above.

-

Output Filename

+

Output Filename

ImageMagick extends the concept of an output filename to include:

diff --git a/www/command-line-tools.html b/www/command-line-tools.html index 4221d5ddc..add3c26b5 100644 --- a/www/command-line-tools.html +++ b/www/command-line-tools.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
@@ -167,80 +171,63 @@
-

ImageMagick Command-line Tools

+

Create, Edit, Compose, or Convert Images from the Command-line

[animate • compare • composite • conjure • convert • display • identify • import • mogrify • montage • stream]

-

ImageMagick includes a number of command-line utilities for manipulating images. Most of you are probably accustomed to editing images one at a time with a graphical user interface (GUI) with such programs as gimp or Photoshop. However, a GUI is not always convenient. Suppose you want to process an image dynamically from a web script or you want to apply the same operations to many images or repeat a specific operation at different times to the same or different image. For these types of operations, the command-line image processing utility is appropriate.

+
+ +

ImageMagick includes a number of command-line utilities for manipulating images. Most of you are probably accustomed to editing images one at a time with a graphical user interface (GUI) with such programs as gimp or Photoshop. However, a GUI is not always convenient. Suppose you want to process an image dynamically from a web script or you want to apply the same operations to many images or repeat a specific operation at different times to the same or different image. For these types of operations, the command-line image processing utility is appropriate.

The ImageMagick command-line tools exit with a status of 0 if the command line arguments have a proper syntax and no problems are encountered. Expect a descriptive message and an exit status of 1 if any exception occurs such as improper syntax, a problem reading or writing an image, or any other problem that prevents the command from completing successfully.

-

In the paragraphs below, find a short description for each command-line tool. Click on the program name to get details about the program usage and a list of command-line options that alters how the program behaves. If you are just getting acquainted with ImageMagick, start with the convert program. Be sure to peruse Anthony Thyssen's tutorial on how to use ImageMagick utilities to convert, compose, or edit images from the command-line.

+

In the paragraphs below, find a short description for each command-line tool. Click on the program name to get details about the program usage and a list of command-line options that alters how the program behaves. If you are just getting acquainted with ImageMagick, start with the convert program. Be sure to peruse Anthony Thyssen's tutorial on how to use ImageMagick utilities to create, edit, compose, or convert images from the command-line.

-
-

animate

-
+
+
animate
-

animate an image sequence on any X server.

+
animate an image sequence on any X server.
-
-

compare

-
+
compare
-

mathematically and visually annotate the difference between an image and its reconstruction.

+
mathematically and visually annotate the difference between an image and its reconstruction.
- +
composite
-

overlap one image over another.

+
overlap one image over another.
-
-

conjure

-
+
conjure
-

interpret and execute scripts written in the Magick Scripting Language (MSL).

+
interpret and execute scripts written in the Magick Scripting Language (MSL).
-
-

convert

-
+
convert
-

convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more.

+
convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more.
-
-

display

-
+
display
-

display an image or image sequence on any X server.

+
display an image or image sequence on any X server.
- +
identify
-

describe the format and characteristics of one or more image files.

+
describe the format and characteristics of one or more image files.
-
-

import

-
+
import
-

save any visible window on an X server and outputs it as an image file. You can capture a single window, the entire screen, or any rectangular portion of the screen.

+
save any visible window on an X server and outputs it as an image file. You can capture a single window, the entire screen, or any rectangular portion of the screen.
-
-

mogrify

-
+
mogrify
-

resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. Mogrify overwrites the original image file, whereas, convert writes to a different image file.

+
resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. Mogrify overwrites the original image file, whereas, convert writes to a different image file.
-
-

montage

-
+
montage
-

create a composite image by combining several separate images. The images are tiled on the composite image optionally adorned with a border, frame, image name, and more.

+
create a composite image by combining several separate images. The images are tiled on the composite image optionally adorned with a border, frame, image name, and more.
-
-

stream

-
+
stream
-

a lightweight tool to stream one or more pixel components of the image or portion of the image to your choice of storage formats. It writes the pixel components as they are read from the input image a row at a time making stream desirable when working with large images or when you require raw pixel components.

+
a lightweight tool to stream one or more pixel components of the image or portion of the image to your choice of storage formats. It writes the pixel components as they are read from the input image a row at a time making stream desirable when working with large images or when you require raw pixel components.
+
+
diff --git a/www/compare.html b/www/compare.html index 59b06cc5c..9ff59872f 100644 --- a/www/compare.html +++ b/www/compare.html @@ -1,7 +1,7 @@ - - + + @@ -10,7 +10,7 @@ - + @@ -22,12 +22,25 @@ - + + + + + @@ -90,7 +103,7 @@ PerlMagick
- Magick++ + Magick++
@@ -128,7 +141,7 @@
@@ -168,13 +172,13 @@
-

ImageMagick Compare Command-line Utility

+

ImageMagick Compare Command-line Tool

[Example Usage • Option Summary]

Use the compare program to mathematically and visually annotate the difference between an image and its reconstruction. See Command Line Processing for advice on how to structure your compare command or see below for example usages of the command.

-

Example Usage

+

Example Usage

We list a few examples of the compare command here to illustrate its usefulness and ease of use. To get started, lets compare an image to one thats been sharpened:

@@ -210,7 +214,7 @@

You can find additional examples of using compare in Graphics from the Command Line. Further discussion is available in More Graphics from the Command Line and Examples of ImageMagick Usage.

-

Option Summary

+

Option Summary

The compare command recognizes these options. Click on an option to get more details about how that option works.

diff --git a/www/compose.html b/www/compose.html index 948e6135a..16accc4e6 100644 --- a/www/compose.html +++ b/www/compose.html @@ -1,16 +1,16 @@ - - + + - ImageMagick: Alpha Compositing + ImageMagick: Alpha Compositing - + @@ -22,12 +22,25 @@ - + + + + + @@ -90,7 +103,7 @@ PerlMagick
- Magick++ + Magick++
@@ -117,10 +130,10 @@
- Site Map + Site Map
- Links + Links
@@ -128,7 +141,7 @@
@@ -168,7 +172,7 @@
- +

ImageMagick Image Composition

This page descibed the Image composition methods that is used to define how two images should be merged together in various image operations. For the Command Line API it is typically set using the - + + @@ -10,7 +10,7 @@ - + @@ -22,12 +22,25 @@ - + + + + + @@ -90,7 +103,7 @@ PerlMagick

- Magick++ + Magick++
@@ -128,7 +141,7 @@
@@ -168,13 +172,13 @@
-

ImageMagick Composite Command-line Utility

+

ImageMagick Composite Command-line Tool

[Example Usage • Option Summary]

Use the composite program to overlap one image over another. See Command Line Processing for advice on how to structure your composite command or see below for example usages of the command.

-

Example Usage

+

Example Usage

We list a few examples of the composite command here to illustrate its usefulness and ease of use. To get started, lets overlay a smiley face over a rose:

@@ -208,7 +212,7 @@

You can find additional examples of using composite in Examples of ImageMagick Usage. You can find out more about them and the mathematics by looking at SVG Alpha Compositing

-

Option Summary

+

Option Summary

The composite command recognizes these options. Click on an option to get more details about how that option works.

diff --git a/www/conjure.html b/www/conjure.html index 597210767..5656faad1 100644 --- a/www/conjure.html +++ b/www/conjure.html @@ -1,7 +1,7 @@ - - + + @@ -10,7 +10,7 @@ - + @@ -22,12 +22,25 @@ - + + + + + @@ -90,7 +103,7 @@ PerlMagick
- Magick++ + Magick++
@@ -128,7 +141,7 @@
@@ -168,14 +172,14 @@
-

ImageMagick Conjure Command-line Utility

+

ImageMagick Conjure Command-line Tool

[Example Usage • Option Summary]

The conjure program gives you the ability to perform custom image processing tasks from a script written in the Magick Scripting Language (MSL). MSL is XML-based and consists of action statements with attributes. Actions include reading an image, processing an image, getting attributes from an image, writing an image, and more. An attribute is a key/value pair that modifies the behavior of an action. See Command Line Processing for advice on how to structure your conjure command or see below for example usages of the command.

-

Example Usage

+

Example Usage

We list a few examples of the conjure command here to illustrate its usefulness and ease of use. To get started, here is simple conjure command:

@@ -254,7 +258,7 @@
-

Option Summary

+

Option Summary

The conjure command recognizes these options. Click on an option to get more details about how that option works.

diff --git a/www/contact.html b/www/contact.html index 66eb6d4d6..c3ada200b 100644 --- a/www/contact.html +++ b/www/contact.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -138,15 +151,6 @@ - - -
@@ -171,8 +175,8 @@

ImageMagick Contact

- -

Use this form to contact the ImageMagick Wizards for any of the issues listed below. You can expect a reply within 24-48 hours if your message is on topic and is a sponsorshp, license, or security issue. The bug and documentation issues are for reporting only. For any other issue, post your message to the discourse server. Do not use this form to send solicitations / advertisements. Be assured you will not get a response.

+
+

Use this form to contact the ImageMagick Wizards for any of the issues listed below. You can expect a reply within 24-48 hours if your message is on topic and is a sponsorshp, license, or security issue. The bug and documentation issues are for reporting only. For any other issue, post your message to the discourse server. Do not use this form to send solicitations / advertisements. Be assured you will not get a response.

Contact the Wizards

Enter this code, @@ -208,7 +212,7 @@

+
diff --git a/www/convert.html b/www/convert.html index d7010855a..74835ac50 100644 --- a/www/convert.html +++ b/www/convert.html @@ -1,7 +1,7 @@ - - + + @@ -10,7 +10,7 @@ - + @@ -22,12 +22,25 @@ - + + + + + @@ -90,7 +103,7 @@ PerlMagick
- Magick++ + Magick++
@@ -128,7 +141,7 @@
@@ -168,14 +172,14 @@
-

ImageMagick Convert Command-line Utility

+

ImageMagick Convert Command-line Tool

[Example Usage • Option Summary]

Use the convert program to convert between image formats as well as resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. See Command Line Processing for advice on how to structure your convert command or see below for example usages of the command.

-

Example Usage

+

Example Usage

We list a few examples of the convert command here to illustrate its usefulness and ease of use. To get started, lets convert an image in the JPEG format to PNG:

@@ -207,7 +211,7 @@
-

Option Summary

+

Option Summary

The convert command recognizes these options. Click on an option to get more details about how that option works.

diff --git a/www/display.html b/www/display.html index cf74a7d38..918623c92 100644 --- a/www/display.html +++ b/www/display.html @@ -1,7 +1,7 @@ - - + + @@ -10,7 +10,7 @@ - + @@ -22,12 +22,25 @@ - + + + + + @@ -90,7 +103,7 @@ PerlMagick
- Magick++ + Magick++
@@ -139,15 +152,6 @@ - - -
@@ -168,14 +172,14 @@
-

ImageMagick Display Command-line Utility

+

ImageMagick Display Command-line Tool

[Example Usage • Option Summary]

Use the display program to display an image or image sequence on any X server. See Command Line Processing for advice on how to structure your display command or see below for example usages of the command.

-

Example Usage

+

Example Usage

We list a few examples of the display command here to illustrate its usefulness and ease of use. To get started, lets display an image in the JPEG format:

@@ -191,7 +195,7 @@
-

Option Summary

+

Option Summary

The display command recognizes these options. Click on an option to get more details about how that option works.

diff --git a/www/download.html b/www/download.html index e0221a088..9fde0e1de 100644 --- a/www/download.html +++ b/www/download.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
@@ -167,10 +171,11 @@
-

ImageMagick Download

+

Download ImageMagick

+

ImageMagick source and binary distributions are available from a variety of FTP and Web mirrors around the world listed below. ImageMagick stable and development source releases are also available from Subversion. Before you download, you may want to review recent changes to the ImageMagick distribution.

-

The latest release of ImageMagick is version 6.6.6-7.

-
+

The latest release of ImageMagick is version 6.6.6-8.

+
Australia
ftp://mirror.aarnet.edu.au/pub/imagemagick/
Austria
@@ -209,6 +214,7 @@
rsync://mirror.imagemagick.org/magick_svn/ (Subversion repository mirror)

If you want to add a new mirror, please contact us.

+
diff --git a/www/escape.html b/www/escape.html index 2ff26f016..5aa7f582e 100644 --- a/www/escape.html +++ b/www/escape.html @@ -1,16 +1,16 @@ - - + + - ImageMagick: Format and Print Image Properties + ImageMagick: Format and Print Image Properties - + @@ -22,12 +22,25 @@ - + + + + + @@ -90,7 +103,7 @@ PerlMagick
- Magick++ + Magick++
@@ -117,10 +130,10 @@
- Site Map + Site Map
- Links + Links
@@ -128,7 +141,7 @@
@@ -168,8 +172,10 @@
+

ImageMagick Escapes

+

Use the -format option to print properties associated with an image in a format of your choosing. You can include the image filename, type, width, height, EXIF data, or other image attributes by embedding special format characters:

@@ -247,9 +253,9 @@ for an image with filename bird.miff and whose width is 512 and heigh
 
 
Use fx: to evaluate FX expressions:

 
-

+
    %[fx:expression]
-

+

 
 
Use pixel: to evaluate a pixel color as defined by the FX expression:

 
@@ -450,7 +456,7 @@ for an image with filename bird.miff and whose width is 512 and heigh
     Post ObjectData Descriptor Record
       9:10   Confirmed ObjectData Size
- +
diff --git a/www/examples.html b/www/examples.html index 32d770730..f111f5adc 100644 --- a/www/examples.html +++ b/www/examples.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
@@ -168,11 +172,13 @@

ImageMagick Examples

-

Here are a few examples of what you can do with an image using ImageMagick from the command line, a program interface, or script. You can generate this image yourself with this PerlMagick script, examples.pl.


+
+

Here are a few examples of what you can do with an image using ImageMagick from the command line, a program interface, or script. You can generate this image yourself with this PerlMagick script, examples.pl.


[ImageMagick]
+
diff --git a/www/exception.html b/www/exception.html index 7655f4efc..5a685423c 100644 --- a/www/exception.html +++ b/www/exception.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/export.html b/www/export.html index 8177cd229..6fea545f3 100644 --- a/www/export.html +++ b/www/export.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
diff --git a/www/formats.html b/www/formats.html index b2a2b3168..26fdf648c 100644 --- a/www/formats.html +++ b/www/formats.html @@ -1,7 +1,7 @@ - - + + @@ -10,7 +10,7 @@ - + @@ -22,12 +22,25 @@ - + + + + + @@ -90,7 +103,7 @@ PerlMagick
- Magick++ + Magick++
@@ -128,7 +141,7 @@
@@ -171,7 +175,7 @@

ImageMagick Image Formats

[Introducing Formats • Supported Formats • Pseudo Formats • Built-in Images • Built-in Patterns • Embedded Profiles]

-

Introducing Image Formats

+

Introducing Image Formats

ImageMagick uses an ASCII string known as magick (e.g. GIF) to identify file formats, algorithms acting as formats, built-in patterns, and embedded profile types.

@@ -185,14 +189,14 @@
-

Supported Image Formats

+

Supported Image Formats

ImageMagick supports reading over 100 major file formats (not including sub-formats). The following table provides a summary of the supported image formats.

- +
@@ -1120,12 +1124,12 @@ convert \( -size 15x15 xc:black xc:white -append \) \ -

Pseudo-image Formats

+

Pseudo-image Formats

ImageMagick supports a number of image format specifications which refer to images prepared via an algorithm, or input/output targets. The following table lists these pseudo-image formats:

-
Tag
+
@@ -1323,12 +1327,12 @@ convert \( -size 15x15 xc:black xc:white -append \) \ -

Built-in Images

+

Built-in Images

ImageMagick includes a number of built-in (embedded) images which may be referenced as if they were an image file. The magick: format tag may be used via the syntax magick:name to request an embedded image (e.g. magick:logo). For backwards compatibility, the image specifications GRANITE:, LOGO:, NETSCAPE:, and ROSE: may also be used to request images with those names.

-
Tag Mode
+
@@ -1367,12 +1371,12 @@ convert \( -size 15x15 xc:black xc:white -append \) \ -

Built-in Patterns

+

Built-in Patterns

ImageMagick includes a number of built-in (embedded) patterns which may be referenced as if they were an image file. The pattern: format tag may be used via the syntax pattern:name to request an embedded pattern (e.g. pattern:checkerboard). The pattern size is controlled with the -size command line option.

-
Tag Mode
+
@@ -1761,12 +1765,12 @@ convert \( -size 15x15 xc:black xc:white -append \) \ -

Embedded Image Profiles

+

Embedded Image Profiles

ImageMagick provides a number of format identifiers which are used to add, remove, and save embedded profiles for images which can support embedded profiles. Image types which may contain embedded profiles are TIFF, JPEG, and PDF.

-
Tag Mode
+
diff --git a/www/fx.html b/www/fx.html index 25005d005..a34af0a99 100644 --- a/www/fx.html +++ b/www/fx.html @@ -1,7 +1,7 @@ - - + + @@ -10,7 +10,7 @@ - + @@ -22,12 +22,25 @@ - + + + + + @@ -90,7 +103,7 @@ PerlMagick
- Magick++ + Magick++
@@ -139,15 +152,6 @@ - - -
@@ -168,10 +172,10 @@
-

ImageMagick FX Special Effects Operator

+

Apply Special Effects to an Image with an Fx Expression

[The Fx Special Effects Image Operator • The Anatomy of an Fx Expression]

- +

Use the Fx special effects image operator to apply a mathematical expression to an image or image channels. Use Fx to:

@@ -225,7 +229,7 @@
-

The Anatomy of an Fx Expression

+

The Anatomy of an Fx Expression

The Fx Expression Language

@@ -423,12 +427,10 @@

$magick> convert -channel red logo: -flop logo: -resize "20%" -fx "(u+v)/2" image.jpg

-

logo-sm-flop.png logo-sm.png ==> logo-sm-fx.png -

diff --git a/www/high-dynamic-range.html b/www/high-dynamic-range.html index eb6e52f35..461cf1cc6 100644 --- a/www/high-dynamic-range.html +++ b/www/high-dynamic-range.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
@@ -171,7 +175,7 @@

ImageMagick High Dynamic-range Imaging

[Introduction to High Dynamic-Range Images • Enabling HDRI in ImageMagick]

- +

High dynamic-range imaging (HDRI) permits a far greater dynamic range of exposures (i.e. a large difference between light and dark areas) than standard digital imaging techniques. HDRI accurately represents the wide range of intensity levels found in real scenes ranging from the brightest direct sunlight to the deepest darkest shadows. The HDR imaging approach includes:

@@ -185,7 +189,7 @@
-

Enabling HDRI in ImageMagick

+

Enabling HDRI in ImageMagick

By default, image pixels in ImageMagick are stored as unsigned values that range from 0 to the quantum depth, which is typically 16-bits (Q16). With HDRI enabled, the pixels are stored in a floating-point representation and can include negative values as well as values that exceed the quantum depth. A majority of digital image formats do not support HDRI, and for those images any pixels outside the quantum range are clamped before they are stored.

diff --git a/www/identify.html b/www/identify.html index d6d2a1751..53417f570 100644 --- a/www/identify.html +++ b/www/identify.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -138,15 +151,6 @@ - - -
@@ -169,14 +173,14 @@ -

ImageMagick Identify Command-line Utility

+

ImageMagick Identify Command-line Tool

[Example Usage • Option Summary]

The identify program describes the format and characteristics of one or more image files. It also reports if an image is incomplete or corrupt. The information returned includes the image 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. Many more attributes are available with the verbose option. See Command Line Processing for advice on how to structure your identify command or see below for example usages of the command.

-

Example Usage

+

Example Usage

We list a few examples of the identify command here to illustrate its usefulness and ease of use. To get started, lets identify an image in the JPEG format:

@@ -238,7 +242,7 @@ Tainted: False
Filesize: 3.97266kb
Number pixels: 3.14453kb
- Version: ImageMagick 6.6.6-7 2010-12-25 Q16 http://www.imagemagick.org

+ Version: ImageMagick 6.6.6-8 2010-12-25 Q16 http://www.imagemagick.org

To get the print size in inches of an image at 72 DPI, use:

$magick> identify -format "%[fx:w/72] by %[fx:h/72] inches" document.png8.5 x 11 inches

@@ -252,7 +256,7 @@
-

Option Summary

+

Option Summary

The identify command recognizes these options. Click on an option to get more details about how that option works.

diff --git a/www/import.html b/www/import.html index 99a3dcea3..a058fbd71 100644 --- a/www/import.html +++ b/www/import.html @@ -1,7 +1,7 @@ - - + + @@ -10,7 +10,7 @@ - + @@ -22,12 +22,25 @@ - + + + + + @@ -90,7 +103,7 @@ PerlMagick
- Magick++ + Magick++
@@ -128,7 +141,7 @@
@@ -168,14 +172,14 @@
-

ImageMagick Import Command-line Utility

+

ImageMagick Import Command-line Tool

[Example Usage • Option Summary]

Use the import program to capture some or all of an X server screen and save the image to a file. See Command Line Processing for advice on how to structure your import command or see below for example usages of the command.

-

Example Usage

+

Example Usage

We list a few examples of the import command here to illustrate its usefulness and ease of use. To get started, lets import an image in the JPEG format:

@@ -188,7 +192,7 @@
-

Option Summary

+

Option Summary

The import command recognizes these options. Click on an option to get more details about how that option works.

diff --git a/www/index.html b/www/index.html index 83c01f60b..5bfa9b5f0 100644 --- a/www/index.html +++ b/www/index.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
@@ -167,11 +171,15 @@
-

About ImageMagick

+

Create, Edit, Compose, or Convert Bitmap Images

[Introduction to ImageMagick • Features and Capabilities • Books About ImageMagick • User Community]

-

ImageMagick® is a software suite to create, edit, or compose bitmap images. It can read, convert and write images in a variety of formats (over 100) including DPX, EXR, GIF, JPEG, JPEG-2000, PDF, PhotoCD, PNG, Postscript, SVG, and TIFF. Use ImageMagick to scale, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves.

+
+ + +
+

ImageMagick® is a software suite to create, edit, compose, or convert bitmap images. It can read and write images in a variety of formats (over 100) including DPX, EXR, GIF, JPEG, JPEG-2000, PDF, PhotoCD, PNG, Postscript, SVG, and TIFF. Use ImageMagick to scale, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves.

The functionality of ImageMagick is typically utilized from the command line or you can use the features from programs written in your favorite programming language. Choose from these interfaces: G2F (Ada), MagickCore (C), MagickWand (C), ChMagick (Ch), ImageMagickObject (COM+), Magick++ (C++), JMagick (Java), L-Magick (Lisp), NMagick (Neko/haXe), MagickNet (.NET), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP (PHP), IMagick (PHP), PythonMagick (Python), RMagick (Ruby), or TclMagick (Tcl/TK). With a language interface, use ImageMagick to modify or create images dynamically and automagically.

@@ -185,7 +193,7 @@
-

Features and Capabilities

+

Features and Capabilities

Here are just a few examples of what ImageMagick can do:

@@ -220,7 +228,7 @@
-

Books About ImageMagick

+

Books About ImageMagick

Definitive Guide to ImageMagick An open source project backed by years of continual development, ImageMagick supports about 100 image formats and can perform impressive operations such as creating images from scratch; changing colors; stretching, rotating, and overlaying images; and overlaying text on images. Whether you use ImageMagick to manage the family photos or to embark on a job involving millions of images, this book provides you with the knowledge to manage your images with ease.

The Definitive Guide to ImageMagick explains all of these capabilities and more in a practical, learn-by-example fashion. You'll get comfortable using ImageMagick for any image-processing task. Through the book's coverage of the ImageMagick interfaces for C, Perl, PHP, and Ruby, you'll learn how to incorporate ImageMagick features into a variety of applications.


@@ -229,7 +237,7 @@
-

User Community

+

User Community

To join the ImageMagick user community, try the discourse server. You can review questions or comments (with informed responses) posed by ImageMagick users or ask your own questions.

diff --git a/www/install-source.html b/www/install-source.html index 6fbdd8e8f..7d55ee7dd 100644 --- a/www/install-source.html +++ b/www/install-source.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
@@ -168,7 +172,7 @@
-

Install from Source

+

Install ImageMagick from Source

[Install from Unix Source • Install from Windows Source]

@@ -179,7 +183,7 @@

If the identify program executes and identifies itself as ImageMagick, you may not need to install ImageMagick from source unless you want to add support for additional image formats or upgrade to a newer version. You also have the option of installing a pre-compiled binary release. However, if you still want to install from source, choose a platform, Unix or Windows. Before installing from source, you may want to review recent changes to the ImageMagick distribution.

-

Install from Unix Source

+

Install from Unix Source

ImageMagick builds on a variety of Unix and Unix-like operating systems including Linux, Solaris, FreeBSD, Mac OS X, and others. A compiler is required and fortunately almost all modern Unix systems have one. Download ImageMagick.tar.gz from ftp.imagemagick.org or a mirrors and verify its message digest.

@@ -205,7 +209,7 @@
-

Install from Windows Source

+

Install from Windows Source

Building ImageMagick source for Windows requires a modern version of Microsoft Visual Studio IDE. Users have reported success with the Borland C++ compiler as well. If you don't have a compiler you can still install a self-installing binary release.

diff --git a/www/jp2.html b/www/jp2.html index c365f4626..da94106b7 100644 --- a/www/jp2.html +++ b/www/jp2.html @@ -1,7 +1,7 @@ - - + + @@ -10,7 +10,7 @@ - + @@ -22,12 +22,25 @@ - + + + + + @@ -90,7 +103,7 @@ PerlMagick
- Magick++ + Magick++
@@ -128,7 +141,7 @@
diff --git a/www/license.html b/www/license.html index 6cef35b1c..71a19735f 100644 --- a/www/license.html +++ b/www/license.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
- Magick++ + Magick++
@@ -127,7 +140,7 @@
@@ -168,9 +172,10 @@

ImageMagick License

-

[Definitions • Grant of Copyright License • Grant of Patent License • Redistribution • Submission of Contributions • Trademarks • Disclaimer of Warranty • Limitation of Liability • Accepting Warranty or Additional Liability]

+

[Terms and Conditions • How to Apply the License to your Work]

-

Before we get to the text of the license lets just review what the license says in simple terms:

+
+

Before we get to the text of the license, lets just review what the license says in simple terms:

It allows you to:

@@ -215,12 +220,17 @@
  • the license is compatible with the GPL V3.
  • when exporting the ImageMagick software, review its export classification.
    • +
    + + +

    Terms and Conditions

    +

    The legally binding and authoritative terms and conditions for use, reproduction, and distribution of ImageMagick follow:

    Copyright 1999-2011 ImageMagick Studio LLC, a non-profit organization dedicated to making software imaging solutions freely available.

    -

    1. Definitions.

    +

    1. Definitions.

    License shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.

    @@ -242,11 +252,11 @@

    Contributor shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.

    -

    2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.

    +

    2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.

    -

    3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.

    +

    3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.

    -

    4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:

    +

    4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:

    1. You must give any other recipients of the Work or Derivative Works a copy of this License; and
      2. @@ -260,17 +270,20 @@

      You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.

      -

      5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.

      +

      5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.

      -

      6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.

      +

      6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.

      -

      7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an AS IS BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.

      +

      7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an AS IS BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.

      -

      8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.

      +

      8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.

      -

      9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.

      +

      9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.

      +
    -
    APPENDIX: How to apply the ImageMagick License to your work
    + +

    How to Apply the License to your Work

    +

    To apply the ImageMagick License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives.

    @@ -290,6 +303,7 @@ under the License. +
    diff --git a/www/links.html b/www/links.html index 949e99206..aa3496e42 100644 --- a/www/links.html +++ b/www/links.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
    - Magick++ + Magick++
    @@ -127,7 +140,7 @@
    @@ -170,118 +174,101 @@

    ImageMagick Links

    [Command-line Tutorials • Program Interface Tutorials • ImageMagick Techniques • Installation Tutorials • ImageMagick Book Review • Web Site Mirrors • Projects that Utilize ImageMagick • Other Projects]

    -

    Listed here are a number of external web sites that are related to ImageMagick. ImageMagick Studio does not maintain or endorse these sites, excepting the Wizard's Toolkit site, but we feel they are a helpful adjunct to the ImageMagick web site.

    +
    -
    -

    Command-line Tutorials

    +

    Listed here are a number of external web sites that are related to ImageMagick. ImageMagick Studio does not maintain or endorse these sites, excepting the Wizard's Toolkit site, but we feel they are a helpfdl adjunct to the ImageMagick web site.

    - -
    -

    Program Interface Tutorials

    -
    +

    Command-line Tutorials

    +
    +
    Examples of ImageMagick Usage
    +
    Advanced image editing from the command line with ImageMagick
    +
    Best Open Source Software for the Macintosh
    +
    Command-line animations using ImageMagick
    +
    Convert Images with Open Source ImageMagick
    +
    Enchanting Pictures with ImageMagick
    +
    Graphics from the Command Line
    +
    Image creation, conversion and manipdlation with ImageMagick
    +
    Image Editing for Power Users on the Mac
    +
    ImageMagick: A graphics wizard for the command line
    +
    ImageMagick command line examples - part 1
    +
    ImageMagick command line examples - part 2
    +
    ImageMagick & Java
    +
    ImageMagick, Part One
    +
    ImageMagick, Part Two
    +
    More Graphics from the Command Line
    +
    Ubuntu Firefox Themes
    +
    - +

    Program Interface Tutorials

    -
    -

    Installation Tutorials

    -
    +
    +
    Create Mosaic Images with Perl and ImageMagick
    +
    Convert images for printing with MagickWand for PHP
    +
    Create Dynamic Images with ImageMagick
    +
    How to compile ImageMagick for PHP by hand
    +
    MagickWand Examples in C
    +
    PHP Extensions: MagickWand for PHP
    +
    PHP frontend to ImageMagick
    +
    PHP ImageMagick MagickWand Examples
    +
    RVG - Ruby Vector Graphics
    +
    Security Images with PHP and ImageMagick
    +
    Simple Uses of PHP and ImageMagick
    +
    - +

    Installation Tutorials

    -
    -

    ImageMagick Techniques

    -
    +
    +
    Installing ImageMagick on Mac OS X
    +
    ImageMagick Installer for Mac OS X
    +
    ImageMagick on iPhone
    +
    ImageMagick on iPhone - Xcode
    +
    Installing ImageMagick from Source on Ubuntu
    +
    - +

    ImageMagick Techniques

    -
    -

    ImageMagick Book Review

    -
    - +
    +
    Down-sampling Methods
    +
    -
    -

    Mailing List Archives

    -
    - +

    ImageMagick Book Review

    +
    +
    Book review: ImageMagick Tricks
    +
    The Definitive Guide To ImageMagick
    +
    -
    -

    ImageMagick Web Site Mirrors

    -
    +

    Mailing List Archives

    +
    +
    ImageMagick Users List
    +
    ImageMagick Developers List
    +
    ImageMagick Bugs List
    +
    + +

    ImageMagick Web Site Mirrors

    Denmark
    -
    http://imagemagick.europnews.de

    +
    http://imagemagick.europnews.de
    Germany
    -
    http://imagemagick.linux-mirror.org

    +
    http://imagemagick.linux-mirror.org
    Ireland
    -
    http://imagemagick.oss-mirror.org

    +
    http://imagemagick.oss-mirror.org
    United States
    http://www.imagemagick.org
    -
    -

    Projects that Utilize ImageMagick

    -
    - -
      -
      G'MIC: convert, manipulate and visualize generic 1D/2D/3D multi-spectral image files
      -
      Image Commander: bulk picture processing with a GUI
      -
    +

    Projects that Utilize ImageMagick

    -
    -

    Other Projects Hosted by ImageMagick Studio

    -
    - +
    +
    G'MIC: convert, manipulate and visualize generic 1D/2D/3D mdlti-spectral image files
    +
    Image Commander: bdlk picture processing with a GUI
    +
    +

    Other Projects Hosted by ImageMagick Studio

    +
    +
    Wizard's Toolkit
    +
    Computational Simdlation of Mdlti-Body Interactions with O(n) Scaling
    +
    diff --git a/www/magick++.html b/www/magick++.html index e69de29bb..9596cc6ea 100644 --- a/www/magick++.html +++ b/www/magick++.html @@ -0,0 +1,285 @@ + + + + + + + ImageMagick: Magick++, C++ API for ImageMagick + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + [ImageMagick] + + [sponsor] + + + + +
    + +
    + +
    + About ImageMagick +
    +
    +
    + Binary Releases +
    +
    + Unix +
    +
    + Mac OS X +
    +
    + Windows +
    +
    +
    + Command-line Tools +
    +
    + Processing +
    +
    + Options +
    +
    + Usage +
    +
    + Program Interfaces +
    +
    + MagickWand +
    +
    + MagickCore +
    +
    + PerlMagick +
    +
    + Magick++ +
    +
    +
    + Install from Source +
    +
    + Unix +
    +
    + Windows +
    +
    + Resources +
    +
    + Architecture +
    +
    + Download +
    +
    +
    + Search +
    +
    +
    + Site Map +
    +
    + Links +
    +
    +
    + Sponsors: + +
    + + + + +
    +
    +
    + +
    + + +
    + +
    + +

    Magick++ C++ API

    +

    [Introduction to Magick++ • Documentation • Obtaining Magick++ • Installation • Reporting Bugs]

    +
    + +

    Magick++ is the object-oriented C++ API to the ImageMagick image-processing library.

    +

    Magick++ supports an object model which is inspired by PerlMagick. +Images support implicit reference counting so that copy constructors +and assignment incur almost no cost. The cost of actually copying an +image (if necessary) is done just before modification and this copy +is managed automagically by Magick++. De-referenced copies are +automagically deleted. The image objects support value (rather than +pointer) semantics so it is trivial to support multiple generations +of an image in memory at one time. +

    +

    Magick++ provides integrated support for the Standard +Template Library (STL) so that the powerful containers available +(e.g. deque, +vector, list, +and map)  can +be used to write programs similar to those possible with PERL & +PerlMagick. STL-compatible template versions of ImageMagick's +list-style operations are provided so that operations may be +performed on multiple images stored in STL containers. +

    +
    +

    Documentation

    +
    + +

    Detailed documentation is +provided for all Magick++ classes, class methods, and template +functions which comprise the API. See a Gentle Introduction to Magick++ for an introductory tutorial to Magick++. We include the source if you want to correct, enhance, or expand the tutorial.

    +

    +
    +

    Obtaining Magick++

    + +
    +

    Magick++ is included as part of ImageMagick +source releases and may be retrieved via ftp +or Subversion. +

    +
    +

    Installation

    +
    + +

    Once you have the Magick++ sources available, follow these detailed +installation instructions for UNIX and +Windows. +

    +

    A helper script named Magick++-config is installed +under Unix which assists with recalling compilation options required +to compile and link programs which use Magick++. For example, the +following command will compile and link the source file demo.cpp +to produce the executable demo (notice that quotes are +backward quotes): +

    +
    +c++ `Magick++-config --cxxflags --cppflags` -O2 -o demo demo.cpp \
+  `Magick++-config --ldflags --libs`
+
    +

    Windows users may get started by manually editing a project file +for one of the Magick++ demo programs. +

    +

    Note, under Windows (and possibly the Mac) it may be necessary to initialize the ImageMagick library prior to using the Magick++ library. This initialization is performed by passing the path to the ImageMagick DLLs (assumed to be in the same directory as your program) to the InitializeMagick() function call. This is commonly performed by providing the path to your program (argv[0]) as shown in the following example:

    +
    +int main( int argc, char ** argv) {
+  InitializeMagick(*argv);
+  ...
+
    +

    This initialization step is not required under Unix, Linux, +Cygwin, or any other operating environment that supports the notion +of installing ImageMagick in a known location. +

    +
    +

    Reporting Bugs

    +
    + +

    Please report any bugs via the +Magick++ bug tracking forum. +Questions regarding usage should be directed to +Magick++ discussion forum. +

    +
    + +
    + + +
    + © 1999-2011 ImageMagick Studio LLC + Contact the Wizards +
    +
    + + + diff --git a/www/magick-core.html b/www/magick-core.html index 1b7446e88..15ab20c27 100644 --- a/www/magick-core.html +++ b/www/magick-core.html @@ -1,7 +1,7 @@ - - + + @@ -10,7 +10,7 @@ - + @@ -22,12 +22,25 @@ - + + + + + @@ -90,7 +103,7 @@ PerlMagick
    - Magick++ + Magick++
    @@ -128,7 +141,7 @@
    @@ -168,7 +172,9 @@
    -

    ImageMagick MagickCore API

    +

    MagickCore C API

    + +

    The MagickCore API is a low-level interface between the C programming language and the ImageMagick image processing libraries and is recommended for wizard-level programmers only. Unlike the MagickWand C API which uses only a few opaque types and accessors, with MagickCore you almost exlusively access the structure members directly. A description of the MagickCore public methods are found here:

    @@ -296,7 +302,7 @@ }
    -

    Now lets perform the same contrast enhancement while taking advantage of our dual or quad-core processing system by running the algorithm in parallel utilizing wand views. The sigmoidal-contrast.c module reads an image, applies sigmoidal non-linearity contrast control, and writes the result to disk just like the previous contrast enhancement program, but now it does its work in parallel (assumes ImageMagick is built with OpenMP support).

    +

    Now lets perform the same contrast enhancement while taking advantage of our dual or quad-core processing system by running the algorithm in parallel utilizing wand views. The sigmoidal-contrast.c module reads an image, applies sigmoidal non-linearity contrast control, and writes the result to disk just like the previous contrast enhancement program, but now it does its work in parallel (assumes ImageMagick is built with OpenMP support).

    @@ -358,7 +364,7 @@ int main(int argc,char **argv)
   ExceptionType \
     severity; \
  \
-  description=GetImageViewException(view,&severity); \
+  description=GetImageViewException(view,&severity); \
   (void) fprintf(stderr,"%s %s %lu %s\n",GetMagickModule(),description); \
   description=DestroyString(description); \
   exit(-1); \
@@ -418,6 +424,7 @@ int main(int argc,char **argv)
 }
    +
    diff --git a/www/magick-vector-graphics.html b/www/magick-vector-graphics.html index 1ff479e3f..8f43a8c1a 100644 --- a/www/magick-vector-graphics.html +++ b/www/magick-vector-graphics.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
    - Magick++ + Magick++
    @@ -127,7 +140,7 @@
    @@ -171,7 +175,7 @@

    ImageMagick Magick Vector Graphics

    [Introduction to Vector Graphics • MVG Overview • Drawing Primitives]

    - +

    This specification defines the features and syntax for Magick Vector Graphics (MVG), a modularized language for describing two-dimensional vector and mixed vector/raster graphics in ImageMagick. You can use the language to draw from the @@ -189,7 +193,6 @@ command line, from an MVG file, from an SVG

    When the drawing gets sufficiently complex, we recommend you assemble the graphic primitives into a MVG file. For our example, we use piechart.mvg:

    -
       push graphic-context
     viewbox 0 0 624 369
     affine 0.283636 0 0 0.283846 -0 -0
@@ -340,7 +343,6 @@ command line, from an MVG file, from an SVG
       pop graphic-context
     pop graphic-context
   pop graphic-context
-

    to render a pie chart with this command:

    @@ -361,7 +363,6 @@ command line, from an MVG file, from an     SVG

    Drawing is available from many of the ImageMagick program interfaces as well. ImageMagick converts the drawing API calls to MVG and renders it. Here is example code written in the MagickWand language:

    -
        (void) PushDrawingWand(draw_wand);
    {
      const PointInfo points[6] =
@@ -387,12 +388,11 @@ command line, from an MVG file, from an SVG
      DrawPolygon(draw_wand,6,points);
    }
    (void) PopDrawingWand(draw_wand);
-
    -

    MVG Overview

    +

    MVG Overview

    MVG ignores all white-space between commands. This allows multiple MVG commands per line. It is common convention to terminate each MVG command with a new line to make MVG easier to edit and read. This syntax description uses indentation in MVG sequences to aid with understanding. Indentation is supported but is not required.

    @@ -468,43 +468,43 @@ command line, from an MVG file, from an SVG
    -

    Drawing Primitives

    +

    Drawing Primitives

    Here is a complete description of the MVG drawing primitives:

    -
    affine sx,rx,ry,sy,tx,ty
    +
    affine sx,rx,ry,sy,tx,ty
    -
    arc x0,y0   x1,y1   a0,a1
    +
    arc x0,y0   x1,y1   a0,a1
    -
    bezier x0,y0 ... xn,yn
    +
    bezier x0,y0 ... xn,yn

    Bezier (spline) requires three or more x,y coordinates to define its shape. The first and last points are the knots (preserved coordinates) and any intermediate coordinates are the control points. If two control points are specified, the line between each end knot and its sequentially respective control point determines the tangent direction of the curve at that end. If one control point is specified, the lines from the end knots to the one control point determines the tangent directions of the curve at each end. If more than two control points are specified, then the additional control points act in combination to determine the intermediate shape of the curve. In order to draw complex curves, it is highly recommended either to use the Path primitive or to draw multiple four-point bezier segments with the start and end knots of each successive segment repeated.

    -
    border-color color
    +
    border-color color
    -
    circle originx,originy   perimeterx,perimetery
    +
    circle originx,originy   perimeterx,perimetery
    -
    clip-path url(name)
    +
    clip-path url(name)
    -
    clip-rule rule
    +
    clip-rule rule
    Choose from these rule types: @@ -514,7 +514,7 @@ command line, from an MVG file, from an SVG

    -
    clip-units units
    +
    clip-units units
    Choose from these unit types: @@ -525,7 +525,7 @@ command line, from an MVG file, from an SVG

    -
    color x,y method
    +
    color x,y method
    @@ -549,7 +549,7 @@ command line, from an MVG file, from an SVG -
    decorate type
    +
    decorate type
    Choose from these types of decorations: @@ -563,20 +563,20 @@ command line, from an MVG file, from an SVG
    -
    ellipse centerx,centery   radiusx,radiusy   arcstart,arcstop
    +
    ellipse centerx,centery   radiusx,radiusy   arcstart,arcstop
    -
    fill color
    +
    fill color
    Choose from any of these colors.
    -
    fill-opacity opacity
    +
    fill-opacity opacity
    The opacity ranges from 0.0 (fully transparent) to 1.0 (fully opaque) or as a percentage (e.g. 50%).
    -
    fill-rule rule
    +
    fill-rule rule
    Choose from these rule types: @@ -588,19 +588,19 @@ command line, from an MVG file, from an SVG
    -
    font name
    +
    font name
    -
    font-family family
    +
    font-family family
    -
    font-size point-size
    +
    font-size point-size
    -
    font-stretch type
    +
    font-stretch type
    Choose from these stretch types: @@ -619,7 +619,7 @@ command line, from an MVG file, from an SVG
    -
    font-style style
    +
    font-style style
    Choose from these styles: @@ -633,7 +633,7 @@ command line, from an MVG file, from an SVG
    -
    font-weight weight
    +
    font-weight weight
    Choose from these weights: @@ -654,7 +654,7 @@ command line, from an MVG file, from an SVG
    -
    gradient-units units
    +
    gradient-units units
    Choose from these units: @@ -666,7 +666,7 @@ command line, from an MVG file, from an SVG
    -
    gravity type
    +
    gravity type
    Choose from these gravity types: @@ -684,7 +684,7 @@ command line, from an MVG file, from an SVG
    -
    image compose x,y width,height 'filename'
    +
    image compose x,y width,height 'filename'
    Choose from these compose operations: @@ -861,23 +861,23 @@ command line, from an MVG file, from an SVG
    -
    interline-spacing pixels
    +
    interline-spacing pixels
    -
    interword-spacing pixels
    +
    interword-spacing pixels
    -
    kerning pixels
    +
    kerning pixels
    -
    line x,y x1,y1
    +
    line x,y x1,y1
    -
    matte x,y method
    +
    matte x,y method
    Choose from these methods: @@ -891,119 +891,119 @@ command line, from an MVG file, from an SVG
    -
    offset offset
    +
    offset offset
    -
    opacity opacity
    +
    opacity opacity
    Use percent (e.g. 50%).
    -
    path path
    +
    path path
    -
    point x,y
    +
    point x,y
    -
    polygon x,y x1,y1, ..., xn,yn
    +
    polygon x,y x1,y1, ..., xn,yn
    -
    polyline x,y x1,y1, ..., xn,yn
    +
    polyline x,y x1,y1, ..., xn,yn
    -
    pop clip-path
    +
    pop clip-path
    -
    pop defs
    +
    pop defs
    -
    pop gradient
    +
    pop gradient
    -
    pop graphic-context
    +
    pop graphic-context
    -
    pop pattern
    +
    pop pattern
    -
    push clip-path name
    +
    push clip-path name
    -
    push defs
    +
    push defs
    -
    push gradient id linear x,y x1,y1
    +
    push gradient id linear x,y x1,y1
    -
    push gradient id radial xc,cy xf,yf radius
    +
    push gradient id radial xc,cy xf,yf radius
    -
    push graphic-context
    +
    push graphic-context
    -
    push pattern id radial x,y width,height
    +
    push pattern id radial x,y width,height
    -
    rectangle x,y x1,y1
    +
    rectangle x,y x1,y1
    -
    rotate angle
    +
    rotate angle
    -
    roundrectangle x,y x1,y1 width,height
    +
    roundrectangle x,y x1,y1 width,height
    -
    scale x,y
    +
    scale x,y
    -
    skewX angle
    +
    skewX angle
    -
    skewX angle
    +
    skewX angle
    -
    stop-color color offset
    +
    stop-color color offset
    -
    stroke color
    +
    stroke color
    -
    stroke-antialias 0 • 1
    +
    stroke-antialias 0 • 1
    -
    stroke-dasharray none • numeric-list
    +
    stroke-dasharray none • numeric-list
    -
    stroke-dashoffset offset
    +
    stroke-dashoffset offset
    -
    stroke-linecap type
    +
    stroke-linecap type
    Choose from these cap types: @@ -1016,7 +1016,7 @@ command line, from an MVG file, from an SVG
    -
    stroke-linejoin type
    +
    stroke-linejoin type
    Choose from these join types: @@ -1028,36 +1028,36 @@ command line, from an MVG file, from an SVG
    -
    stroke-miterlimit limit
    +
    stroke-miterlimit limit
    -
    stroke-opacity opacity
    +
    stroke-opacity opacity
    The opacity ranges from 0.0 (fully transparent) to 1.0 (fully opaque) or as a percentage (e.g. 50%).
    -
    stroke-width width
    +
    stroke-width width
    -
    text "text"
    +
    text "text"
    -
    text-antialias 0 • 1
    +
    text-antialias 0 • 1
    -
    text-undercolor color
    +
    text-undercolor color
    -
    translate x,y
    +
    translate x,y
    -
    viewbox x,y x1,y1
    +
    viewbox x,y x1,y1
    diff --git a/www/magick-wand.html b/www/magick-wand.html index 14f1f13d2..36ebef3de 100644 --- a/www/magick-wand.html +++ b/www/magick-wand.html @@ -1,7 +1,7 @@ - - + + @@ -10,7 +10,7 @@ - + @@ -22,12 +22,25 @@ - + + + + + @@ -90,7 +103,7 @@ PerlMagick
    - Magick++ + Magick++
    @@ -128,7 +141,7 @@
    @@ -168,8 +172,9 @@
    -

    ImageMagick MagickWand API

    +

    MagickWand C API

    +

    The MagickWand API is the recommended interface between the C programming language and the ImageMagick image processing libraries. Unlike the MagickCore C API, MagickWand uses only a few opaque types. Accessors are available to set or get important wand properties. A description of the MagickWand public methods are found here:

    After you write your MagickWand program, compile it like this:

    @@ -363,7 +367,7 @@ int main(int argc,char **argv) }
    -

    Now lets perform the same contrast enhancement while taking advantage of our dual or quad-core processing system by running the algorithm in parallel utilizing wand views. The sigmoidal-contrast.c module reads an image, applies sigmoidal non-linearity contrast control, and writes the result to disk just like the previous contrast enhancement program, but now it does its work in parallel (assumes ImageMagick is built with OpenMP support).

    +

    Now lets perform the same contrast enhancement while taking advantage of our dual or quad-core processing system by running the algorithm in parallel utilizing wand views. The sigmoidal-contrast.c module reads an image, applies sigmoidal non-linearity contrast control, and writes the result to disk just like the previous contrast enhancement program, but now it does its work in parallel (assumes ImageMagick is built with OpenMP support).

    @@ -409,14 +413,14 @@ int main(int argc,char **argv)
 {
 #define ThrowViewException(view) \
 { \
-  description=GetWandViewException(view,&severity); \
+  description=GetWandViewException(view,&severity); \
   (void) fprintf(stderr,"%s %s %lu %s\n",GetMagickModule(),description); \
   description=(char *) MagickRelinquishMemory(description); \
   exit(-1); \
 }
 #define ThrowWandException(wand) \
 { \
-  description=MagickGetException(wand,&severity); \
+  description=MagickGetException(wand,&severity); \
   (void) fprintf(stderr,"%s %s %lu %s\n",GetMagickModule(),description); \
   description=(char *) MagickRelinquishMemory(description); \
   exit(-1); \
@@ -475,6 +479,7 @@ int main(int argc,char **argv)
 }
    +
    diff --git a/www/miff.html b/www/miff.html index 378e4a731..1b11aa66a 100644 --- a/www/miff.html +++ b/www/miff.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
    - Magick++ + Magick++
    @@ -127,7 +140,7 @@
    @@ -168,18 +172,17 @@

    ImageMagick Magick Image File Format

    -

    [MIFF Header • MIFF Binary Data]

    +

    [MIFF Header • MIFF Binary Data]

    The Magick Image File Format (MIFF) is ImageMagick's own platform-independent format for storing bitmap images. It has an advantage over other image formats in that it stores all metadata known to ImageMagick (e.g. image color profiles, comments, author, copyright, etc.), whereas, other formats may only support a small portion of available metadata or none at all. A MIFF image file consist of two sections. The first section is a header composed of keys describing the image in text form. The next section is the binary image data. We discuss these sections in detail below.

    -

    MIFF Header

    +

    MIFF Header

    -

    The MIFF header is composed entirely of ISO-8859-1 characters. The fields -in the header are key and value combination in the key = value format, with each key and value separated by an equal sign (=). Each key = value combination is delimited by at least one control or whitespace character. Comments may appear in the header section and are always delimited by braces. The MIFF header always ends with a colon (:) character, followed by a ctrl-Z character. It is also common to proceed the colon with a formfeed and a newline character. The formfeed prevents the listing of binary data when using the more Unix program, whereas, the ctrl-Z has the same effect with the type command on the Windows command line.

    +

    The MIFF header is composed entirely of ISO-8859-1 characters. The fields in the header are key and value combination in the key = value format, with each key and value separated by an equal sign (=). Each key = value combination is delimited by at least one control or whitespace character. Comments may appear in the header section and are always delimited by braces. The MIFF header always ends with a colon (:) character, followed by a ctrl-Z character. It is also common to proceed the colon with a formfeed and a newline character. The formfeed prevents the listing of binary data when using the more Unix program, whereas, the ctrl-Z has the same effect with the type command on the Windows command line.

    The following is a partial list of key = value combinations that are typically be found in a MIFF file:

    @@ -302,7 +305,7 @@ in the header are key and value combination in the key = value format,
    -

    MIFF Binary Data

    +

    MIFF Binary Data

    Next comes the binary image data itself. How the image data is formatted depends upon the class of the image as specified (or not specified) by the value of the class key in the header.

    diff --git a/www/mogrify.html b/www/mogrify.html index 2ed54fef9..c6772006f 100644 --- a/www/mogrify.html +++ b/www/mogrify.html @@ -1,7 +1,7 @@ - - + + @@ -10,7 +10,7 @@ - + @@ -22,12 +22,25 @@ - + + + + + @@ -90,7 +103,7 @@ PerlMagick
    - Magick++ + Magick++
    @@ -128,7 +141,7 @@
    @@ -168,14 +172,14 @@
    -

    ImageMagick Mogrify Command-line Utility

    +

    ImageMagick Mogrify Command-line Tool

    [Example Usage • Option Summary]

    Use the mogrify program to resize an image, blur, crop, despeckle, dither, draw on, flip, join, re-sample, and much more. This tool is similiar to convert except that the original image file is overwritten (unless you change the file suffix with the -format option) with any changes you request. See Command Line Processing for advice on how to structure your mogrify command or see below for sample usages of the command.

    -

    Example Usage

    +

    Example Usage

    We list a few examples of the mogrify command here to illustrate its usefulness and ease of use. To get started, lets reduce the size of our @@ -205,7 +209,7 @@ rose:

    -

    Option Summary

    +

    Option Summary

    The mogrify command recognizes these options. Click on an option to get more details about how that option works.

    diff --git a/www/montage.html b/www/montage.html index 24b4a9cd9..4787c41b1 100644 --- a/www/montage.html +++ b/www/montage.html @@ -1,7 +1,7 @@ - - + + @@ -10,7 +10,7 @@ - + @@ -22,12 +22,25 @@ - + + + + + @@ -90,7 +103,7 @@ PerlMagick
    - Magick++ + Magick++
    @@ -128,7 +141,7 @@
    @@ -168,14 +172,14 @@
    -

    ImageMagick Montage Command-line Utility

    +

    ImageMagick Montage Command-line Tool

    [Example Usage • Option Summary]

    Use the montage program to create a composite image by combining several separate images. The images are tiled on the composite image optionally adorned with a border, frame, image name, and more. See Command Line Processing for advice on how to structure your montage command or see below for example usages of the command.

    -

    Example Usage

    +

    Example Usage

    We list a few examples of the montage command here to illustrate its usefulness and ease of use. To get started, let's montage two images into a single composite:

    @@ -214,7 +218,7 @@
    -

    Option Summary

    +

    Option Summary

    The montage command recognizes these options. Click on an option to get more details about how that option works.

    diff --git a/www/motion-picture.html b/www/motion-picture.html index f7d698f6d..2d4241273 100644 --- a/www/motion-picture.html +++ b/www/motion-picture.html @@ -1,7 +1,7 @@ - - + + @@ -10,7 +10,7 @@ - + @@ -22,12 +22,25 @@ - + + + + + @@ -90,7 +103,7 @@ PerlMagick
    - Magick++ + Magick++
    @@ -128,7 +141,7 @@
    @@ -171,7 +175,7 @@

    ImageMagick Motion Picture Formats

    [Introduction to Motion Picture Formats • Log Format • DPX properties • DPX Settings]

    -

    Introduction to Motion Picture Formats

    +

    Introduction to Motion Picture Formats

    DPX (SMPTE 268M-2003) - This format is used in Motion Picture and Effects industry that makes particular use of the extensive header information and the format's flexibility in being able to handle high dynamic range and logarithmic color values at a variety of bit depths using RGB or YCbCr pixel descriptions. It is based on, but largely supercedes, Kodak's Cineon format that has more a more film specific header.

    @@ -188,7 +192,7 @@
    -

    Log Format

    +

    Log Format

    The color values for each pixel are often stored logarithmically (particularly if the sequence is destined to be transferred back on to film) which more naturally reflects the density of how color information is stored in the emulsion on the original film. When viewed without alteration logarithmic files appear to have very low contrast (leftmost image), and so require a 'look up table' to translate the logarithmic image to something that resembles what you might see if the image was transferred back to film and projected in a cinema (rightmost image). Apart from making the image linear (like most typical computer images) and adjusting the gamma level this table sets where the black and white point lies.

    @@ -209,7 +213,7 @@
    -

    DPX Properties

    +

    DPX Properties

    ImageMagick supports these DPX properties:

    @@ -274,7 +278,7 @@

    $magick> convert bluebells.dpx -define dpx:television.time.code=10:00:02:15 bluebells-001.dpx

    -

    DPX Settings

    +

    DPX Settings

    Use -set to specify the image or film gamma or black and white points. For example use: diff --git a/www/perl-magick.html b/www/perl-magick.html index 9b7243e13..4cec9fc46 100644 --- a/www/perl-magick.html +++ b/www/perl-magick.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick

    - Magick++ + Magick++
    @@ -127,7 +140,7 @@
    @@ -172,7 +176,7 @@

    [Installation • Overview • Example Script • Read or Write an Image • Manipulate an Image • Set an Image Attribute • Get an Image Attribute • Compare an Image to its Reconstruction • Create an Image Montage • Working with Blobs • Direct-access to Image Pixels • Miscellaneous Methods • Handling Exceptions• Constant ]

    - +

    PerlMagick is an objected-oriented Perl interface to ImageMagick. Use the module to read, manipulate, or write an image or image sequence from within a Perl script. This makes it very suitable for Web CGI scripts. You must have ImageMagick 6.5.5 or above and Perl version 5.005_02 or greater installed on your system for PerlMagick to build properly.

    There are a number of useful scripts available to show you the value of PerlMagick. You can do Web based image manipulation and conversion with MagickStudio, or use L-systems to create images of plants using mathematical constructs, and finally navigate through collections of thumbnail images and select the image to view with the WebMagick Image Navigator.

    @@ -180,7 +184,7 @@

    You can try PerlMagick from your Web browser at the ImageMagick Studio. Or, you can see examples of select PerlMagick functions.

    -

    Installation

    +

    Installation

    UNIX

    @@ -219,7 +223,7 @@ ImageMagick 6.6.6) and unpack it as shown below:

    -

    Overview

    +

    Overview

    Any script that wants to use PerlMagick methods must first define the methods within its namespace and instantiate an image object. Do this with:

    @@ -262,7 +266,7 @@ ImageMagick 6.6.6) and unpack it as shown below:

    $magick> $ENV{PATH}='/../bin:/usr/bin:/usr/local/bin';

    -

    Example Script

    +

    Example Script

    Here is an example script to get you started:

    @@ -351,7 +355,7 @@ ImageMagick 6.6.6) and unpack it as shown below:

    -

    Read or Write an Image

    +

    Read or Write an Image

    Use the methods listed below to either read, write, or display an image or image sequence:

    @@ -448,7 +452,7 @@ ImageMagick 6.6.6) and unpack it as shown below:

    -

    Manipulate an Image

    +

    Manipulate an Image

    Once you create an image with, for example, method ReadImage() you may want to operate on it. Below is a list of all the image manipulations methods available to you with PerlMagick. There are examples of select PerlMagick methods. Here is an example call to an image manipulation method:

    @@ -1317,7 +1321,7 @@ fill=>color name, channel=>{All, De
    -

    Set an Image Attribute

    +

    Set an Image Attribute

    Use method Set() to set an image attribute. For example,

    @@ -1734,7 +1738,7 @@ can use the integers 1 and 0.

    -

    Get an Image Attribute

    +

    Get an Image Attribute

    Use method Get() to get an image attribute. For example,

    @@ -1986,7 +1990,7 @@ can use the integers 1 and 0.

    -

    Compare an Image to its Reconstruction

    +

    Compare an Image to its Reconstruction

    @@ -2044,7 +2048,7 @@ can use the integers 1 and 0.

    In addition to the reported root mean squared error of around 0.024, a difference image is displayed so you can visually identify the difference between the images.

    -

    Create an Image Montage

    +

    Create an Image Montage

    Use method Montage() to create a composite image 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. For example,

    @@ -2178,7 +2182,7 @@ South, SouthEast
    -

    Working with Blobs

    +

    Working with Blobs

    A blob contains data that directly represent a particular image @@ -2231,7 +2235,7 @@ blobs in any of these image formats and provid

    -

    Direct-access to Image Pixels

    +

    Direct-access to Image Pixels

    Use these methods to obtain direct access to the image pixels:

    @@ -2280,7 +2284,7 @@ blobs in any of these image formats and provid
    -

    Miscellaneous Methods

    +

    Miscellaneous Methods

    The Append() method append a set of images. For example,

    @@ -2459,7 +2463,7 @@ blobs in any of these image formats and provid
    -

    Handling Exceptions

    +

    Handling Exceptions

    All PerlMagick methods return an undefined string context upon success. If any problems occur, the error is returned as a string with an embedded numeric status code. A status code less than 400 is a warning. This means that the operation did not complete but was recoverable to some degree. A numeric code greater or equal to 400 is an error and indicates the operation failed completely. Here is how exceptions are returned for the different methods:

    @@ -2510,7 +2514,7 @@ blobs in any of these image formats and provid
    -

    Constants

    +

    Constants

    PerlMagick includes these constants:

    diff --git a/www/quantize.html b/www/quantize.html index e5d9a7681..3ae57b0e2 100644 --- a/www/quantize.html +++ b/www/quantize.html @@ -1,15 +1,15 @@ - - + + - ImageMagick: Color Reduction Utilizing Adaptive Spatial Subdivision + ImageMagick: Color Reduction Utilizing Adaptive Spatial Subdivision - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
    - Magick++ + Magick++
    @@ -116,10 +129,10 @@
    - Site Map + Site Map
    - Links + Links
    @@ -138,15 +151,6 @@ - - -
    @@ -167,13 +171,14 @@
    +

    ImageMagick Color Reduction

    [Algorithm Description • Measuring Color Reduction Error]

    This document describes how ImageMagick performs color reduction on an image. To fully understand what follows, you should have a knowledge of basic imaging techniques and the tree data structure and terminology.

    -

    Algorithm Description

    +

    Algorithm Description

    For purposes of color allocation, an image is a set of n pixels, where each pixel is a point in RGB space. RGB space is a 3-dimensional vector space, and each pixel, p(i), is defined by an ordered triple of red, green, and blue coordinates, (r(i), g(i), b(i)).

    @@ -271,7 +276,7 @@
    -

    Measuring Color Reduction Error

    +

    Measuring Color Reduction Error

    Depending on the image, the color reduction error may be obvious or invisible. Images with high spatial frequencies (such as hair or grass) will show error much less than pictures with large smoothly shaded areas (such as faces). This because the high-frequency contour edges introduced by the color reduction process are masked by the high frequencies in the image.

    diff --git a/www/resources.html b/www/resources.html index 03ee75e34..1d4b329f1 100644 --- a/www/resources.html +++ b/www/resources.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
    - Magick++ + Magick++
    @@ -127,7 +140,7 @@
    @@ -167,19 +171,19 @@
    -

    ImageMagick Resources

    +

    Customize ImageMagick With Resources

    [Configuration Files • Modules • Fonts • Environment Variables]

    ImageMagick depends on a number of external resources including configuration files, loadable modules, fonts, and environment variables.

    -

    Configuration Files

    +

    Configuration Files

    ImageMagick depends on a number of external configuration files detailed here:

    -
    +
    coder.xml
    Associate an image format with the specified coder module. @@ -192,7 +196,7 @@

    A number of command line options require a color parameter. It is often convenient to refer to a color by name (e.g. white) rather than by hex value (e.g. #fff). This file maps a color name to its equivalent red, green, blue, and alpha intensities (e.g. for white, red = 255, green = 255, blue = 255, and alpha = 0).

    -
    configure.xml
    +
    configure.xml
    Set ImageMagick build parameters and system-wide environment variables (e.g. MAGICK_TEMPORARY_PATH).

    As ImageMagick is built, a number of build parameters are saved to this configuration file. They include the version, release date, dependent delegate libraries, and quantum depth among others.

    @@ -205,10 +209,10 @@
    english.xml
    -
    Associate message tags with English translations.

    +
    Associate message tags with English translations.
    francais.xml
    -
    Associate message tags with French translations.

    +
    Associate message tags with French translations.
    locale.xml
    Associate message tags with a translation for your locale. @@ -256,9 +260,9 @@ file or data stream.

    thresholds.xml
    -
    Set threshold maps for ordered posterized dither.

    +
    Set threshold maps for ordered posterized dither.
    -
    type.xml
    +
    type.xml
    Configure fonts.

    Define the font name, family, foundry, style, format, metrics, and glyphs for any font you want to use within ImageMagick.

    @@ -322,7 +326,7 @@ file or data stream.

    -

    Modules

    +

    Modules

    ImageMagick's image format support is usually provided in the form of loadable modules. It searches for loadable modules in the following order and it uses the first match found:

    @@ -339,7 +343,7 @@ file or data stream.

    -

    Fonts

    +

    Fonts

    ImageMagick is able to load raw TrueType and Postscript font files. It searches for the font configuration file, type.xml, in the following order, and loads them if found:

    @@ -355,63 +359,62 @@ file or data stream.

    -

    Environment Variables

    +

    Environment Variables

    Environment variables recognized by ImageMagick include:

    -
    +
    HOME
    -
    Set path to search for configuration files in $HOME/.magick if the directory exists.

    +
    Set path to search for configuration files in $HOME/.magick if the directory exists.
    LD_LIBRARY_PATH
    -
    Set path to the ImageMagick shareable libraries and other dependent libraries.

    +
    Set path to the ImageMagick shareable libraries and other dependent libraries.
    MAGICK_AREA_LIMIT
    -
    Set the maximum width * height of an image that can reside in the pixel cache memory.

    -
    Images that exceed the area limit are cached to disk (see MAGICK_DISK_LIMIT).

    +
    Set the maximum width * height of an image that can reside in the pixel cache memory.
    +
    Images that exceed the area limit are cached to disk (see MAGICK_DISK_LIMIT).
    MAGICK_CODER_FILTER_PATH
    -
    Set search path to use when searching for filter process modules (invoked via -process).

    -
    This path permits the user to extend ImageMagick's image processing functionality by adding loadable modules to a preferred location rather than copying them into the ImageMagick installation directory. The formatting of the search path is similar to operating system search paths (i.e. colon delimited for Unix, and semi-colon delimited for Microsoft Windows). This user specified search path is searched before trying the default search path.

    +
    Set search path to use when searching for filter process modules (invoked via -process).
    +
    This path permits the user to extend ImageMagick's image processing functionality by adding loadable modules to a preferred location rather than copying them into the ImageMagick installation directory. The formatting of the search path is similar to operating system search paths (i.e. colon delimited for Unix, and semi-colon delimited for Microsoft Windows). This user specified search path is searched before trying the default search path.
    MAGICK_CODER_MODULE_PATH
    -
    Set path where ImageMagick can locate its coder modules.

    -
    This path permits the user to arbitrarily extend the image formats supported by ImageMagick by adding loadable coder modules from an preferred location rather than copying them into the ImageMagick installation directory. The formatting of the search path is similar to operating system search paths (i.e. colon delimited for Unix, and semi-colon delimited for Microsoft Windows). This user specified search path is searched before trying the default search path.

    +
    Set path where ImageMagick can locate its coder modules.
    +
    This path permits the user to arbitrarily extend the image formats supported by ImageMagick by adding loadable coder modules from an preferred location rather than copying them into the ImageMagick installation directory. The formatting of the search path is similar to operating system search paths (i.e. colon delimited for Unix, and semi-colon delimited for Microsoft Windows). This user specified search path is searched before trying the default search path.
    MAGICK_CONFIGURE_PATH
    -
    Set path where ImageMagick can locate its configuration files

    -
    Use this search path to search for configuration (.xml) files. The formatting of the search path is similar to operating system search paths (i.e. colon delimited for Unix, and semi-colon delimited for Microsoft Windows). This user specified search path is searched before trying the default search path.

    +
    Set path where ImageMagick can locate its configuration files
    +
    Use this search path to search for configuration (.xml) files. The formatting of the search path is similar to operating system search paths (i.e. colon delimited for Unix, and semi-colon delimited for Microsoft Windows). This user specified search path is searched before trying the default search path.
    MAGICK_DEBUG
    -
    Set debug options.

    -
    See -debug for a description of debugging options.

    -
    MAGICK_DISK_LIMIT
    -
    Set maximum amount of disk space in bytes permitted for use by the pixel cache.

    -
    When this limit is exceeded, the pixel cache is not be created and an error message is returned.

    +
    Set debug options.
    +
    See -debug for a description of debugging options.
    +
    MAGICK_DISK_LIMIT
    +
    Set maximum amount of disk space in bytes permitted for use by the pixel cache.
    +
    When this limit is exceeded, the pixel cache is not be created and an error message is returned.
    MAGICK_FILE_LIMIT
    -
    Set maximum number of open pixel cache files.

    -
    When this limit is exceeded, any subsequent pixels cached to disk are closed and reopened on demand. This behavior permits a large number of images to be accessed simultaneously on disk, but with a speed penalty due to repeated open/close calls.

    +
    Set maximum number of open pixel cache files.
    +
    When this limit is exceeded, any subsequent pixels cached to disk are closed and reopened on demand. This behavior permits a large number of images to be accessed simultaneously on disk, but with a speed penalty due to repeated open/close calls.
    MAGICK_FONT_PATH
    -
    Set path ImageMagick searches for TrueType and Postscript Type1 font files.

    -
    This path is only consulted if a particular font file is not found in the current directory.

    +
    Set path ImageMagick searches for TrueType and Postscript Type1 font files.
    +
    This path is only consulted if a particular font file is not found in the current directory.
    MAGICK_HOME
    -
    Set the path at the top of ImageMagick installation directory.

    -
    This path is consulted by uninstalled builds of ImageMagick which do not have their location hard-coded or set by an installer.

    -
    MAGICK_MAP_LIMIT
    -
    Set maximum amount of memory map in bytes to allocate for the pixel cache.

    +
    Set the path at the top of ImageMagick installation directory.
    +
    This path is consulted by uninstalled builds of ImageMagick which do not have their location hard-coded or set by an installer.
    +
    MAGICK_MAP_LIMIT
    +
    Set maximum amount of memory map in bytes to allocate for the pixel cache.
    When this limit is exceeded, the image pixels are cached to disk (see MAGICK_DISK_LIMIT).
    -
    MAGICK_MEMORY_LIMIT
    -
    Set maximum amount of memory in bytes to allocate for the pixel cache from the heap.

    -
    When this limit is exceeded, the image pixels are cached to memory-mapped disk (see MAGICK_MAP_LIMIT).

    +
    Set maximum amount of memory in bytes to allocate for the pixel cache from the heap.
    +
    When this limit is exceeded, the image pixels are cached to memory-mapped disk (see MAGICK_MAP_LIMIT).
    MAGICK_PRECISION
    -
    Set the maximum number of significant digits to be printed.

    +
    Set the maximum number of significant digits to be printed.
    MAGICK_SYNCHRONIZE
    -
    Set to true to synchronize image to storage device.

    +
    Set to true to synchronize image to storage device.
    MAGICK_TEMPORARY_PATH
    -
    Set path to store temporary files.

    +
    Set path to store temporary files.
    MAGICK_THREAD_LIMIT
    -
    Set maximum parallel threads.

    -
    Many ImageMagick algorithms run in parallel on multi-processor systems. Use this enviroment variable to set the maximum number of threads that are permitted to run in parallel.

    +
    Set maximum parallel threads.
    +
    Many ImageMagick algorithms run in parallel on multi-processor systems. Use this enviroment variable to set the maximum number of threads that are permitted to run in parallel.
    MAGICK_THROTTLE
    -
    Periodically yield the CPU for at least the time specified in milliseconds.

    +
    Periodically yield the CPU for at least the time specified in milliseconds.
    MAGICK_TIME_LIMIT
    -
    Set maximum time in seconds.

    +
    Set maximum time in seconds.
    When this limit is exceeded, an exception is thrown and processing stops.
    diff --git a/www/search.html b/www/search.html index 55e85d69f..9e8f6b0cc 100644 --- a/www/search.html +++ b/www/search.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
    - Magick++ + Magick++
    @@ -127,7 +140,7 @@
    @@ -159,7 +163,7 @@

    ImageMagick Search

    -
    +
    Be right with you...
    @@ -173,6 +177,7 @@ customSearchControl.draw('cse', options); }, true); +
    diff --git a/www/sitemap.html b/www/sitemap.html index bce94349e..52f83ee6d 100644 --- a/www/sitemap.html +++ b/www/sitemap.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
    - Magick++ + Magick++
    @@ -127,7 +140,7 @@
    @@ -170,12 +174,14 @@

    ImageMagick Site Map

    [ImageMagick Overview • Download ImageMagick • Install ImageMagick • Command-line Tools • Program Interfaces • Image Formats • Getting Help • Support ImageMagick • Miscellaneous Topics]

    -

    Use this ImageMagick sitemap to quickly jump to one of the areas of interest listed below. If you can't find what you want on this page, try our site search.

    +
    -
    -

    ImageMagick Overview

    +

    Use this ImageMagick sitemap to quickly jump to one of the areas of interest listed below. If you can't find what you want on this page, try our site search.

    +

    ImageMagick Overview

    +
    +
    Introduction: convert, edit, or compose images from the command-line or program interface.
    Examples of ImageMagick usage: a few examples that show what you can do with an image using ImageMagick.
    @@ -186,11 +192,11 @@
    License: the legally binding and authoritative terms and conditions for use, reproduction, and distribution of ImageMagick.
    Export classification: export control status of ImageMagick.
    - -
    -

    Download ImageMagick

    +

    Download ImageMagick

    +
    +
    Download ImageMagick: ImageMagick source and binary distributions are available from a variety of FTP and Web mirrors.
      @@ -202,24 +208,21 @@
      Delegate libraries: ImageMagick depends on a number of optional delegate libraries to extend its functionality.
    - -
    -

    Install ImageMagick

    +

    Install ImageMagick

    +
    + +

    You can install ImageMagick from source. However, if don't have a proper development environment or if you're anxious to get started, download a ready-to-run Unix or Windows executable.

    -
    You can install ImageMagick from source. However, if don't have a proper development environment or if you're anxious to get started, download a ready-to-run Unix or Windows executable.
    -
    - -
    -

    Command-line Tools

    +

    Command-line Tools

    +
    Command-line tools: overview of the ImageMagick commands.
      @@ -240,15 +243,15 @@
      Fx: apply a mathematical expression to an image or image channels.
      Fred's ImageMagick Scripts: a plethora of command-line scripts that perform geometric transforms, blurs, sharpens, edging, noise removal, and color manipulations.
    - -
    -

    Program Interfaces

    +

    Program Interfaces

    +
    +
    Program interfaces: application programming interfaces.
      -
      ChMagick: is a Ch an embeddable MagickCore C/C++ interpreter for cross-platform scripting.
      +
      ChMagick: is a Ch an embeddable MagickCore C/C++ interpreter for cross-platform scripting.
      CL-Magick: provides a Common Lisp interface to the ImageMagick library.
      G2F: implements an Ada 95 binding to a subset of the low-level MagickCore library.
      Magick++: provides an object-oriented C++ interface to ImageMagick.
      @@ -265,10 +268,10 @@
      TclMagick: a native Tcl-extension to the ImageMagick MagickWand API.
    - -
    -

    Image Formats

    + +

    Image Formats

    +
    Supported image formats: annotated list of all image formats that ImageMagick can read and/or write.
    Motion picture digital images: use SMPTE DPX Version 2.0 to process images used by the motion picture (film and high-definition) industry.
    @@ -276,32 +279,32 @@
    Magick Vector Graphics: a modularized language for describing two-dimensional vector and mixed vector/raster graphics in ImageMagick.
    Magick Image File Format: MIFF is ImageMagick's own platform-independent format for storing bitmap images.
    - -
    -

    Getting Help

    +

    Getting Help

    +
    +
    Definitive Guide to ImageMagick: this book explains ImageMagick in a practical, learn-by-example fashion.
    ImageMagick Tricks: this book is packed with examples of photo manipulations, logo creation, animations, and complete web projects.
    Discourse server: get help from fellow ImageMagick users and developers, post to these forums.
    Contact the Wizards: for bug reports (only if you do not want to sign up to the discourse server), a source or documentation patch, a security or license issue, or if you want to be a sponsor of the ImageMagick project.
    - -
    -

    Support ImageMagick

    +

    Support ImageMagick

    +
    +
    Report bugs and vulnerabilities: our highest priority is to fix security defects and bug reports, usually within 48 hours of your report. The bug discourse server requires that you register. If you do not want to register, you can contact the ImageMagick developers with a convenient web form.
    Sponsor ImageMagick: contribute bug fixes, enhancements, hardware, funds, etc. to ensure the ImageMagick project thrives.
    ImageMagick t-shirt: donate $25 USD and we acknowledge your gift with a logoed t-shirt.
    - -
    -

    Miscellaneous Topics

    +

    Miscellaneous Topics

    +
    +
    Format conversion: convert an image from one format to another (e.g. PNG to JPEG).
    Transform: resize, rotate, crop, fddp or trim an image.
    @@ -327,6 +330,7 @@
    Heterogeneous distributed processing: certain algorithms are OpenCL-enabled to take advantage of speed-ups offered by executing in concert across heterogeneous platforms consisting of CPUs, GPUs, and other processors.
    ImageMagick on the iPhone: convert, edit, or compose images on your iPhone.
    +
    diff --git a/www/sponsors.html b/www/sponsors.html index cb8ebbe67..8255be274 100644 --- a/www/sponsors.html +++ b/www/sponsors.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
    - Magick++ + Magick++
    @@ -127,7 +140,7 @@
    @@ -168,32 +172,29 @@

    ImageMagick Sponsors

    -

    [ImageMagick Sponsors • Support the ImageMagick Project]

    +

    [Active ImageMagick Sponsors • Support the ImageMagick Project]

    - + +

    Active ImageMagick Sponsors

    We want to thank the sponsors of the ImageMagick project, including:

    -
    -

    Support the ImageMagick Project

    +

    Support the ImageMagick Project

    ImageMagick has been available to both free and commercial users since the early 1990's. In early 1993 it was one of the most comprehensive free image processing packages available, but, unlike competing packages, it continues to be supported and enhanced. Today, ImageMagick is more comprehensive and better supported than ever.

    diff --git a/www/stream.html b/www/stream.html index ef1ab104c..d64abba0b 100644 --- a/www/stream.html +++ b/www/stream.html @@ -1,7 +1,7 @@ - - + + @@ -10,7 +10,7 @@ - + @@ -22,12 +22,25 @@ - + + + + + @@ -90,7 +103,7 @@ PerlMagick
    - Magick++ + Magick++
    @@ -128,7 +141,7 @@
    @@ -168,14 +172,14 @@
    -

    ImageMagick Stream Command-line Utility

    +

    ImageMagick Stream Command-line Tool

    [Example Usage • Option Summary]

    Stream is a lightweight tool to stream one or more pixel components of the image or portion of the image to your choice of storage formats. It writes the pixel components as they are read from the input image a row at a time making stream desirable when working with large images or when you require raw pixel components.

    -

    Example Usage

    +

    Example Usage

    We list a few examples of the stream command here to illustrate its usefulness and ease of use. To get started, lets stream the red, green, blue components of a 640x480 JPEG image to disk as unsigned characters:

    @@ -189,7 +193,7 @@

    $magick> stream -map i -storage-type double 'image.tif[100x100+30+40]' gray.raw

    -

    Option Summary

    +

    Option Summary

    The stream command recognizes these options. Click on an option to get more details about how that option works.

    diff --git a/www/subversion.html b/www/subversion.html index f8335f6dd..dec43133d 100644 --- a/www/subversion.html +++ b/www/subversion.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
    - Magick++ + Magick++
    @@ -127,7 +140,7 @@
    @@ -169,7 +173,7 @@

    ImageMagick Subversion Repository

    -

    +

    The ImageMagick stable and development source releases are available from Subversion. This a convenient way for developers to download the ImageMagick source, fix bugs, or add new features.

    @@ -185,6 +189,7 @@ ImageMagick-6.6.6

    $magick> svn update

    and only the files which have changed are updated.

    +
    diff --git a/www/t-shirt.html b/www/t-shirt.html index 74ac0e991..f730ca519 100644 --- a/www/t-shirt.html +++ b/www/t-shirt.html @@ -1,6 +1,6 @@ - - + + @@ -9,7 +9,7 @@ - + @@ -21,12 +21,25 @@ - + + + + + @@ -89,7 +102,7 @@ PerlMagick
    - Magick++ + Magick++
    @@ -127,7 +140,7 @@
    -- 2.50.0
    Tag