1E ' ImageMagick For WindowsB 2 2 2 n V  D





<8 a

=
This page provides informationCspecific to ImageMagick installed via a "setup.exe" styleCinstallation wizard under Microsoft Windows. It applies only to theDpre-built "binaries" package, and not to versions compiled?from source code. If you would like to install ImageMagick fromHsource code, then please refer to the ImageMagickinstallation guide .
7  #  

>Normal% Installation


&

Prerequisites

@

While multiple versions of ImageMagick may be>installed at one time, if your intention is to replace a priorEinstallation of ImageMagick with a newer version, then it may be wiseEto uninstall the existing ImageMagick (see uninstall procedure) prior9to installing the newer version.

While it is not airequirement, it is strongly recommended that the Ghostscript<package be installed. ImageMagick uses Ghostscript to renderBPostscript and PDF files, as well as formats where a translator to<Postscript is available. ImageMagick will also use the fontsDdelivered with Ghostscript to support the standard set of PostscriptEfonts.

The installation package includes the ImageMagick PerlBextension ( PerlMagick) as an installation>option. If you would like to use this extension, then you mustZinstall ActiveStateEActivePerl prior to commencing with installation of ImageMagick. 

1

Retrieve Install Package

B

Retrieve the ImageMagick Windows binary installUpackage from a one of the ftp sites listed at the ImageMagick:Download Sites page. The file will be named similar toEImageMagick-i686-pc-windows.exe and should be found in the 'binaries'subdirectory of the ftp site. 

.

Start Installation Wizard 

C

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

5

Select Destination Directory

>

Specify what drive and directory to installCImageMagick into. Approximately 13MB of free disk space is requiredEto install ImageMagick. The default installation directory is similarAto “C:\Program Files\ImageMagick-5.4.8-Q16”. Once youShave entered the desired installation directory, then select “Next>” to continue. 

1

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. 

0

Select Additional Tasks

E

A screen is displayed which provides the option toEcreate a desktop shortcut icon to the imdisplay program and to updateCthe executable search path so that ImageMagick is available withoutBspecifying the full path to the programs. The default is to enableRboth of these. Once you have made your selections, click on “Next>” to continue. 

)

Ready to Install

D

A screen is displayed which displays the selectedDoptions. If you are not satisfied with a selected option, then clickEon “<Back” to go back to a previous screen so that theEoption may be adjusted. If you are satisfied with the options and areAready to install, then select “Install”. To abort the4installation entirely, select “Cancel”. 

.

Installation Progress

>

While the install program is performing theAinstallation, it will display what it is doing in an installationprogress window. 

%

Finishing Up

D

By default “View ImageMagick.html” isCcheck-marked. This causes the ImageMagick web pages to be displayedAin a browser when “Finish” is selected. If you do not6want to view the web pages, then de-select “View@ImageMagick.html”. Select “Finish” to exit theCinstallation program.
Under Windows '95 and Windows '98 it willDbe necessary to reboot the system in order for some settings to take>effect (such as executable search path) since these are set inautoexec.bat. 

1

Testing The Installation

?

Select “Command Prompt” from the.Windows Start menu. Within the window type

O

convert1logo: logo.miff
imdisplay logo.miff

D

and the ImageMagick logo should be displayed in a window.

7  #  

>. Advanced Installation


2




n

[ The following is transcribed from the Inno@Setup documentation. Inno Setup is used to create the binaryDinstall package. This information may be of value if the ImageMagickBinstallation must be automated (e.g. If it is installed as part ofanother package). ]

B

The Setup program accepts optional command line@parameters. These can be useful to system administrators, and to*other programs calling the Setup program. 


G
/SP
-
FDisables the "This will install... Do you wish to continue?"Eprompt at the beginning of Setup. Of course, this will have no effectif the DisableStartupPrompt [Setup] section directive was set to yes.


D
 /SILENT, /VERYSILENT
-
EInstructs Setup to be silent or very silent. When Setup is silent the:wizard and the background window are not displayed but theAinstallation progress window is. When a setup is very silent thisAinstallation progress window is not displayed. Everything else is<normal so for example error messages during installation areDdisplayed and the startup prompt is (if you haven't disabled it with@DisableStartupPrompt or the '/SP-' command line option explainedabove) 2
AIf a restart is necessary and the '/NORESTART' command isn't used>(see below) and Setup is silent, it will display a Reboot now?messagebox. If it's very silent it will reboot without asking.


D
/NORESTART
-
}Instructs Setup not to reboot even if it's necessary.


D
 /LOADINF="filename"
-
BInstructs Setup to load the settings from the specified file afterDhaving checked the command line. This file can be prepared using theE'/SAVEINF=' command as explained below. Don't forget to use quotes ifethe filename contains spaces.


D
 /SAVEINF="filename"
-
DInstructs Setup to save installation settings to the specified file.Don't forget to use quotes if the filename contains spaces.


D
 /DIR=“x:\dirname”
-
<Overrides the default directory name displayed on the SelectEDestination Directory wizard page. A fully qualified pathname must beEspecified. If the [Setup] section directive DisableDirPage was set totyes, this command line parameter is ignored.


D
/GROUP="folder name"
-
DOverrides the default folder name displayed on the Select Start Menu4Folder wizard page. If the [Setup] section directiveCDisableProgramGroupPage was set to yes, this command line parameter is ignored. H


D
/NOICONS
-
EInstructs Setup to initially disable the Don't create any icons check1box on the Select Start Menu Folder wizard page. H


D
A /COMPONENTS="comma separated list of component names"
C
BOverrides the default components settings. Using this command line>parameter causes Setup to automatically select a custom type. 
7  #  

