This page provides information specific to GraphicsMagick installed via a "setup.exe" style installation wizard under Microsoft Windows. It applies only to the pre-built "binaries" package, and not to versions compiled from source code. If you would like to install GraphicsMagick from source code, then please refer to the GraphicsMagick installation guide for Windows .

>Normal Installation

Prerequisites

While multiple versions of GraphicsMagick may be installed at one time, if your intention is to replace a prior installation of GraphicsMagick with a newer version, then it may be wise to uninstall the existing GraphicsMagick (see uninstall procedure) prior to installing the newer version.

While it is not a requirement, it is strongly recommended that the Ghostscript package (GraphicsMagick is tested with version 8.50) be installed. GraphicsMagick uses Ghostscript to render Postscript and PDF files, as well as formats where a translator to Postscript is available. GraphicsMagick will also use the fonts delivered with Ghostscript to support the standard set of Adobe Postscript fonts like "Helvetica" and "Times Roman" if these fonts are not available as TrueType fonts.

The installation package includes the GraphicsMagick Perl extension ( PerlMagick) as an installation option. If you would like to use this extension, then you must install ActiveState ActivePerl prior to commencing with installation of GraphicsMagick.

Retrieve Install Package

Retrieve the GraphicsMagick Windows binary install package from a one of the ftp sites listed at the GraphicsMagick Download Sites page. The available install packages are as follows

Windows Dynamic-Multithread (DLL-based) install package with utilities, PerlMagick, ImageMagickObject COM object, API headers, DLLs, link libraries, and web pages.

    GraphicsMagick-1.1.8-Q8-windows-dll.exe
    GraphicsMagick-1.1.8-Q16-windows-dll.exe

Windows Static-Multithread package including the utilities (gm.exe, gmdisplay.exe, and MagickCMD.exe), the ImageMagickObject COM object, and the GraphicsMagick web pages. This package does not include PerlMagick.

    GraphicsMagick-1.1.8-Q8-windows-static.exe
    GraphicsMagick-1.1.8-Q16-windows-static.exe

Note that the QuantumDepth=8 version (Q8) which provides industry standard 24/32 bit pixels consumes half the memory and about 30% less CPU than the QuantumDepth=16 version (Q16) which provides 48/64 bit pixels for high-resolution color. A Q8 version is fine for processing typical photos. If you are dealing with film, scientific, or medical images or deal with images that have limited contrast, then the Q16 version is recommended. It is also possible to build a Q32 version which has enough resolution to deal with the latest reconnaissance images. Please let us know if there is any demand for the Q32 versions.

Start Installation Wizard

Execute the downloaded file from your browser or by double-clicking on the filename from within Windows Explorer. The GraphicsMagick Setup Wizard will appear. Click on “Next>” to continue.

Read Installation Information

An informational screen is presented which provides a summary of things you should know before you proceed. Please take care to read this information. Once you have finished, Click on “Next>” to continue.

Select Destination Directory

Specify what drive and directory to install GraphicsMagick into. Approximately 15MB of free disk space is required to install all of GraphicsMagick (you may choose to install a subset to save space). A message at the bottom of the screen will tell you exactly how much space is required to install the complete package. The default installation directory is similar to “C:\Program Files\GraphicsMagick-1.1.8-Q8”. Once you have entered the desired installation directory, then select “Next>” to continue.

Select Start Menu Folder

Select the folder where you would like the program's shortcuts to appear. The default should normally be satisfactory. Click on “Next>” to continue.

Select Additional Tasks

A screen is displayed which presents most (or all) of the following options:

"Creating a desktop icon" and "Update the executable search path" are selected by default. The remaining options default to un-selected. Select the options you prefer. Note that ActiveState Perl packages are intended to be binary compatible across a build series (i.e. 800 series builds should be binary compatible).

Think twice before selecting "Associate supported file extensions with GraphicsMagick" since this will set up approximately fifty file associations, including common formats like JPEG, GIF, PNG, TIFF, and PDF. These file associations will be to the 'gmdisplay' program which is suitable for displaying images, but currently offers little more than that. Windows XP seems to handle the file associations pretty well, allowing you to choose from a list of programs, but older systems like Windows NT 4.0 and Windows '98 only support a single association per format, which can be quite annoying. Associations for GraphicsMagick's native formats (such as MIFF) will always be made.

Once you have made your selections, click on “Next>” to continue.

Ready to Install

A screen is displayed which displays the selected options. If you are not satisfied with a selected option, then click on “<Back” to go backsing, software development, simulation, image, software, AniMagick, Animagic, Magick++">

> GraphicsMagick Utilities

GraphicsMagick provides a powerful command line utility which may be used to access all GraphicsMagick functions. Gm uses a consistent set of options (see options documentation). GraphicsMagick provides access to major command modes via a single executable command-line program called 'gm'; for example, to use the "convert" mode, type "gm convert ...". The available command modes and links to their documentation are shown in the following table:

GM Command Mode

Description

gm animate

animate a sequence of images

gm composite

composite images together

gm conjure

execute a Magick Scripting Language (MSL) XML script

gm convert

convert an image or sequence of images

gm display

display an image on a workstation running X

gm identify

describe an image or image sequence

gm import

capture an application or X server screen

gm mogrify

transform an image or sequence of images

gm montage

create a composite image (in a grid) from separate images

