Debian Codegraph @

www/convex-hull.html

raw ◀ ▶
Source reconstructed at patch state 1 of 3 — not the installed (fully patched) source.
3 Debian patches touch this file
1
2
3
4 <!DOCTYPE html>
5 <html lang="en" data-bs-theme="dark">
6 <head>
7 <meta charset="utf-8" />
8 <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
9
10 <!-- Title and Description -->
11 <title>ImageMagick | Convex Hull</title>
12 <meta name="description" content="ImageMagick is a powerful open-source software suite for creating, editing, converting, and manipulating images in over 200 formats. Ideal for developers, designers, and researchers." />
13
14 <!-- Canonical URL -->
15 <link rel="canonical" href="convex-hull.html" />
16
17 <!-- Robots -->
18 <meta name="robots" content="index, follow" />
19
20 <!-- Theme Color -->
21 <meta name="theme-color" content="#000000" />
22
23 <!-- Verification Tags -->
24 <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
25
26 <!-- Favicon and Apple Icon -->
27 <link rel="shortcut icon" href="../images/wand.png" type="images/png" />
28 <link rel="apple-touch-icon" href="../images/wand.png" type="images/png" />
29
30 <!-- Preconnect for External Resources -->
31 <link rel="preconnect" href="../index.html" />
32
33 <!-- Stylesheets -->
34 <link rel="preload" href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" as="style" crossorigin="anonymous" />
35 <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" />
36
37 <!-- Accessibility Enhancement -->
38 <style>
39 html {
40 scroll-padding-top: 70px;
41 }
42 a.nav-link:hover,
43 a.dropdown-item:hover {
44 color: #ffc107 !important;
45 text-shadow: 0px 2px 4px rgba(255, 193, 7, 0.8);
46 }
47 .btn-outline-warning {
48 color: #cd7f32;
49 border-color: #cd7f32;
50 }
51 .navbar-brand {
52 color: #d4af37;
53 transition: color 0.3s ease, text-shadow 0.3s ease;
54 }
55 .navbar-brand:hover {
56 color: #e9c03d;
57 text-shadow: 0px 2px 4px rgba(203, 163, 120, 0.6);
58 }
59 </style>
60
61 <!-- Open Graph Meta Tags -->
62 <meta property="og:title" content="ImageMagick | Convex Hull" />
63 <meta property="og:description" content="ImageMagick is a powerful open-source software suite for creating, editing, converting, and manipulating images in over 200 formats. Ideal for developers, designers, and researchers." />
64 <meta property="og:image" content="../images/logo.png" />
65 <meta property="og:logo" content="../images/logo.png" />
66 <meta property="og:url" content="../www/convex-hull.html" />
67 <meta property="og:type" content="website" />
68 <meta property="og:site_name" content="ImageMagick" />
69 <meta property="og:locale" content="en_us" />
70
71 <!-- Twitter Card Meta Tags -->
72 <meta name="twitter:card" content="summary_large_image" />
73 <meta name="twitter:site" content="@imagemagick" />
74 <meta name="twitter:creator" content="@imagemagick" />
75 <meta name="twitter:title" content="ImageMagick | Convex Hull" />
76 <meta name="twitter:description" content="ImageMagick is a powerful open-source software suite for creating, editing, converting, and manipulating images in over 200 formats. Ideal for developers, designers, and researchers." />
77 <meta name="twitter:image" content="../images/logo.png" />
78 <meta name="twitter:image:alt" content="ImageMagick logo and tag line" />
79
80 <!-- JSON-LD Structured Data -->
81 <script type="application/ld+json">
82 {
83 "@context": "https://schema.org",
84 "@type": "SoftwareApplication",
85 "name": "ImageMagick",
86 "url": "../www/convex-hull.html",
87 "image": "../images/logo.png",
88 "description": "ImageMagick is a powerful open-source software suite for creating, editing, converting, and manipulating images in over 200 formats. Ideal for developers, designers, and researchers.",
89 "applicationCategory": "Multimedia",
90 "operatingSystem": "Windows, macOS, Linux, Unix",
91 "softwareVersion": "7.1.2-3",
92 "license": "../www/license.html",
93 "creator": {
94 "@type": "Organization",
95 "name": "ImageMagick Studio LLC",
96 "url": "https://imagemagick.org"
97 },
98 "keywords": [
99 "Convex Hull",
100 "image processing software",
101 "image conversion tool",
102 "batch image editing",
103 "open-source image editor",
104 "ImageMagick command-line",
105 "resize images ImageMagick",
106 "crop and rotate images",
107 "ImageMagick tutorial",
108 "ImageMagick automation",
109 "ImageMagick for developers",
110 "ImageMagick CLI",
111 "ImageMagick filters and effects",
112 "ImageMagick scripting",
113 "ImageMagick API integration"
114 ],
115 "sameAs": [
116 "https://github.com/ImageMagick",
117 "https://x.com/imagemagick"
118 ],
119 "offers": {
120 "@type": "Offer",
121 "price": "0.00",
122 "priceCurrency": "USD"
123 }
124 }
125 </script>
126 <!-- Google Custom Search -->
127 </head>
128 <body>
129 <script>
130 function setTheme(theme) {
131 localStorage.setItem('theme', theme);
132 updateThemeIcon(theme);
133 document.documentElement.setAttribute('data-bs-theme', theme === 'auto' ? getSystemTheme() : theme);
134 }
135 function getSystemTheme() {
136 return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
137 }
138 function updateThemeIcon(theme) {
139 const iconMap = {
140 light: '☀️',
141 dark: '🌙',
142 auto: '🌓'
143 };
144 document.getElementById('currentThemeIcon').textContent = iconMap[theme] || '🌓';
145 }
146 document.addEventListener('DOMContentLoaded', () => {
147 const savedTheme = localStorage.getItem('theme') || 'auto';
148 setTheme(savedTheme);
149 });
150 </script>
151 <nav class="navbar navbar-expand-md navbar-dark bg-dark fixed-top">
152 <div class="container-fluid">
153 <a class="navbar-brand fw-bold" href="../index.html" title="$meta->sitename;">
154 ImageMagick </a>
155 <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">
156 <span class="navbar-toggler-icon"></span>
157 </button>
158
159 <div class="collapse navbar-collapse" id="magick-navbars">
160 <ul class="navbar-nav me-auto">
161 <li class="nav-item">
162 <a class="nav-link " href="download.html">Download</a>
163 </li>
164 <li class="nav-item">
165 <a class="nav-link " href="command-line-tools.html">Tools</a>
166 </li>
167 <li class="nav-item">
168 <a class="nav-link " href="command-line-processing.html">CLI</a>
169 </li>
170 <li class="nav-item">
171 <a class="nav-link " href="develop.html">Develop</a>
172 </li>
173 <li class="nav-item">
174 <a class="nav-link" rel="noopener noreferrer" target="_blank" href="https://github.com/ImageMagick/ImageMagick/discussions">Community</a>
175 </li>
176 <li class="nav-item ms-4">
177 <iframe src="https://github.com/sponsors/ImageMagick/button" title="Sponsor ImageMagick" height="35" width="107" style="border: 0;"></iframe>
178 </li>
179 </ul>
180 <ul class="navbar-nav ms-auto">
181 <li class="nav-item ms-3">
182 <form class="d-flex form-inline" action="../www/search.html">
183 <input class="form-control me-2" type="text" name="q" placeholder="Search site..." aria-label="Search">
184 <button class="btn btn-outline-warning" type="submit" name="sa">Search</button>
185 </form>
186 </li>
187 <li class="nav-item dropdown ms-3">
188 <a class="nav-link dropdown-toggle" href="#" id="themeDropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false">
189 <span id="currentThemeIcon">🌓</span>
190 </a>
191 <ul class="dropdown-menu dropdown-menu-end" aria-labelledby="themeDropdown">
192 <li><a class="dropdown-item" href="#" onclick="setTheme('light')">☀️ Light</a></li>
193 <li><a class="dropdown-item" href="#" onclick="setTheme('dark')">🌙 Dark</a></li>
194 <li><a class="dropdown-item" href="#" onclick="setTheme('auto')">🌓 Auto</a></li>
195 </ul>
196 </li>
197 </ul>
198 </div>
199 </div>
200 </nav>
201
202 <div class="col-lg-8 mx-auto text-body-secondary pt-5 pt-lg-5">
203 <header class="d-flex align-items-center pb-3 mb-5 border-bottom">
204 <div class="mt-3 ms-3">
205 <a href="../index.html" class="text-decoration-none">
206 <h1 class="fs-2 mb-1">Convex Hull</h1>
207 </a>
208 <h2 class="fs-5 text-muted">ImageMagick</h2>
209 </div>
210 </header>
211
212 <main role="main" class="container">
213 <div>
214 <p class="text-center"><a href="#about">Convex Hull</a> • <a href="#box">Minimum Bounding Box</a> • <a href="#unrotate">Unrotate an Image</a></p>
215
216 <p>The convex hull is the is the smallest area convex polygon containing the set of points inside it. The convex hull may be visualized as the shape enclosed by a rubber band stretched around the set of points.</p>
217
218 <p>The convex-hull string format returns a list of x,y coordinates of the vertices of the convex-hull polygon containing all the non-black pixels within it.</p>
219
220 <pre class="code">
221 magick [-fuzz <var>value</var>%] [-background <var>background-color</var>] -format "%[convex-hull]" info:
222 </pre>
223
224 <p>Use <samp>%[convex-hull:extreme-points]</samp> to only return the top, right, bottom, and left extreme points.</p>
225
226 <p>where the string format is sensitive to an optional <samp>-fuzz</samp> value and to an optional background color specified by the define. The command above will find the background color automatically according to the fuzz value unless the background color is defined. The fuzz value defaults to 0 when not specified.</p>
227
228 <p>For example, consider the following white rectangle on a black background:</p>
229
230 <ul><img class="img-fluid img-thumbnail" src="../images/convex-hull.png" alt="[Convex Hull]" width="250" height="250" name="convert-hull" /></ul>
231
232 <p>The convex hull set of points may be computed as:</p>
233
234 <pre class="code">magick rect.png -format "%[convex-hull]" info:
235 190,121 193,122 281,154 377,189 378,190 377,193 345,281 310,377 309,378 306,377 218,345 122,310 121,309 122,306 154,218 189,122 190,121
236 </pre>
237
238 <p>The convex hull may also be drawn as a polygon (filled or unfilled) using <samp>-draw</samp> as follows:</p>
239
240 <pre class="code">magick rect.png -set option:hull "%[convex-hull]" -fill none -stroke red -strokewidth 1 -draw "polygon %[hull]" blocks_hull.png</pre>
241
242 <p>Here is an example using a non-convex shaped image on a black background:</p>
243
244 <ul><img class="img-fluid img-thumbnail" src="../images/convex-hull-blocks.png" alt="[Convex Hull Blocks]" width="128" height="128" name="convert-hull-blocks" /></ul>
245
246 <pre class="code">magick blocks_black.png -set option:hull "%[convex-hull]" -fill none -stroke red -strokewidth 1 -draw "polygon %[hull]" blocks_hull.png</pre>
247
248 <ul><img class="img-fluid img-thumbnail" src="../images/convex-hull-blocks-closure.png" alt="[Convex Hull Blocks Closure]" width="128" height="128" name="convert-hull" /></ul>
249
250 <p>Finally, here is an example with a non-constant, non-black background using -fuzz to determine the background color:</p>
251
252 <ul><img class="img-fluid img-thumbnail" src="../images/convex-hull-barn.jpg" alt="[Convex Hull Barn]" width="250" height="250" name="convert-hull-barn" /></ul>
253
254 <p>Now let's highlight the convex hull of the image foreground object:</p>
255 <pre class="code">magick barn_rot20.png -fuzz 10% -set hull "%[convex-hull]" -fill none -stroke red -strokewidth 1 -draw "polygon %[hull]" barn_rot20_hull.png</pre>
256
257 <ul><img class="img-fluid img-thumbnail" src="../images/convex-hull-barn-closure.jpg" alt="[Convex Hull Barn Closure]" width="250" height="250" name="convert-hull-barn-closure" /></ul>
258
259 <h2><a class="anchor" id="box"></a>Minimum Bounding Box</h2>
260 <p>Similar to the convex hull of the image foreground object(s), is the minimum bounding box. Use <samp>%[minimum-bounding-box]</samp> to return the points that make up the bounding box. In addition, these properties are set: <samp>minimum-bounding-box:area</samp>, <samp>minimum-bounding-box:width</samp>, <samp>minimum-bounding-box:height</samp>, and <samp>minimum-bounding-box:angle</samp>. </p>
261
262 <pre class="code">magick barn_rot20.png -fuzz 10% -background gray25 -set MBR "%[minimum-bounding-box]" -fill none -stroke red -strokewidth 1 -draw "polygon %[MBR]" barn-mbr.png</pre>
263
264 <h2><a class="anchor" id="unrotate"></a>Unrotate an Image</h2>
265 <p>Use <samp>%[minimum-bounding-box:unrotate]</samp> to correct for any rotation the image may exhibit. Unless you specify the image orientation, the unrotate angle should properly align the image to the correct coordinate axis for angles &lt;= 45. For angles > 45, the image will align with the wrong coordinate axis. Set the correct image orientation to ensure the proper unrotate angle is returned. Use <samp>-define minimum-bounding-box:orientation=<em>{landscape,portrait}</em></samp> to set the image orientation. Note, that like convex-hull, the string format is sensitive to an optional <a href="command-line-options.html#fuzz">-fuzz</a> value and an optional <a href="command-line-options.html#background">-background</a> color.</p>
266
267 <p>The barn image above is rotated by 20 degrees. Here is how we can automatically correct for the rotation and return it to its original landscape orientation:
268
269 <pre class="code">magick barn_rotate20.jpg -fuzz 15% -set option:angle "%[minimum-bounding-box:unrotate]" -background gray -rotate "%[angle]" -trim barn_unrotate.jpg</pre>
270 </p>
271
272 </div>
273 <a aria-label="About ImageMagick" class="btn btn-outline-warning mt-3" href="../index.html">About ImageMagick</a>
274 </main><!-- /.container -->
275 <footer class="text-center pt-5 my-5 text-body-secondary border-top">
276 <div class="container-fluid">
277 <a href="security-policy.html">Security</a> •
278 <a href="../www/news.html">News</a>
279
280 <a href="#"><img class="d-inline" id="wand" alt="And Now a Touch of Magick" width="16" height="16" src="../images/wand.ico" /></a>
281
282 <a href="../www/links.html">Related</a> •
283 <a href="../www/sitemap.html">Sitemap</a>
284 <br>
285 <a href="../www/support.html">Sponsor</a> •
286 <a href="../www/cite.html">Cite</a> •
287 <a href="http://pgp.mit.edu/pks/lookup?op=get&amp;search=0x89AB63D48277377A">Public Key</a> •
288 <a href="../www/https://imagemagick.org/script/contact.php">Contact Us</a>
289 <br>
290 <a href="https://github.com/imagemagick/imagemagick" rel="noopener noreferrer" target="_blank" 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> •
291 <a href="https://twitter.com/imagemagick" rel="noopener noreferrer" target="_blank" aria-label="Twitter"><svg xmlns="http://www.w3.org/2000/svg" class="navbar-nav-svg" viewBox="0 0 300 300" width="2%" height="2%" role="img" focusable="false"><title>Twitter</title><path d="M178.57 127.15 290.27 0h-26.46l-97.03 110.38L89.34 0H0l117.13 166.93L0 300.25h26.46l102.4-116.59 81.8 116.59h89.34M36.01 19.54H76.66l187.13 262.13h-40.66"/></svg></a>
292 <br>
293 <small>Copyright © 1999 ImageMagick Studio LLC</small>
294 </div>
295 </footer>
296 </div>
297
298 <!-- Javascript assets -->
299 <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/js/bootstrap.bundle.min.js" integrity="sha384-FKyoEForCGlyvwx9Hj09JcYn3nv7wiPVlz7YYwJrWVcXK/BmnVDxM+D2scQbITxI" crossorigin="anonymous"></script>
300 ~
301 </body>
302 </html>
303 <!-- Magick Cache 3rd October 2025 21:22 -->