diff options
Diffstat (limited to 'www/README.html')
| -rw-r--r-- | www/README.html | 121 |
1 files changed, 63 insertions, 58 deletions
diff --git a/www/README.html b/www/README.html index 1cd200f..9092333 100644 --- a/www/README.html +++ b/www/README.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>Installing GraphicsMagick</title> -<link rel="stylesheet" href="docutils-articles.css" type="text/css" /> + <meta charset="utf-8"> + <meta content="en" name="language"> + <title>Installing GraphicsMagick</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,19 +35,19 @@ <li><a href="reference.html">Reference</a></li> </ul> </div> + <div class="document" id="installing-graphicsmagick"> <h1 class="title">Installing GraphicsMagick</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="#executive-summary" id="id1">Executive Summary</a></li> -<li><a class="reference internal" href="#availability" id="id2">Availability</a></li> -<li><a class="reference internal" href="#documentation" id="id3">Documentation</a></li> -<li><a class="reference internal" href="#installation" id="id4">Installation</a></li> -<li><a class="reference internal" href="#add-on-libraries-programs" id="id5">Add-On Libraries & Programs</a></li> +<li><p><a class="reference internal" href="#executive-summary" id="id1">Executive Summary</a></p></li> +<li><p><a class="reference internal" href="#availability" id="id2">Availability</a></p></li> +<li><p><a class="reference internal" href="#documentation" id="id3">Documentation</a></p></li> +<li><p><a class="reference internal" href="#installation" id="id4">Installation</a></p></li> +<li><p><a class="reference internal" href="#add-on-libraries-programs" id="id5">Add-On Libraries & Programs</a></p></li> </ul> </div> <div class="section" id="executive-summary"> @@ -81,9 +84,10 @@ GraphicsMagick updates from the main repository whenever you like.</p> <div class="section" id="documentation"> <h1><a class="toc-backref" href="#id3">Documentation</a></h1> <blockquote> -Open the file index.html in a web browser, or refer to the gm(1) manual +<p>Open the file index.html in a web browser, or refer to the gm(1) manual page. Also read the GraphicsMagick frequently asked questions in the -file <a class="reference external" href="FAQ.html">www/FAQ.html</a>.</blockquote> +file <a class="reference external" href="FAQ.html">www/FAQ.html</a>.</p> +</blockquote> </div> <div class="section" id="installation"> <h1><a class="toc-backref" href="#id4">Installation</a></h1> @@ -93,10 +97,10 @@ modern Unix system (including Linux and MacOS X) and Microsoft Windows. Installation instructions may be found in the following files (or their HTML equivalents):</p> <ul> -<li><p class="first">Unix / Linux / *BSD / MacOS-X / Cygwin / MinGW:</p> +<li><p>Unix / Linux / *BSD / MacOS-X / Cygwin / MinGW:</p> <p><a class="reference external" href="INSTALL-unix.html">Installation on Unix-like systems</a></p> </li> -<li><p class="first">Microsoft Windows (Via "setup" style installer or from source code):</p> +<li><p>Microsoft Windows (Via "setup" style installer or from source code):</p> <p><a class="reference external" href="INSTALL-windows.html">Installation on Microsoft Windows</a></p> </li> </ul> @@ -109,20 +113,20 @@ get these programs or libraries. Note that these packages are already integrated into the GraphicsMagick Mercurial repository for use when building under Microsoft Windows:</p> <ul> -<li><p class="first">GraphicsMagick requires the BZLIB library from</p> +<li><p>GraphicsMagick requires the BZLIB library from</p> <blockquote> <p><a class="reference external" href="http://www.sourceware.org/bzip2/">http://www.sourceware.org/bzip2/</a></p> </blockquote> <p>to read and write BZip compressed MIFF images.</p> </li> -<li><p class="first">GraphicsMagick requires 'ralcgm' from</p> +<li><p>GraphicsMagick requires 'ralcgm' from</p> <blockquote> <p><a class="reference external" href="http://www.agocg.ac.uk/train/cgm/ralcgm.htm">http://www.agocg.ac.uk/train/cgm/ralcgm.htm</a></p> </blockquote> <p>to read the Computer Graphics Metafile (CGM) image format. You also need Ghostscript and Ghostscript Fonts (see below).</p> </li> -<li><p class="first">GraphicsMagick requires 'dcraw' (version 8.95 or later) from</p> +<li><p>GraphicsMagick requires 'dcraw' (version 8.95 or later) from</p> <blockquote> <p><a class="reference external" href="https://www.dechifro.org/dcraw/">https://www.dechifro.org/dcraw/</a></p> </blockquote> @@ -130,7 +134,7 @@ need Ghostscript and Ghostscript Fonts (see below).</p> automatically when used to read files using a common RAW file format extension.</p> </li> -<li><p class="first">GraphicsMagick requires 'fig2dev' provided in the transfig package +<li><p>GraphicsMagick requires 'fig2dev' provided in the transfig package from</p> <blockquote> <p><a class="reference external" href="http://mcj.sourceforge.net/">http://mcj.sourceforge.net/</a></p> @@ -138,14 +142,14 @@ from</p> <p>to read the Fig image format. Ghostscript and Ghostscript Fonts (see below) are also required.</p> </li> -<li><p class="first">GraphicsMagick requires the FreeType software, version 2.0 or above, +<li><p>GraphicsMagick requires the FreeType software, version 2.0 or above, available as</p> <blockquote> <p><a class="reference external" href="http://www.freetype.org/">http://www.freetype.org/</a></p> </blockquote> <p>to annotate with TrueType and Postscript Type 1 fonts.</p> </li> -<li><p class="first">GraphicsMagick requires Ghostscript software available from</p> +<li><p>GraphicsMagick requires Ghostscript software available from</p> <blockquote> <p><a class="reference external" href="https://ghostscript.com/releases/index.html">https://ghostscript.com/releases/index.html</a></p> </blockquote> @@ -190,7 +194,7 @@ GraphicsMagick, and all delegate libraries which depend on libjpeg, or convince Ghostscript to build against an unmodified installed JPEG library (and lose compatibility with some Postscript files).</p> </li> -<li><p class="first">GraphicsMagick requires hp2xx available from</p> +<li><p>GraphicsMagick requires hp2xx available from</p> <blockquote> <p><a class="reference external" href="http://www.gnu.org/software/hp2xx/hp2xx.html">http://www.gnu.org/software/hp2xx/hp2xx.html</a></p> </blockquote> @@ -198,41 +202,41 @@ JPEG library (and lose compatibility with some Postscript files).</p> format. HP printers usually accept PCL format rather than HPGL format. Ghostscript (see above) is also required.</p> </li> -<li><p class="first">GraphicsMagick requires the lcms library (2.0 or later) available +<li><p>GraphicsMagick requires the lcms library (2.0 or later) available from</p> <blockquote> <p><a class="reference external" href="http://www.littlecms.com/">http://www.littlecms.com/</a></p> </blockquote> <p>to perform ICC CMS color management.</p> </li> -<li><p class="first">GraphicsMagick requires Graphviz available from</p> +<li><p>GraphicsMagick requires Graphviz available from</p> <blockquote> <p><a class="reference external" href="http://www.graphviz.org/">http://www.graphviz.org/</a></p> </blockquote> <p>to read Graphvis 'dot' digraph files (with extension dot). Ghostscript (see above) is also required.</p> </li> -<li><p class="first">GraphicsMagick requires html2ps available from</p> +<li><p>GraphicsMagick requires html2ps available from</p> <blockquote> <p><a class="reference external" href="https://sourceforge.net/projects/html2ps/">https://sourceforge.net/projects/html2ps/</a></p> </blockquote> <p>to rasterize HTML files. Ghostscript (see above) is also required.</p> </li> -<li><p class="first">GraphicsMagick requires the JBIG-Kit software available via +<li><p>GraphicsMagick requires the JBIG-Kit software available via HTTP from</p> <blockquote> <p><a class="reference external" href="http://www.cl.cam.ac.uk/~mgk25/jbigkit/">http://www.cl.cam.ac.uk/~mgk25/jbigkit/</a></p> </blockquote> <p>to read and write the JBIG image format.</p> </li> -<li><p class="first">GraphicsMagick requires the WebP library version 0.1.99 (or later) +<li><p>GraphicsMagick requires the WebP library version 0.1.99 (or later) available via HTTPS from</p> <blockquote> <p><a class="reference external" href="https://developers.google.com/speed/webp/">https://developers.google.com/speed/webp/</a></p> </blockquote> <p>to read and write the WebP image format.</p> </li> -<li><p class="first">GraphicsMagick requires the Independent JPEG Group's software +<li><p>GraphicsMagick requires the Independent JPEG Group's software available from</p> <blockquote> <p><a class="reference external" href="http://www.ijg.org/">http://www.ijg.org/</a></p> @@ -250,12 +254,11 @@ is not compatible with standard lossless JPEG!).</p> <p>GraphicsMagick supports both 8-bit and 12-bit JPEG, but unfortunately it does not yet support both at once.</p> </li> -<li><p class="first">GraphicsMagick requires the JasPer Project's JasPer library from +<li><p>GraphicsMagick requires the JasPer Project's JasPer library from <a class="reference external" href="https://jasper-software.github.io/jasper/">https://jasper-software.github.io/jasper/</a> to read and write the JPEG-2000 format. Due to security concerns, using the latest -version of JasPer (3.0.0 or later) is recommended.</p> -</li> -<li><p class="first">On Unix-type systems, Windows/MinGW, and Windows/Cygwin, +version of JasPer (3.0.0 or later) is recommended.</p></li> +<li><p>On Unix-type systems, Windows/MinGW, and Windows/Cygwin, GraphicsMagick requires libltdl from libtool in order to support building GraphicsMagick with dynamically loadable modules. Libtool is available via anonymous FTP from</p> @@ -263,18 +266,17 @@ is available via anonymous FTP from</p> <p><a class="reference external" href="ftp://ftp.gnu.org/pub/gnu/libtool/">ftp://ftp.gnu.org/pub/gnu/libtool/</a></p> </blockquote> </li> -<li><p class="first">GraphicsMagick requires the MPEG utilities +<li><p>GraphicsMagick requires the MPEG utilities (<cite>mpeg2vidcodec_v12.tar.gz</cite>) from the MPEG Software Simulation Group -in order to read or write the MPEG image format.</p> -</li> -<li><p class="first">GraphicsMagick requires the LIBPNG library, version 1.0 or above, from</p> +in order to read or write the MPEG image format.</p></li> +<li><p>GraphicsMagick requires the LIBPNG library, version 1.0 or above, from</p> <blockquote> <p><a class="reference external" href="http://www.libpng.org/pub/png/pngcode.html">http://www.libpng.org/pub/png/pngcode.html</a></p> </blockquote> <p>to read or write the PNG, MNG, or JNG image formats. LIBPNG depends upon the ZLIB library (see below).</p> </li> -<li><p class="first">GraphicsMagick requires Sam Leffler's TIFF software available via +<li><p>GraphicsMagick requires Sam Leffler's TIFF software available via HTTP at</p> <blockquote> <p><a class="reference external" href="https://libtiff.gitlab.io/libtiff/">https://libtiff.gitlab.io/libtiff/</a></p> @@ -282,7 +284,7 @@ HTTP at</p> <p>to read the TIFF image format. It in turn optionally requires the JPEG and ZLIB libraries. Libtiff 3.8.2 or later is recommended.</p> </li> -<li><p class="first">GraphicsMagick may optionally use the TRIO library from</p> +<li><p>GraphicsMagick may optionally use the TRIO library from</p> <blockquote> <p><a class="reference external" href="http://sourceforge.net/projects/ctrio/">http://sourceforge.net/projects/ctrio/</a></p> </blockquote> @@ -293,7 +295,7 @@ replacement) is not used, then vsprintf is used instead, which decreases the security of GraphicsMagick due to possible buffer overrun exploits.</p> </li> -<li><p class="first">GraphicsMagick may optionally use the 'tcmalloc' library provided as +<li><p>GraphicsMagick may optionally use the 'tcmalloc' library provided as part of Google gperftools available from</p> <blockquote> <p><a class="reference external" href="https://github.com/gperftools/gperftools">https://github.com/gperftools/gperftools</a></p> @@ -305,7 +307,7 @@ Linux shows a doubling of performance with tcmalloc over the default glibc malloc when images are repeatedly allocated, cleared, and de-allocated.</p> </li> -<li><p class="first">GraphicsMagick may optionally use the umem memory allocation library +<li><p>GraphicsMagick may optionally use the umem memory allocation library which is included in Sun's Solaris operating system, and OpenSolaris/Illumos derivatives, or available from</p> <blockquote> @@ -317,7 +319,7 @@ programs and provides access to debugging features that detect memory leaks, buffer overruns, multiple frees, use of uninitialized data, use of freed data, and many other common programming errors.</p> </li> -<li><p class="first">GraphicsMagick requires libwmflite from libwmf 0.2.5 (or later) from</p> +<li><p>GraphicsMagick requires libwmflite from libwmf 0.2.5 (or later) from</p> <blockquote> <p><a class="reference external" href="http://sourceforge.net/projects/wvware/">http://sourceforge.net/projects/wvware/</a></p> </blockquote> @@ -348,7 +350,7 @@ for these fonts requires that they be distributed in the original non-Windows systems.</p> </blockquote> </li> -<li><p class="first">GraphicsMagick requires an X server for the 'display', 'animate', and +<li><p>GraphicsMagick requires an X server for the 'display', 'animate', and 'import' functions to work properly. Unix systems usually provide an X server as part of their standard installation. For MacOS-X, X11 is a system install time option.</p> @@ -359,14 +361,14 @@ available from</p> <p><a class="reference external" href="http://www.cygwin.com/">http://www.cygwin.com/</a></p> </blockquote> </li> -<li><p class="first">GraphicsMagick requires libxml2 available from</p> +<li><p>GraphicsMagick requires libxml2 available from</p> <blockquote> <p><a class="reference external" href="http://xmlsoft.org/">http://xmlsoft.org/</a></p> </blockquote> <p>to read the SVG image format and to retrieve files from over a network via FTP and HTTP.</p> </li> -<li><p class="first">GraphicsMagick requires the liblzma library from XZ Utils available from</p> +<li><p>GraphicsMagick requires the liblzma library from XZ Utils available from</p> <blockquote> <p><a class="reference external" href="https://www.tukaani.org/xz/">https://www.tukaani.org/xz/</a></p> </blockquote> @@ -375,13 +377,13 @@ features (yet to be developed). The utilities from this package are also necessary in order to decompress GraphicsMagick packages distributed with ".xz" or ".lzma" extensions.</p> </li> -<li><p class="first">GraphicsMagick requires the ZLIB library from</p> +<li><p>GraphicsMagick requires the ZLIB library from</p> <blockquote> <p><a class="reference external" href="http://www.zlib.net/">http://www.zlib.net/</a></p> </blockquote> <p>to read or write the PNG or Zip compressed MIFF images.</p> </li> -<li><p class="first">GraphicsMagick requires the Zstandard (Zstd) library from</p> +<li><p>GraphicsMagick requires the Zstandard (Zstd) library from</p> <blockquote> <p><a class="reference external" href="https://facebook.github.io/zstd/">https://facebook.github.io/zstd/</a></p> <blockquote> @@ -392,21 +394,21 @@ distributed with ".xz" or ".lzma" extensions.</p> <p>to read or write Zstd compressed TIFF images. In the future it is likely that other purposes will be found for Zstd.</p> </li> -<li><p class="first">GraphicsMagick may require the deflate library to link with libtiff.</p> +<li><p>GraphicsMagick may require the deflate library to link with libtiff.</p> <p>Libtiff may optionally depend on the libdeflate library (from <a class="reference external" href="https://github.com/ebiggers/libdeflate">https://github.com/ebiggers/libdeflate</a>). Linking with this library may be necessary for builds where libtiff depends on libdeflate.</p> </li> -<li><p class="first">GraphicsMagick requires the heif library from</p> +<li><p>GraphicsMagick requires the heif library from</p> <blockquote> <p><a class="reference external" href="https://github.com/strukturag/libheif">https://github.com/strukturag/libheif</a></p> <p>and the libde265 library from</p> <p><a class="reference external" href="https://github.com/strukturag/libde265">https://github.com/strukturag/libde265</a></p> </blockquote> -<p>to read HEIF/h.265 files. Libheif makes use of libde265 for -h.265/HEVC decoding and libx265 for encoding. GraphicsMagick does -not itself provide any h.265/HEVC algoriths and it does not -currently support encoding.</p> +<p>to read HEIF/h.265 files and HEIF/AVIF files. Libheif makes use of +libde265 for h.265/HEVC decoding and libx265 for encoding. +GraphicsMagick does not itself provide any h.265/HEVC algoriths and +it does not currently support encoding.</p> <p>The HEVC codec is covered by a huge number of patents (the MPEG LA HEVC patent list is 164 pages long!). While GraphicsMagick is unable to grant any patent usage rights to users or offer legal @@ -419,16 +421,19 @@ software patents. The user is responsible for assuring that some entity has paid to allow use of any applicable HEVC patents on their device, or that the patents do not apply in their country.</p> </li> -<li><p class="first">GraphicsMagick requires the JPEG XL library from -<a class="reference external" href="https://github.com/libjxl/libjxl">https://github.com/libjxl/libjxl</a> to read and write JPEG XL files.</p> -</li> +<li><p>GraphicsMagick requires the JPEG XL (JXL) library (release 0.7.0 or +later) from <a class="reference external" href="https://github.com/libjxl/libjxl">https://github.com/libjxl/libjxl</a> to read and write JPEG +XL files.</p></li> </ul> </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> |