Commit 5bf6732b authored by Cristy's avatar Cristy

...

parent 86de0213
......@@ -61,16 +61,14 @@
<p>ImageMagick provides a statically-built ImageMagick object as part of its <a href="download.html#windows">Windows installation package</a>. When this package is installed, ImageMagickObject and its sample programs are installed to this path:</p>
<pre><code>
c:\Program Files\ImageMagick-7.0.7-Q16\ImageMagickObject
<pre class="highlight"><code> c:\Program Files\ImageMagick-7.0.4-Q16\ImageMagickObject
</code></pre>
<p>The ImageMagickObject is registered if the checkbox, <code>Register ImageMagickObject</code>, is checked at install time.</p>
<p>To execute the sample program from the Windows Command Shell, type:</p>
<pre><code>
cscript SimpleTest.vbs
<pre class="highlight"><code>cscript SimpleTest.vbs
</code></pre>
<p>Since the ImageMagick utility command line parsers are incorporated within ImageMagickObject, please refer to the <a href="command-line-tools.html">command-line tools</a> discussion to learn how to use it. The sample VBS scripts show how the object should be called and used and have lots of comments.</p>
......@@ -85,8 +83,7 @@ cscript SimpleTest.vbs
<p>Once the VisualStaticMT project has been built, build the ImageMagickObject with this procedure:</p>
<pre><code>
cd ImageMagick/contrib/win32/ATL7/ImageMagickObject
<pre class="highlight"><code>cd ImageMagick/contrib/win32/ATL7/ImageMagickObject
BuildImageMagickObject release
</code></pre>
......@@ -94,14 +91,12 @@ BuildImageMagickObject release
<p>To register the DLL as a COM+ server, type</p>
<pre><code>
regsvr32 /c /s ImageMagickObject.dll
<pre class="highlight"><code>regsvr32 /c /s ImageMagickObject.dll
</code></pre>
<p>To unregister the DLL, type</p>
<pre><code>
regsvr32 /u /s ImageMagickObject.dll
<pre class="highlight"><code>regsvr32 /u /s ImageMagickObject.dll
</code></pre>
<p>Use MagickCMD to exercise ImageMagickObject to verify that it is working properly.</p>
......@@ -121,8 +116,9 @@ regsvr32 /u /s ImageMagickObject.dll
</footer>
</div><!-- /.container -->
<script src="https://localhost/ajax/libs/jquery/1.12.4/jquery.min.js"></script>
<script src="https://code.jquery.com/jquery-3.2.1.slim.min.js" integrity="sha384-KJ3o2DKtIkvYIK3UENzmM7KCkRr/rE9/Qpg6aAZGJwFDMVNA/GpGFF93hXpG5KkN" crossorigin="anonymous"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.11.0/umd/popper.min.js" integrity="sha384-b/U6ypiBEHpOf/4+1nzFpr53nxSS+GLCkfwBdFNTxtclqqenISfwAzpKaMNFNmj4" crossorigin="anonymous"></script>
<script src="../js/magick.html"></script>
</body>
</html>
<!-- Magick Cache 9th September 2017 08:02 -->
\ No newline at end of file
<!-- Magick Cache 8th October 2017 11:16 -->
\ No newline at end of file
This diff is collapsed.
......@@ -61,12 +61,11 @@
<p>Building ImageMagick source for Windows requires a modern version of Microsoft Visual Studio IDE. Users have reported success with the Borland C++ compiler as well. If you don't have a compiler you can still install a self-installing <a href="download.html#windows">binary release</a>.</p>
<p>Download <a href="https://www.imagemagick.org/download/windows/ImageMagick-windows.zip">ImageMagick-windows.zip</a> from <a href="https://www.imagemagick.org/download/windows">ftp.imagemagick.org</a> or its <a href="mirror.html">mirrors</a> and verify the distribution against its <a href="https://www.imagemagick.org/download/windows/digest.rdf">message digest</a>.</p>
<p>Download <a href="https://www.imagemagick.org/download/windows/ImageMagick-windows.zip">ImageMagick-windows.zip</a> from <a href="https://www.imagemagick.org/download/windows">ftp.imagemagick.org</a> or its <a href="download.html">mirrors</a> and verify the distribution against its <a href="https://www.imagemagick.org/download/windows/digest.rdf">message digest</a>.</p>
<p>You can unpack the distribution with <a href="http://www.winzip.com">WinZip</a> or type the following from any Command Prompt window:</p>
<pre><code>
unzip ImageMagick-windows.zip
<pre class="highlight"><code>unzip ImageMagick-windows.zip
</code></pre>
<p>Now that you have the ImageMagick Windows source distribution unpacked, let's configure it.</p>
......@@ -157,8 +156,7 @@ unzip ImageMagick-windows.zip
<p>With this feature enabled, you should be able to nab a copy of</p>
<pre><code>
VisualMagick\utilities\UTIL_convert_xxx_exe.dsp (for C) or
<pre class="highlight"><code>VisualMagick\utilities\UTIL_convert_xxx_exe.dsp (for C) or
VisualMagick\Magick++\demo\UTIL_demo_xxx_exe.dsp (for C++)
</code></pre>
......@@ -170,8 +168,7 @@ VisualMagick\Magick++\demo\UTIL_demo_xxx_exe.dsp (for C++)
<p>For straight C API command line applications use something from:</p>
<pre><code>
ImageMagick\tests or
<pre class="highlight"><code>ImageMagick\tests or
ImageMagick\utilities (source code) or
ImageMagick\VisualMagick\tests or
ImageMagick\Visualmagick\utilities (project - DSP)
......@@ -179,16 +176,14 @@ ImageMagick\Visualmagick\utilities (project - DSP)
<p>For C++ and Magick++ command line applications use something from:</p>
<pre><code>
ImageMagick\Magick++\tests or ImageMagick\Magick++\demo (source code) or
<pre class="highlight"><code>ImageMagick\Magick++\tests or ImageMagick\Magick++\demo (source code) or
ImageMagick\VisualMagick\Magick++\tests or <br/>
ImageMagick\VisualMagick\Magick++\demo (project - DSP)
</code></pre>
<p>For C++ and Magick++ and MFC windows applications use:</p>
<pre><code>
ImageMagick\contrib\win32\MFC\NtMagick (source code) or
<pre class="highlight"><code>ImageMagick\contrib\win32\MFC\NtMagick (source code) or
ImageMagick\VisualMagick\contrib\win32\MFC\NtMagick (project - DSP)
</code></pre>
......@@ -221,15 +216,13 @@ ImageMagick\VisualMagick\contrib\win32\MFC\NtMagick (project - DSP)
<p>This environmental variable sets the default list of places were Windows looks for EXE's and DLL's. Windows CMD shell seems to look in the <var>current</var> directory first no matter what, which may make it unnecessary to update the PATH. If you wish to run any of utilities from another location then you must add the path to your <code>bin</code> directory in. For instance, to do this for the default build environment like I do, you might add:</p>
<pre><code>
C:\ImageMagick\VisualMagick\bin
<pre class="highlight"><code>C:\ImageMagick\VisualMagick\bin
</code></pre>
<h4>MAGICK_HOME</h4>
<p>If all you do is modify the PATH variable, the first problem you will run into is that ImageMagick may not be able to find any of its <var>modules</var>. Modules are all the IM_MOD*.DLL files you see in the distribution. There is one of these for each and every file format that ImageMagick supports. This environment variable tells the system were to look for these DLL's. The compiled in <var>default</var> is <var>execution path</var> - which says - look in the same place that the application is running <var>in</var>. If you are running from somewhere other then <code>bin</code> - this will no longer work and you must use this variable. If you elect 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>
<pre><code>
C:\ImageMagick\coders
<pre class="highlight"><code>C:\ImageMagick\coders
</code></pre>
<p>This also the place were ImageMagick expects to find the <code>colors.xml</code>, <code>delegates.xml</code>, <code>magic.xml</code>, <code>modules.xml</code>, and <code>type.xml</code> files.</p>
......@@ -240,14 +233,12 @@ C:\ImageMagick\coders
<p>You can elect to changes these things the good old <var>hard-coded</var> way. This define is applicable in <code>magick-config.h</code>:</p>
<pre><code>
#define MagickConfigurePath "C:\\ImageMagick\\"
<pre class="highlight"><code>#define MagickConfigurePath "C:\\ImageMagick\\"
</code></pre>
<p>To view any image in a Microsoft window, type</p>
<pre><code>
magick image.ext win:
<pre class="highlight"><code>magick image.ext win:
</code></pre>
<p>Make sure <a href="http://www.cs.wisc.edu/~ghost/">Ghostscript</a> is installed, otherwise, you will be unable to convert or view a Postscript document, and Postscript standard fonts will not be available.</p>
......@@ -299,8 +290,7 @@ magick image.ext win:
<ol>
<li>Launch the Command Prompt application and move to the <code>contrib\win32\ATL7\ImageMagickObject</code> folder.</li>
<li>Build ImageMagickObject with these commands:
<pre><code>
BuildImageMagickObject clean
<pre class="highlight"><code>BuildImageMagickObject clean
BuildImageMagickObject release
</code></pre></li>
</ol>
......@@ -310,8 +300,7 @@ BuildImageMagickObject release
<ol>
<li>Launch the Command Prompt application and move to the <code>PerlMagick</code> folder.</li>
<li>Build PerlMagick with these commands:
<pre><code>
perl Makefile.PL
<pre class="highlight"><code>perl Makefile.PL
dmake release
</code></pre></li>
</ol>
......@@ -327,7 +316,7 @@ dmake release
<ol>
<li>Double-click on
<code>VisualMagick/bin/ImageMagick-7.0.7-0-Q16-windows-dll.exe</code>
<code>VisualMagick/bin/ImageMagick-7.0.4-0-Q16-windows-dll.exe</code>
to launch the ImageMagick binary distribution.</li>
<li>Complete the installer screens to install ImageMagick on your system.</li>
</ol>
......@@ -336,21 +325,17 @@ dmake release
<ol>
<li>Launch the Command Prompt application and move to the <code>PerlMagick</code> folder and type
<pre><code>
nmake test
<pre class="highlight"><code>nmake test
</code></pre></li>
<li>Move to the <code>VisualMagick/tests</code> folder and type
<pre><code>
validate
<pre class="highlight"><code>validate
</code></pre></li>
<li>Move to the <code>VisualMagick/Magick++/tests</code> folder and type
<pre><code>
run_tests.bat
<pre class="highlight"><code>run_tests.bat
</code></pre></li>
<li>Move to the <code>VisualMagick/Magick++/demo</code> folder and type
<pre><code>
run_demos.bat
<pre class="highlight"><code>run_demos.bat
</code></pre></li>
</ol>
......@@ -367,8 +352,7 @@ run_demos.bat
<p>The Windows <a href="download.html#windows">binary</a> distribution includes a number of demo projects that you can use as a template for your own custom project. For example, start with the Button project, generally located in the <code>c:/Program Files/ImageMagick-7.5.5-0/Magick++_demos</code> folder. If not, be sure to select <code>Configuration Properties->C/C++->Preprocessor</code> and set these definitions:</p>
<pre><code>
NDEBUG
<pre class="highlight"><code>NDEBUG
WIN32
_CONSOLE
_VISUALC_
......@@ -392,8 +376,9 @@ _MAGICKMOD_
</footer>
</div><!-- /.container -->
<script src="https://localhost/ajax/libs/jquery/1.12.4/jquery.min.js"></script>
<script src="https://code.jquery.com/jquery-3.2.1.slim.min.js" integrity="sha384-KJ3o2DKtIkvYIK3UENzmM7KCkRr/rE9/Qpg6aAZGJwFDMVNA/GpGFF93hXpG5KkN" crossorigin="anonymous"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.11.0/umd/popper.min.js" integrity="sha384-b/U6ypiBEHpOf/4+1nzFpr53nxSS+GLCkfwBdFNTxtclqqenISfwAzpKaMNFNmj4" crossorigin="anonymous"></script>
<script src="../js/magick.html"></script>
</body>
</html>
<!-- Magick Cache 9th September 2017 07:59 -->
\ No newline at end of file
<!-- Magick Cache 8th October 2017 11:17 -->
\ No newline at end of file
......@@ -61,14 +61,12 @@
<p>We list a few examples of the <code>animate</code> command here to illustrate its usefulness and ease of use. To get started, lets animate an image sequence in the GIF format:</p>
<pre><code>
magick animate movie.gif
<pre class="highlight"><code>magick animate movie.gif
</code></pre>
<p>To animate a directory of JPEG images, use:</p>
<pre><code>
magick animate *.jpg
<pre class="highlight"><code>magick animate *.jpg
</code></pre>
<p>You can find additional examples of using <code>animate</code> in <a href="https://www.imagemagick.org/Usage/basics/#animate">Examples of ImageMagick Usage</a>.</p>
......@@ -523,8 +521,9 @@ transparent, extract, background, or shape the alpha channel</td>
</footer>
</div><!-- /.container -->
<script src="https://localhost/ajax/libs/jquery/1.12.4/jquery.min.js"></script>
<script src="https://code.jquery.com/jquery-3.2.1.slim.min.js" integrity="sha384-KJ3o2DKtIkvYIK3UENzmM7KCkRr/rE9/Qpg6aAZGJwFDMVNA/GpGFF93hXpG5KkN" crossorigin="anonymous"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.11.0/umd/popper.min.js" integrity="sha384-b/U6ypiBEHpOf/4+1nzFpr53nxSS+GLCkfwBdFNTxtclqqenISfwAzpKaMNFNmj4" crossorigin="anonymous"></script>
<script src="../js/magick.html"></script>
</body>
</html>
<!-- Magick Cache 9th September 2017 08:02 -->
\ No newline at end of file
<!-- Magick Cache 8th October 2017 11:16 -->
\ No newline at end of file
......@@ -45,7 +45,7 @@
<a class="magick-nav-item " href="command-line-processing.html">Command-line</a>
<a class="magick-nav-item " href="resources.html">Resources</a>
<a class="magick-nav-item active" href="api.html">Develop</a>
<a class="magick-nav-item " href="https://www.imagemagick.org/script/https://www.imagemagick.org/script/search.php">Search</a>
<a class="magick-nav-item " href="https://www.imagemagick.org/script/search.php">Search</a>
<a class="magick-nav-item pull-right" href="http://www.imagemagick.org/discourse-server/">Community</a>
</nav>
</div>
......@@ -164,7 +164,7 @@
</p>
<p><a href="api.html#">Back to top</a>
<a href="http://pgp.mit.edu:11371/pks/lookup?op=get&amp;search=0x89AB63D48277377A">Public Key</a>
<a href="https://www.imagemagick.org/script/https://www.imagemagick.org/script/contact.php">Contact Us</a></p>
<a href="https://www.imagemagick.org/script/contact.php">Contact Us</a></p>
<p><small>© 1999-2016 ImageMagick Studio LLC</small></p>
</footer>
</div><!-- /.container -->
......
This diff is collapsed.
......@@ -45,7 +45,7 @@
<a class="magick-nav-item " href="command-line-processing.html">Command-line</a>
<a class="magick-nav-item " href="resources.html">Resources</a>
<a class="magick-nav-item " href="api.html">Develop</a>
<a class="magick-nav-item " href="https://www.imagemagick.org/script/https://www.imagemagick.org/script/search.php">Search</a>
<a class="magick-nav-item " href="https://www.imagemagick.org/script/search.php">Search</a>
<a class="magick-nav-item pull-right" href="http://www.imagemagick.org/discourse-server/">Community</a>
</nav>
</div>
......@@ -447,7 +447,7 @@ objShell.Exec("convert ""e:/myimages/image.png"" ""e:/myimages/image.jpg""")
</p>
<p><a href="binary-releases.html#">Back to top</a>
<a href="http://pgp.mit.edu:11371/pks/lookup?op=get&amp;search=0x89AB63D48277377A">Public Key</a>
<a href="https://www.imagemagick.org/script/https://www.imagemagick.org/script/contact.php">Contact Us</a></p>
<a href="https://www.imagemagick.org/script/contact.php">Contact Us</a></p>
<p><small>© 1999-2016 ImageMagick Studio LLC</small></p>
</footer>
</div><!-- /.container -->
......
This source diff could not be displayed because it is too large. You can view the blob instead.
......@@ -63,22 +63,19 @@
<p>Use the <a href="command-line-options.html#encipher">-encipher</a> option to scramble your image so that it is unrecognizable. The option requires a filename that contains your passphrase. In this example we scramble an image and save it in the PNG format:</p>
<pre><code>
convert rose.jpg -encipher passphrase.txt rose.png
<pre class="highlight"><code>convert rose.jpg -encipher passphrase.txt rose.png
</code></pre>
<p>Here we encipher an image using another image as the passphrase:</p>
<pre><code>
convert rose.jpg -encipher smiley.gif rose.png
<pre class="highlight"><code>convert rose.jpg -encipher smiley.gif rose.png
</code></pre>
<h2 class="magick-post-title"><a id="decipher"></a>Decipher an Image</h2>
<p>Use the <a href="command-line-options.html#decipher">-decipher</a> option to unscramble your image so that it is recognizable once again. The option requires a filename that contains your passphrase. In this example we unscramble an image and save it in the JPEG format:</p>
<pre><code>
convert rose.png -decipher passphrase.txt rose.jpg
<pre class="highlight"><code>convert rose.png -decipher passphrase.txt rose.jpg
</code></pre>
<h2 class="magick-post-title"><a id="caveats"></a>Encipher and Decipher Caveats</h2>
......@@ -131,8 +128,9 @@ Examples <a href="https://www.imagemagick.org/Usage/transform/#encipher"
</footer>
</div><!-- /.container -->
<script src="https://localhost/ajax/libs/jquery/1.12.4/jquery.min.js"></script>
<script src="https://code.jquery.com/jquery-3.2.1.slim.min.js" integrity="sha384-KJ3o2DKtIkvYIK3UENzmM7KCkRr/rE9/Qpg6aAZGJwFDMVNA/GpGFF93hXpG5KkN" crossorigin="anonymous"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.11.0/umd/popper.min.js" integrity="sha384-b/U6ypiBEHpOf/4+1nzFpr53nxSS+GLCkfwBdFNTxtclqqenISfwAzpKaMNFNmj4" crossorigin="anonymous"></script>
<script src="../js/magick.html"></script>
</body>
</html>
<!-- Magick Cache 9th September 2017 08:01 -->
\ No newline at end of file
<!-- Magick Cache 8th October 2017 11:16 -->
\ No newline at end of file
......@@ -54,50 +54,50 @@
<div class="container">
<div class="magick-header">
<p class="lead magick-description">Color management has changed significantly between ImageMagick version 6.7.5-5 and 6.8.0-3 in order to better conform to color and grayscale standards.</p>
<p>The first major change was to swap -colorspace RGB and -colorspace sRGB. In earlier versions, RGB really meant non-linear sRGB. With the completion of the changes, RGB now means linear color and sRGB means non-linear color in terms of their respective colorspaces.</p>
<p class="lead magick-description">Due to the standardization of sRGB on the Internet, most image formats use SRGB as the default working color space. If the color space of an image is unknown and it is an 8- to 16-bit image format, assuming it is in the sRGB color space is a safe choice. This extends to grayscale as well. We assume non-linear grayscale. These assumptions are overridden if a particular image format includes color space and / or gamma metadata. ImageMagick assumes linear color if the color space is RGB instead of sRGB. You can also override the default color space assumptions with color profiles or the <a href="command-line-processing.html#set">-set</a> option.</p>
<p>ImageMagick supports color profiles, however, for images without a profile or a declaration of colorspace, ImageMagick assumes non-linear sRGB. Most image processing algorithms assume a linear colorspace, therefore it might be prudent to convert to linear color or remove the gamma function before certain image processing algorithms are applied. For example,</p>
<pre><code>magick myimage.jpg -colorspace RGB -resize 200% -colorspace sRGB mybigimage.jpg</code></pre>
<pre class="highlight"><code>magick myimage.jpg -colorspace RGB -resize 200% -colorspace sRGB mybigimage.jpg</code></pre>
<p>To declare that an image is linear RGB rather than sRGB, you can use the set option:</p>
<pre><code>magick myimage.png -set colorspace RGB myRGBimage.png</code></pre>
<pre class="highlight"><code>magick myimage.png -set colorspace RGB myRGBimage.png</code></pre>
<p>Afterwards, the verbose information for the output file lists the colorspace as RGB. This only works on image types containing meta data that distinguishes between linear RGB and non-linear sRGB, such as PNG and GIF. Therefore, if the above command is run with a JPG or TIF output format, the verbose information for the colorspace still shows sRGB. In order to properly have the JPG output know that it is linear RGB, include an appropriate color profile.</p>
<p>The second major change treats any grayscale image as linear rather than non-linear, as it was previously. This change is appropriate, since many types of processing requires a linear colorspace. This means that the conversion of a color image to grayscale via <code>-colorspace gray</code> looks darker relative to previous versions of ImageMagick (note that desaturating to convert to grayscale does not convert the image to linear grayscale). If you prefer to keep the conversion to non-linear grayscale, set the colorspace of the input to linear RGB so that <code>-colorspace gray</code> does not apply the gamma correction during the conversion process. For example, the following produces a non-linear grayscale result.</p>
<p>By default, converting color images to grayscale returns non-linear gray. To instead convert to linear gray, use the <a href="command-line-processing.html#set">-set</a> or <a href="command-line-processing.html#intensity">-intensity</a> options:</p>
<pre><code>magick myimage.png -set colorspace RGB -colorspace gray myRGBimage.png</code></pre>
<pre class="highlight"><code>magick myimage.png -set colorspace RGB -colorspace gray myRGBimage.png
magick myimage.png -intensity Rec709luminance -colorspace gray myRGBimage.png
</code></pre>
<p>The same concept is needed when separating channels. Normally, the conversion to separate each channel of an sRGB color image produces separate linear grayscale images. However the same concept can be applied, if it is desired to keep the separate channels as non-linear grayscale. For example, the following produces non-linear grayscale channels.</p>
<pre><code>magick myimage.png -set colorspace RGB -separate myimage_channels_%d.png</code></pre>
<pre class="highlight"><code>magick myimage.png -set colorspace RGB -separate myimage_channels_%d.png</code></pre>
<p>When separating and recombining channels, with potential intermediate processing, it is important to identify the colorspace used, especially during the recombination. For example,</p>
<pre><code>magick myimage.png -separate myimage_channels_%d.png
<pre class="highlight"><code>magick myimage.png -separate myimage_channels_%d.png
magick myimage_channels_*.png -combine myimage2.png</code></pre>
<p>In the above example, the result is darker than the original, because the channels were separate as linear gray and subsequently combined as linear color. In order to return the channels back to sRGB, one must change the colorspace from RGB back to sRGB after the <code>-combine</code> step.</p>
<pre><code>magick myimage.png -separate myimage_channels_%d.png
<pre class="highlight"><code>magick myimage.png -separate myimage_channels_%d.png
magick myimage_channels_*.png -combine -colorspace sRGB myimage2.png</code></pre>
<p>If one desires to separate to non-linear grayscale channels, recombine them later, perhaps after some processing, then use the same concept as above for maintaining non-linear grayscale:</p>
<pre><code>magick myimage.png -set colorspace RGB -separate myimage_channels_%d.png
<pre class="highlight"><code>magick myimage.png -set colorspace RGB -separate myimage_channels_%d.png
magick myimage_channels_*.png -combine -colorspace RGB -set colorspace sRGB myimage2.png</code></pre>
<p>When converting to another colorspace and back, such as between sRGB and HSL, the following two commands handle the first case of linear channels and the second case of non-linear channels:</p>
<pre><code>magick myimage.png -colorspace HSL -separate myimage_channels_%d.png
<pre class="highlight"><code>magick myimage.png -colorspace HSL -separate myimage_channels_%d.png
magick myimage_channels_*.png -set colorspace HSL -combine -colorspace sRGB myimage2.png</code></pre>
<pre><code>magick myimage.png -set colorspace RGB -colorspace HSL -separate myimage_channels_%d.png
<pre class="highlight"><code>magick myimage.png -set colorspace RGB -colorspace HSL -separate myimage_channels_%d.png
magick myimage_channels_*.png -set colorspace HSL -combine -colorspace RGB -set colorspace sRGB myimage2.png</code></pre>
<p>A majority of the image formats assume an sRGB colorspace (e.g. JPEG, PNG, etc.). A few support only linear RGB (e.g. EXR, DPX, CIN, HDR) or only linear GRAY (e.g. PGM). A few formats support CMYK. For example JPG does, but PNG does not. Then there is the occasional format that also supports LAB (that is CieLAB) (e.g. TIFF, PSD, JPG, JP2). For additional information, see the <a href="https://www.imagemagick.org/script/formats.html#colorspace" >Colorspace</a> and <a href="https://www.imagemagick.org/script/formats.html#supported" >Supported Formats</a> pages.</p>
......@@ -123,8 +123,9 @@ magick myimage_channels_*.png -set colorspace HSL -combine -colorspace RGB -set
</footer>
</div><!-- /.container -->
<script src="https://localhost/ajax/libs/jquery/1.12.4/jquery.min.js"></script>
<script src="https://code.jquery.com/jquery-3.2.1.slim.min.js" integrity="sha384-KJ3o2DKtIkvYIK3UENzmM7KCkRr/rE9/Qpg6aAZGJwFDMVNA/GpGFF93hXpG5KkN" crossorigin="anonymous"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.11.0/umd/popper.min.js" integrity="sha384-b/U6ypiBEHpOf/4+1nzFpr53nxSS+GLCkfwBdFNTxtclqqenISfwAzpKaMNFNmj4" crossorigin="anonymous"></script>
<script src="../js/magick.html"></script>
</body>
</html>
<!-- Magick Cache 9th September 2017 08:01 -->
\ No newline at end of file
<!-- Magick Cache 8th October 2017 11:14 -->
\ No newline at end of file
......@@ -63,7 +63,7 @@
<p>Each of the following commands produces the same <var>lime</var> border around the image. (Use "double quotes" for Windows.)</p>
<pre><code>magick -bordercolor lime -border 10 image.jpg image.png
<pre class="highlight"><code>magick -bordercolor lime -border 10 image.jpg image.png
magick -bordercolor '#0f0' -border 10 image.jpg image.png
magick -bordercolor '#00ff00' -border 10 image.jpg image.png
magick -bordercolor 'rgb(0,255,0)' -border 10 image.jpg image.png
......@@ -75,7 +75,7 @@ magick -bordercolor 'rgb(0,100%,0)' -border 10 image.jpg image.png</code></pre>
<p>The sRGB, CMYK, HSL and HSB color models are used in numerical color specifications. These examples all specify the same red sRGB color:</p>
<pre><code>#f00 #rgb
<pre class="highlight"><code>#f00 #rgb
#ff0000 #rrggbb
#ff0000ff #rrggbbaa
#ffff00000000 #rrrrggggbbbb
......@@ -91,7 +91,7 @@ rgb(100.0%, 0.0%, 0.0%) a float in the range 0—100% for each component</code
<p>The sRGB color model is extended in this specification to include <var>alpha</var> to allow specification of the transparency of a color. These examples all specify the same color:</p>
<pre><code>rgb(255, 0, 0) range 0 - 255
<pre class="highlight"><code>rgb(255, 0, 0) range 0 - 255
rgba(255, 0, 0, 1.0) the same, with an explicit alpha value
rgb(100%, 0%, 0%) range 0.0% - 100.0%
rgba(100%, 0%, 0%, 1.0) the same, with an explicit alpha value</code></pre>
......@@ -102,7 +102,7 @@ rgba(100%, 0%, 0%, 1.0) the same, with an explicit alpha value</code></pr
<p>Gray values are conveniently defined with a single intensity value or an intensity value and an alpha value:</p>
<pre><code>gray(50%) mid gray
<pre class="highlight"><code>gray(50%) mid gray
graya(50%, 0.5) semi-transparent mid gray</code></pre>
<p>The ImageMagick color model also supports hue-saturation-lightness (HSL) and hue-saturation-brightness (HSB) colors as a complement to numerical sRGB colors. HSL colors are encoding as a triple (hue, saturation, lightness). Likewise HSB colors are encoding as a triple (hue, saturation, brightness). HSL or HSB triples are either direct values (hue 0—360, saturation 0—255, lightness or brightness 0—255) or with S,L,B as percentage values relative to these ranges.</p>
......@@ -121,7 +121,7 @@ graya(50%, 0.5) semi-transparent mid gray</code></pre>
<p>The HSB color system is a little easier to understand than the HSL color system. In the HSB color system, black is at the bottom apex and white is at the top center of the cone on the central axis. The most colorful or saturated colors will then be at the outer edge of the top of the cone at the widest part. Thus at Saturation=100% and Brightness=100%</p>
<pre><code>hsb(0, 100%, 100%) or hsb(0, 255, 255) full red
<pre class="highlight"><code>hsb(0, 100%, 100%) or hsb(0, 255, 255) full red
hsb(120, 100%, 100%) or hsb(120, 255, 255) full green
hsb(120, 100%, 75%) or hsb(120, 255, 191.25) medium green
hsb(120, 100%, 50%) or hsb(120, 255, 127.5) dark green
......@@ -130,7 +130,7 @@ hsb(120, 50%, 50%) or hsb(120, 127.5, 127.5) pastel green</code></p
<p>In the HSL color system, black is at the bottom apex and white is at the top apex. However, saturation is largest at the middle of the double cone on its outer perimeter and thus at a lightness value of 50%. The most colorful or saturated colors will then be at the outer edge of the double cone at its widest part. Thus at Saturation=100% and Brightness=50%</p>
<pre><code>hsl(0, 100%, 50%) or hsl(0, 255, 127.5) full red
<pre class="highlight"><code>hsl(0, 100%, 50%) or hsl(0, 255, 127.5) full red
hsl(120, 100%, 100%) or hsl(120, 255, 255) white
hsl(120, 100%, 75%) or hsl(120, 255, 191.25) pastel green
hsl(120, 100%, 50%) or hsl(120, 255, 127.5) full green
......@@ -141,7 +141,7 @@ hsl(120, 50%, 50%) or hsl(120, 127.5, 127.5) medium green</code></p
<p>Just as the 'rgb()' functional notation has the 'rgba()' alpha counterpart, the 'hsl()' and 'hsb()' functional notations have their 'hsla()' 'hsba()' alpha counterparts. These examples specify the same color:</p>
<pre><code>hsb(120, 100%, 100%) full green in hsb
<pre class="highlight"><code>hsb(120, 100%, 100%) full green in hsb
hsba(120, 100%, 100%, 1.0) the same, with an alpha value of 1.0
hsb(120, 255, 255) full green in hsb
hsba(120, 255, 255, 1.0) the same, with an alpha value of 1.0
......@@ -154,20 +154,20 @@ hsla(120, 255, 127.5, 1.0) the same, with an alpha value of 1.0</code></
<p>For ImageMagick between 6.5.6-6 and 6.9.2-0, HSL (HSB) could only be specified with Hue as percent in range 0—100%, when Saturation and Lightness (Brightness) were also specified as percent in range 0—100%.</p>
<p>Specify the Lab colors like this:</p>
<pre><code>cielab(62.253188, 23.950124, 48.410653)</code></pre>
<pre class="highlight"><code>cielab(62.253188, 23.950124, 48.410653)</code></pre>
<p>Note, the <code>a</code> and <code>b</code> components of any Lab color you specify are biased internally by 50% to ensure it fits in the quantum range (typically 0 to 65535). The bias is retained when writing to the TIFF and MIFF image formats. However, the TXT format supports negative pixel values so the bias is removed when writing to this format:</p>
<pre><code>-> magick xc:cyan -colorspace LAB txt:
<pre class="highlight"><code>-> magick xc:cyan -colorspace LAB txt:
# ImageMagick pixel enumeration: 1,1,65535,cielab
0,0: (91.1131%,-18.8571%,-5.5436%) #E93F00000000 cielab(91.1131%,-18.8571%,-5.5436%)
-> magick -size 100x100 xc:"cielab(91.1131%,-18.8571%,-5.5436%)" -colorspace sRGB cyan.png</code></pre>
<p>Or specify colors generically with the <code>icc-color</code> keyword, for example:</p>
<pre><code>icc-color(cmyk, 0.11, 0.48, 0.83, 0.00)
<pre class="highlight"><code>icc-color(cmyk, 0.11, 0.48, 0.83, 0.00)
icc-color(rgb, white)</code></pre>
<p>Or specify uncalibrated device colors with the <code>device-</code> keyword, for example:</p>
<pre><code>device-gray(0.5)
<pre class="highlight"><code>device-gray(0.5)
device-rgb(0.5, 1.0, 0.0)
device-cmyk(0.11, 0.48, 0.83, 0.00)</code></pre>
......@@ -4920,8 +4920,9 @@ device-cmyk(0.11, 0.48, 0.83, 0.00)</code></pre>
</footer>
</div><!-- /.container -->
<script src="https://localhost/ajax/libs/jquery/1.12.4/jquery.min.js"></script>
<script src="https://code.jquery.com/jquery-3.2.1.slim.min.js" integrity="sha384-KJ3o2DKtIkvYIK3UENzmM7KCkRr/rE9/Qpg6aAZGJwFDMVNA/GpGFF93hXpG5KkN" crossorigin="anonymous"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.11.0/umd/popper.min.js" integrity="sha384-b/U6ypiBEHpOf/4+1nzFpr53nxSS+GLCkfwBdFNTxtclqqenISfwAzpKaMNFNmj4" crossorigin="anonymous"></script>
<script src="../js/magick.html"></script>
</body>
</html>
<!-- Magick Cache 9th September 2017 08:02 -->
\ No newline at end of file
<!-- Magick Cache 8th October 2017 11:16 -->
\ No newline at end of file
This diff is collapsed.
This diff is collapsed.
......@@ -79,7 +79,7 @@
<dt class="col-md-4"><a id="stream"></a><a href="stream.html">stream</a></dt><dd class="col-md-8">a lightweight tool to stream one or more pixel components of the image or portion of the image to your choice of storage formats. It writes the pixel components as they are read from the input image a row at a time making <code>stream</code> desirable when working with large images or when you require raw pixel components.</dd>
</dl>
<p>If these tools are not available, you can simply append them to the <code>magick</code> tool like this:</p>
<pre><code>magick convert logo: logo.jpg</code></pre>
<pre class="highlight"><code>magick convert logo: logo.jpg</code></pre>
</div>
<footer class="magick-footer">
......@@ -96,8 +96,9 @@
</footer>
</div><!-- /.container -->
<script src="https://localhost/ajax/libs/jquery/1.12.4/jquery.min.js"></script>
<script src="https://code.jquery.com/jquery-3.2.1.slim.min.js" integrity="sha384-KJ3o2DKtIkvYIK3UENzmM7KCkRr/rE9/Qpg6aAZGJwFDMVNA/GpGFF93hXpG5KkN" crossorigin="anonymous"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.11.0/umd/popper.min.js" integrity="sha384-b/U6ypiBEHpOf/4+1nzFpr53nxSS+GLCkfwBdFNTxtclqqenISfwAzpKaMNFNmj4" crossorigin="anonymous"></script>
<script src="../js/magick.html"></script>
</body>
</html>
<!-- Magick Cache 9th September 2017 08:01 -->
\ No newline at end of file
<!-- Magick Cache 8th October 2017 11:14 -->
\ No newline at end of file
......@@ -61,8 +61,7 @@
<p>We list a few examples of the <code>compare</code> command here to illustrate its usefulness and ease of use. To get started, lets compare an image to one thats been sharpened:</p>
<pre><code>
magick convert rose.jpg -sharpen 0x1 reconstruct.jpg
<pre class="highlight"><code>magick convert rose.jpg -sharpen 0x1 reconstruct.jpg
magick compare rose.jpg reconstruct.jpg difference.png
magick compare -compose src rose.jpg reconstruct.jpg difference.png
</code></pre>
......@@ -78,8 +77,7 @@ magick compare -compose src rose.jpg reconstruct.jpg difference.png
<p>In addition to the visual interpretation of the difference in an image and its reconstruction, we report a mathematical measure of the difference:</p>
<pre><code>
-> magick compare -verbose -metric mae rose.jpg reconstruct.jpg difference.png
<pre class="highlight"><code>-> magick compare -verbose -metric mae rose.jpg reconstruct.jpg difference.png
Image: rose.jpg
Channel distortion: MAE
red: 2282.91 (0.034835)
......@@ -89,22 +87,19 @@ Image: rose.jpg
</code></pre>
<p>Or, if you just want the red channel distortion, use this command:</p>
<pre><code>
-> magick compare -channel red -metric PSNR rose.jpg reconstruct.jpg difference.png
<pre class="highlight"><code>-> magick compare -channel red -metric PSNR rose.jpg reconstruct.jpg difference.png
19.63
</code></pre>
<p>Or, if you just want the overall image distortion, use this command:</p>
<pre><code>
-> magick compare -metric PSNR rose.jpg reconstruct.jpg difference.png
<pre class="highlight"><code>-> magick compare -metric PSNR rose.jpg reconstruct.jpg difference.png
28.31
</code></pre>
<p>If the reconstructed image is a subimage of the image, the compare program returns the best match offset. In addition, it returns a similarity image such that an exact match location is completely white and if none of the pixels match, black, otherwise some gray level in-between:</p>
<pre><code>
-> magick compare -metric RMSE -subimage-search logo.png wizard.jpg similarity.gif
<pre class="highlight"><code>-> magick compare -metric RMSE -subimage-search logo.png wizard.jpg similarity.gif
85.05 (0.00129778) @ 353,157
</code></pre>
......@@ -214,6 +209,11 @@ transparent, extract, background, or shape the alpha channel</td>
<td>colors within this distance are considered equal</td>
</tr>
<tr>
<td><a href="command-line-options.html#gravity">-gravity <var>type</var></a></td>
<td>horizontal and vertical text placement</td>
</tr>
<tr>
<td><a href="command-line-options.html#help">-help</a></td>
<td>print program options</td>
......@@ -411,8 +411,9 @@ transparent, extract, background, or shape the alpha channel</td>
</footer>
</div><!-- /.container -->
<script src="https://localhost/ajax/libs/jquery/1.12.4/jquery.min.js"></script>
<script src="https://code.jquery.com/jquery-3.2.1.slim.min.js" integrity="sha384-KJ3o2DKtIkvYIK3UENzmM7KCkRr/rE9/Qpg6aAZGJwFDMVNA/GpGFF93hXpG5KkN" crossorigin="anonymous"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.11.0/umd/popper.min.js" integrity="sha384-b/U6ypiBEHpOf/4+1nzFpr53nxSS+GLCkfwBdFNTxtclqqenISfwAzpKaMNFNmj4" crossorigin="anonymous"></script>
<script src="../js/magick.html"></script>
</body>
</html>
<!-- Magick Cache 9th September 2017 08:02 -->
\ No newline at end of file
<!-- Magick Cache 8th October 2017 11:16 -->
\ No newline at end of file
......@@ -46,7 +46,7 @@
<a class="nav-link " href="https://www.imagemagick.org/script/command-line-processing.html">Command-line</a>
<a class="nav-link " href="https://www.imagemagick.org/script/resources.html">Resources</a>
<a class="nav-link " href="https://www.imagemagick.org/script/develop.html">Develop</a>
<a class="nav-link " href="https://www.imagemagick.org/script/https://www.imagemagick.org/script/https://www.imagemagick.org/script/search.php">Search</a>
<a class="nav-link " href="https://www.imagemagick.org/script/https://www.imagemagick.org/script/search.php">Search</a>
<a class="nav-link float-right" href="https://www.imagemagick.org/discourse-server/">Community</a>
</nav>
</div>
......@@ -452,8 +452,7 @@ but not always, the same name as the composite 'method' they use, and replaces
the normal use of the <a href="https://www.imagemagick.org/script/command-line-options.html#compose" >-compose</a>
setting in the "<code>composite</code>" command. For example... </p>
<pre><code>
composite ... -blend 50x50 ...
<pre class="highlight"><code>composite ... -blend 50x50 ...
</code></pre>
<p>As of IM v6.5.3-4 the "<code>convert</code>" command can now also supply
......@@ -464,8 +463,7 @@ make use of these special augmented <a href="https://www.imagemagick.org/script/
>-compose</a> methods, those the argument and the method both need to be set
separately. For example... </p>
<pre><code>
convert ... -compose blend -define compose:args=50,50 -composite ...
<pre class="highlight"><code>convert ... -compose blend -define compose:args=50,50 -composite ...
</code></pre>
<p>The following is a table of these special 'argumented' compose methods,
......@@ -630,12 +628,13 @@ href="https://www.imagemagick.org/script/command-line-options.html#list">-list c
</p>
<p><a href="compose.html#">Back to top</a>
<a href="http://pgp.mit.edu:11371/pks/lookup?op=get&amp;search=0x89AB63D48277377A">Public Key</a>
<a href="https://www.imagemagick.org/script/https://www.imagemagick.org/script/https://www.imagemagick.org/script/contact.php">Contact Us</a></p>
<a href="https://www.imagemagick.org/script/https://www.imagemagick.org/script/contact.php">Contact Us</a></p>
<p><small>© 1999-2017 ImageMagick Studio LLC</small></p>
</footer>
</div><!-- /.container -->
<script src="https://localhost/ajax/libs/jquery/1.12.4/jquery.min.js"></script>
<script src="https://code.jquery.com/jquery-3.2.1.slim.min.js" integrity="sha384-KJ3o2DKtIkvYIK3UENzmM7KCkRr/rE9/Qpg6aAZGJwFDMVNA/GpGFF93hXpG5KkN" crossorigin="anonymous"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.11.0/umd/popper.min.js" integrity="sha384-b/U6ypiBEHpOf/4+1nzFpr53nxSS+GLCkfwBdFNTxtclqqenISfwAzpKaMNFNmj4" crossorigin="anonymous"></script>
<script src="https://www.imagemagick.org/js/magick.html"></script>
</body>
</html>
......@@ -61,8 +61,7 @@
<p>We list a few examples of the <code>composite</code> command here to illustrate its usefulness and ease of use. To get started, lets overlay a smiley face over a rose:</p>
<pre><code>
magick composite -gravity center smile.gif rose: rose-over.png
<pre class="highlight"><code>magick composite -gravity center smile.gif rose: rose-over.png
</code></pre>
<ul>
......@@ -75,8 +74,7 @@ magick composite -gravity center smile.gif rose: rose-over.png
<p>You can create three-dimensional effect with the <var>Atop</var>:</p>
<pre><code>
magick convert -size 70x70 canvas:none -fill red -draw 'circle 35,35 10,30' red-circle.png
<pre class="highlight"><code>magick convert -size 70x70 canvas:none -fill red -draw 'circle 35,35 10,30' red-circle.png
magick convert -size 70x70 canvas:none -draw 'circle 35,35 35,20' -negate \
-channel A -gaussian-blur 0x8 white-highlight.png
magick composite -compose atop -geometry -13-17 white-highlight.png red-circle.png red-ball.png
......@@ -517,8 +515,9 @@ transparent, extract, background, or shape the alpha channel</td>
</footer>
</div><!-- /.container -->
<script src="https://localhost/ajax/libs/jquery/1.12.4/jquery.min.js"></script>
<script src="https://code.jquery.com/jquery-3.2.1.slim.min.js" integrity="sha384-KJ3o2DKtIkvYIK3UENzmM7KCkRr/rE9/Qpg6aAZGJwFDMVNA/GpGFF93hXpG5KkN" crossorigin="anonymous"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.11.0/umd/popper.min.js" integrity="sha384-b/U6ypiBEHpOf/4+1nzFpr53nxSS+GLCkfwBdFNTxtclqqenISfwAzpKaMNFNmj4" crossorigin="anonymous"></script>
<script src="../js/magick.html"></script>
</body>
</html>
<!-- Magick Cache 9th September 2017 07:56 -->
\ No newline at end of file
<!-- Magick Cache 8th October 2017 11:14 -->
\ No newline at end of file
......@@ -61,14 +61,12 @@
<p>We list a few examples of the <code>conjure</code> command here to illustrate its usefulness and ease of use. To get started, here is simple <code>conjure</code> command:</p>
<pre><code>
magick conjure -dimensions 400x400 msl:incantation.msl
<pre class="highlight"><code>magick conjure -dimensions 400x400 msl:incantation.msl
</code></pre>
<p>The MSL script <a href="http://www.imagemagick.org/source/incantation.msl">incantation.msl</a> used above is here:</p>
<pre><code>
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
<pre class="highlight"><code>&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;image&gt;
&lt;read filename="image.gif" /&gt;
&lt;get width="base-width" height="base-height" /&gt;
......@@ -81,8 +79,7 @@ magick conjure -dimensions 400x400 msl:incantation.msl
<p>In this example, a family stayed home for their vacation but as far as their friends are concerned they went to a beautiful beach in the Caribbean:</p>
<pre><code>
&lt;?xml version="1.0" encoding="UTF-8"?>
<pre class="highlight"><code>&lt;?xml version="1.0" encoding="UTF-8"?>
&lt;group>
&lt;image id="family">
&lt;read filename="family.gif"/>
......@@ -103,8 +100,7 @@ magick conjure -dimensions 400x400 msl:incantation.msl
<p>Here we display the width in pixels of text for a particular font and pointsize.</p>
<pre><code>
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
<pre class="highlight"><code>&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;image&gt;
&lt;query-font-metrics text="ImageMagick" font="helvetica" pointsize="48" /&gt;
&lt;print output="Text width is %[msl:font-metrics.width] pixels.\n" /&gt;
......@@ -113,8 +109,7 @@ magick conjure -dimensions 400x400 msl:incantation.msl
<p>The <code>query-font-metrics</code> tag supports these properties:</p>
<pre><code>
msl:font-metrics.pixels_per_em.x
<pre class="highlight"><code>msl:font-metrics.pixels_per_em.x
msl:font-metrics.pixels_per_em.y
msl:font-metrics.ascent
msl:font-metrics.descent
......@@ -1129,8 +1124,9 @@ fill="color name", channel="All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray,
</footer>
</div><!-- /.container -->
<script src="https://localhost/ajax/libs/jquery/1.12.4/jquery.min.js"></script>
<script src="https://code.jquery.com/jquery-3.2.1.slim.min.js" integrity="sha384-KJ3o2DKtIkvYIK3UENzmM7KCkRr/rE9/Qpg6aAZGJwFDMVNA/GpGFF93hXpG5KkN" crossorigin="anonymous"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.11.0/umd/popper.min.js" integrity="sha384-b/U6ypiBEHpOf/4+1nzFpr53nxSS+GLCkfwBdFNTxtclqqenISfwAzpKaMNFNmj4" crossorigin="anonymous"></script>
<script src="../js/magick.html"></script>
</body>
</html>
<!-- Magick Cache 9th September 2017 08:02 -->
\ No newline at end of file
<!-- Magick Cache 8th October 2017 11:16 -->
\ No newline at end of file