The gm utility makes it easy to perform complex image processing operations using a single command. It may be invoked from scripts, or from other programs in order to automate the processing of thousands of images.

Copyright © GraphicsMagick Group 2002, 2003, 2004

./usr/share/doc/graphicsmagick/www/windows.html0000644000000000000000000006677311262474110020572 0ustar rootroot GraphicsMagick For Windows
This page provides information specific to GraphicsMagick installed via a "setup.exe" style installation wizard under Microsoft Windows. It applies only to the pre-built "binaries" package, and not to versions compiled from source code. If you would like to install GraphicsMagick from source code, then please refer to the GraphicsMagick installation guide for Windows .

>Normal Installation

Prerequisites

While multiple versions of GraphicsMagick may be installed at one time, if your intention is to replace a prior installation of GraphicsMagick with a newer version, then it may be wise to uninstall the existing GraphicsMagick (see uninstall procedure) prior to installing the newer version.

While it is not a requirement, it is strongly recommended that the Ghostscript package (GraphicsMagick is tested with version 8.50) be installed. GraphicsMagick uses Ghostscript to render Postscript and PDF files, as well as formats where a translator to Postscript is available. GraphicsMagick will also use the fonts delivered with Ghostscript to support the standard set of Adobe Postscript fonts like "Helvetica" and "Times Roman" if these fonts are not available as TrueType fonts.

The installation package includes the GraphicsMagick Perl extension ( PerlMagick) as an installation option. If you would like to use this extension, then you must install ActiveState ActivePerl prior to commencing with installation of GraphicsMagick.

Retrieve Install Package

Retrieve the GraphicsMagick Windows binary install package from a one of the ftp sites listed at the GraphicsMagick Download Sites page. The available install packages are as follows

Windows Dynamic-Multithread (DLL-based) install package with utilities, PerlMagick, ImageMagickObject COM object, API headers, DLLs, link libraries, and web pages.

    GraphicsMagick-1.1.8-Q8-windows-dll.exe
    GraphicsMagick-1.1.8-Q16-windows-dll.exe

Windows Static-Multithread package including the utilities (gm.exe, gmdisplay.exe, and MagickCMD.exe), the ImageMagickObject COM object, and the GraphicsMagick web pages. This package does not include PerlMagick.

    GraphicsMagick-1.1.8-Q8-windows-static.exe
    GraphicsMagick-1.1.8-Q16-windows-static.exe

Note that the QuantumDepth=8 version (Q8) which provides industry standard 24/32 bit pixels consumes half the memory and about 30% less CPU than the QuantumDepth=16 version (Q16) which provides 48/64 bit pixels for high-resolution color. A Q8 version is fine for processing typical photos. If you are dealing with film, scientific, or medical images or deal with images that have limited contrast, then the Q16 version is recommended. It is also possible to build a Q32 version which has enough resolution to deal with the latest reconnaissance images. Please let us know if there is any demand for the Q32 versions.

Start Installation Wizard

Execute the downloaded file from your browser or by double-clicking on the filename from within Windows Explorer. The GraphicsMagick Setup Wizard will appear. Click on “Next>” to continue.

Read Installation Information

An informational screen is presented which provides a summary of things you should know before you proceed. Please take care to read this information. Once you have finished, Click on “Next>” to continue.

Select Destination Directory

Specify what drive and directory to install GraphicsMagick into. Approximately 15MB of free disk space is required to install all of GraphicsMagick (you may choose to install a subset to save space). A message at the bottom of the screen will tell you exactly how much space is required to install the complete package. The default installation directory is similar to “C:\Program Files\GraphicsMagick-1.1.8-Q8”. Once you have entered the desired installation directory, then select “Next>” to continue.

Select Start Menu Folder

Select the folder where you would like the program's shortcuts to appear. The default should normally be satisfactory. Click on “Next>” to continue.

Select Additional Tasks

A screen is displayed which presents most (or all) of the following options:

"Creating a desktop icon" and "Update the executable search path" are selected by default. The remaining options default to un-selected. Select the options you prefer. Note that ActiveState Perl packages are intended to be binary compatible across a build series (i.e. 800 series builds should be binary compatible).

Think twice before selecting "Associate supported file extensions with GraphicsMagick" since this will set up approximately fifty file associations, including common formats like JPEG, GIF, PNG, TIFF, and PDF. These file associations will be to the 'gmdisplay' program which is suitable for displaying images, but currently offers little more than that. Windows XP seems to handle the file associations pretty well, allowing you to choose from a list of programs, but older systems like Windows NT 4.0 and Windows '98 only support a single association per format, which can be quite annoying. Associations for GraphicsMagick's native formats (such as MIFF) will always be made.

Once you have made your selections, click on “Next>” to continue.

Ready to Install

A screen is displayed which displays the selected options. If you are not satisfied with a selected option, then click on “<Back” to go backsing, software development, simulation, image, software, AniMagick, Animagic, Magick++">

> GraphicsMagick Utilities

GraphicsMagick provides a powerful command line utility which may be used to access all GraphicsMagick functions. Gm uses a consistent set of options (see options documentation). GraphicsMagick provides access to major command modes via a single executable command-line program called 'gm'; for example, to use the "convert" mode, type "gm convert ...". The available command modes and links to their documentation are shown in the following table:

GM Command Mode

Description

gm animate

animate a sequence of images

gm composite