github.com/kaydxh/golang@v0.0.131/pkg/gocv/cgo/third_path/graphics-magick/share/doc/GraphicsMagick/www/tools.html (about) 1 <?xml version="1.0" encoding="utf-8" ?> 2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> 4 <head> 5 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 6 <meta name="generator" content="Docutils 0.15.2: http://docutils.sourceforge.net/" /> 7 <title>GraphicsMagick Tools</title> 8 <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 Photo CD. 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" /> 9 <meta content="GraphicsMagick, Image Magick, Image Magic, PerlMagick, Perl Magick, Perl Magic, image processing, software development, image, software, Magick++" name="keywords" /> 10 <link rel="stylesheet" href="docutils-articles.css" type="text/css" /> 11 </head> 12 <body> 13 14 <div class="banner"> 15 <img src="images/gm-107x76.png" alt="GraphicMagick logo" width="107" height="76" /> 16 <span class="title">GraphicsMagick</span> 17 <form action="http://www.google.com/search"> 18 <input type="hidden" name="domains" value="www.graphicsmagick.org" /> 19 <input type="hidden" name="sitesearch" value="www.graphicsmagick.org" /> 20 <span class="nowrap"><input type="text" name="q" size="25" maxlength="255" /> <input type="submit" name="sa" value="Search" /></span> 21 </form> 22 </div> 23 24 <div class="navmenu"> 25 <ul> 26 <li><a href="index.html">Home</a></li> 27 <li><a href="project.html">Project</a></li> 28 <li><a href="download.html">Download</a></li> 29 <li><a href="README.html">Install</a></li> 30 <li><a href="Hg.html">Source</a></li> 31 <li><a href="NEWS.html">News</a> </li> 32 <li><a href="utilities.html">Utilities</a></li> 33 <li><a href="programming.html">Programming</a></li> 34 <li><a href="reference.html">Reference</a></li> 35 </ul> 36 </div> 37 <div class="document" id="graphicsmagick-tools"> 38 <h1 class="title">GraphicsMagick Tools</h1> 39 40 <!-- -*- mode: rst -*- --> 41 <!-- This text is in reStucturedText format, so it may look a bit odd. --> 42 <!-- See http://docutils.sourceforge.net/rst.html for details. --> 43 <div class="contents local topic" id="contents"> 44 <ul class="simple"> 45 <li><a class="reference internal" href="#animate-animate-a-sequence-of-images" id="id2">Animate: animate a sequence of images</a></li> 46 <li><a class="reference internal" href="#compare-compare-two-images-using-statistics-and-or-visual-differencing" id="id3">Compare: compare two images using statistics and/or visual differencing</a></li> 47 <li><a class="reference internal" href="#composite-composite-images-together" id="id4">Composite: composite images together</a></li> 48 <li><a class="reference internal" href="#conjure-execute-a-magick-scripting-language-msl-xml-script" id="id5">Conjure: execute a Magick Scripting Language (MSL) XML script</a></li> 49 <li><a class="reference internal" href="#convert-convert-an-image-or-sequence-of-images" id="id6">Convert: convert an image or sequence of images</a></li> 50 <li><a class="reference internal" href="#display-display-an-image-on-a-workstation-running-x" id="id7">Display: display an image on a workstation running X</a></li> 51 <li><a class="reference internal" href="#identify-describe-an-image-or-image-sequence" id="id8">Identify: describe an image or image sequence</a></li> 52 <li><a class="reference internal" href="#import-capture-an-application-or-x-server-screen" id="id9">Import: capture an application or X server screen</a></li> 53 <li><a class="reference internal" href="#mogrify-transform-an-image-or-sequence-of-images" id="id10">Mogrify: transform an image or sequence of images</a></li> 54 <li><a class="reference internal" href="#montage-create-a-composite-image-in-a-grid-from-separate-images" id="id11">Montage: create a composite image (in a grid) from separate images</a></li> 55 </ul> 56 </div> 57 <div class="section" id="animate-animate-a-sequence-of-images"> 58 <h1><a class="toc-backref" href="#id2">Animate: animate a sequence of images</a></h1> 59 <p><a class="reference external" href="animate.html">Animate</a> displays a sequence of images or an animation on any display 60 running an X server.</p> 61 </div> 62 <div class="section" id="compare-compare-two-images-using-statistics-and-or-visual-differencing"> 63 <h1><a class="toc-backref" href="#id3">Compare: compare two images using statistics and/or visual differencing</a></h1> 64 <p><a class="reference external" href="compare.html">Compare</a> compares two images using either a specified standard 65 statistical metric (MAE, MSE, PAE, PSNR, RMSE), or a specified visual 66 differencing method (assign, threshold, tint, xor). The statistical 67 comparison produces a textual display of metric values while the visual 68 differencing method writes a difference image with the differences 69 annotated using the specified algorithm. For example:</p> 70 <pre class="literal-block"> 71 % gm convert input.jpg -blur 0x1.5 output.jpg 72 % gm compare -metric MSE input.jpg output.jpg 73 Image Difference (MeanSquaredError): 74 Normalized Absolute 75 ============ ========== 76 Red: 0.0014374614 94.2 77 Green: 0.0014396270 94.3 78 Blue: 0.0014464548 94.8 79 Total: 0.0014411811 94.4 80 </pre> 81 </div> 82 <div class="section" id="composite-composite-images-together"> 83 <h1><a class="toc-backref" href="#id4">Composite: composite images together</a></h1> 84 <p><a class="reference external" href="composite.html">Composite</a> blends and merges images to create new images.</p> 85 </div> 86 <div class="section" id="conjure-execute-a-magick-scripting-language-msl-xml-script"> 87 <h1><a class="toc-backref" href="#id5">Conjure: execute a Magick Scripting Language (MSL) XML script</a></h1> 88 <p><a class="reference external" href="conjure.html">Conjure</a> interprets and executes scripts in the Magick Scripting Language 89 (MSL). The interpreter is called conjure and here is an example script:</p> 90 <pre class="literal-block"> 91 <?xml version="1.0" encoding="UTF-8"?> 92 <image size="400x400" > 93 <read filename="image.gif" /> 94 <get width="base-width" height="base-height" /> 95 <resize geometry="%[dimensions]" /> 96 <get width="width" height="height" /> 97 <print output= 98 "Image sized from %[base-width]x%[base-height] 99 to %[width]x%[height].\n" /> 100 <write filename="image.png" /> 101 </image> 102 </pre> 103 <p>which is invoked like</p> 104 <pre class="literal-block"> 105 conjure -dimensions 400x400 incantation.msl 106 </pre> 107 <p>All operations closely follow the key/value pairs defined in the 108 <a class="reference external" href="perl.html">PerlMagick</a> documentation, unless otherwise noted.</p> 109 </div> 110 <div class="section" id="convert-convert-an-image-or-sequence-of-images"> 111 <h1><a class="toc-backref" href="#id6">Convert: convert an image or sequence of images</a></h1> 112 <p><a class="reference external" href="convert.html">Convert</a> converts an input file using one image format to an output file 113 with using any of the supported writeable image formats. A large number 114 of image processing operations may be performed on the image before it is 115 written. By default, the input image format is determined by its magic 116 number. To specify a particular image format, precede the filename with 117 an image format name and a colon (i.e. ps:image) or specify the image 118 type as the filename suffix (i.e. image.ps). Specify file as - for 119 standard input or output. If file has the extension .Z, the file is 120 decoded with uncompress. For example:</p> 121 <pre class="literal-block"> 122 % gm convert input.jpg -rotate 90 rotated.tiff 123 </pre> 124 </div> 125 <div class="section" id="display-display-an-image-on-a-workstation-running-x"> 126 <h1><a class="toc-backref" href="#id7">Display: display an image on a workstation running X</a></h1> 127 <p><a class="reference external" href="display.html">Display</a> is a machine architecture independent image processing and 128 display program. It can display an image on any workstation display 129 running an X server. The image can be displayed as background image of 130 any window.</p> 131 </div> 132 <div class="section" id="identify-describe-an-image-or-image-sequence"> 133 <h1><a class="toc-backref" href="#id8">Identify: describe an image or image sequence</a></h1> 134 <p><a class="reference external" href="identify.html">Identify</a> describes the format and characteristics of one or more image 135 files. It will also report if an image is incomplete or corrupt. The 136 information displayed includes the scene number, the file name, the width 137 and height of the image, whether the image is colormapped or not, the 138 number of colors in the image, the number of bytes in the image, the 139 format of the image (JPEG, PNM, etc.), and finally the number of seconds 140 it took to read and process the image. For example:</p> 141 <pre class="literal-block"> 142 % gm identify tiger-1200-rgb16.tiff 143 tiger-1200-rgb16.tiff TIFF 9083x9450+0+0 DirectClass 16-bit 491.2M 0.000u 0:01 144 </pre> 145 </div> 146 <div class="section" id="import-capture-an-application-or-x-server-screen"> 147 <h1><a class="toc-backref" href="#id9">Import: capture an application or X server screen</a></h1> 148 <p><a class="reference external" href="import.html">Import</a> reads an image from any visible window on an X server and outputs 149 it as an image file. You can capture a single window, the entire screen, 150 or any rectangular portion of the screen.</p> 151 <p>The target window can be specified by id, name, or may be selected by 152 clicking the mouse in the desired window. If you press a button and then 153 drag, a rectangle will form which expands and contracts as the mouse 154 moves. To save the portion of the screen defined by the rectangle, just 155 release the button. The keyboard bell is rung once at the beginning of 156 the screen capture and twice when it completes. For example:</p> 157 <pre class="literal-block"> 158 % gm import capture.tiff 159 </pre> 160 </div> 161 <div class="section" id="mogrify-transform-an-image-or-sequence-of-images"> 162 <h1><a class="toc-backref" href="#id10">Mogrify: transform an image or sequence of images</a></h1> 163 <p><a class="reference external" href="mogrify.html">Mogrify</a> transforms an image or a sequence of images "in place". These 164 transforms include image scaling, image rotation, color reduction, and 165 others. The transmogrified image overwrites the original image. <a class="reference external" href="mogrify.html">Mogrify</a> 166 is very similar to <a class="reference external" href="convert.html">Convert</a> except that it can operate on many images at 167 once, and overwrites the input files by default. However, <a class="reference external" href="mogrify.html">Mogrify</a> may 168 also be used to convert file formats, and send modified files to another 169 directory. For example, the following reads several JPEG files and writes 170 a rotated version of them in TIFF format:</p> 171 <pre class="literal-block"> 172 % gm mogrify -rotate 90 -format tiff image1.jpg image2.jpg image3.jpg 173 </pre> 174 </div> 175 <div class="section" id="montage-create-a-composite-image-in-a-grid-from-separate-images"> 176 <h1><a class="toc-backref" href="#id11">Montage: create a composite image (in a grid) from separate images</a></h1> 177 <p><a class="reference external" href="montage.html">Montage</a> creates a composite by combining several separate images. The 178 images are tiled on a composite image with the name of the image and its 179 properties optionally appearing just below the individual tile.</p> 180 <p>Copyright © GraphicsMagick Group 2002 - 2020</p> 181 </div> 182 </div> 183 </body> 184 </html>