-\r
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" \r
- "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">\r
-<html version="-//W3C//DTD XHTML 1.1//EN"\r
- xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"\r
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"\r
- xsi:schemaLocation="http://www.w3.org/1999/xhtml\r
- http://www.w3.org/MarkUp/SCHEMA/xhtml11.xsd">\r
-<head>\r
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>\r
- <meta name="google-site-verification" content="MxsMq6bdLOx0KSuz1MY6yG9ZTIJ7_7DVRfl5NCAT5Yg"/>\r
- <title>ImageMagick: Color Names</title>
- <meta http-equiv="Content-Language" content="en-US"/>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
- <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
- <meta name="Application-name" content="ImageMagick"/>
- <meta name="Description" content="Use ImageMagick to convert, edit, or compose bitmap images in a variety of formats. In addition resize, rotate, shear, distort and transform images automagically."/>
- <meta name="Application-url" content="http://www.imagemagick.org"/>
- <meta name="Generator" content="PHP"/>
- <meta name="Keywords" content="color, names, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Image, Processing, Automagically"/>
- <meta name="Rating" content="GENERAL"/>
- <meta name="Robots" content="INDEX, FOLLOW"/>
- <meta name="Generator" content="ImageMagick Studio LLC"/>
- <meta name="Author" content="ImageMagick Studio LLC"/>
- <meta name="Revisit-after" content="2 DAYS"/>
- <meta name="Resource-type" content="document"/>
- <meta name="Copyright" content="Copyright (c) 1999-2011 ImageMagick Studio LLC"/>
- <meta name="Distribution" content="Global"/>
- <link rel="icon" href="../images/wand.png"/>
- <link rel="shortcut icon" href="../images/wand.ico" type="images/x-icon"/>
- <link rel="canonical" href="http://www.imagemagick.org" />\r
- <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>\r
- <link rel="stylesheet" href="http://www.google.com/cse/style/look/default.css" type="text/css" />\r
- <link rel="stylesheet" type="text/css" href="http://www.imagemagick.org/fancybox/jquery.fancybox-1.3.4.css" media="screen" />\r
- <style type="text/css" media="all">\r
- @import url("../www/magick.css");\r
- </style>\r
- <script type="text/javascript" src="https://apis.google.com/js/plusone.js"></script>\r
- <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.1/jquery.min.js"></script>\r
- <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.fancybox-1.3.4.pack.js"></script>\r
- <script type="text/javascript">\r
- $(document).ready(function() {\r
- $("a[href$=.jpg],a[href$=.png],a[href$=.gif]").fancybox({\r
- 'transitionIn' : 'elastic',\r
- 'transitionOut' : 'elastic',\r
- 'overlayShow' : false,\r
- 'opacity' : true\r
- });\r
- });\r
- </script>\r
-</head>\r
-\r
-<body id="www-imagemagick-org">\r
-<div class="titlebar">\r
-<div style="margin: 17px auto; float: left;">\r
- <script type="text/javascript">\r
- <!--\r
- google_ad_client = "pub-3129977114552745";\r
- google_ad_slot = "5439289906";\r
- google_ad_width = 728;\r
- google_ad_height = 90;\r
- //-->\r
- </script>\r
- <script type="text/javascript"\r
- src="http://pagead2.googlesyndication.com/pagead/show_ads.js">\r
- </script>\r
-</div>\r
-<a href="http://www.imagemagick.org/discourse-server/">\r
- <img src="../images/logo.jpg"\r
- alt="ImageMagick Logo"\r
- style="width: 123px; height: 118px; border: 0px; float: right;" /></a>\r
-<a href="../index.html">\r
- <img src="../images/sprite.jpg"\r
- alt="ImageMagick Sprite"\r
- style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
-</div>\r
-\r
-<div class="westbar">\r
-\r
-<div class="menu">
- <a title="About ImageMagick" href="../index.html">About ImageMagick</a>
-</div>
-<div class="menu">
- <a title="Binary Releases" href="../www/binary-releases.html">Binary Releases</a>
-</div>
-<div class="sub">
- <a title="Binary Release: Unix" href="../www/binary-releases.html#unix">Unix</a>
-</div>
-<div class="sub">
- <a title="Binary Release: MacOS X" href="../www/binary-releases.html#macosx">Mac OS X</a>
-</div>
-<div class="sub">
- <a title="Binary Release: iOS" href="../www/binary-releases.html#iOS">iOS</a>
-</div>
-<div class="sub">
- <a title="Binary Release: Windows" href="../www/binary-releases.html#windows">Windows</a>
-</div>
-<div class="sep"></div>\r
-<div class="menu">
- <a title="Command-line Tools" href="../www/command-line-tools.html">Command-line Tools</a>
-</div>
-<div class="sub">
- <a title="Command-line Tools: Processing" href="../www/command-line-processing.html">Processing</a>
-</div>
-<div class="sub">
- <a title="Command-line Tools: Options" href="../www/command-line-options.html">Options</a>
-</div>
-<div class="sub">
- <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
-</div>
-<div class="menu">
- <a title="Program Interfaces" href="../www/api.html">Program Interfaces</a>
-</div>
-<div class="sub">
- <a title="Program Interface: MagickWand" href="../www/magick-wand.html">MagickWand</a>
-</div>
-<div class="sub">
- <a title="Program Interface: MagickCore" href="../www/magick-core.html">MagickCore</a>
-</div>
-<div class="sub">
- <a title="Program Interface: PerlMagick" href="../www/perl-magick.html">PerlMagick</a>
-</div>
-<div class="sub">
- <a title="Program Interface: Magick++" href="../www/magick++.html">Magick++</a>
-</div>
-<div class="sep"></div>\r
-<div class="menu">
- <a title="Install from Source" href="../www/install-source.html">Install from Source</a>
-</div>
-<div class="sub">
- <a title="Install from Source: Unix" href="../www/install-source.html#unix">Unix</a>
-</div>
-<div class="sub">
- <a title="Install from Source: Windows" href="../www/install-source.html#windows">Windows</a>
- </div>
-<div class="menu">
- <a title="Resources" href="../www/resources.html">Resources</a>
-</div>
-<div class="menu">
- <a title="Architecture" href="../www/architecture.html">Architecture</a>
-</div>
-<div class="menu">
- <a title="Download" href="../www/download.html">Download</a>
-</div>
-<div class="sep"></div>\r
-<div class="menu">
- <a title="Search" href="../www/search.html">Search</a>
-</div>
-<div class="sep"></div>\r
-<div class="menu">
- <a title="Site Map" href="../www/sitemap.html">Site Map</a>
-</div>
-<div class="sub">
- <a title="Site Map: Links" href="../www/links.html">Links</a>
-</div>
-<div class="sep"></div>\r
-<div class="menu">
- <a rel="follow" title="Sponsors" href="../www/sponsors.html">Sponsors:</a>
-
-<a href="http://www.networkredux.com">
- <img src="../images/networkredux.png" alt="[sponsor]"
- style="margin-top: 4px; margin-left: 4px; border: 0px; float: left;" /></a>
-<div class="sponsbox">
-<div class="sponsor">
- <a rel="follow" title="Sponsor: Web Hosting" href="http://www.micfo.com">Web Hosting</a><!-- 209901010090s golestan -->
-</div>
-<div class="sponsor">
- <a rel="follow" title="Sponsor: Autos part" href="http://www.pkwteile.de/autoteile">Autos part</a><!-- 201112010090s jr@pkwte... -->
-</div>
-<div class="sponsor">
- <a rel="follow" title="Sponsor: Search engine optimisation" href="http://www.seomoves.com.au">Search engine optimisation</a><!-- 201110010090s jen@seo lowprofilelinks -->
-</div>
-<div class="sponsor">
- <a rel="follow" title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 201110010720 -->
-</div>
-<div class="sponsor">
- <a rel="follow" title="Sponsor: Web Hosting Deals" href="http://www.webhostingdeals.org">Web Hosting Deals</a><!-- 201111010270 chee.hoa darin -->
-</div>
-<div class="sponsor">
- <a rel="follow" title="Sponsor: Web Hosting Reviews" href="http://www.webhostingsecretrevealed.com">Web Hosting Secret Revealed</a><!-- 201204010540 iamchee jerry -->
-</div>
-<div class="sponsor">
- <a rel="follow" title="Sponsor: Web Hosting Break" href="http://www.webhostingbreak.com">Web Hosting Break</a><!-- 201109010090 ian@ian-m... -->
-</div>
-<div class="sponsor">
- <a rel="follow" title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201303011500 r.leo -->
-</div>
-<div class="sponsor">
- <a rel="follow" title="Sponsor: Website Hosting" href="http://www.hostreviewgeeks.com">Website Hosting</a><!-- 201110010090 alexanian media -->
-</div>
-<div class="sponsor">
- <a rel="follow" title="Sponsor: Hotel München" href="http://www.messehotel-erb-muenchen.de">Hotel München</a><!-- 201111010450 cerb -->
-</div>
-<div class="sponsor">
- <a rel="follow" title="Sponsor: Best Web Hosting" href="http://webhostinggeeks.com">Best Web Hosting</a><!-- 201110010720 -->
-</div>
-<div class="sponsor">
- <a rel="follow" title="Sponsor: Flyer drucken" href="http://www.online-druck.biz">Flyer drucken</a><!-- 201109010900 Floeter-->
-</div>
-<div class="sponsor">
- <a rel="follow" title="Sponsor: Web Hosting Ratings" href="http://webhostingrating.com">Web Hosting Ratings</a><!-- 201110010720 -->
-</div>
-<div class="sponsor">
- <a rel="follow" title="Sponsor: Fernsehdienst Berlin" href="http://www.atlas-multimedia.de">Fernsehdienst Berlin</a><!-- 2011090100025 atlas.multimedia-->
-</div>
-</div>
-</div>
-</div>\r
-\r
-<div class="eastbar">\r
- <div class="g-plusone" data-size="standard" data-count="false"></div>\r
-</div>\r
-\r
-<div class="main">\r
-\r
-<h1>ImageMagick Color Names</h1>
-<p class="navigation-index">[<a href="#usage">Example Usage</a> • <a href="#models">Color Model Specification</a> • <a href="#color_names">List of Color Names</a>]</p>
-
-<div class="doc-section">
-<p>A number of ImageMagick options and methods take a color as an argument. The color can then be given as a color name (there is a limited but large set of these; see below) or it can be given as a set of numbers (in decimal or hexadecimal), each corresponding to a channel in an RGB or RGBA color model. HSL, HSLA, HSB, HSBA, CMYK, or CMYKA color models may also be specified. These topics are briefly described in the sections below.</p>
-</div>
-
-<h2><a id="color-converter"></a>Interactive Color Converter</h2>
-<div class="doc-section">
-<p>Use the
-<a href="../www/contrib/color-converter.html">Color Converter</a>
-to supply any valid ImageMagick color specification as described below to see a
-color swatch of that color and to convert to all the other color models.
-</p>
-</div>
-<h2><a id="usage"></a>Example Usage</h2>
-<div class="doc-section">
-<p>Each of the following commands produces the same <em>lime</em> border around the image. (Use "double quotes" for Windows.)</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>convert -bordercolor lime -border 10 image.jpg image.png</span><span class='crtout'></span><span class="crtprompt"> $magick> </span><span class='crtin'>convert -bordercolor '#0f0' -border 10 image.jpg image.png</span><span class='crtout'></span><span class="crtprompt"> $magick> </span><span class='crtin'>convert -bordercolor '#00ff00' -border 10 image.jpg image.png</span><span class='crtout'></span><span class="crtprompt"> $magick> </span><span class='crtin'>convert -bordercolor 'rgb(0,255,0)' -border 10 image.jpg image.png</span><span class='crtout'></span><span class="crtprompt"> $magick> </span><span class='crtin'>convert -bordercolor 'rgb(0,100%,0)' -border 10 image.jpg image.png</span></p>
-<p>The list of recognized color names (for example, <em>aqua</em>, <em>black</em>, <em>blue</em>, <em>fuchsia</em>, <em>gray</em>, <em>green</em>, <em>lime</em>, <em>maroon</em>, <em>navy</em>, <em>olive</em>, <em>purple</em>, <em>red</em>, <em>silver</em>, <em>teal</em>, <em>white</em>, <em>yellow</em>, and others) is shown in a table further below.</p>
-
-</div>
-
-<h2><a id="models"></a>Color Model Specification</h2>
-<div class="doc-section">
-
-<p>The RGB, CMYK, HSL and HSB color models are used in numerical color specifications. These examples all specify the same red RGB color:</p>
-
-<pre class="text">
- #f00 #rgb
- #ff0000 #rrggbb
- #ff0000ff #rrggbbaa
- #ffff00000000 #rrrrggggbbbb
- #ffff00000000ffff #rrrrggggbbbbaaaa
- rgb(255, 0, 0) an integer in the range 0—255 for each component
- rgb(100.0%, 0.0%, 0.0%) a float in the range 0—100% for each component
-</pre >
-
-<p>The format of an RGB value in hexadecimal notation is a '#' immediately followed by either three, six, or twelve hexadecimal characters. The three-digit RGB notation (#rgb) is converted into six-digit form (#rrggbb) by replicating digits, not by adding zeros. For example, #fb0 expands to #ffbb00. This ensures that white (#ffffff) can be specified with the short notation (#fff) and removes any dependencies on the color depth of the image. Use the hexadecimal notation whenever performance is an issue. ImageMagick does not need to load the expansive color table to interpret a hexadecimal color, e.g., <kbd>#000000</kbd>, but it does if <kbd>black</kbd> is used instead.</p>
-
-<p>The format of an RGB value in the functional notation is 'rgb(<em>r</em>,<em>g</em>,<em>b</em>)', where <em>r</em>, <em>g</em>, and <em>b</em> are either three integer or float values in the range 0—255 or three integer or float percentage values in the range 0—100%. The value 255 corresponds to 100%, and to #F or #FF in the hexadecimal notation: rgb(255, 255, 255) = rgb(100%, 100%, 100%) = #FFF = #FFFFFF. </p>
+<!DOCTYPE html>
+<html lang="en">
+<head>
+ <meta charset="utf-8" />
+ <meta name="viewport" content="width=device-width,minimum-scale=1,initial-scale=1,shrink-to-fit=no" />
+ <title>Color Names @ ImageMagick</title>
+ <meta name="application-name" content="ImageMagick" />
+ <meta name="description" content="Use ImageMagick® to create, edit, compose, convert bitmap images. With ImageMagick you can resize your image, crop it, change its shades and colors, add captions, among other operations." />
+ <meta name="application-url" content="https://imagemagick.org" />
+ <meta name="generator" content="PHP" />
+ <meta name="keywords" content="color, names, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert" />
+ <meta name="rating" content="GENERAL" />
+ <meta name="robots" content="INDEX, FOLLOW" />
+ <meta name="generator" content="ImageMagick Studio LLC" />
+ <meta name="author" content="ImageMagick Studio LLC" />
+ <meta name="revisit-after" content="2 DAYS" />
+ <meta name="resource-type" content="document" />
+ <meta name="copyright" content="Copyright (c) 1999-2017 ImageMagick Studio LLC" />
+ <meta name="distribution" content="Global" />
+ <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1" />
+ <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
+ <link href="color.html" rel="canonical" />
+ <link href="../images/wand.png" rel="icon" />
+ <link href="../images/wand.ico" rel="shortcut icon" />
+ <link href="assets/magick.css" rel="stylesheet" />
+</head>
+<body>
+ <header>
+ <nav class="navbar navbar-expand-md navbar-dark bg-dark fixed-top">
+ <a class="navbar-brand" href="../"><img class="d-block" id="icon" alt="ImageMagick" width="32" height="32" src="../images/wand.ico"/></a>
+ <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarsExampleDefault" aria-controls="navbarsExampleDefault" aria-expanded="false" aria-label="Toggle navigation">
+ <span class="navbar-toggler-icon"></span>
+ </button>
+
+ <div class="navbar-collapse collapse" id="navbarsExampleDefault" style="">
+ <ul class="navbar-nav mr-auto">
+ <li class="nav-item ">
+ <a class="nav-link" href="../index.html">Home <span class="sr-only">(current)</span></a>
+ </li>
+ <li class="nav-item ">
+ <a class="nav-link" href="../www/download.html">Download</a>
+ </li>
+ <li class="nav-item ">
+ <a class="nav-link" href="../www/command-line-tools.html">Tools</a>
+ </li>
+ <li class="nav-item ">
+ <a class="nav-link" href="../www/command-line-processing.html">Command-line</a>
+ </li>
+ <li class="nav-item ">
+ <a class="nav-link" href="../www/resources.html">Resources</a>
+ </li>
+ <li class="nav-item ">
+ <a class="nav-link" href="../www/develop.html">Develop</a>
+ </li>
+ <li class="nav-item">
+ <a class="nav-link" target="_blank" href="https://imagemagick.org/discourse-server/">Community</a>
+ </li>
+ </ul>
+ <form class="form-inline my-2 my-lg-0" action="https://imagemagick.org/script/search.php">
+ <input class="form-control mr-sm-2" type="text" name="q" placeholder="Search" aria-label="Search">
+ <button class="btn btn-outline-success my-2 my-sm-0" type="submit" name="sa">Search</button>
+ </form>
+ </div>
+ </nav>
+ <div class="container">
+ <script async="async" src="https://localhost/pagead/js/adsbygoogle.js"></script> <ins class="adsbygoogle"
+ style="display:block"
+ data-ad-client="ca-pub-3129977114552745"
+ data-ad-slot="6345125851"
+ data-ad-format="auto"></ins>
+ <script>
+ (adsbygoogle = window.adsbygoogle || []).push({});
+ </script>
+
+ </div>
+ </header>
+ <main class="container">
+ <div class="magick-template">
+<div class="magick-header">
+<p class="text-center"><a href="color.html#usage">Example Usage</a> • <a href="color.html#models">Color Model Specification</a> • <a href="color.html#color_names">List of Color Names</a></p>
+
+<p class="lead magick-description">A number of ImageMagick options and methods take a color as an argument. The color can then be given as a color name (there is a limited but large set of these; see below) or it can be given as a set of numbers (in decimal or hexadecimal), each corresponding to a channel in an RGB or RGBA color model. HSL, HSLA, HSB, HSBA, CMYK, or CMYKA color models may also be specified. These topics are briefly described in the sections below.</p>
+
+<p>Use the <a href="../contrib/color-converter.html">Color Converter</a> to supply any valid ImageMagick color specification as described below to see a color swatch of that color and to convert to all the other color models.</p>
+
+<h2 class="magick-post-title"><a class="anchor" id="usage"></a>Example Usage</h2>
+
+<p>Each of the following commands produces the same <var>lime</var> border around the image. (Use "double quotes" for Windows.)</p>
+
+<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
+magick -bordercolor 'rgb(0,100%,0)' -border 10 image.jpg image.png</code></pre>
+
+<p>The list of recognized color names (for example, <var>aqua</var>, <var>black</var>, <var>blue</var>, <var>fuchsia</var>, <var>gray</var>, <var>green</var>, <var>lime</var>, <var>maroon</var>, <var>navy</var>, <var>olive</var>, <var>purple</var>, <var>red</var>, <var>silver</var>, <var>teal</var>, <var>white</var>, <var>yellow</var>, and others) is shown in a table further below.</p>
+
+<h2 class="magick-post-title"><a class="anchor" id="models"></a>Color Model Specification</h2>
+
+<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 class="highlight"><code>#f00 #rgb
+#ff0000 #rrggbb
+#ff0000ff #rrggbbaa
+#ffff00000000 #rrrrggggbbbb
+#ffff00000000ffff #rrrrggggbbbbaaaa
+rgb(255, 0, 0) an integer in the range 0—255 for each component
+rgb(100.0%, 0.0%, 0.0%) a float in the range 0—100% for each component</code></pre>
+
+<p>The format of an sRGB value in hexadecimal notation is a '#' immediately followed by either three, six, or twelve hexadecimal characters. The three-digit sRGB notation (#rgb) is converted into six-digit form (#rrggbb) by replicating digits, not by adding zeros. For example, #fb0 expands to #ffbb00. This ensures that white (#ffffff) can be specified with the short notation (#fff) and removes any dependencies on the color depth of the image. Use the hexadecimal notation whenever performance is an issue. ImageMagick does not need to load the expansive color table to interpret a hexadecimal color, e.g., <code>#000000</code>, but it does if <code>black</code> is used instead.</p>
+
+<p>The format of an sRGB value in the functional notation is 'rgb(<var>r</var>,<var>g</var>,<var>b</var>)', where <var>r</var>, <var>g</var>, and <var>b</var> are either three integer or float values in the range 0—255 or three integer or float percentage values in the range 0—100%. The value 255 corresponds to 100%, and to #F or #FF in the hexadecimal notation: rgb(255, 255, 255) = rgb(100%, 100%, 100%) = #FFF = #FFFFFF. </p>
<p>White space characters are allowed around the numerical values, at least if the entire color argument is enclosed in quotes ('single quotes' for Unix-like systems, "double quotes" for Windows).</p>
-<p>The RGB color model is extended in this specification to include <em>alpha</em> to allow specification of the transparency of a color. These examples all specify the same color:</p>
+<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 class="text">
- 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
-</pre>
+<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>
-<p>The format of an RGBA value in the functional notation is 'rgba(<em>r</em>,<em>g</em>,<em>b</em>,<em>a</em>)', where <em>r</em>, <em>g</em>, and <em>b</em> are as described above for the RGB functional notation, and where the alpha value <em>a</em> ranges from 0.0 (fully transparent) to 1.0 (fully opaque).</p>
+<p>The format of an RGBA value in the functional notation is 'rgba(<var>r</var>,<var>g</var>,<var>b</var>,<var>a</var>)', where <var>r</var>, <var>g</var>, and <var>b</var> are as described above for the RGB functional notation, and where the alpha value <var>a</var> ranges from 0.0 (fully transparent) to 1.0 (fully opaque).</p>
-<p>There is also a color called 'none' that is fully transparent. This color is shorthand for <kbd>rgba(0, 0, 0, 0.0)</kbd>.</p>
+<p>There is also a color called 'none' that is fully transparent. This color is shorthand for <code>rgba(0, 0, 0, 0.0)</code>.</p>
-<p>Gray values are conviently defined with a single intensity value or an intensity value and an alpha value:</p>
+<p>Non-linear gray values are conveniently defined with a name, single intensity value or an intensity value and an alpha value:</p>
-<pre class="text">
- gray(50%) mid gray
- graya(50%, 0.5) semi-transparent mid gray
-</pre>
+<pre class="highlight"><code>
+gray50 near mid gray
+gray(127) near mid gray
+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 RGB 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, ligthness or brightness 0—255) or as percentage values relative to these ranges.</p>
+<p>For linear gray values add -colorspace RGB -colorspace Gray or -colorspace LinearGray when creating gray colors. The latter is new as of Imagemagick 6.9.9-29 and 7.0.7-17.</p>
+
+<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>
<p>The HSB color system is geometrically represented as a cone with its apex pointing downward. Hue is measured around the perimeter. Saturation is measured from the axis outward. Brightness is measured from the apex upward.</p>
<p>See <a href="http://en.wikipedia.org/wiki/HSL_and_HSV">http://en.wikipedia.org/wiki/HSL_and_HSV</a> for more details on HSL and HSB color systems.</p>
-<p>Hue is represented as an angle of the color around the circular perimeter of the cone(s) (i.e. the rainbow represented in a circle). Hue values are either integer or floats in the range 0—360 or integer or float percentage values in the range 0—100%. By definition red=0=360 (or 0%=100%), and the other colors are spread around the circle, so green=120 (or 33.3333%), blue=240 (or (66.6667%), etc. As an angle, it implicitly wraps around such that -120=240 and 480=120, for instance. (Students of trigonometry would say that "coterminal angles are equivalent" here; an angle <em>θ</em> can be standardized by computing the equivalent angle, <em>θ</em> mod 360.)</p>
+<p>Hue is represented as an angle of the color around the circular perimeter of the cone(s) (i.e. the rainbow represented in a circle). Hue values are integers or floats in the range 0—360. By definition red=0=360, and the other colors are spread around the circle, so green=120, blue=240, etc. As an angle, it implicitly wraps around such that -120=240 and 480=120, for instance. (Students of trigonometry would say that "coterminal angles are equivalent" here; an angle <var>θ</var> can be standardized by computing the equivalent angle, <var>θ</var> mod 360.)</p>
-<p>Saturation is measure outward from the central axis of the cone(s) toward the perimeter of the cone(s). Saturation may be expressed as an integer or float in the range 0—255 or as an integer or float percentage in the range 0—100. Saturation may be thought of as the absence of any "white" mixed with the base color. Thus 255 or 100% is full saturation and corresponds to a point on the outside surface of the cone (HSB) or double cone (HSL). It will be the most "colorful" region. 0 or 0% is no saturation which results in some shade of gray. It occurs along the central axis of the cone or double cone with black at the bottom apex and white at the top.</p>
+<p>Saturation is measure outward from the central axis of the cone(s) toward the perimeter of the cone(s). Saturation may be expressed as an integer or float in the range 0—255 or as an integer or float percentage in the range 0—100. Saturation may be thought of as the absence of any "white" mixed with the base color. Thus 255 or 100% is full saturation and corresponds to a point on the outside surface of the cone (HSB) or double cone (HSL). It will be the most "colorful" region. 0 or 0% is no saturation which results in some shade of gray. It occurs along the central axis of the cone or double cone with black at the bottom apex and white at the top.</p>
-<p>Brightness and Lightness also may be represented as integers or floats in the range 0—255 or as integer or float percentages in the range 0—100%. Brightness and Lightness are measured from the bottom apex upward to the top of the cone or double cone along the cone(s) central axis. 0 or 0% corresponds to the bottom apex and 255 or 100% corresponds to the top center of the cone for Brightness and to the top apex of the double cone for Lightness.</p>
+<p>Brightness and Lightness also may be represented as integers or floats in the range 0—255 or as integer or float percentages in the range 0—100%. Brightness and Lightness are measured from the bottom apex upward to the top of the cone or double cone along the cone(s) central axis. 0 or 0% corresponds to the bottom apex and 255 or 100% corresponds to the top center of the cone for Brightness and to the top apex of the double cone for Lightness.</p>
<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 class="text">
- hsb(0%, 100%, 100%) or hsl(0, 255, 255) full red
- hsb(33.3333%, 100%, 100%) or hsl(120, 255, 255) full green
- hsb(33.3333%, 100%, 75%) or hsl(120, 255, 191.25) medium green
- hsb(33.3333%, 100%, 50%) or hsl(120, 255, 127.5) dark green
- hsb(33.3333%, 100%, 25%) or hsl(120, 255, 63.75) very dark green
- hsb(33.3333%, 50%, 50%) or hsl(120, 127.5, 127.5) pastel green
-</pre>
+<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
+hsb(120, 100%, 25%) or hsb(120, 255, 63.75) very dark green
+hsb(120, 50%, 50%) or hsb(120, 127.5, 127.5) pastel green</code></pre>
<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 class="text">
- hsl(0%, 100%, 50%) or hsl(0, 255, 127.5) full red
- hsb(33.3333%, 100%, 100%) or hsl(120, 255, 255) white
- hsl(33.3333%, 100%, 75%) or hsl(120, 255, 191.25) pastel green
- hsl(33.3333%, 100%, 50%) or hsl(120, 255, 127.5) full green
- hsl(33.3333%, 100%, 25%) or hsl(120, 255, 63.75) dark green
- hsl(33.3333%, 50%, 50%) or hsl(120, 127.5, 127.5) medium green
-</pre>
+<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
+hsl(120, 100%, 25%) or hsl(120, 255, 63.75) dark green
+hsl(120, 50%, 50%) or hsl(120, 127.5, 127.5) medium green</code></pre>
<p>One advantage of HSB or HSL over RGB is that it can be more intuitive: you can guess at the colors you want, and then tweak. It is also easier to create sets of matching colors (by keeping the hue the same and varying the brightness or lightness and saturation, for example).</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 class="text">
- hsb(33.3333%, 100%, 100%) full green in hsb
- hsba(33.3333%, 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
-
- hsl(33.3333%, 100%, 50%) full green in hsl
- hsla(33.3333%, 100%, 50%, 1.0) the same, with an alpha value of 1.0
- hsl(120, 255, 127.5) full green in hsl
- hsla(120, 255, 127.5, 1.0) the same, with an alpha value of 1.0
-</pre>
-
-<p>Prior to ImageMagick 6.5.6-6, HSL (HSB) could only be specified with Hue in range 0—360, but Saturation and Lightness (Brightness) as percent in range 0—100%.</p>
-
-</div>
-
-<h2><a id="color_names"></a>List of Color Names</h2>
-<div class="doc-section">
+<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
+
+hsl(120, 100%, 50%) full green in hsl
+hsla(120, 100%, 50%, 1.0) the same, with an alpha value of 1.0
+hsl(120, 255, 127.5) full green in hsl
+hsla(120, 255, 127.5, 1.0) the same, with an alpha value of 1.0</code></pre>
+
+<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 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 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 class="highlight"><code>
+icc-color(cmyk, 0.11, 0.48, 0.83, 0.00) cymk
+icc-color(rgb, 1, 0, 0) linear rgb
+icc-color(rgb, red) linear rgb
+icc-color(lineargray, 0.5) linear gray
+icc-color(srgb, 1, 0, 0) non-linear rgb
+icc-color(srgb, red) non-linear rgb
+icc-color(gray, 0.5) non-linear gray
+</code></pre>
+
+<p>Or specify uncalibrated device colors with the <code>device-</code> keyword, for example:</p>
+<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>
+
+<h2 class="magick-post-title"><a class="anchor" id="color_names"></a>List of Color Names</h2>
<p>The table below provides a list of named colors recognized by ImageMagick:</p>
-<table class="doc">
+<table class="table table-sm table-striped">
<tbody>
<tr>
<th align="right">Name</th>
<tr>
<td align="right">maroon</td>
- <td align="center" style="background-color: rgb(128, 0, 0)">maroon</td>
+ <td align="center" style="background-color: rgb(128, 0, 0)">maroon (SVG compliance)</td>
<td align="left">rgb(128, 0, 0)</td>
<td align="left">#800000</td>
</tr>
<tr>
<td align="right">maroon</td>
- <td align="center" style="background-color: rgb(176, 48, 96)">maroon</td>
+ <td align="center" style="background-color: rgb(176, 48, 96)">maroon (X11 compliance)</td>
<td align="left">rgb(176, 48, 96)</td>
<td align="left">#B03060</td>
</tr>
<tr>
<td align="right">purple</td>
- <td align="center" style="background-color: rgb(128, 0, 128)">purple</td>
+ <td align="center" style="background-color: rgb(128, 0, 128)">purple (SVG compliance)</td>
<td align="left">rgb(128, 0, 128)</td>
<td align="left">#800080</td>
</tr>
<tr>
<td align="right">purple</td>
- <td align="center" style="background-color: rgb(160, 32, 240)">purple</td>
+ <td align="center" style="background-color: rgb(160, 32, 240)">purple (X11 compliance)</td>
<td align="left">rgb(160, 32, 240)</td>
<td align="left">#A020F0</td>
</tr>
</table>
</div>
-\r
-</div>\r
-\r
-<div id="linkbar">\r
- <span id="linkbar-west"> </span>\r
- <span id="linkbar-center">\r
- <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> •\r
- <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
- </span>\r
- <span id="linkbar-east"> </span>\r
- </div>\r
- <div class="footer">\r
- <span id="footer-west">© 1999-2011 ImageMagick Studio LLC</span>\r
- <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
- </div>\r
- <div style="clear: both; margin: 0; width: 100%; "></div>\r
- <script type="text/javascript">\r
- var _gaq = _gaq || [];\r
- _gaq.push(['_setAccount', 'UA-17690367-1']);\r
- _gaq.push(['_trackPageview']);\r
-\r
- (function() {\r
- var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;\r
- ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';\r
- var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);\r
- })();\r
- </script>\r
-</body>\r
-</html>\r
+ </div>
+ </main><!-- /.container -->
+ <footer class="magick-footer">
+ <p><a href="../www/security-policy.html">Security</a> •
+ <a href="../www/architecture.html">Architecture</a> •
+ <a href="../www/links.html">Related</a> •
+ <a href="../www/sitemap.html">Sitemap</a>
+
+ <a href="color.html#"><img class="d-inline" id="wand" alt="And Now a Touch of Magick" width="16" height="16" src="../images/wand.ico"/></a>
+
+ <a href="http://pgp.mit.edu/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> •
+ <a href="../www/support.html">Donate</a> •
+ <a href="../www/https://imagemagick.org/script/contact.php">Contact Us</a>
+ <br/>
+ <small>© 1999-2018 ImageMagick Studio LLC</small></p>
+ </footer>
+
+ <!-- Javascript assets -->
+ <script src="assets/magick.js" crossorigin="anonymous"></script>
+ <script>window.jQuery || document.write('<script src="assets/jquery.min.js"><\/script>')</script>
+</body>
+</html>
projects / imagemagick / blobdiff