GraphicsMagick: Remove references to ftp.graphicsmagick.org
GraphicsMagick Commits <[email protected]>
| Newsgroups | gmane.comp.video.graphicsmagick.cvs |
|---|---|
| Message-ID | <mailman.31556.1638632613.2008.graphicsmagick-commit@lists.sourceforge.net> |
changeset 31fa0b9bdeb4 in /hg/GraphicsMagick details: http://hg.GraphicsMagick.org/hg/GraphicsMagick?cmd=changeset;node=31fa0b9bdeb4 summary: Remove references to ftp.graphicsmagick.org diffstat: ChangeLog | 6 + README.txt | 29 +- VisualMagick/installer/inc/version.isx | 4 +- magick/version.h | 4 +- www/Changelog.html | 5 + www/Changes.html | 75 +++ www/FAQ.html | 794 +++++++++++++++++++++++++++++++++ www/INSTALL-windows.html | 791 ++++++++++++++++++++++++++++++++ www/ImageMagickObject.html | 136 +++++ www/README.html | 32 +- www/api/attribute.html | 4 +- www/api/memory.html | 4 +- www/api/profile.html | 4 +- www/api/render.html | 4 +- www/download.html | 67 +-- www/download.rst | 77 +-- www/formats.html | 2 +- www/index.html | 3 - www/index.rst | 3 - 19 files changed, 1858 insertions(+), 186 deletions(-) diffs (truncated from 2290 to 500 lines): diff -r b8fe54431aef -r 31fa0b9bdeb4 ChangeLog --- a/ChangeLog Fri Dec 03 16:37:01 2021 -0600 +++ b/ChangeLog Sat Dec 04 09:43:07 2021 -0600 @@ -1,3 +1,9 @@ +2021-12-04 Bob Friesenhahn <[email protected]> + + * www/download.rst, www/index.rst, README.txt: Remove references + to ftp.graphicsmagick.org, which was shut down due to continuing + abusive practices and lack of support from the user community. + 2021-12-03 Bob Friesenhahn <[email protected]> * magick/memory-private.h diff -r b8fe54431aef -r 31fa0b9bdeb4 README.txt --- a/README.txt Fri Dec 03 16:37:01 2021 -0600 +++ b/README.txt Sat Dec 04 09:43:07 2021 -0600 @@ -27,16 +27,15 @@ Availability ------------ -The master ftp site for GraphicsMagick distributions is -ftp://ftp.graphicsmagick.org/pub/GraphicsMagick/. Bandwidth on this -site is very limited, so it is recommended to download from SourceForge -at http://sourceforge.net/projects/graphicsmagick/files/ if -possible. +GraphicsMagick release files may be downloaded from SourceForge +at http://sourceforge.net/projects/graphicsmagick/files/. GraphicsMagick is a continual work in progress. The very latest code is available via the Mercurial distributed source control management tool (https://www.mercurial-scm.org/). GraphicsMagick may be retrieved -via the following command: +from OSDN or SourceForge via the following commands: + + hg clone https://hg.osdn.net/view/graphicsmagick/GM GM hg clone http://hg.code.sf.net/p/graphicsmagick/code/ GM @@ -223,15 +222,6 @@ GraphicsMagick supports both 8-bit and 12-bit JPEG, but unfortunately it does not yet support both at once. - Apply this JPEG patch to Independent JPEG Group's (6b release!) - source distribution if you want to read lossless jpeg-encoded DICOM - (medical) images: - - ftp://ftp.graphicsmagick.org/pub/GraphicsMagick/delegates/ljpeg-6b.tar.gz - - Use of lossless JPEG is not encouraged. Unless you have a requirement - to read lossless jpeg-encoded DICOM images, please disregard the patch. - * GraphicsMagick requires the JasPer Project's JasPer library from https://jasper-software.github.io/jasper/ (although older versions back to 1.701.0 are still available via http from the original web @@ -251,12 +241,9 @@ ftp://ftp.gnu.org/pub/gnu/libtool/ -* GraphicsMagick requires the MPEG utilities from the MPEG Software - Simulation Group, which are available via anonymous FTP as - - ftp://ftp.GraphicsMagick.org/pub/GraphicsMagick/delegates/mpeg2vidcodec_v12.tar.gz - - to read or write the MPEG image format. +* GraphicsMagick requires the MPEG utilities + (`mpeg2vidcodec_v12.tar.gz`) from the MPEG Software Simulation Group + in order to read or write the MPEG image format. * GraphicsMagick requires the LIBPNG library, version 1.0 or above, from diff -r b8fe54431aef -r 31fa0b9bdeb4 VisualMagick/installer/inc/version.isx --- a/VisualMagick/installer/inc/version.isx Fri Dec 03 16:37:01 2021 -0600 +++ b/VisualMagick/installer/inc/version.isx Sat Dec 04 09:43:07 2021 -0600 @@ -10,5 +10,5 @@ #define public MagickPackageName "GraphicsMagick" #define public MagickPackageVersion "1.4" -#define public MagickPackageVersionAddendum ".020211203" -#define public MagickPackageReleaseDate "snapshot-20211203" +#define public MagickPackageVersionAddendum ".020211204" +#define public MagickPackageReleaseDate "snapshot-20211204" diff -r b8fe54431aef -r 31fa0b9bdeb4 magick/version.h --- a/magick/version.h Fri Dec 03 16:37:01 2021 -0600 +++ b/magick/version.h Sat Dec 04 09:43:07 2021 -0600 @@ -38,8 +38,8 @@ #define MagickLibVersion 0x252200 #define MagickLibVersionText "1.4" #define MagickLibVersionNumber 25,22,0 -#define MagickChangeDate "20211203" -#define MagickReleaseDate "snapshot-20211203" +#define MagickChangeDate "20211204" +#define MagickReleaseDate "snapshot-20211204" /* The MagickLibInterfaceNewest and MagickLibInterfaceOldest defines diff -r b8fe54431aef -r 31fa0b9bdeb4 www/Changelog.html --- a/www/Changelog.html Fri Dec 03 16:37:01 2021 -0600 +++ b/www/Changelog.html Sat Dec 04 09:43:07 2021 -0600 @@ -35,6 +35,11 @@ <div class="document"> +<p>2021-12-04 Bob Friesenhahn <<a class="reference external" href="mailto:bfriesen%40simple.dallas.tx.us">bfriesen<span>@</span>simple<span>.</span>dallas<span>.</span>tx<span>.</span>us</a>></p> +<blockquote> +* www/download.rst, www/index.rst, README.txt: Remove references +to ftp.graphicsmagick.org, which was shut down due to continuing +abusive practices and lack of support from the user community.</blockquote> <p>2021-12-03 Bob Friesenhahn <<a class="reference external" href="mailto:bfriesen%40simple.dallas.tx.us">bfriesen<span>@</span>simple<span>.</span>dallas<span>.</span>tx<span>.</span>us</a>></p> <blockquote> <p>* magick/memory-private.h diff -r b8fe54431aef -r 31fa0b9bdeb4 www/Changes.html --- a/www/Changes.html Fri Dec 03 16:37:01 2021 -0600 +++ b/www/Changes.html Sat Dec 04 09:43:07 2021 -0600 @@ -0,0 +1,75 @@ +<?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"> +<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 Change Logs</title> +<meta content="GraphicsMagick is a robust collection of tools and libraries to read, write, and manipulate an image in any of the more popular image formats including GIF, JPEG, PNG, PDF, and WebP. With GraphicsMagick you can create GIFs dynamically making it suitable for Web applications. You can also resize, rotate, sharpen, color reduce, or add special effects to an image and save your completed work in the same or differing image format. " name="description" /> +<meta content="GraphicsMagick, GM, PerlMagick, Perl Magick, Perl Magic, image processing, software development, TclMagick, Magick++" name="keywords" /> +<link rel="stylesheet" href="docutils-articles.css" type="text/css" /> +</head> +<body> + +<div class="banner"> +<img src="images/gm-107x76.png" alt="GraphicMagick logo" width="107" height="76" /> +<span class="title">GraphicsMagick</span> +<form action="http://www.google.com/search"> + <input type="hidden" name="domains" value="www.graphicsmagick.org" /> + <input type="hidden" name="sitesearch" value="www.graphicsmagick.org" /> +<span class="nowrap"><input type="text" name="q" size="25" maxlength="255" /> <input type="submit" name="sa" value="Search" /></span> +</form> +</div> + +<div class="navmenu"> +<ul> + <li><a href="index.html">Home</a></li> + <li><a href="project.html">Project</a></li> + <li><a href="download.html">Download</a></li> + <li><a href="README.html">Install</a></li> + <li><a href="Hg.html">Source</a></li> + <li><a href="NEWS.html">News</a> </li> + <li><a href="utilities.html">Utilities</a></li> + <li><a href="programming.html">Programming</a></li> + <li><a href="reference.html">Reference</a></li> +</ul> +</div> +<div class="document" id="graphicsmagick-change-logs"> +<h1 class="title">GraphicsMagick Change Logs</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. --> +<p>The following are the <tt class="docutils literal">GraphicsMagick</tt> change logs since 2001:</p> +<blockquote> +<ul class="simple"> +<li><a class="reference external" href="Changelog.html">2020</a> (1.3.35, 1.3.36 released)</li> +<li><a class="reference external" href="ChangeLog-2019.html">2019</a> (1.3.32, 1.3.33, 1.3.34 released)</li> +<li><a class="reference external" href="ChangeLog-2018.html">2018</a> (1.3.28, 1.3.29, 1.3.30, 1.3.31 released)</li> +<li><a class="reference external" href="ChangeLog-2017.html">2017</a> (1.3.26, 1.3.27, 1.3.27a released)</li> +<li><a class="reference external" href="ChangeLog-2016.html">2016</a> (1.3.24, 1.3.25 released)</li> +<li><a class="reference external" href="ChangeLog-2015.html">2015</a> (1.3.21 - 1.3.23 released)</li> +<li><a class="reference external" href="ChangeLog-2014.html">2014</a> (1.3.20 released)</li> +<li><a class="reference external" href="ChangeLog-2013.html">2013</a> (1.3.18 - 1.3.19 released)</li> +<li><a class="reference external" href="ChangeLog-2012.html">2012</a> (1.3.14 - 1.3.17 released)</li> +<li><a class="reference external" href="ChangeLog-2011.html">2011</a> (1.3.13 released)</li> +<li><a class="reference external" href="ChangeLog-2010.html">2010</a> (1.2.10, 1.3.8 - 1.3.12 released)</li> +<li><a class="reference external" href="ChangeLog-2009.html">2009</a> (1.3.4 - 1.3.7 released)</li> +<li><a class="reference external" href="ChangeLog-2008.html">2008</a> (1.1.11 - 1.1.14, 1.2 - 1.2.9, 1.3 - 1.3.3 released)</li> +<li><a class="reference external" href="ChangeLog-2007.html">2007</a> (1.1.8 - 1.1.10 released)</li> +<li><a class="reference external" href="ChangeLog-2006.html">2006</a></li> +<li><a class="reference external" href="ChangeLog-2005.html">2005</a> (1.1.5 - 1.1.7 released)</li> +<li><a class="reference external" href="ChangeLog-2004.html">2004</a> (1.0.5 - 1.0.6, 1.1 - 1.1.4 released)</li> +<li><a class="reference external" href="ChangeLog-2003.html">2003</a> (1.0 - 1.0.4 released)</li> +<li><a class="reference external" href="ChangeLog-2002.html">2002</a></li> +<li><a class="reference external" href="ChangeLog-2001.html">2001</a></li> +</ul> +</blockquote> +</div> + +<hr class="docutils"> +<div class="document"> + <p><a href="Copyright.html">Copyright</a> © GraphicsMagick Group 2002 - 2021<!--SPONSOR_LOGO--></p> +</div> +</body> +</html> diff -r b8fe54431aef -r 31fa0b9bdeb4 www/FAQ.html --- a/www/FAQ.html Fri Dec 03 16:37:01 2021 -0600 +++ b/www/FAQ.html Sat Dec 04 09:43:07 2021 -0600 @@ -0,0 +1,794 @@ +<?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"> +<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 FAQ</title> +<link rel="stylesheet" href="docutils-articles.css" type="text/css" /> +</head> +<body> + +<div class="banner"> +<img src="images/gm-107x76.png" alt="GraphicMagick logo" width="107" height="76" /> +<span class="title">GraphicsMagick</span> +<form action="http://www.google.com/search"> + <input type="hidden" name="domains" value="www.graphicsmagick.org" /> + <input type="hidden" name="sitesearch" value="www.graphicsmagick.org" /> +<span class="nowrap"><input type="text" name="q" size="25" maxlength="255" /> <input type="submit" name="sa" value="Search" /></span> +</form> +</div> + +<div class="navmenu"> +<ul> + <li><a href="index.html">Home</a></li> + <li><a href="project.html">Project</a></li> + <li><a href="download.html">Download</a></li> + <li><a href="README.html">Install</a></li> + <li><a href="Hg.html">Source</a></li> + <li><a href="NEWS.html">News</a> </li> + <li><a href="utilities.html">Utilities</a></li> + <li><a href="programming.html">Programming</a></li> + <li><a href="reference.html">Reference</a></li> +</ul> +</div> +<div class="document" id="graphicsmagick-faq"> +<h1 class="title">GraphicsMagick FAQ</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. --> +<!-- URL links --> +<div class="contents topic" id="faq-contents"> +<p class="topic-title">FAQ Contents</p> +<ul class="simple"> +<li><a class="reference internal" href="#how-does-graphicsmagick-differ-from-imagemagick" id="id1">How does GraphicsMagick differ from ImageMagick?</a></li> +<li><a class="reference internal" href="#how-often-does-graphicsmagick-pick-up-new-code-from-imagemagick" id="id2">How often does GraphicsMagick pick up new code from ImageMagick?</a></li> +<li><a class="reference internal" href="#are-there-any-plans-to-use-opencl-or-cuda-to-use-a-gpu" id="id3">Are there any plans to use OpenCL or CUDA to use a GPU?</a></li> +<li><a class="reference internal" href="#what-is-the-meaning-of-magick" id="id4">What is the meaning of "magick"?</a></li> +<li><a class="reference internal" href="#how-can-i-process-many-files-at-once" id="id5">How can I process many files at once?</a></li> +<li><a class="reference internal" href="#i-received-the-following-message-delegation-failed-what-does-it-mean" id="id6">I received the following message, "?????? delegation failed ...". What does it mean?</a></li> +<li><a class="reference internal" href="#how-do-i-set-the-transparency-index-in-a-gif-image-so-it-displays-properly-within-mozilla" id="id7">How do I set the transparency index in a GIF image so it displays properly within Mozilla?</a></li> +<li><a class="reference internal" href="#how-can-i-stop-the-filenames-from-changing-in-the-title-bar-of-the-animate-1-image-window" id="id8">How can I stop the filenames from changing in the title bar of the animate(1) image window?</a></li> +<li><a class="reference internal" href="#the-image-grabbed-by-import-1-does-not-look-like-the-image-on-my-x-server-what-s-wrong" id="id9">The image grabbed by import(1) does not look like the image on my X server. What's wrong?</a></li> +<li><a class="reference internal" href="#how-do-i-animate-a-digital-yuv-image-sequence" id="id10">How do I animate a digital YUV image sequence?</a></li> +<li><a class="reference internal" href="#how-do-i-change-the-default-postscript-page-size" id="id11">How do I change the default <em>PostScript</em> page size?</a></li> +<li><a class="reference internal" href="#i-get-a-memory-allocation-error-what-can-i-do" id="id12">I get a memory allocation error. What can I do?</a></li> +<li><a class="reference internal" href="#how-do-i-concatenate-three-images-left-to-right-with-no-borders-frames-or-text" id="id13">How do I concatenate three images left-to-right with no borders, frames, or text?</a></li> +<li><a class="reference internal" href="#how-do-i-create-a-gif-animation-sequence-to-display-within-firefox" id="id14">How do I create a GIF animation sequence to display within Firefox?</a></li> +<li><a class="reference internal" href="#when-i-display-a-postscript-image-white-borders-are-trimmed" id="id15">When I display a <em>PostScript</em> image, white borders are trimmed.</a></li> +<li><a class="reference internal" href="#what-are-visual-image-directories-how-do-i-use-them" id="id16">What are visual image directories? How do I use them?</a></li> +<li><a class="reference internal" href="#how-can-i-include-the-window-frame-when-importing-a-window" id="id17">How can I include the window frame when importing a window?</a></li> +<li><a class="reference internal" href="#i-displayed-an-image-and-it-appears-as-one-solid-color-what-did-i-do-wrong" id="id18">I displayed an image and it appears as one solid color. What did I do wrong?</a></li> +<li><a class="reference internal" href="#i-received-the-following-message-library-is-not-available" id="id19">I received the following message, "???? library is not available...".</a></li> +<li><a class="reference internal" href="#i-want-to-inspect-the-values-of-the-matte-channel-within-my-image" id="id20">I want to inspect the values of the matte channel within my image.</a></li> +<li><a class="reference internal" href="#how-can-i-add-one-of-those-cool-bevels-to-my-image-that-i-see-used-on-the-web" id="id21">How can I add one of those cool bevels to my image that I see used on the Web?</a></li> +<li><a class="reference internal" href="#i-try-to-launch-display-from-my-window-manager-and-it-fails-what-s-up" id="id22">I try to launch display from my window manager and it fails. What's up?</a></li> +<li><a class="reference internal" href="#how-can-i-make-postscript-text-look-good" id="id23">How can I make Postscript text look good?</a></li> +<li><a class="reference internal" href="#how-can-i-annotate-an-image-with-text-that-is-2-to-3-inches-tall" id="id24">How can I annotate an image with text that is 2 to 3 inches tall?</a></li> +<li><a class="reference internal" href="#how-can-i-convert-my-gif-animation-sequence-to-individual-image-files" id="id25">How can I convert my GIF animation sequence to individual image files?</a></li> +<li><a class="reference internal" href="#how-can-i-remove-the-background-that-prints-around-my-image-when-i-display-it-with-firefox" id="id26">How can I remove the background that prints around my image when I display it with Firefox?</a></li> +<li><a class="reference internal" href="#how-do-i-create-a-gif-or-png-image-with-web-safe-colors" id="id27">How do I create a GIF or PNG image with Web safe colors?</a></li> +<li><a class="reference internal" href="#how-can-i-add-a-matte-layer-to-my-image" id="id28">How can I add a matte layer to my image?</a></li> +<li><a class="reference internal" href="#how-can-i-draw-with-text-using-convert-under-windows-nt" id="id29">How can I draw with text using 'convert' under Windows NT?</a></li> +<li><a class="reference internal" href="#why-are-my-jpeg-files-larger-than-expected" id="id30">Why are my JPEG files larger than expected?</a></li> +<li><a class="reference internal" href="#how-do-i-extract-a-single-image-from-a-multi-image-file" id="id31">How do I extract a single image from a multi-image file?</a></li> +<li><a class="reference internal" href="#how-can-i-extract-and-combine-cmyk-channels-in-a-cmyk-image" id="id32">How can I extract and combine CMYK channels in a CMYK image?</a></li> +<li><a class="reference internal" href="#how-can-i-create-a-solid-or-patterned-canvas-image" id="id33">How can I create a solid or patterned canvas image?</a></li> +<li><a class="reference internal" href="#what-does-identify-report" id="id34">What does <cite>identify</cite> report?</a></li> +</ul> +</div> +<div class="section" id="how-does-graphicsmagick-differ-from-imagemagick"> +<h1><a class="toc-backref" href="#id1">How does GraphicsMagick differ from ImageMagick?</a></h1> +<p><em>GraphicsMagick</em> is originally based on (forked from) ImageMagick +5.5.2 in November 2002, from the version distributed by ImageMagick +Studio LLC, which is itself forked in August 1999 from ImageMagick +developed by E. I. du Pont de Nemours and Company starting in +1992. Other than utilities being executed as sub-commands of the 'gm' +command, the command-line syntax and programming APIs remain entirely +upward compatible with ImageMagick 5.5.2. A better question might be +"<em>How does ImageMagick differ from ImageMagick?</em>" since ImageMagick +continues to alter and evolve its interfaces so they are no longer +completely compatible with earlier versions. While GraphicsMagick also +adds new features, it does so in a way which assures that existing +features work as they did before. ImageMagick focuses on adding new +functionality and features and has dramatically mutated several times +since the fork.</p> +<p>GraphicsMagick maintains a stable release branch, maintains a detailed +ChangeLog, and maintains a stable source repository with complete version +history so that changes are controlled, and changes between releases are +accurately described. GraphicsMagick provides continued support for a +release branch. ImageMagick does not offer any of these things.</p> +<p>Since GraphicsMagick is more stable, more time has been spent optimizing +and debugging its code.</p> +<p>GraphicsMagick is much smaller than ImageMagick and has dramatically +fewer dependencies on external libraries. For example, on the FreeBSD +operating system, a fully-featured install of GraphicsMagick depends +on 36 libraries whereas ImageMagick requires 64. GraphicsMagick's +installation footprint is 3-5X smaller than ImageMagick.</p> +<p>GraphicsMagick is usually faster than ImageMagick. The baseline execution +overhead for simple commands is much lower, and GraphicsMagick is also +more efficient at dealing with large images.</p> +</div> +<div class="section" id="how-often-does-graphicsmagick-pick-up-new-code-from-imagemagick"> +<h1><a class="toc-backref" href="#id2">How often does GraphicsMagick pick up new code from ImageMagick?</a></h1> +<p>GraphicsMagick never picks up new code from ImageMagick as distributed +by ImageMagick Studio LLC. Not long after the GraphicsMagick project +was started in November 2002, ImageMagick from ImageMagick Studio LLC +abandoned the MIT X11 style license it had been using since 1992, and +switched between several different licenses until it ended up with one +based on the Apache license, which is intended to penalize projects +which borrow some of its source code, or fork from it. Since that +time, GraphicsMagick has not incorporated any ImageMagick source code.</p> +<p>On November 27, 2003 ImageMagick Studio LLC applied to register +"ImageMagick" as its trademark, and it was awarded this registered +trademark (serial number 78333969) on August 30, 2005. Those who +re-distribute modified versions of "ImageMagick" (e.g. patched or +improved) under license as "ImageMagick" now face the risk of +arbitrary trademark infringement claims by ImageMagick Studio LLC.</p> +<p>Authors of new features are encouraged to independently contribute +their work to the GraphicsMagick project so that it can be released +under GraphicsMagick's MIT X11 style license without additional +encumberment. In order for a work to be accepted, it must have been +developed entirely outside the ImageMagick source base to avoid any +possibility of copyright taint.</p> +</div> +<div class="section" id="are-there-any-plans-to-use-opencl-or-cuda-to-use-a-gpu"> +<h1><a class="toc-backref" href="#id3">Are there any plans to use OpenCL or CUDA to use a GPU?</a></h1> +<p>It is well known that some math-intensive algorithms run very quickly +on video-card (and stand-alone) GPUs. Video card vendors encourage +you to buy an expensive video card with quite a lot of installed RAM +and modify applications to use the GPU via their proprietary or +limited-purpose APIs. GPUs are quite effective at producing images +for real-time display, such as for video games and virtual reality. +GraphicsMagick has been significantly updated to use multiple CPU +cores to speed up the image processing, and work continues to thread +the few remaining algorithms, or remove inefficiencies in algorithms +which don't see as much speed-up as they should. Linear speedup as +cores are added is typical for CPU-bound algorithms on well-designed +CPUs. Regardless, <a class="reference external" href="http://en.wikipedia.org/wiki/Amdal%27s_law">Amdahl's law</a> is a significant factor +in GraphicsMagick, with non-parallelizable code paths often dominating +the time.</p> +<p>It is my belief that stand-alone GPUs are a poor design (expensive, +inefficient, failure-prone, bandwidth bottlenecked, lack +functionality, are insecure, and are not supported in servers) and +that multi-core CPUs will ultimately prevail. Functionality which +currently works best in a GPU will simply be integrated into +tomorrow's multi-core CPUs and C compilers will naturally support that +functionality. Once GPU capabilities are integrated into CPUs, there +will be no more need to develop specialized code for a GPU. Today 16 +core CPUs are readily available for purchase in systems at reasonable +prices, and this trend is certain to continue.</p> +<p>Future multi-core CPUs will use a similar amount of power to today's +CPUs, will idle at very low power consumption levels, and will fit +into a very small chassis. Due to this trend, there is no value +obtained by expending energy toward developing specialized code for +today's GPUs in GraphicsMagick.</p> +</div> +<div class="section" id="what-is-the-meaning-of-magick"> +<h1><a class="toc-backref" href="#id4">What is the meaning of "magick"?</a></h1> +<p>According to the infamous British occultist <a class="reference external" href="http://en.wikipedia.org/wiki/Aleister_Crowley">Aleister Crowley</a>, the definition of +<a class="reference external" href="http://en.wikipedia.org/wiki/Magick_(Aleister_Crowley)">magick</a> is +"the science and art of causing change to occur in conformity with the +will".</p> +</div> +<div class="section" id="how-can-i-process-many-files-at-once"> +<h1><a class="toc-backref" href="#id5">How can I process many files at once?</a></h1> +<p>Use 'gm mogrify'. The 'mogrify' subcommand is designed to operate on +any number of files in one command. Normally 'mogrify' overwrites the +input files but the <cite>-output-directory</cite> option (which must appear +before any input file names!) allows sending the modified files to a +different directory (which could be in a subdirectory). For example:</p> +<pre class="literal-block"> +gm mogrify -output-directory .thumbs -resize 320x200 *.jpg +</pre> +<p>If you encounter command line length limitations then you can have +GraphicsMagick expand the file list by quoting the wildcard argument +to prevent it from being expanded by your command shell:</p> +<pre class="literal-block"> +gm mogrify -output-directory .thumbs -resize 320x200 "*.jpg" +</pre> +<p>and you can also retrieve a list of files to process from a text file +(e.g. named 'files.txt') like:</p> +<pre class="literal-block"> +gm mogrify -output-directory .thumbs -resize 320x200 @files.txt +</pre> +<p>where files.txt has one line per file name. If the input file paths +contain relative sub-directory paths (e.g. "foo/file1", "bar/file2"), +you can instruct GraphicsMagick to create a similar subdirectory +structure under the output directory by adding the +<cite>-create-directories</cite> option:</p> +<pre class="literal-block"> +gm mogrify -output-directory .thumbs -create-directories -resize 320x200 @files.txt +</pre> +<p>Note that the algorithm used to generate output file names is quite +simple. If -output-directory is "/foo" and the file path is +"bar/none.jpg" then the final path will be "foo/bar/none.jpg". Based +on this it should be clear that when <cite>-output-directory</cite> is used, file +paths should be relative paths rather than absolute paths or else the +concatenation won't work.</p> +</div> +<div class="section" id="i-received-the-following-message-delegation-failed-what-does-it-mean"> +<h1><a class="toc-backref" href="#id6">I received the following message, "?????? delegation failed ...". What does it mean?</a></h1> +<p><em>GraphicsMagick</em> uses several freely available packages to perform the +translation of certain image formats (<em>PostScript</em>, <em>MPEG</em>, etc.). Make +sure these packages are available as described in the <a class="reference external" href="README.html">README</a> file. Also +verify that you have plenty of temporary disk space. If not, set the +MAGICK_TMPDIR (or TMPDIR) environment variable to an area where +sufficient space is available. Finally, for <em>PostScript</em>, verify that +Ghostscript supports the <em>pnmraw</em> or <em>ppmraw</em> device (<tt class="docutils literal">gs <span class="pre">-h</span></tt>) and that +the document contains valid <em>PostScript</em> statements (<tt class="docutils literal">gs image.ps</tt>).</p> +</div> +<div class="section" id="how-do-i-set-the-transparency-index-in-a-gif-image-so-it-displays-properly-within-mozilla"> +<h1><a class="toc-backref" href="#id7">How do I set the transparency index in a GIF image so it displays properly within Mozilla?</a></h1> +<p>Display your GIF image with <a class="reference external" href="display.html">display</a>. Choose <em>Matte</em> from the <em>Image +Edit</em> command menu and identify a pixel that has the <em>transparency</em> +color. Press <em>Method</em> and select a matte edit method from a pop-up menu. +Choose from these methods:</p> +<ul class="simple"> +<li>point</li> +<li>replace</li> +<li>floodfill</li> +</ul> +<p>The <em>point</em> method changes the matte value of any pixel selected with the +pointer until the button is is released. The <em>replace</em> method changes the +matte value of any pixel that matches the color of the pixel you select +with a button press. <em>Floodfill</em> changes the matte value of any pixel +that matches the color of the pixel you select with a button press and is +a neighbor.</p> +<p>Select your transparent pixel with the pointer and press a button. The +image is redisplayed with any transparent pixels recolored to the +background color. You can select other pixels or areas to force to +transparent. When you are satisfied, press Return.</p> +<p>Finally, choose <em>Save</em> from the command menu and write your GIF image to +a file. <strong>Note that setting transparency works best on a TrueColor or +DirectColor visual</strong>. If your server only exports colormapped visuals you +will need to use a <em>Standard Colormap</em> to set transparency.</p> +<pre class="literal-block"> +xstdcmap -best +gm display -map list image.gif +[ choose Matte Edit ] +[ select your transparent pixel then press Return ] +[ choose Save ' +</pre> +<p>If you do not have the <em>xstdcmap(1)</em> program, try</p> +<pre class="literal-block"> +gm display -visual TrueColor image.gif +</pre> +</div> +<div class="section" id="how-can-i-stop-the-filenames-from-changing-in-the-title-bar-of-the-animate-1-image-window"> +<h1><a class="toc-backref" href="#id8">How can I stop the filenames from changing in the title bar of the animate(1) image window?</a></h1> +<p><a class="reference external" href="animate.html">Animate</a> updates the image file name in the title bar of the image window +as each image is displayed from the image sequence. To display just a +single name that will not change, use <em>-title</em>:</p> +<pre class="literal-block"> +gm animate -title "My Image Sequence" images. +</pre> +</div> +<div class="section" id="the-image-grabbed-by-import-1-does-not-look-like-the-image-on-my-x-server-what-s-wrong"> +<h1><a class="toc-backref" href="#id9">The image grabbed by import(1) does not look like the image on my X server. What's wrong?</a></h1> +<p>Use the <em>-descend</em> option:</p> +<pre class="literal-block"> +gm import -descend image.miff +</pre> +<p>or set this X resource:</p> +<pre class="literal-block"> +gm import.descend: True +</pre> +<p>By default, <a class="reference external" href="import.html">import</a> quickly grabs the image from the X server. However, +it may not always have the correct colors in some areas. This can happen +when a subwindow has a different colormap than its parent. With +<em>-descend</em>, <a class="reference external" href="import.html">import</a> descends the window hierarchy. Descending involves +grabbing the image and colormap of each window or subwindow associated +with the window you select and compositing it on a blank canvas. This can +be significantly slower than just grabbing the top-level window but +ensures the correct image.</p> +</div> +<div class="section" id="how-do-i-animate-a-digital-yuv-image-sequence"> +<h1><a class="toc-backref" href="#id10">How do I animate a digital YUV image sequence?</a></h1> +<p>Suppose your sequence is 72 352x240 frames titled frame0.Y, frame0.U, +frame0.V, frame1.Y, frame1.U, etc. Use this command:</p> +<pre class="literal-block"> +gm animate -geometry 352x240 -scene 0-71 yuv3:frame%d +</pre> +</div> +<div class="section" id="how-do-i-change-the-default-postscript-page-size"> +<h1><a class="toc-backref" href="#id11">How do I change the default <em>PostScript</em> page size?</a></h1> +<p>The default dimensions of a <em>PostScript</em> page is 612x792. If you prefer +another default, change the page geometries (PSPageGeometry) in +<cite>magick/image.h</cite> and recompile.</p> +</div> +<div class="section" id="i-get-a-memory-allocation-error-what-can-i-do"> +<h1><a class="toc-backref" href="#id12">I get a memory allocation error. What can I do?</a></h1> +<p>Memory allocation is a complex topic in GraphicsMagick and image +processing requires a lot of memory. GraphicsMagick tries to take best +advantage of the resources available by optimizing its use of <em>virtual</em> +memory. Virtual memory is normally the amount of RAM (Random Access +Memory) available to the process plus the amount of free space in the