1 2 3 4 5 <!DOCTYPE html> 6 <html lang="en"> 7 <head> 8 <title>ImageMagick: Image Gradients</title> 9 <meta charset="utf-8" /> 10 <meta http-equiv="X-UA-Compatible" content="IE=edge" /> 11 <meta name="viewport" content="width=device-width, initial-scale=1" /> 12 <meta http-equiv="content-type" content="text/html; charset=utf-8"/> 13 <meta name="application-name" content="ImageMagick"/> 14 <meta name="description" content="ImageMagick is a software suite to create, edit, compose, or convert bitmap images. It can read and write images in a variety of formats (over 200) including PNG, JPEG, JPEG-2000, GIF, WebP, Postscript, PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bzier curves."/> 15 <meta name="application-url" content="http://www.imagemagick.org"/> 16 <meta name="generator" content="PHP"/> 17 <meta name="keywords" content="image, gradients, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert"/> 18 <meta name="rating" content="GENERAL"/> 19 <meta name="robots" content="INDEX, FOLLOW"/> 20 <meta name="generator" content="ImageMagick Studio LLC"/> 21 <meta name="author" content="ImageMagick Studio LLC"/> 22 <meta name="revisit-after" content="2 DAYS"/> 23 <meta name="resource-type" content="document"/> 24 <meta name="copyright" content="Copyright (c) 1999-2016 ImageMagick Studio LLC"/> 25 <meta name="distribution" content="Global"/> 26 <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1"/> 27 <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" /> 28 <link rel="icon" href="../images/wand.png"/> 29 <link rel="shortcut icon" href="../images/wand.ico"/> 30 <link rel="stylesheet" type="text/css" href="http://fonts.googleapis.com/css?family=Roboto:900,400,400italic,700,700italic,300,300italic|Open+Sans:300italic,400italic,700italic,300,400,600,700"> 31 <link rel="stylesheet" href="css/magick.css"/> 32 </head> 33 <body> 34 <div class="main"> 35 <div class="magick-masthead"> 36 <div class="container"> 37 <script async="async" src="http://localhost/pagead/js/adsbygoogle.js"></script> <ins class="adsbygoogle" 38 style="display:block" 39 data-ad-client="ca-pub-3129977114552745" 40 data-ad-slot="6345125851" 41 data-ad-format="auto"></ins> 42 <script> 43 (adsbygoogle = window.adsbygoogle || []).push({}); 44 </script> 45 <nav class="magick-nav"> 46 <a class="magick-nav-item " href="../index.html">Home</a> 47 <a class="magick-nav-item " href="binary-releases.html">Download</a> 48 <a class="magick-nav-item " href="command-line-tools.html">Tools</a> 49 <a class="magick-nav-item " href="command-line-processing.html">Command-line</a> 50 <a class="magick-nav-item " href="resources.html">Resources</a> 51 <a class="magick-nav-item " href="api.html">Develop</a> 52 <a class="magick-nav-item " href="http://www.imagemagick.org/script/search.php">Search</a> 53 <a class="magick-nav-item pull-right" href="https://www.imagemagick.org/discourse-server/">Community</a> 54 </nav> 55 </div> 56 </div> 57 <div class="container"> 58 <div class="magick-header"> 59 60 <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> 61 62 <p>For a linear gradient, the operator is either:</p> 63 64 <pre> 65 gradient: 66 gradient:color1-color2 67 </pre> 68 69 <p> The for a radial gradient, the operator is either:</p> 70 71 <pre> 72 radial-gradient: 73 radial-gradient:color1-color2 74 </pre> 75 76 <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> 77 78 <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> 79 80 <p>Gradient colors may be any valid color defined per <a href="color.html" target="_blank">http://www.imagemagick.org/www/color.html</a>. The named colors of black/white/grayXX are non-linear gray gradients; whereas gray(XX[%]) is a linear gray gradient. For Unix systems, enclose rgb(a) and hex colors in quotes. Use double quotes, if using variables for the values.</p> 81 82 <p>Here is an example linear gradient:</p> 83 84 <pre> 85 convert -size 256x256 gradient: linear_gradient.png 86 convert -size 256x256 gradient:white-black linear_gradient.png 87 </pre> 88 <p><img src="../images/gradients/linear_gradient.png" width="256" height="256"></p> 89 90 <p>If you want a radial gradient, try:</p> 91 92 <pre> 93 convert -size 256x256 radial-gradient: radial_gradient.png 94 convert -size 256x256 radial-gradient:white-black radial_gradient.png 95 </pre> 96 <p><img src="../images/gradients/radial_gradient.png" width="256" height="256"></p> 97 98 <p>As of IM 6.9.2.5, gradients have been enhanced through the use of several -defines.</p> 99 100 <table class="table table-condensed table-striped"> 101 <tr> 102 <td><code>-define gradient:vector=<var>x1</var>,<var>y1</var>, <var>x2</var>,<var>y2</var></code> <code></td> 103 <td>Specifies the direction of the linear gradient going from vector1 104 (x1,y1) to vector2 (x2,y2). Color1 (fromColor) will be located at vector 105 position x1,y1 and color2 (toColor) will be located at vector position 106 x2,y2.</td> 107 </tr> 108 109 <tr> 110 <td><code>-define gradient:center=<var>x</var>,<var>y</var></code></td> 111 <td>Specifies the coordinates of the center point for the radial gradient. 112 The default is the center of the image.</td> 113 </tr> 114 115 <tr> 116 <td><code>-define gradient:radii=<var>x</var>,<var>y</var></code></td> 117 <td>Specifies the x and y radii of the gradient. If the x radius and the y 118 radius are equal, the shape of the radial gradient will be a circle. If 119 they differ, then the shape will be an ellipse. The default values are the 120 maximum of the half width and half height of the image.</td> 121 </tr> 122 123 <tr> 124 <td><code>-define gradient:angle=<var>angle in degrees</var></code></td> 125 <td>For a linear gradient, this specifies the direction of the gradient 126 going from color1 to color2 in a clockwise positive manner relative to 127 north (up). For a radial gradient, this specifies the rotation of the 128 gradient in a clockwise positive manner from its normal X-Y 129 orientation.</td> 130 </tr> 131 132 <tr> 133 <td><code>-define gradient:bounding-box=<var>width</var>x<var>height</var>+<var>x</var>+<var>y</var></code></td> 134 <td>Limits the gradient to a larger or smaller region than the image 135 dimensions. If the region defined by the bounding box is smaller than the 136 image, then color1 will be the color of the background.</td> 137 </tr> 138 </table> 139 140 141 <p>We also support two convenience defines for setting the linear gradient direction and the radial gradient shape.</p> 142 143 <table class="table table-condensed table-striped"> 144 <tr> 145 <td><code>-define gradient:direction=<em>{NorthWest, North, Northeast, West, East, SouthWest, South, SouthEast}</em></code></td> 146 <td>Specifies the direction of the linear gradient towards the 147 top/bottom/left/right or diagonal corners.</td> 148 </tr> 149 150 <tr> 151 <td><code>-define gradient:extent=<em>{Circle, Diagonal, Ellipse, Maximum, Minimum}</code></td> 152 <td>Specifies the shape of an image centered radial gradient. Circle and 153 Maximum draw a circular radial gradient even for rectangular shaped images 154 of radius equal to the larger of the half-width and half-height of the 155 image. The Circle and Maximum options are both equivalent to the default 156 radial gradient. The Minimum option draws a circular radial gradient 157 even for rectangular shaped images of radius equal to the smaller of the 158 half-width and half-height of the image. The Diagonal option draws a 159 circular radial gradient even for rectangular shaped images of radius equal 160 to the half-diagonal of the image. The Ellipse options draws an elliptical 161 radial gradient for rectangular shaped images of radii equal to half the 162 width and half the height of the image.</td> 163 </tr> 164 </table> 165 166 <p>Examples</p> 167 168 <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> 169 170 <pre> 171 convert -size 256x128 -define gradient:direction=north gradient:black-white linear_gradient_default.png 172 convert -size 256x128 -define gradient:angle=0 gradient:black-white linear_gradient_default.png 173 </pre> 174 <p><img src="../images/gradients/linear_gradient_default.png" width="256" height="128"></p> 175 176 <p>The equivalent of </p> 177 178 <pre> 179 convert -size 128x256 gradient: -rotate 90 linear_gradient_east.png 180 </pre> 181 182 <p>can be generate by either of the following (or by reversing the direction and swapping color1 and color2):</p> 183 184 <pre> 185 convert -size 256x128 -define gradient:direction=east gradient:black-white linear_gradient_east.png 186 convert -size 256x128 -define gradient:angle=90 gradient:black-white linear_gradient_east.png 187 </pre> 188 <p><img src="../images/gradients/linear_gradient_east.png" width="256" height="128"></p> 189 190 191 <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> 192 193 194 <pre> 195 convert -size 256x128 radial-gradient:black-white radial_gradient_maximum.png 196 convert -size 256x128 -define gradient:radii=128,128 radial-gradient:black-white radial_gradient_maximum.png 197 </pre> 198 <p><img src="../images/gradients/radial_gradient_maximum.png" width="256" height="128"></p> 199 200 <pre> 201 convert -size 256x128 -define gradient:extent=minimum radial-gradient:black-white radial_gradient_minimum.png 202 convert -size 256x128 -define gradient:radii=64,64 radial-gradient:black-white radial_gradient_minimum.png 203 </pre> 204 <p><img src="../images/gradients/radial_gradient_minimum.png" width="256" height="128"></p> 205 206 <pre> 207 convert -size 256x128 -define gradient:extent=diagonal radial-gradient:black-white radial_gradient_diagonal.png 208 </pre> 209 <p><img src="../images/gradients/radial_gradient_diagonal.png" width="256" height="128"></p> 210 211 <pre> 212 convert -size 256x128 -define gradient:extent=ellipse radial-gradient:black-white radial_gradient_ellipse.png 213 convert -size 256x128 -define gradient:radii=128,64 radial-gradient:black-white radial_gradient_ellipse.png 214 </pre> 215 <p><img src="../images/gradients/radial_gradient_ellipse.png" width="256" height="128"></p> 216 217 <pre> 218 convert -size 256x256 -define gradient:radii=128,64 -define gradient:angle=45 radial-gradient:black-white radial_gradient_ellipse_angle45.png 219 </pre> 220 <p><img src="../images/gradients/radial_gradient_ellipse_angle45.png" width="256" height="256"></p> 221 222 </div> 223 224 <footer class="magick-footer"> 225 <p><a href="support.html">Donate</a> 226 <a href="sitemap.html">Sitemap</a> 227 <a href="links.html">Related</a> 228 <a href="architecture.html">Architecture</a> 229 </p> 230 <p><a href="gradient.html#">Back to top</a> 231 <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> 232 <a href="http://www.imagemagick.org/script/contact.php">Contact Us</a></p> 233 <p><small> 1999-2016 ImageMagick Studio LLC</small></p> 234 </footer> 235 </div><!-- /.container --> 236 237 <script src="https://localhost/ajax/libs/jquery/1.11.3/jquery.min.js"></script> 238 <script src="../js/magick.html"></script> 239 </div> 240 </body> 241 </html> 242