>Uninstall


2




?

The ImageMagick package incorporates its ownCuninstall functionality. Always remove an installed ImageMagick via=its uninstall function since manually removing it (such as byCremoving its installation directory) will leave behind the registry:entries and path settings established at install time.

=

Under Windows '95 and Windows '95, use the?“Uninstall” entry in the ImageMagick portion of the1Windows start menu to initiate the uninstall.

@

On NT 4.0 and 5.X -based systems, ImageMagickCshould be removed via the “Add or Remove Programs” areaEof the Windows Control Panel. Select the ImageMagick package from theClist, and click on “Change/Remove” to uninstall it.

7  #  

>Use8 From Another Package or Program


2




D

The ImageMagick utilities (e.g. convert, mogrify,Ccomposite, ...) may be executed as a sub-process by other programs.DIf the utilities are not in the systems executable search path (theyCshould be since the ImageMagick install extends the path), then theCutility should be executed via the complete path to the executable.LNote that systems other than Windows '9X provide a “convert.exe”<as part of the operating system. Care must be taken to avoid=executing the wrong “convert.exe” by mistake.

D

A package which is linked against the ImageMagickBcore DLLs may use the DLLs from an installed ImageMagick, providedEthat the ImageMagick release versions are identical, and the value ofBQuantumDepth matches the value used when building the package. OneDway to ensure this is to include a matching ImageMagick installation(package along with your own package.

E

In order to facilitate building C and C++ programs@that use ImageMagick without requiring building ImageMagick fromBsource code, the header files and link libraries required to buildCprograms using Visual C++ 6.0 are provided in “include”;and “lib” subdirectories under the installationDdirectory. Using these headers and libraries to build your dependentAapplication ensures that they will be compatible with the release DLLs.

C

Note that the DLLs and libraries are built usingCVisual C++ 6.0. It is not known how well they will work with VisualCC++ .NET. While it should be possible to use the MinGW gcc compiler=with the CORE_RL_magick_.dll (ImageMagick C library), it will>certainly not be possible to use it with CORE_RL_Magick++_.dll?(ImageMagick C++ library) due to name mangling differences.

>

The following project build options (changeB“C:\ImageMagick” to whever you have chosen to install)=should ensure compatibility with the headers and libraries asdelivered:

6   " "   " "   " "   " "   " "  
e

Key$ Name


e

Key$ Type


F

Proprocessor Definitions


u

NDEBUG,WIN32,_CONSOLE,_VISUALC_,NeedFunctionPrototypes,_DLL,_MAGICKMOD_


A

Compilation Options


O

/nologo /MD /W3 /GX /Zi /O2 /I "."B /I "C:\\ImageMagick\include" /D "NDEBUG" /DE "WIN32" /D "_CONSOLE" /D "_VISUALC_"? /D "NeedFunctionPrototypes" /D "_DLL" /D) "_MAGICKMOD_" /FD /c 


<

Linker Options


6

CORE_RL_magick_.libB CORE_RL_Magick++_.lib X11.lib kernel32.lib user32.lib gdi32.lib; odbc32.lib odbccp32.lib ole32.lib oleaut32.lib winmm.libA dxguid.lib wsock32.lib advapi32.lib /nologo /subsystem:console' /incremental:no /debug /machine:I3863 /libpath:"C:\ImageMagick\lib\" 


>

Resource Options


I

/l 0x409 /d "NDEBUG" 


C

When ImageMagick is installed, entries are addedEto the Windows Registry so that other programs may obtain informationDregarding the most recently installed ImageMagick. These entries are"available under the registry path 

HKEY_LOCAL_MACHINE\SOFTWARE\ImageMagick\Current

:

These keys are currently available:

6    " " "   " " "   " " "   " " "   " " "   " " "   " " "  
e

Key$ Name


e

Key$ Type



Description


5

BinPath


4

REG_SZ


>

Directory where ImageMagick' executables are installed


;

ConfigurePath


4

REG_SZ


@

Directory where configuration! files are installed


5

LibPath


4

REG_SZ


C

Directory where ImageMagick core DLLs are installed


9

ModulesPath


4

REG_SZ


>

Directory where ImageMagick, loadable modules are installed


:

QuantumDepth


7

REG_DWORD


E

Number of bits in a pixel quantum.= A pixel quantum is used to store part of a color (e.g. red component)


5

Version


4

REG_SZ


A

ImageMagick version


@

In addition to registry entries which provideDinformation on the most recently installed ImageMagick (which is not?necessarily the newest version installed), registry entries areBavailable for specific versions of installed ImageMagick packages.AThese registry entries are available under a registry path of the form:

HKEY_LOCAL_MACHINE\SOFTWARE\ImageMagick\VERSION\Q:DEPTH

C

where VERSION represents the ImageMagick versionCand DEPTH (which may have the values 8 or 16) represents the number>of bits per pixel quantum. Packages which require a particularDversion of ImageMagick built with a specific QuantumDepth may find a5matching installation via these registry entries.

:

These keys are currently available:

6    " " "   " " "   " " "   " " "   " " "   " " "  
Z

Key Name


Z

Key Type


]

Description


5

BinPath


4

REG_SZ


>

Directory where ImageMagick' executables are installed


;

ConfigurePath


4

REG_SZ


@

Directory where configuration! files are installed


5

LibPath


4

REG_SZ


C

Directory where ImageMagick core DLLs are installed


9

ModulesPath


4

REG_SZ


>

Directory where ImageMagick, loadable modules are installed


7

SharePath


4

REG_SZ


@

Directory where configuration! files are installed


2





>

9Image manipulation software that works like magic.