Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ImageMagick / bbb6988855991e7b5575638961fed8abca48cc0d / . / www / gradient.html
blob: 5e0ccac67d6c4ac84f9ccae076dedf4eb9dddb1a [file] [log] [blame]
Cristy594d2772015-11-15 10:47:42 -0500[diff] [blame]1
2
3
4
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]5<!DOCTYPE html>
6<html lang="en">
7<head>
Cristybbb69882017-06-30 10:13:32 -0400[diff] [blame^]8 <meta charset="utf-8" />
9 <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no" />
Cristy6549abb2016-11-10 08:25:55 -0500[diff] [blame]10 <title>Image Gradients @ ImageMagick</title>
Cristybbb69882017-06-30 10:13:32 -0400[diff] [blame^]11 <meta name="application-name" content="ImageMagick" />
12 <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 Bézier curves." />
13 <meta name="application-url" content="https://www.imagemagick.org" />
14 <meta name="generator" content="PHP" />
15 <meta name="keywords" content="image, gradients, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert" />
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-2017 ImageMagick Studio LLC" />
23 <meta name="distribution" content="Global" />
24 <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1" />
Cristy912a9222016-06-17 15:37:28 -0400[diff] [blame]25 <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
Cristybbb69882017-06-30 10:13:32 -0400[diff] [blame^]26 <link href="https://www.imagemagick.org/script/gradient.html" rel="canonical" />
27 <link href="../images/wand.png" rel="icon" />
28 <link href="../images/wand.ico" rel="shortcut icon" />
29 <link href="css/magick.css" rel="stylesheet" />
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]30</head>
31<body>
Cristybbb69882017-06-30 10:13:32 -0400[diff] [blame^]32<div class="magick-masthead">
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]33 <div class="container">
Cristy6549abb2016-11-10 08:25:55 -0500[diff] [blame]34 <script async="async" src="http://localhost/pagead/js/adsbygoogle.js"></script> <ins class="adsbygoogle"
Cristy594d2772015-11-15 10:47:42 -0500[diff] [blame]35 style="display:block"
36 data-ad-client="ca-pub-3129977114552745"
37 data-ad-slot="6345125851"
38 data-ad-format="auto"></ins>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]39 <script>
40 (adsbygoogle = window.adsbygoogle || []).push({});
41 </script>
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]42 <nav class="nav magick-nav">
43 <a class="nav-link " href="../index.html">Home</a>
44 <a class="nav-link " href="download.html">Download</a>
45 <a class="nav-link " href="command-line-tools.html">Tools</a>
46 <a class="nav-link " href="command-line-processing.html">Command-line</a>
47 <a class="nav-link " href="resources.html">Resources</a>
48 <a class="nav-link " href="develop.html">Develop</a>
49 <a class="nav-link " href="https://www.imagemagick.org/script/search.php">Search</a>
50 <a class="nav-link float-right" href="https://www.imagemagick.org/discourse-server/">Community</a>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]51 </nav>
52 </div>
53</div>
54<div class="container">
55<div class="magick-header">
56
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]57<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>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]58
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]59<p>For a linear gradient, the operator is either:</p>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]60
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]61<pre><code>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]62gradient:
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]63gradient:color1-color2
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]64</code></pre>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]65
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]66<p> The for a radial gradient, the operator is either:</p>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]67
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]68<pre><code>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]69radial-gradient:
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]70radial-gradient:color1-color2
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]71</code></pre>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]72
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]73<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>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]74
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]75<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>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]76
Cristy6549abb2016-11-10 08:25:55 -0500[diff] [blame]77<p>Gradient colors may be any valid color defined per <a href="https://www.imagemagick.org/script/color.html" target="_blank">https://www.imagemagick.org/script/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>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]78
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]79<p>Here is an example linear gradient:</p>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]80
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]81<pre><code>
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]82convert -size 256x256 gradient: linear_gradient.png
83convert -size 256x256 gradient:white-black linear_gradient.png
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]84</code></pre>
Cristy92721ca2017-06-10 13:26:30 -0400[diff] [blame]85<p><img src="../images/gradients/linear_gradient.png" width="256" height="256" /></p>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]86
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]87<p>If you want a radial gradient, try:</p>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]88
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]89<pre><code>
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]90convert -size 256x256 radial-gradient: radial_gradient.png
91convert -size 256x256 radial-gradient:white-black radial_gradient.png
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]92</code></pre>
Cristy92721ca2017-06-10 13:26:30 -0400[diff] [blame]93<p><img src="../images/gradients/radial_gradient.png" width="256" height="256" /></p>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]94
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]95<p>As of IM 6.9.2.5, gradients have been enhanced through the use of several -defines.</p>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]96
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]97<table class="table table-sm table-striped">
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]98 <tr>
Cristybc232422016-11-22 07:46:18 -0500[diff] [blame]99 <td><code>-define gradient:vector=<var>x1</var>,<var>y1</var>, <var>x2</var>,<var>y2</var></code></td>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]100 <td>Specifies the direction of the linear gradient going from vector1
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]101 (x1,y1) to vector2 (x2,y2). Color1 (fromColor) will be located at vector
102 position x1,y1 and color2 (toColor) will be located at vector position
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]103 x2,y2.</td>
104 </tr>
105
106 <tr>
107 <td><code>-define gradient:center=<var>x</var>,<var>y</var></code></td>
108 <td>Specifies the coordinates of the center point for the radial gradient.
109 The default is the center of the image.</td>
110 </tr>
111
112 <tr>
113 <td><code>-define gradient:radii=<var>x</var>,<var>y</var></code></td>
114 <td>Specifies the x and y radii of the gradient. If the x radius and the y
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]115 radius are equal, the shape of the radial gradient will be a circle. If
116 they differ, then the shape will be an ellipse. The default values are the
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]117 maximum of the half width and half height of the image.</td>
118 </tr>
119
120 <tr>
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]121 <td><code>-define gradient:angle=<var>angle in degrees</var></code></td>
122 <td>For a linear gradient, this specifies the direction of the gradient
123 going from color1 to color2 in a clockwise positive manner relative to
124 north (up). For a radial gradient, this specifies the rotation of the
125 gradient in a clockwise positive manner from its normal X-Y
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]126 orientation.</td>
127 </tr>
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]128
129 <tr>
130 <td><code>-define gradient:bounding-box=<var>width</var>x<var>height</var>+<var>x</var>+<var>y</var></code></td>
131 <td>Limits the gradient to a larger or smaller region than the image
132 dimensions. If the region defined by the bounding box is smaller than the
133 image, then color1 will be the color of the background.</td>
134 </tr>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]135</table>
136
137
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]138<p>We also support two convenience defines for setting the linear gradient direction and the radial gradient shape.</p>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]139
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]140<table class="table table-sm table-striped">
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]141 <tr>
142 <td><code>-define gradient:direction=<em>{NorthWest, North, Northeast, West, East, SouthWest, South, SouthEast}</em></code></td>
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]143 <td>Specifies the direction of the linear gradient towards the
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]144 top/bottom/left/right or diagonal corners.</td>
145 </tr>
146
147 <tr>
Cristybc232422016-11-22 07:46:18 -0500[diff] [blame]148 <td><code>-define gradient:extent=<em>{Circle, Diagonal, Ellipse, Maximum, Minimum}</em></code></td>
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]149 <td>Specifies the shape of an image centered radial gradient. Circle and
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]150 Maximum draw a circular radial gradient even for rectangular shaped images
151 of radius equal to the larger of the half-width and half-height of the
152 image. The Circle and Maximum options are both equivalent to the default
153 radial gradient. The Minimum option draws a circular radial gradient
154 even for rectangular shaped images of radius equal to the smaller of the
155 half-width and half-height of the image. The Diagonal option draws a
156 circular radial gradient even for rectangular shaped images of radius equal
157 to the half-diagonal of the image. The Ellipse options draws an elliptical
158 radial gradient for rectangular shaped images of radii equal to half the
159 width and half the height of the image.</td>
160 </tr>
161</table>
162
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]163<p>Examples</p>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]164
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]165<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>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]166
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]167<pre><code>
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]168convert -size 256x128 -define gradient:direction=north gradient:black-white linear_gradient_default.png
169convert -size 256x128 -define gradient:angle=0 gradient:black-white linear_gradient_default.png
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]170</code></pre>
Cristy92721ca2017-06-10 13:26:30 -0400[diff] [blame]171<p><img src="../images/gradients/linear_gradient_default.png" width="256" height="128" /></p>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]172
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]173<p>The equivalent of </p>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]174
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]175<pre><code>
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]176convert -size 128x256 gradient: -rotate 90 linear_gradient_east.png
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]177</code></pre>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]178
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]179<p>can be generate by either of the following (or by reversing the direction and swapping color1 and color2):</p>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]180
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]181<pre><code>
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]182convert -size 256x128 -define gradient:direction=east gradient:black-white linear_gradient_east.png
183convert -size 256x128 -define gradient:angle=90 gradient:black-white linear_gradient_east.png
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]184</code></pre>
Cristy92721ca2017-06-10 13:26:30 -0400[diff] [blame]185<p><img src="../images/gradients/linear_gradient_east.png" width="256" height="128" /></p>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]186
187
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]188<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>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]189
190
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]191<pre><code>
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]192convert -size 256x128 radial-gradient:black-white radial_gradient_maximum.png
193convert -size 256x128 -define gradient:radii=128,128 radial-gradient:black-white radial_gradient_maximum.png
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]194</code></pre>
Cristy92721ca2017-06-10 13:26:30 -0400[diff] [blame]195<p><img src="../images/gradients/radial_gradient_maximum.png" width="256" height="128" /></p>
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]196
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]197<pre><code>
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]198convert -size 256x128 -define gradient:extent=minimum radial-gradient:black-white radial_gradient_minimum.png
199convert -size 256x128 -define gradient:radii=64,64 radial-gradient:black-white radial_gradient_minimum.png
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]200</code></pre>
Cristy92721ca2017-06-10 13:26:30 -0400[diff] [blame]201<p><img src="../images/gradients/radial_gradient_minimum.png" width="256" height="128" /></p>
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]202
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]203<pre><code>
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]204convert -size 256x128 -define gradient:extent=diagonal radial-gradient:black-white radial_gradient_diagonal.png
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]205</code></pre>
Cristy92721ca2017-06-10 13:26:30 -0400[diff] [blame]206<p><img src="../images/gradients/radial_gradient_diagonal.png" width="256" height="128" /></p>
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]207
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]208<pre><code>
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]209convert -size 256x128 -define gradient:extent=ellipse radial-gradient:black-white radial_gradient_ellipse.png
210convert -size 256x128 -define gradient:radii=128,64 radial-gradient:black-white radial_gradient_ellipse.png
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]211</code></pre>
Cristy92721ca2017-06-10 13:26:30 -0400[diff] [blame]212<p><img src="../images/gradients/radial_gradient_ellipse.png" width="256" height="128" /></p>
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]213
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]214<pre><code>
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]215convert -size 256x256 -define gradient:radii=128,64 -define gradient:angle=45 radial-gradient:black-white radial_gradient_ellipse_angle45.png
Cristy49380402017-06-29 11:24:55 -0400[diff] [blame]216</code></pre>
Cristy92721ca2017-06-10 13:26:30 -0400[diff] [blame]217<p><img src="../images/gradients/radial_gradient_ellipse_angle45.png" width="256" height="256" /></p>
Cristye93be682015-11-26 09:07:51 -0500[diff] [blame]218
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]219</div>
220
221 <footer class="magick-footer">
222 <p><a href="support.html">Donate</a> •
223 <a href="sitemap.html">Sitemap</a> •
224 <a href="links.html">Related</a> •
Cristye0779712016-07-30 17:25:22 -0400[diff] [blame]225 <a href="security-policy.html">Security</a> •
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]226 <a href="architecture.html">Architecture</a>
227</p>
228 <p><a href="gradient.html#">Back to top</a> •
229 <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&amp;search=0x89AB63D48277377A">Public Key</a> •
Cristy6549abb2016-11-10 08:25:55 -0500[diff] [blame]230 <a href="https://www.imagemagick.org/script/contact.php">Contact Us</a></p>
Cristyfe36f992016-12-29 20:24:13 -0500[diff] [blame]231 <p><small>© 1999-2017 ImageMagick Studio LLC</small></p>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]232 </footer>
233</div><!-- /.container -->
234
Cristyb7f455a2017-03-03 19:30:34 -0500[diff] [blame]235 <script src="https://localhost/ajax/libs/jquery/1.12.4/jquery.min.js"></script>
Cristy1f1f3a02016-06-01 07:25:42 -0400[diff] [blame]236 <script src="../js/magick.html"></script>
Cristy882d9f42015-10-29 16:48:39 -0400[diff] [blame]237</body>
238</html>
Cristybbb69882017-06-30 10:13:32 -0400[diff] [blame^]239<!-- Magick Cache 30th June 2017 09:55 -->