1 2 3 4 5<!doctype html> 6<html lang="en"> 7<head> 8 <meta charset="utf-8" /> 9 <meta name="viewport" content="width=device-width, initial-scale=1" /> 10 <title>ImageMagick - Image Gradients</title> 11 <meta name="application-name" content="ImageMagick" /> 12 <meta name="description" content="Use ImageMagick® to create, edit, compose, and convert digital images. Resize an image, crop it, change its shades and colors, add captions, and more." /> 13 <meta name="application-url" content="https://imagemagick.org" /> 14 <meta name="generator" content="PHP" /> 15 <meta name="keywords" content="image, gradients, image processing software" /> 16 <meta name="rating" content="GENERAL" /> 17 <meta name="robots" content="INDEX, FOLLOW" /> 18 <meta name="generator" content="ImageMagick Studio LLC" /> 19 <meta name="author" content="ImageMagick Studio LLC" /> 20 <meta name="revisit-after" content="2 DAYS" /> 21 <meta name="resource-type" content="document" /> 22 <meta name="copyright" content="Copyright (c) 1999-2020 ImageMagick Studio LLC" /> 23 <meta name="distribution" content="Global" /> 24 <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1" /> 25 <meta property='og:url' content='../' /> 26 <meta property='og:title' content='ImageMagick' /> 27 <meta property='og:image' content='../images/logo.png' /> 28 <meta property='og:type' content='website' /> 29 <meta property='og:site_name' content='ImageMagick' /> 30 <meta property='og:description' content="Create, Edit, Compose, or Convert Digital Images" /> 31 <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" /> 32 <link href="../www/gradient.html" rel="canonical" /> 33 <link href="../images/wand.png" rel="icon" /> 34 <link href="../images/wand.ico" rel="shortcut icon" /> 35 <link href="assets/magick.css" rel="stylesheet" /> 36</head> 37<body> 38 <nav class="navbar navbar-expand-md navbar-dark bg-dark fixed-top"> 39 <div class="container-fluid"> 40 <a class="navbar-brand" href="../index.html"><img class="d-block" id="icon" alt="ImageMagick" width="32" height="32" src="../images/wand.ico"/></a> 41 <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#magick-navbars" aria-controls="magick-navbars" aria-expanded="false" aria-label="Toggle navigation"> 42 <span class="navbar-toggler-icon"></span> 43 </button> 44 45 <div class="collapse navbar-collapse" id="magick-navbars"> 46 <ul class="navbar-nav me-auto mb-2 mb-md-0"> 47 <li class="nav-item"> 48 <a class="nav-link " href="index.html">Home</a> 49 </li> 50 <li class="nav-item"> 51 <a class="nav-link " href="download.html">Download</a> 52 </li> 53 <li class="nav-item"> 54 <a class="nav-link " href="command-line-tools.html">Tools</a> 55 </li> 56 <li class="nav-item"> 57 <a class="nav-link " href="command-line-processing.html">CLI</a> 58 </li> 59 <li class="nav-item"> 60 <a class="nav-link " href="develop.html">Develop</a> 61 </li> 62 <li class="nav-item"> 63 <a class="nav-link" target="_blank" href="https://github.com/ImageMagick/ImageMagick/discussions">Community</a> 64 </li> 65 <li class="nav-item"> 66 <iframe src="https://github.com/sponsors/ImageMagick/button" title="Sponsor ImageMagick" height="35" width="107" style="border: 0;"></iframe> 67 </li> 68 </ul> 69 <form class="d-flex form-inline" action="../www/search.html"> 70 <input class="form-control me-2" type="text" name="q" placeholder="Search" aria-label="Search"> 71 <button class="btn btn-outline-success" type="submit" name="sa">Search</button> 72 </form> 73 </div> 74 </div> 75 </nav> 76 77 <div class="container"> 78 <script async="async" src="http://localhost/pagead/js/adsbygoogle.js"></script> 79 <ins class="adsbygoogle" 80 style="display:block" 81 data-ad-client="ca-pub-3129977114552745" 82 data-ad-slot="6345125851" 83 data-full-width-responsive="true" 84 data-ad-format="horizontal"></ins> 85 <script> 86 (adsbygoogle = window.adsbygoogle || []).push({}); 87 </script> 88 89 </div> 90 91 <main class="container"> 92 <div class="magick-template"> 93<div class="magick-header"> 94<h1 class="text-center">Create a Gradual Blend of Two Colors</h1> 95<p class="lead magick-description">An image gradient creates a gradual blend between two colors formed into a shape that is linear, circular, or ellipical.</p> 96 97<p>For a linear gradient, the operator is either:</p> 98 99<pre class="highlight"><code>gradient: 100gradient:color1-color2 101</code></pre> 102 103<p> The for a radial gradient, the operator is either:</p> 104 105<pre class="highlight"><code>radial-gradient: 106radial-gradient:color1-color2 107</code></pre> 108 109<p> In the above, color1 is the fromColor and color2 is the toColor, as described in more detail below. The default is white for color1 and black for color2, i.e., white-black.</p> 110 111<p>The default for a linear gradient has color1 at the top of the image and color2 at the bottom of the image. Similarly, the default for a radial gradient has color1 at the center of the image and color2 at the boundary of the image.</p> 112 113<p>Gradient colors may be any valid color defined per <a href="color.html" target="_blank">../www/color.html</a>. The named colors of black/white/grayXX and gray(XX[%]) are non-linear gray. For Unix systems, enclose rgb(a) and hex colors in quotes. Use double quotes, if using variables for the values.</p> 114 115<p>Here is an example linear (as opposed to radial) gradient:</p> 116 117<pre class="highlight"><code>magick -size 256x256 gradient: linear_gradient.png 118magick -size 256x256 gradient:white-black linear_gradient.png 119</code></pre> 120<p><img src="../images/gradients/linear_gradient.png" width="256" height="256" /></p> 121 122<p>If you want a radial gradient, try:</p> 123 124<pre class="highlight"><code>magick -size 256x256 radial-gradient: radial_gradient.png 125magick -size 256x256 radial-gradient:white-black radial_gradient.png 126</code></pre> 127<p><img src="../images/gradients/radial_gradient.png" width="256" height="256" /></p> 128 129<p>If you want non-linear grayscale gradients, then add -colorspace RGB -colorspace gray 130before saving the output. For example:<p> 131 132<pre class="highlight"><code>magick -size 256x256 gradient: linear_gradient.png 133magick -size 256x256 gradient:white-black -colorspace RGB -colorspace gray linear_linear_gradient.png 134</code></pre> 135 136<pre class="highlight"><code>magick -size 256x256 radial-gradient: radial_gradient.png 137magick -size 256x256 radial-gradient:white-black -colorspace RGB -colorspace gray linea_radial_gradient.png 138</code></pre> 139 140<p>As of IM 6.9.2.5, gradients have been enhanced through the use of several -defines.</p> 141 142<table class="table table-sm table-hover"> 143 <tr> 144 <td><code>-define gradient:vector=<var>x1</var>,<var>y1</var>, <var>x2</var>,<var>y2</var></code></td> 145 <td>Specifies the direction of the linear gradient going from vector1 146 (x1,y1) to vector2 (x2,y2). Color1 (fromColor) will be located at vector 147 position x1,y1 and color2 (toColor) will be located at vector position 148 x2,y2.</td> 149 </tr> 150 151 <tr> 152 <td><code>-define gradient:center=<var>x</var>,<var>y</var></code></td> 153 <td>Specifies the coordinates of the center point for the radial gradient. 154 The default is the center of the image.</td> 155 </tr> 156 157 <tr> 158 <td><code>-define gradient:radii=<var>x</var>,<var>y</var></code></td> 159 <td>Specifies the x and y radii of the gradient. If the x radius and the y 160 radius are equal, the shape of the radial gradient will be a circle. If 161 they differ, then the shape will be an ellipse. The default values are the 162 maximum of the half width and half height of the image.</td> 163 </tr> 164 165 <tr> 166 <td><code>-define gradient:angle=<var>angle in degrees</var></code></td> 167 <td>For a linear gradient, this specifies the direction of the gradient 168 going from color1 to color2 in a clockwise positive manner relative to 169 north (up). For a radial gradient, this specifies the rotation of the 170 gradient in a clockwise positive manner from its normal X-Y 171 orientation.</td> 172 </tr> 173 174 <tr> 175 <td><code>-define gradient:bounding-box=<var>width</var>x<var>height</var>+<var>x</var>+<var>y</var></code></td> 176 <td>Limits the gradient to a larger or smaller region than the image 177 dimensions. If the region defined by the bounding box is smaller than the 178 image, then color1 will be the color of the background.</td> 179 </tr> 180</table> 181 182 183<p>We also support two convenience defines for setting the linear gradient direction and the radial gradient shape.</p> 184 185<table class="table table-sm table-hover"> 186 <tr> 187 <td><code>-define gradient:direction=<em>{NorthWest, North, Northeast, West, East, SouthWest, South, SouthEast}</em></code></td> 188 <td>Specifies the direction of the linear gradient towards the 189 top/bottom/left/right or diagonal corners.</td> 190 </tr> 191 192 <tr> 193 <td><code>-define gradient:extent=<em>{Circle, Diagonal, Ellipse, Maximum, Minimum}</em></code></td> 194 <td>Specifies the shape of an image centered radial gradient. Circle and 195 Maximum draw a circular radial gradient even for rectangular shaped images 196 of radius equal to the larger of the half-width and half-height of the 197 image. The Circle and Maximum options are both equivalent to the default 198 radial gradient. The Minimum option draws a circular radial gradient 199 even for rectangular shaped images of radius equal to the smaller of the 200 half-width and half-height of the image. The Diagonal option draws a 201 circular radial gradient even for rectangular shaped images of radius equal 202 to the half-diagonal of the image. The Ellipse options draws an elliptical 203 radial gradient for rectangular shaped images of radii equal to half the 204 width and half the height of the image.</td> 205 </tr> 206</table> 207 208<p>Examples</p> 209 210<p>The default linear gradient may also be generated in any of the following ways (or by reversing the direction and swapping color1 and color2):</p> 211 212<pre class="highlight"><code>magick -size 256x128 -define gradient:direction=north gradient:black-white linear_gradient_default.png 213magick -size 256x128 -define gradient:angle=0 gradient:black-white linear_gradient_default.png 214</code></pre> 215<p><img src="../images/gradients/linear_gradient_default.png" width="256" height="128" /></p> 216 217<p>The equivalent of </p> 218 219<pre class="highlight"><code>magick -size 128x256 gradient: -rotate 90 linear_gradient_east.png 220</code></pre> 221 222<p>can be generate by either of the following (or by reversing the direction and swapping color1 and color2):</p> 223 224<pre class="highlight"><code>magick -size 256x128 -define gradient:direction=east gradient:black-white linear_gradient_east.png 225magick -size 256x128 -define gradient:angle=90 gradient:black-white linear_gradient_east.png 226</code></pre> 227<p><img src="../images/gradients/linear_gradient_east.png" width="256" height="128" /></p> 228 229 230<p>Examples of radial gradients going from black in the center to white at the boundary for the cases of "maximum/circle/default", "minimum", "diagonal", "ellipse" and 45 degree rotated ellipse, respectively, follow below.</p> 231 232 233<pre class="highlight"><code>magick -size 256x128 radial-gradient:black-white radial_gradient_maximum.png 234magick -size 256x128 -define gradient:radii=128,128 radial-gradient:black-white radial_gradient_maximum.png 235</code></pre> 236<p><img src="../images/gradients/radial_gradient_maximum.png" width="256" height="128" /></p> 237 238<pre class="highlight"><code>magick -size 256x128 -define gradient:extent=minimum radial-gradient:black-white radial_gradient_minimum.png 239magick -size 256x128 -define gradient:radii=64,64 radial-gradient:black-white radial_gradient_minimum.png 240</code></pre> 241<p><img src="../images/gradients/radial_gradient_minimum.png" width="256" height="128" /></p> 242 243<pre class="highlight"><code>magick -size 256x128 -define gradient:extent=diagonal radial-gradient:black-white radial_gradient_diagonal.png 244</code></pre> 245<p><img src="../images/gradients/radial_gradient_diagonal.png" width="256" height="128" /></p> 246 247<pre class="highlight"><code>magick -size 256x128 -define gradient:extent=ellipse radial-gradient:black-white radial_gradient_ellipse.png 248magick -size 256x128 -define gradient:radii=128,64 radial-gradient:black-white radial_gradient_ellipse.png 249</code></pre> 250<p><img src="../images/gradients/radial_gradient_ellipse.png" width="256" height="128" /></p> 251 252<pre class="highlight"><code>conmagickvert -size 256x256 -define gradient:radii=128,64 -define gradient:angle=45 radial-gradient:black-white radial_gradient_ellipse_angle45.png 253</code></pre> 254<p><img src="../images/gradients/radial_gradient_ellipse_angle45.png" width="256" height="256" /></p> 255 256</div> 257 258 </div> 259 </main><!-- /.container --> 260 <footer class="magick-footer"> 261 <div class="container-fluid"> 262 <a href="security-policy.html">Security</a> • 263 <a href="news.html">News</a> 264 265 <a href="gradient.html#"><img class="d-inline" id="wand" alt="And Now a Touch of Magick" width="16" height="16" src="../images/wand.ico"/></a> 266 267 <a href="links.html">Related</a> • 268 <a href="sitemap.html">Sitemap</a> 269 <br/> 270 <a href="support.html">Sponsor</a> • 271 <a href="cite.html">Cite</a> • 272 <a href="http://pgp.mit.edu/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> • 273 <a href="https://imagemagick.org/script/contact.php">Contact Us</a> 274 <br/> 275 <a href="https://github.com/imagemagick/imagemagick" target="_blank" rel="noopener" aria-label="GitHub"><svg xmlns="http://www.w3.org/2000/svg" class="navbar-nav-svg" viewBox="0 0 512 499.36" width="2%" height="2%" role="img" focusable="false"><title>GitHub</title><path fill="currentColor" fill-rule="evenodd" d="M256 0C114.64 0 0 114.61 0 256c0 113.09 73.34 209 175.08 242.9 12.8 2.35 17.47-5.56 17.47-12.34 0-6.08-.22-22.18-.35-43.54-71.2 15.49-86.2-34.34-86.2-34.34-11.64-29.57-28.42-37.45-28.42-37.45-23.27-15.84 1.73-15.55 1.73-15.55 25.69 1.81 39.21 26.38 39.21 26.38 22.84 39.12 59.92 27.82 74.5 21.27 2.33-16.54 8.94-27.82 16.25-34.22-56.84-6.43-116.6-28.43-116.6-126.49 0-27.95 10-50.8 26.35-68.69-2.63-6.48-11.42-32.5 2.51-67.75 0 0 21.49-6.88 70.4 26.24a242.65 242.65 0 0 1 128.18 0c48.87-33.13 70.33-26.24 70.33-26.24 14 35.25 5.18 61.27 2.55 67.75 16.41 17.9 26.31 40.75 26.31 68.69 0 98.35-59.85 120-116.88 126.32 9.19 7.9 17.38 23.53 17.38 47.41 0 34.22-.31 61.83-.31 70.23 0 6.85 4.61 14.81 17.6 12.31C438.72 464.97 512 369.08 512 256.02 512 114.62 397.37 0 256 0z"/></svg></a> • 276 <a href="https://twitter.com/imagemagick" target="_blank" rel="noopener" aria-label="Twitter"><svg xmlns="http://www.w3.org/2000/svg" class="navbar-nav-svg" viewBox="0 0 512 416.32" width="2%" height="2%" role="img" focusable="false"><title>Twitter</title><path fill="currentColor" d="M160.83 416.32c193.2 0 298.92-160.22 298.92-298.92 0-4.51 0-9-.2-13.52A214 214 0 0 0 512 49.38a212.93 212.93 0 0 1-60.44 16.6 105.7 105.7 0 0 0 46.3-58.19 209 209 0 0 1-66.79 25.37 105.09 105.09 0 0 0-181.73 71.91 116.12 116.12 0 0 0 2.66 24c-87.28-4.3-164.73-46.3-216.56-109.82A105.48 105.48 0 0 0 68 159.6a106.27 106.27 0 0 1-47.53-13.11v1.43a105.28 105.28 0 0 0 84.21 103.06 105.67 105.67 0 0 1-47.33 1.84 105.06 105.06 0 0 0 98.14 72.94A210.72 210.72 0 0 1 25 370.84a202.17 202.17 0 0 1-25-1.43 298.85 298.85 0 0 0 160.83 46.92"/></svg></a> 277 <br/> 278 <small>© 1999-2021 ImageMagick Studio LLC</small> 279 </div> 280 </footer> 281 282 <!-- Javascript assets --> 283 <script src="assets/magick.js" ></script> 284 </body> 285</html> 286<!-- Magick Cache 13th February 2021 14:08 -->
