diff options
Diffstat (limited to 'www/INSTALL-windows.html')
| -rw-r--r-- | www/INSTALL-windows.html | 505 |
1 files changed, 266 insertions, 239 deletions
diff --git a/www/INSTALL-windows.html b/www/INSTALL-windows.html index 3453b15..291a07e 100644 --- a/www/INSTALL-windows.html +++ b/www/INSTALL-windows.html @@ -1,12 +1,14 @@ -<?xml version="1.0" encoding="utf-8" ?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<!DOCTYPE html> +<html lang="en"> <head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> -<meta name="generator" content="Docutils 0.16: http://docutils.sourceforge.net/" /> -<title>GraphicsMagick Windows Installation</title> -<link rel="stylesheet" href="docutils-articles.css" type="text/css" /> + <meta charset="utf-8"> + <meta content="en" name="language"> + <title>GraphicsMagick Windows Installation</title> + <meta name="viewport" content="width=device-width, initial-scale=1.0"> + <link media="screen" href="docutils-articles.css" type="text/css" rel="stylesheet"> + </head> + <body> <div class="banner"> @@ -19,6 +21,7 @@ </form> </div> + <div class="navmenu"> <ul> <li><a href="index.html">Home</a></li> @@ -32,37 +35,39 @@ <li><a href="reference.html">Reference</a></li> </ul> </div> + <div class="document" id="graphicsmagick-windows-installation"> <h1 class="title">GraphicsMagick Windows Installation</h1> - <!-- -*- mode: rst -*- --> <!-- This text is in reStucturedText format, so it may look a bit odd. --> <!-- See http://docutils.sourceforge.net/rst.html for details. --> <div class="contents local topic" id="contents"> <ul class="simple"> -<li><a class="reference internal" href="#installing-using-installer-package" id="id1">Installing Using Installer Package</a><ul> -<li><a class="reference internal" href="#prerequisites" id="id2">Prerequisites</a></li> -<li><a class="reference internal" href="#retrieve-install-package" id="id3">Retrieve Install Package</a></li> -<li><a class="reference internal" href="#start-installation-wizard" id="id4">Start Installation Wizard</a></li> -<li><a class="reference internal" href="#read-installation-information" id="id5">Read Installation Information</a></li> -<li><a class="reference internal" href="#select-destination-directory" id="id6">Select Destination Directory</a></li> -<li><a class="reference internal" href="#select-start-menu-folder" id="id7">Select Start Menu Folder</a></li> -<li><a class="reference internal" href="#select-additional-tasks" id="id8">Select Additional Tasks</a></li> -<li><a class="reference internal" href="#ready-to-install" id="id9">Ready to Install</a></li> -<li><a class="reference internal" href="#installation-progress" id="id10">Installation Progress</a></li> -<li><a class="reference internal" href="#final-information" id="id11">Final Information</a></li> -<li><a class="reference internal" href="#finishing-up" id="id12">Finishing Up</a></li> -<li><a class="reference internal" href="#testing-the-installation" id="id13">Testing The Installation</a></li> -<li><a class="reference internal" href="#uninstall" id="id14">Uninstall</a></li> -<li><a class="reference internal" href="#use-from-another-package-or-program" id="id15">Use From Another Package or Program</a></li> +<li><p><a class="reference internal" href="#installing-using-installer-package" id="id1">Installing Using Installer Package</a></p> +<ul> +<li><p><a class="reference internal" href="#prerequisites" id="id2">Prerequisites</a></p></li> +<li><p><a class="reference internal" href="#retrieve-install-package" id="id3">Retrieve Install Package</a></p></li> +<li><p><a class="reference internal" href="#start-installation-wizard" id="id4">Start Installation Wizard</a></p></li> +<li><p><a class="reference internal" href="#read-installation-information" id="id5">Read Installation Information</a></p></li> +<li><p><a class="reference internal" href="#select-destination-directory" id="id6">Select Destination Directory</a></p></li> +<li><p><a class="reference internal" href="#select-start-menu-folder" id="id7">Select Start Menu Folder</a></p></li> +<li><p><a class="reference internal" href="#select-additional-tasks" id="id8">Select Additional Tasks</a></p></li> +<li><p><a class="reference internal" href="#ready-to-install" id="id9">Ready to Install</a></p></li> +<li><p><a class="reference internal" href="#installation-progress" id="id10">Installation Progress</a></p></li> +<li><p><a class="reference internal" href="#final-information" id="id11">Final Information</a></p></li> +<li><p><a class="reference internal" href="#finishing-up" id="id12">Finishing Up</a></p></li> +<li><p><a class="reference internal" href="#testing-the-installation" id="id13">Testing The Installation</a></p></li> +<li><p><a class="reference internal" href="#uninstall" id="id14">Uninstall</a></p></li> +<li><p><a class="reference internal" href="#use-from-another-package-or-program" id="id15">Use From Another Package or Program</a></p></li> </ul> </li> -<li><a class="reference internal" href="#installing-from-source-code" id="id16">Installing From Source Code</a><ul> -<li><a class="reference internal" href="#applicability" id="id17">Applicability</a></li> -<li><a class="reference internal" href="#important-notes" id="id18">Important Notes</a></li> -<li><a class="reference internal" href="#windows-xp-vista-7-visual-c-6-0-through-19-0-compilation" id="id19">Windows XP, Vista, 7 Visual C++ 6.0 through 19.0 Compilation</a></li> -<li><a class="reference internal" href="#environment-variables" id="id20">Environment Variables</a></li> -<li><a class="reference internal" href="#windows-distribution-build-procedure" id="id21">Windows Distribution Build Procedure</a></li> +<li><p><a class="reference internal" href="#installing-from-source-code" id="id16">Installing From Source Code</a></p> +<ul> +<li><p><a class="reference internal" href="#applicability" id="id17">Applicability</a></p></li> +<li><p><a class="reference internal" href="#important-notes" id="id18">Important Notes</a></p></li> +<li><p><a class="reference internal" href="#windows-xp-vista-7-visual-c-6-0-through-17-6-5-compilation" id="id19">Windows XP, Vista, 7 Visual C++ 6.0 through 17.6.5 Compilation</a></p></li> +<li><p><a class="reference internal" href="#environment-variables" id="id20">Environment Variables</a></p></li> +<li><p><a class="reference internal" href="#windows-distribution-build-procedure" id="id21">Windows Distribution Build Procedure</a></p></li> </ul> </li> </ul> @@ -70,12 +75,13 @@ <div class="section" id="installing-using-installer-package"> <h1><a class="toc-backref" href="#id1">Installing Using Installer Package</a></h1> <blockquote> -This section provides information specific to GraphicsMagick installed +<p>This section 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 Installing From Source Code -section.</blockquote> +section.</p> +</blockquote> <div class="section" id="prerequisites"> <h2><a class="toc-backref" href="#id2">Prerequisites</a></h2> <blockquote> @@ -94,8 +100,7 @@ Fonts") to support the standard set of Adobe Postscript fonts like "Helvetica" and "Times Roman" if these fonts are not available as TrueType fonts. The Ghostscript fonts need to manually installed with administrator privileges in the Ghostscript installation -directory (e.g. as <tt class="docutils literal"><span class="pre">C:\Program</span> Files\gs\fonts</tt> or <tt class="docutils literal">C:Program -Files\gs\gs9.27\fonts</tt>).</p> +directory (e.g. as <span class="docutils literal"><span class="pre">C:\Program</span> Files\gs\fonts</span> or <span class="docutils literal">C:Program Files\gs\gs9.27\fonts</span>).</p> <p>The algorithm used to find the fonts consults the Windows registry to learn Ghostscript installation paths, and then looks for a "fonts/n019003l.pfb" file in each path until it finds a match.</p> @@ -115,12 +120,10 @@ of the ftp sites listed at the <a class="reference external" href="download.html <p>Windows Dynamic-Multithread (DLL-based) install package with utilities, ImageMagickObject COM object, and web pages:</p> <blockquote> -<pre class="literal-block"> -GraphicsMagick-1.3-Q8-win32-dll.exe +<pre class="literal-block">GraphicsMagick-1.3-Q8-win32-dll.exe GraphicsMagick-1.3-Q16-win32-dll.exe GraphicsMagick-1.3-Q8-win64-dll.exe -GraphicsMagick-1.3-Q16-win64-dll.exe -</pre> +GraphicsMagick-1.3-Q16-win64-dll.exe</pre> </blockquote> <p>Note that the QuantumDepth=8 version (Q8) which provides industry standard 24/32 bit pixels consumes half the memory and about 30% less @@ -140,35 +143,38 @@ access is 1000 times faster than disk access.</p> <div class="section" id="start-installation-wizard"> <h2><a class="toc-backref" href="#id4">Start Installation Wizard</a></h2> <blockquote> -Execute the downloaded file from your browser or by double-clicking on +<p>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 "<em>Next></em>" to continue.</blockquote> +Wizard will appear. Click on "<em>Next></em>" to continue.</p> +</blockquote> </div> <div class="section" id="read-installation-information"> <h2><a class="toc-backref" href="#id5">Read Installation Information</a></h2> <blockquote> -An informational screen is presented which provides a summary of things +<p>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 "<em>Next></em>" to continue.</blockquote> +information. Once you have finished, Click on "<em>Next></em>" to continue.</p> +</blockquote> </div> <div class="section" id="select-destination-directory"> <h2><a class="toc-backref" href="#id6">Select Destination Directory</a></h2> <blockquote> -Specify what drive and directory to install GraphicsMagick into. +<p>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 <tt class="docutils literal"><span class="pre">C:\Program</span> -<span class="pre">Files\GraphicsMagick-1.3-Q8</span></tt>. Once you have entered the desired -installation directory, then select "<em>Next></em>" to continue.</blockquote> +installation directory is similar to <span class="docutils literal"><span class="pre">C:\Program</span> <span class="pre">Files\GraphicsMagick-1.3-Q8</span></span>. Once you have entered the desired +installation directory, then select "<em>Next></em>" to continue.</p> +</blockquote> </div> <div class="section" id="select-start-menu-folder"> <h2><a class="toc-backref" href="#id7">Select Start Menu Folder</a></h2> <blockquote> -Select the folder where you would like the program's shortcuts to +<p>Select the folder where you would like the program's shortcuts to appear. The default should normally be satisfactory. Click on "<em>Next></em>" -to continue.</blockquote> +to continue.</p> +</blockquote> </div> <div class="section" id="select-additional-tasks"> <h2><a class="toc-backref" href="#id8">Select Additional Tasks</a></h2> @@ -176,9 +182,9 @@ to continue.</blockquote> <p>A screen is displayed which presents some (or all) of the following options:</p> <ul class="simple"> -<li>Create a desktop icon</li> -<li>Update executable search path</li> -<li>Associate supported file extensions with GraphicsMagick</li> +<li><p>Create a desktop icon</p></li> +<li><p>Update executable search path</p></li> +<li><p>Associate supported file extensions with GraphicsMagick</p></li> </ul> <p>"Creating a desktop icon" and "Update the executable search path" are selected by default. The remaining options default to @@ -196,35 +202,39 @@ native formats (such as <a class="reference external" href="miff.html">MIFF</a>) <div class="section" id="ready-to-install"> <h2><a class="toc-backref" href="#id9">Ready to Install</a></h2> <blockquote> -A screen is displayed which displays the selected options. If you are +<p>A screen is displayed which displays the selected options. If you are not satisfied with a selected option, then click on "<em><Back</em>" to go back to a previous screen so that the option may be adjusted. If you are satisfied with the options and are ready to install, then select -"<em>Install</em>". To abort the installation entirely, select "<em>Cancel</em>".</blockquote> +"<em>Install</em>". To abort the installation entirely, select "<em>Cancel</em>".</p> +</blockquote> </div> <div class="section" id="installation-progress"> <h2><a class="toc-backref" href="#id10">Installation Progress</a></h2> <blockquote> -While the install program is performing the installation, it will -display what it is doing in an installation progress window.</blockquote> +<p>While the install program is performing the installation, it will +display what it is doing in an installation progress window.</p> +</blockquote> </div> <div class="section" id="final-information"> <h2><a class="toc-backref" href="#id11">Final Information</a></h2> <blockquote> -A summary of post-install steps is provided. These steps include some +<p>A summary of post-install steps is provided. These steps include some commands you can execute to make sure that GraphicsMagick is working, as well as some notes about what has been installed on your system, and where to find additional information. Once you have read this -information, click on "<em>Next></em>" to continue.</blockquote> +information, click on "<em>Next></em>" to continue.</p> +</blockquote> </div> <div class="section" id="finishing-up"> <h2><a class="toc-backref" href="#id12">Finishing Up</a></h2> <blockquote> -By default "<em>View GraphicsMagick.html</em>" is check-marked. This causes the +<p>By default "<em>View GraphicsMagick.html</em>" is check-marked. This causes the GraphicsMagick web pages to be displayed in your web browser when "<em>Finish</em>" is selected. If you do not want to view the web pages, then de-select "<em>View GraphicsMagick.html</em>". Select "<em>Finish</em>" to exit the -installation program.</blockquote> +installation program.</p> +</blockquote> </div> <div class="section" id="testing-the-installation"> <h2><a class="toc-backref" href="#id13">Testing The Installation</a></h2> @@ -232,10 +242,8 @@ installation program.</blockquote> <p>Select "<em>Command Prompt</em>" from the Windows Start menu. Within the window type</p> <blockquote> -<pre class="literal-block"> -gm convert logo: logo.miff -gm convert logo.miff win: -</pre> +<pre class="literal-block">gm convert logo: logo.miff +gm convert logo.miff win:</pre> </blockquote> <p>and the GraphicsMagick logo should be displayed in a window.</p> </blockquote> @@ -272,50 +280,50 @@ source code.</p> <p>When GraphicsMagick is installed, entries are added to the Windows Registry so that other programs may obtain information regarding the most recently installed GraphicsMagick. These entries are available -under the registry path <tt class="docutils literal">HKEY_LOCAL_MACHINE\SOFTWARE\GraphicsMagick\Current</tt>.</p> +under the registry path <span class="docutils literal">HKEY_LOCAL_MACHINE\SOFTWARE\GraphicsMagick\Current</span>.</p> <p>These registry keys are currently available:</p> -<table border="1" class="docutils"> +<table> <colgroup> -<col width="25%" /> -<col width="12%" /> -<col width="64%" /> +<col style="width: 25%" /> +<col style="width: 12%" /> +<col style="width: 64%" /> </colgroup> -<thead valign="bottom"> -<tr><th class="head">Key Name</th> -<th class="head">Key Type</th> -<th class="head">Description</th> +<thead> +<tr><th class="head"><p>Key Name</p></th> +<th class="head"><p>Key Type</p></th> +<th class="head"><p>Description</p></th> </tr> </thead> -<tbody valign="top"> -<tr><td>BinPath</td> -<td>REG_SZ</td> -<td>Directory where GraphicsMagick executables -are installed</td> +<tbody> +<tr><td><p>BinPath</p></td> +<td><p>REG_SZ</p></td> +<td><p>Directory where GraphicsMagick executables +are installed</p></td> </tr> -<tr><td>ConfigurePath</td> -<td>REG_SZ</td> -<td>Directory where configuration files are -installed</td> +<tr><td><p>ConfigurePath</p></td> +<td><p>REG_SZ</p></td> +<td><p>Directory where configuration files are +installed</p></td> </tr> -<tr><td>LibPath</td> -<td>REG_SZ</td> -<td>Directory where GraphicsMagick core DLLs -are installed</td> +<tr><td><p>LibPath</p></td> +<td><p>REG_SZ</p></td> +<td><p>Directory where GraphicsMagick core DLLs +are installed</p></td> </tr> -<tr><td>CoderModulesPath</td> -<td>REG_SZ</td> -<td>Directory where GraphicsMagick loadable -coder modules are installed</td> +<tr><td><p>CoderModulesPath</p></td> +<td><p>REG_SZ</p></td> +<td><p>Directory where GraphicsMagick loadable +coder modules are installed</p></td> </tr> -<tr><td>FilterModulesPath</td> -<td>REG_SZ</td> -<td>Directory where GraphicsMagick loadable -filter modules are installed</td> +<tr><td><p>FilterModulesPath</p></td> +<td><p>REG_SZ</p></td> +<td><p>Directory where GraphicsMagick loadable +filter modules are installed</p></td> </tr> -<tr><td>SharePath</td> -<td>REG_SZ</td> -<td>Directory where configuration files are -installed</td> +<tr><td><p>SharePath</p></td> +<td><p>REG_SZ</p></td> +<td><p>Directory where configuration files are +installed</p></td> </tr> </tbody> </table> @@ -327,32 +335,34 @@ installed</td> <div class="section" id="applicability"> <h2><a class="toc-backref" href="#id17">Applicability</a></h2> <blockquote> -This section provides instructions for building GraphicsMagick +<p>This section provides instructions for building GraphicsMagick Microsoft Windows using the Visual C++ (Visual Studio, etc.) IDE. For building using the free Cygwin or MinGW compilers (e.g. as part of <a class="reference external" href="https://www.msys2.org/">MSYS2</a>), follow the instructions -in INSTALL-unix.txt.</blockquote> +in INSTALL-unix.txt.</p> +</blockquote> </div> <div class="section" id="important-notes"> <h2><a class="toc-backref" href="#id18">Important Notes</a></h2> <blockquote> -On some platforms Visual C++ may fail with an internal compiler +<p>On some platforms Visual C++ may fail with an internal compiler error. If this happens to you, then make sure that your compiler is updated with the latest fixes from the Microsoft web site and the problem will hopefully go away. If the problem does not go away, then adjust the settings for the module which failed and disable optimization, and the problem is likely to go away (but with less -performance).</blockquote> +performance).</p> +</blockquote> </div> -<div class="section" id="windows-xp-vista-7-visual-c-6-0-through-19-0-compilation"> -<h2><a class="toc-backref" href="#id19">Windows XP, Vista, 7 Visual C++ 6.0 through 19.0 Compilation</a></h2> +<div class="section" id="windows-xp-vista-7-visual-c-6-0-through-17-6-5-compilation"> +<h2><a class="toc-backref" href="#id19">Windows XP, Vista, 7 Visual C++ 6.0 through 17.6.5 Compilation</a></h2> <blockquote> <p>The Visual C++ distribution targeted at Windows 2000 through Windows 10 does not provide any stock workspace (DSW) or project files (DSP) except for those included with third party libraries. Instead, there is a "configure" program that must run to create build environments to satisfy various requirements.</p> -<p>The configure program resides in <tt class="docutils literal">VisualMagick\configure</tt> in the +<p>The configure program resides in <span class="docutils literal">VisualMagick\configure</span> in the GraphicsMagick source tree. A pre-compiled configure.exe is provided, as well as Visual Studio project files to recompile it from source code if needed.</p> @@ -361,17 +371,22 @@ dialog after proceeding past the initial notifications screen:</p> <img alt="Configure program screen shot" class="align-center" src="configure-target-setup.png" style="width: 498.0px; height: 473.0px;" /> <p>In addition to (or as a replacement to) the above dialog, the configure.exe program supports these command-line options:</p> -<dl class="docutils"> +<dl class="simple"> <dt><cite>/Q8 /Q16 /Q32</cite></dt> -<dd>Set quantum depth</dd> +<dd><p>Set quantum depth</p> +</dd> <dt><cite>/x64</cite></dt> -<dd>Add x64 configuration</dd> +<dd><p>Add x64 configuration</p> +</dd> <dt><cite>/mtd /sts /mts /mtsd</cite></dt> -<dd>Set project type</dd> +<dd><p>Set project type</p> +</dd> <dt><cite>/noWizard</cite></dt> -<dd>Do not show the wizard</dd> +<dd><p>Do not show the wizard</p> +</dd> <dt><cite>/openMP</cite></dt> -<dd>Enable openMP</dd> +<dd><p>Enable openMP</p> +</dd> </dl> <p>The Visual C++ system provides three different types of "runtimes" that must match across all application, library, and DLL code that is @@ -379,10 +394,10 @@ built. The "configure" program creates a set of build files that are consistent for a specific runtime selection.</p> <p>The three options for runtime support are:</p> <ol class="arabic simple"> -<li>Dynamic Multi-threaded DLL runtimes (VisualDynamicMT), <cite>/mtd</cite> option</li> -<li>Static Single-threaded runtimes (<cite>VisualStaticST</cite>), <cite>/sts</cite> option</li> -<li>Static Multi-threaded runtimes (VisualStaticMT), <cite>/mts</cite> option</li> -<li>Static Multi-threaded DLL runtimes (VisualStaticMTDLL), <cite>/mtsd</cite> option</li> +<li><p>Dynamic Multi-threaded DLL runtimes (VisualDynamicMT), <cite>/mtd</cite> option</p></li> +<li><p>Static Single-threaded runtimes (<cite>VisualStaticST</cite>), <cite>/sts</cite> option</p></li> +<li><p>Static Multi-threaded runtimes (VisualStaticMT), <cite>/mts</cite> option</p></li> +<li><p>Static Multi-threaded DLL runtimes (VisualStaticMTDLL), <cite>/mtsd</cite> option</p></li> </ol> <p>In addition to these runtimes, the VisualMagick build environment allows you to select whether to include the X11 libraries in the build or not. @@ -400,18 +415,20 @@ directory under VisualMagick and open the configure.dsw workspace (for Visual C++ 6.0) or configure.sln (for Visual C++ 7.X through 9.X). Set the build configuration to "Release" under the</p> <blockquote> -"Build..., Set Active Configuration..." menu.</blockquote> +<p>"Build..., Set Active Configuration..." menu.</p> +</blockquote> <p>Build and execute the configure program and follow the on-screen instructions. You should not change any of the defaults unless you have a specific reason to do so.</p> <p>The configure program provides a button entitled</p> <blockquote> -Edit "magick_config.h"</blockquote> +<p>Edit "magick_config.h"</p> +</blockquote> <p>Clicking this button brings up magick_config.h in Windows notepad for optionally changing any preprocessor defines in GraphicsMagick's magick_config.h file. This file is copied to -<tt class="docutils literal">magick\magick_config.h</tt>. You may safely open -<tt class="docutils literal">magick\magick_config.h</tt>, modify it, and recompile without +<span class="docutils literal">magick\magick_config.h</span>. You may safely open +<span class="docutils literal">magick\magick_config.h</span>, modify it, and recompile without re-running the configure program. In fact, using Visual Studio to edit the copied file may be preferable since it preserves the original magick_config.h file.</p> @@ -419,28 +436,32 @@ original magick_config.h file.</p> <blockquote> <p>QuantumDepth (default 8)</p> <blockquote> -Specify size of PixelPacket color Quantums (8, 16, or 32) A value of +<p>Specify size of PixelPacket color Quantums (8, 16, or 32) A value of 8 uses half the memory than 16 and may run 30% faster, but provides -256 times less color resolution than a value of 16.</blockquote> +256 times less color resolution than a value of 16.</p> +</blockquote> <p>UseInstalledMagick (default undefined)</p> <blockquote> -Define to build a GraphicsMagick which uses registry settings or +<p>Define to build a GraphicsMagick which uses registry settings or embedded paths to locate installed components (coder modules and configuration files). The default is to look for all files in the -same directory as the executable.</blockquote> +same directory as the executable.</p> +</blockquote> <p>ProvideDllMain (default undefined)</p> <blockquote> -Define to include a DllMain() function ensures that the GraphicsMagick +<p>Define to include a DllMain() function ensures that the GraphicsMagick DLL is properly initialized without participation from dependent applications. This avoids the requirement to invoke IntializeMagick() -from dependent applications but only works for DLL builds.</blockquote> +from dependent applications but only works for DLL builds.</p> +</blockquote> <p>EnableBrokenCoders (default undefined)</p> <blockquote> -Define to enable broken/dangerous file format support. Only +<p>Define to enable broken/dangerous file format support. Only enable this if you have complete control over the input files and not for arbitrary files such as uploaded from untrusted sources via the Internet. Currently this must be enabled to -enable Adobe Photoshop Format (PSD).</blockquote> +enable Adobe Photoshop Format (PSD).</p> +</blockquote> </blockquote> <p>After creating your build environment you can proceed to open the DSW (or SLN) file that was generated in the VisualMagick directory and build @@ -452,11 +473,11 @@ the "active" project. Set the build configuration to the desired one do the build in a specific way:</p> <blockquote> <ol class="arabic simple"> -<li>Make the "All" project the active project (Bold) -Right click on the All project and select "Set As Active Project"</li> -<li>Select "Build..., Clean"</li> -<li>Select "Build..., Build"</li> -<li>Go get some coffee unless you have a very fast machine!.</li> +<li><p>Make the "All" project the active project (Bold) +Right click on the All project and select "Set As Active Project"</p></li> +<li><p>Select "Build..., Clean"</p></li> +<li><p>Select "Build..., Build"</p></li> +<li><p>Go get some coffee unless you have a very fast machine!.</p></li> </ol> </blockquote> <p>The "Clean" step is needed in order to make sure that all of the target @@ -471,22 +492,24 @@ system installation.</p> <p>Note #1:</p> <p>The Visual C++ distribution of GraphicsMagick comes with the Magick++ C++ wrapper by default. This add-on layer has a large number of demo -and test files that can be found in <tt class="docutils literal"><span class="pre">GraphicsMagick\Magick++\demo</span></tt>, and -<tt class="docutils literal"><span class="pre">GraphicsMagick\Magick++\tests</span></tt>. There are also a variety of tests that -use the straight C API as well in <tt class="docutils literal">GraphicsMagick\tests</tt>.</p> +and test files that can be found in <span class="docutils literal"><span class="pre">GraphicsMagick\Magick++\demo</span></span>, and +<span class="docutils literal"><span class="pre">GraphicsMagick\Magick++\tests</span></span>. There are also a variety of tests that +use the straight C API as well in <span class="docutils literal">GraphicsMagick\tests</span>.</p> <p>All of these programs are NOT configured to be built in the default workspace created by the configure program. You can cause all of these demos and test programs to be built by checking the box in configure that says:</p> <blockquote> -"Include all demo and test programs"</blockquote> +<p>"Include all demo and test programs"</p> +</blockquote> <p>In addition, there is another related checkbox (checked by default) that causes all generated project files to be created standalone so that they can be copied to other areas of you system.</p> <p>This is the checkbox:</p> <blockquote> -"Generate all utility projects with full paths rather then relative -paths"</blockquote> +<p>"Generate all utility projects with full paths rather then relative +paths"</p> +</blockquote> <p>WOW - that a mouthfull - eh?</p> <p>Visual C++ uses a concept of "dependencies" that tell it what other components need to be build when a particular project is being build. This @@ -502,10 +525,11 @@ and can actually be copied and used as templates to get a particular custom application compiling with little effort.</p> <p>With this feature enabled, you should be able to nab a copy of...</p> <blockquote> -<p><tt class="docutils literal">VisualMagick\utilities\UTIL_gm_xxx_exe.dsp</tt> (for C)</p> +<p><span class="docutils literal">VisualMagick\utilities\UTIL_gm_xxx_exe.dsp</span> (for C)</p> <blockquote> --or-</blockquote> -<p><tt class="docutils literal"><span class="pre">VisualMagick\Magick++\demo\UTIL_demo_xxx_exe.dsp</span></tt> (for C++)</p> +<p>-or-</p> +</blockquote> +<p><span class="docutils literal"><span class="pre">VisualMagick\Magick++\demo\UTIL_demo_xxx_exe.dsp</span></span> (for C++)</p> </blockquote> <p>... and pop it into notepad, modify it (carefully) to your needs and be on your way to happy compiling and linking.</p> @@ -515,20 +539,20 @@ and the source and hacking away.</p> <p>The choice of what to use as a starting point is very easy...</p> <p>For straight C API command line applications use something from</p> <blockquote> -<p><tt class="docutils literal">GraphicsMagick\tests</tt> or <tt class="docutils literal">GraphicsMagick\utilities</tt> (source code)</p> -<p><tt class="docutils literal">GraphicsMagick\VisualMagick\tests</tt> or <tt class="docutils literal">GraphicsMagick\Visualmagick\utilities</tt> +<p><span class="docutils literal">GraphicsMagick\tests</span> or <span class="docutils literal">GraphicsMagick\utilities</span> (source code)</p> +<p><span class="docutils literal">GraphicsMagick\VisualMagick\tests</span> or <span class="docutils literal">GraphicsMagick\Visualmagick\utilities</span> (project - DSP)</p> </blockquote> <p>For C++ and Magick++ command line applications use something from</p> <blockquote> -<p><tt class="docutils literal"><span class="pre">GraphicsMagick\Magick++\tests</span></tt> or <tt class="docutils literal"><span class="pre">GraphicsMagick\Magick++\demo</span></tt> (source code)</p> -<p><tt class="docutils literal"><span class="pre">GraphicsMagick\VisualMagick\Magick++\tests</span></tt> or -<tt class="docutils literal"><span class="pre">GraphicsMagick\VisualMagick\Magick++\demo</span></tt> (project - DSP)</p> +<p><span class="docutils literal"><span class="pre">GraphicsMagick\Magick++\tests</span></span> or <span class="docutils literal"><span class="pre">GraphicsMagick\Magick++\demo</span></span> (source code)</p> +<p><span class="docutils literal"><span class="pre">GraphicsMagick\VisualMagick\Magick++\tests</span></span> or +<span class="docutils literal"><span class="pre">GraphicsMagick\VisualMagick\Magick++\demo</span></span> (project - DSP)</p> </blockquote> <p>For C++ and Magick++ and MFC windows applications use</p> <blockquote> -<p><tt class="docutils literal">GraphicsMagick\win2k\IMDisplay</tt> (source code)</p> -<p><tt class="docutils literal">GraphicsMagick\VisualMagick\win32\NtMagick</tt> (project - DSP)</p> +<p><span class="docutils literal">GraphicsMagick\win2k\IMDisplay</span> (source code)</p> +<p><span class="docutils literal">GraphicsMagick\VisualMagick\win32\NtMagick</span> (project - DSP)</p> </blockquote> <p>Note #2:</p> <p>The GraphicsMagick distribution is very modular. The default @@ -541,20 +565,20 @@ components may be copied to another folder (such as to another computer).</p> following files:</p> <blockquote> <ol class="arabic simple"> -<li>colors.mgk</li> -<li>delegates.mgk</li> -<li>log.mgk</li> -<li>magic.mgk</li> -<li>modules.mgk</li> -<li>type.mgk</li> -<li>type-ghostscript.mgk (if Ghostscript is used)</li> +<li><p>colors.mgk</p></li> +<li><p>delegates.mgk</p></li> +<li><p>log.mgk</p></li> +<li><p>magic.mgk</p></li> +<li><p>modules.mgk</p></li> +<li><p>type.mgk</p></li> +<li><p>type-ghostscript.mgk (if Ghostscript is used)</p></li> </ol> </blockquote> <p>The "bin" folder should contains all EXE's and DLL's as well as the very important "modules.mgk" file.</p> <p>With this default setup, you can use any of the command line tools and run scripts as normal. You can actually get by quite nicely this -way by doing something like <tt class="docutils literal">pushd <span class="pre">e:\xxx\yyy\bin</span></tt> in any scripts you +way by doing something like <span class="docutils literal">pushd <span class="pre">e:\xxx\yyy\bin</span></span> in any scripts you write to execute "out of" this directory.</p> <p>By default the core of GraphicsMagick on Win32 always looks in the place were the exe program is run from in order to find all of the files as @@ -575,7 +599,8 @@ DLL's. Windows CMD shell seems to look in the "current" directory firs you wish to run any of utilities from another location then you must add the path to your "bin" directory in. For instance, you might add:</p> <blockquote> -<tt class="docutils literal"><span class="pre">D:\Devel\GraphicsMagick\VisualMagick\bin</span></tt></blockquote> +<p><span class="docutils literal"><span class="pre">D:\Devel\GraphicsMagick\VisualMagick\bin</span></span></p> +</blockquote> <p>to do this for the default build environment like I do.</p> </blockquote> <p>MAGICK_HOME</p> @@ -593,7 +618,8 @@ to leave the modules in the same place as the EXE's (a good idea) then you can simply set this to the same place as you did the PATH variable. In my case:</p> <blockquote> -<tt class="docutils literal"><span class="pre">D:\\GraphicsMagick\coders</span></tt></blockquote> +<p><span class="docutils literal"><span class="pre">D:\\GraphicsMagick\coders</span></span></p> +</blockquote> <p>This is also the place were GraphicsMagick expects to find the "colors.mgk", "delegates.mgk", "magic.mgk", "modules.mgk", and "type.mgk" files.</p> @@ -608,10 +634,12 @@ purposes.</p> way. Two #defines are applicable.</p> <p>defines.h has</p> <blockquote> -<tt class="docutils literal">#define MagickConfigurePath <span class="pre">"c:\\GraphicsMagick\\"</span></tt></blockquote> +<p><span class="docutils literal">#define MagickConfigurePath <span class="pre">"c:\\GraphicsMagick\\"</span></span></p> +</blockquote> <p>To view any image in a Microsoft window, type</p> <blockquote> -<tt class="docutils literal">gm convert image.ext win:</tt></blockquote> +<p><span class="docutils literal">gm convert image.ext win:</span></p> +</blockquote> <p>Make sure Ghostscript is installed, otherwise, you will be unable to convert or view a Postscript document, and Postscript standard fonts will not be available.</p> @@ -629,103 +657,97 @@ Professional. This is the same procedure used to produce the release packages. The PerlMagick steps are skipped as of GraphicsMagick 1.3.26):</p> <ol class="arabic simple"> -<li>Install prerequisite software:</li> +<li><p>Install prerequisite software:</p></li> </ol> <blockquote> <ol class="loweralpha simple"> -<li>Install Microsoft Visual Studio.</li> -<li>Download and install Inno Setup 6 -<"<a class="reference external" href="http://www.jrsoftware.org/isinfo.php">http://www.jrsoftware.org/isinfo.php</a>">.</li> -<li>Download and install ActiveState ActivePerl (optional) -<"<a class="reference external" href="http://www.activestate.com/activeperl/downloads/">http://www.activestate.com/activeperl/downloads/</a>">.</li> +<li><p>Install Microsoft Visual Studio.</p></li> +<li><p>Download and install Inno Setup 6 +<"<a class="reference external" href="http://www.jrsoftware.org/isinfo.php">http://www.jrsoftware.org/isinfo.php</a>">.</p></li> +<li><p>Download and install ActiveState ActivePerl (optional) +<"<a class="reference external" href="http://www.activestate.com/activeperl/downloads/">http://www.activestate.com/activeperl/downloads/</a>">.</p></li> </ol> </blockquote> <ol class="arabic" start="2"> -<li><p class="first">Disable automatic indexing and virus scanning for the +<li><p>Disable automatic indexing and virus scanning for the GraphicsMagick source tree. In particular, "Windows Defender" in Windows 10 (and similar software in earlier Windows releases) has been observed to cause Visual Studio builds to fail since the virus scanner opens built libraries and executables to inspect whem while Visual Studio is still using them. Indexing and scanning also cause significant slowdowns since there are many -megabytes of files to index.</p> -</li> -<li><p class="first">Build <cite>GMVisualMagickconfigureconfigure.exe</cite> (if +megabytes of files to index.</p></li> +<li><p>Build <cite>GMVisualMagickconfigureconfigure.exe</cite> (if missing/outdated)</p> <ol class="loweralpha simple"> -<li>Open workspace <cite>GMVisualMagickconfigureconfigure.dsp</cite> by -double-clicking from Windows Explorer.</li> -<li>Upgrade Visual Studio project (as required)</li> -<li>Select <cite>Rebuild All</cite> to build configure.exe</li> -<li>Close the project.</li> +<li><p>Open workspace <cite>GMVisualMagickconfigureconfigure.dsp</cite> by +double-clicking from Windows Explorer.</p></li> +<li><p>Upgrade Visual Studio project (as required)</p></li> +<li><p>Select <cite>Rebuild All</cite> to build configure.exe</p></li> +<li><p>Close the project.</p></li> </ol> </li> -<li><p class="first">Configure Initial GraphicsMagick Visual Studio Workspace</p> +<li><p>Configure Initial GraphicsMagick Visual Studio Workspace</p> <ol class="loweralpha simple"> -<li>Use Windows Explorer to navigate to <cite>GMVisualMagickconfigure</cite>.</li> -<li>Double-click on <cite>configure.exe</cite> to run configure program.</li> -<li>Select desired build options: DLL build, Quantum Depth, 64-bit, OpenMP)</li> -<li>Check <cite>Build demo and test programs</cite>.</li> -<li>Finish remaining configure wizard screens to complete.</li> -<li><cite>File</cite> -> <cite>Close Workspace</cite>.</li> +<li><p>Use Windows Explorer to navigate to <cite>GMVisualMagickconfigure</cite>.</p></li> +<li><p>Double-click on <cite>configure.exe</cite> to run configure program.</p></li> +<li><p>Select desired build options: DLL build, Quantum Depth, 64-bit, OpenMP)</p></li> +<li><p>Check <cite>Build demo and test programs</cite>.</p></li> +<li><p>Finish remaining configure wizard screens to complete.</p></li> +<li><p><cite>File</cite> -> <cite>Close Workspace</cite>.</p></li> </ol> </li> -<li><p class="first">Open Workspace, set build configuration, build GraphicsMagick software.</p> +<li><p>Open Workspace, set build configuration, build GraphicsMagick software.</p> <ol class="loweralpha simple"> -<li>Open workspace <cite>GMVisualMagickconfigureconfigure.sln</cite> by -double-clicking from Windows Explorer.</li> -<li>Build -> "Set Active Configuration" -> "All - Win32 Release" -> OK</li> -<li>Optionally enable 64-bit (WIN64) compilation. "<cite>Build</cite> / +<li><p>Open workspace <cite>GMVisualMagickconfigureconfigure.sln</cite> by +double-clicking from Windows Explorer.</p></li> +<li><p>Build -> "Set Active Configuration" -> "All - Win32 Release" -> OK</p></li> +<li><p>Optionally enable 64-bit (WIN64) compilation. "<cite>Build</cite> / <cite>Configuration Manager...</cite> / <cite>Active Solution Platform</cite> / -<cite>New</cite> / <cite>x64</cite>".</li> -<li>Open <cite>CORE_magickmagickmagick_config.h</cite> and edit any +<cite>New</cite> / <cite>x64</cite>".</p></li> +<li><p>Open <cite>CORE_magickmagickmagick_config.h</cite> and edit any configuration settings you would like to change. For example, -you might change QuantumDepth to 16 for a"Q:16" build.</li> -<li>If using Visual Studio Professional Edition, and OpenMP +you might change QuantumDepth to 16 for a"Q:16" build.</p></li> +<li><p>If using Visual Studio Professional Edition, and OpenMP support is desired, then select <cite>CORE_magick</cite> in the Solution Explorer pane and use the right mouse button menu to select <cite>Properties</cite>. In <cite>Configuration Properties</cite> / <cite>C/C++</cite> / -<cite>Language</cite> set OpenMP support to 'yes'.</li> -<li>Select "Rebuild All"</li> -<li>Click on '!' icon to run configure program</li> -<li>Select DLL build</li> -<li>Check <cite>Build demo and test programs</cite>.</li> -<li>Click on Edit <cite>magick_config.h</cite> and verify desired settings +<cite>Language</cite> set OpenMP support to 'yes'.</p></li> +<li><p>Select "Rebuild All"</p></li> +<li><p>Click on '!' icon to run configure program</p></li> +<li><p>Select DLL build</p></li> +<li><p>Check <cite>Build demo and test programs</cite>.</p></li> +<li><p>Click on Edit <cite>magick_config.h</cite> and verify desired settings such as QuantumDepth. You can also defer this step to later by opening the header file -<tt class="docutils literal">CORE_magick\include\magick_config.h</tt> in the Visual Studio -project.</li> -<li>Finish remaining configure wizard screens to complete.</li> -<li>File -> <cite>Close Workspace</cite></li> +<span class="docutils literal">CORE_magick\include\magick_config.h</span> in the Visual Studio +project.</p></li> +<li><p>Finish remaining configure wizard screens to complete.</p></li> +<li><p>File -> <cite>Close Workspace</cite></p></li> </ol> </li> -<li><p class="first">Build ImageMagickObject</p> +<li><p>Build ImageMagickObject</p> <ol class="loweralpha simple"> -<li>Open Visual Studio Command Shell Window for WIN32 or WIN64</li> -<li>Change to GraphicsMagick project directory <tt class="docutils literal">GM</tt></li> -<li><tt class="docutils literal">cd GM\contrib\win32\ATL7\ImageMagickObject</tt></li> -<li><tt class="docutils literal">BuildImageMagickObject clean</tt></li> -<li><tt class="docutils literal">BuildImageMagickObject release</tt></li> -<li><tt class="docutils literal">cd <span class="pre">..\..\..\..</span></tt></li> +<li><p>Open Visual Studio Command Shell Window for WIN32 or WIN64</p></li> +<li><p>Change to GraphicsMagick project directory <span class="docutils literal">GM</span></p></li> +<li><p><span class="docutils literal">cd GM\contrib\win32\ATL7\ImageMagickObject</span></p></li> +<li><p><span class="docutils literal">BuildImageMagickObject clean</span></p></li> +<li><p><span class="docutils literal">BuildImageMagickObject release</span></p></li> +<li><p><span class="docutils literal">cd <span class="pre">..\..\..\..</span></span></p></li> </ol> </li> -<li><p class="first">Build PerlMagick extension (optional and now rarely done)</p> +<li><p>Build PerlMagick extension (optional and now rarely done)</p> <ol class="loweralpha"> -<li><p class="first">Open Visual Studio Command Shell Window for WIN32 or WIN64</p> -</li> -<li><p class="first">Change to GraphicsMagick project directory <tt class="docutils literal">GM</tt></p> -</li> -<li><p class="first"><tt class="docutils literal">cd GM\PerlMagick</tt></p> -</li> -<li><p class="first"><tt class="docutils literal">nmake clean</tt> (only if this is a rebuild)</p> -</li> -<li><p class="first"><tt class="docutils literal"><span class="pre">C:\Perl32\bin\perl.exe</span> Makefile.nt</tt> (or Perl64)</p> +<li><p>Open Visual Studio Command Shell Window for WIN32 or WIN64</p></li> +<li><p>Change to GraphicsMagick project directory <span class="docutils literal">GM</span></p></li> +<li><p><span class="docutils literal">cd GM\PerlMagick</span></p></li> +<li><p><span class="docutils literal">nmake clean</span> (only if this is a rebuild)</p></li> +<li><p><span class="docutils literal"><span class="pre">C:\Perl32\bin\perl.exe</span> Makefile.nt</span> (or Perl64)</p> <p>Note that if multiple Perl's are installed, then it may be necessary to specify the full path to perl.exe in order to use the correct Perl.</p> </li> -<li><p class="first"><tt class="docutils literal">nmake release</tt></p> -</li> +<li><p><span class="docutils literal">nmake release</span></p></li> </ol> </li> </ol> @@ -734,58 +756,63 @@ how the install of Visual Studio was done, this may not be the case. Visual Studio provides a batch script in VC98Bin called VCVARS32.BAT that can be used to do this manually after you open up a command prompt.</p> <ol class="arabic simple" start="8"> -<li>Open <cite>GMVisualMagickinstallergm-win32-Q8-dll-full.iss</cite> (or +<li><p>Open <cite>GMVisualMagickinstallergm-win32-Q8-dll-full.iss</cite> (or <cite>gm-win32-Q16-dll-full.iss</cite> if QuantumDepth=16) by -double-clicking from Windows Explorer.<ol class="loweralpha"> -<li><cite>File</cite> -> <cite>Compile</cite></li> -<li>Test install by clicking on green triangle</li> +double-clicking from Windows Explorer.</p> +<ol class="loweralpha simple"> +<li><p><cite>File</cite> -> <cite>Compile</cite></p></li> +<li><p>Test install by clicking on green triangle</p></li> </ol> </li> -<li>Test PerlMagick (optional).<ol class="loweralpha"> -<li><tt class="docutils literal">cd PerlMagick</tt></li> -<li><tt class="docutils literal">nmake test</tt> (All tests must pass!)</li> +<li><p>Test PerlMagick (optional).</p> +<ol class="loweralpha simple"> +<li><p><span class="docutils literal">cd PerlMagick</span></p></li> +<li><p><span class="docutils literal">nmake test</span> (All tests must pass!)</p></li> </ol> </li> -<li>Test file format read and write.</li> +<li><p>Test file format read and write.</p></li> </ol> <blockquote> <ol class="loweralpha simple"> -<li><tt class="docutils literal">cd VisualMagick\tests</tt></li> -<li><tt class="docutils literal">run_rwfile.bat</tt> (All tests must pass!)</li> -<li><tt class="docutils literal">run_rwblob.bat</tt> (All tests must pass!)</li> +<li><p><span class="docutils literal">cd VisualMagick\tests</span></p></li> +<li><p><span class="docutils literal">run_rwfile.bat</span> (All tests must pass!)</p></li> +<li><p><span class="docutils literal">run_rwblob.bat</span> (All tests must pass!)</p></li> </ol> </blockquote> <ol class="arabic simple" start="11"> -<li>Run Magick++ test programs.</li> +<li><p>Run Magick++ test programs.</p></li> </ol> <blockquote> <ol class="loweralpha simple"> -<li><tt class="docutils literal">cd <span class="pre">Magick++/tests</span></tt></li> -<li><tt class="docutils literal">run_tests.bat</tt> (All tests must pass!)</li> +<li><p><span class="docutils literal">cd <span class="pre">Magick++/tests</span></span></p></li> +<li><p><span class="docutils literal">run_tests.bat</span> (All tests must pass!)</p></li> </ol> </blockquote> <ol class="arabic simple" start="12"> -<li>Run Magick++ demo programs.</li> +<li><p>Run Magick++ demo programs.</p></li> </ol> <blockquote> <ol class="loweralpha simple"> -<li><tt class="docutils literal">cd <span class="pre">Magick++/demo</span></tt></li> -<li><tt class="docutils literal">run_demos.bat</tt></li> -<li>Use <em>gmdisplay</em> to visually inspect all output files.</li> +<li><p><span class="docutils literal">cd <span class="pre">Magick++/demo</span></span></p></li> +<li><p><span class="docutils literal">run_demos.bat</span></p></li> +<li><p>Use <em>gmdisplay</em> to visually inspect all output files.</p></li> </ol> </blockquote> <ol class="arabic simple" start="13"> -<li>Distribution package is available named similar to -<tt class="docutils literal"><span class="pre">GM\VisualMagick\bin\GraphicsMagick-1.3-Q8-dll.exe</span></tt></li> +<li><p>Distribution package is available named similar to +<span class="docutils literal"><span class="pre">GM\VisualMagick\bin\GraphicsMagick-1.3-Q8-dll.exe</span></span></p></li> </ol> </blockquote> </div> </div> </div> + <hr class="docutils"> <div class="document"> - <p><a href="Copyright.html">Copyright</a> © GraphicsMagick Group 2002 - 2022<!--SPONSOR_LOGO--></p> + <p><a href="Copyright.html">Copyright</a> © GraphicsMagick Group 2002 - 2023<!--SPONSOR_LOGO--></p> +</div> + </div> </body> </html> |