| |
| |
| |
| |
| <!doctype html> |
| <html lang="en"> |
| <head> |
| <meta charset="utf-8" /> |
| <meta name="viewport" content="width=device-width, initial-scale=1" /> |
| <title>ImageMagick - Magick++, C++ API: Classes</title> |
| <meta name="application-name" content="ImageMagick" /> |
| <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." /> |
| <meta name="application-url" content="https://imagemagick.org" /> |
| <meta name="generator" content="PHP" /> |
| <meta name="keywords" content="magick++, c++, api:, classes, image processing software" /> |
| <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-2020 ImageMagick Studio LLC" /> |
| <meta name="distribution" content="Global" /> |
| <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1" /> |
| <meta property='og:url' content='../../' /> |
| <meta property='og:title' content='ImageMagick' /> |
| <meta property='og:image' content='../../../images/logo.png' /> |
| <meta property='og:type' content='website' /> |
| <meta property='og:site_name' content='ImageMagick' /> |
| <meta property='og:description' content="Create, Edit, Compose, or Convert Digital Images" /> |
| <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" /> |
| <link href="magick++-classes.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> |
| <nav class="navbar navbar-expand-md navbar-dark bg-dark fixed-top"> |
| <div class="container-fluid"> |
| <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-bs-toggle="collapse" data-bs-target="#magick-navbars" aria-controls="magick-navbars" aria-expanded="false" aria-label="Toggle navigation"> |
| <span class="navbar-toggler-icon"></span> |
| </button> |
| |
| <div class="collapse navbar-collapse" id="magick-navbars"> |
| <ul class="navbar-nav me-auto mb-2 mb-md-0"> |
| <li class="nav-item"> |
| <a class="nav-link " href="../../www/index.html">Home</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">CLI</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://github.com/ImageMagick/ImageMagick/discussions">Community</a> |
| </li> |
| <li class="nav-item"> |
| <iframe src="https://github.com/sponsors/ImageMagick/button" title="Sponsor ImageMagick" height="35" width="107" style="border: 0;"></iframe> |
| </li> |
| </ul> |
| <form class="d-flex form-inline" action="https://imagemagick.org/script/search.php"> |
| <input class="form-control me-2" type="text" name="q" placeholder="Search" aria-label="Search"> |
| <button class="btn btn-outline-success" type="submit" name="sa">Search</button> |
| </form> |
| </div> |
| </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-full-width-responsive="true" |
| data-ad-format="horizontal"></ins> |
| <script> |
| (adsbygoogle = window.adsbygoogle || []).push({}); |
| </script> |
| |
| </div> |
| |
| <main class="container"> |
| <div class="magick-template"> |
| <h1>Magick++ Classes</h1> |
| <div class="doc-section"> |
| <p><a href="http://www.imagemagick.org/Magick++">Magick++</a> provides a simple C++ API to the ImageMagick image processing library which supports reading and writing a huge number of image formats as well as supporting a broad spectrum of traditional image processing operations. The ImageMagick C API is complex and the data structures are currently not documented. Magick++ provides access to most of the features available from the C API but in a simple object-oriented and well-documented framework.</p> |
| <p>Magick++ is intended to support commercial-grade application development. In order to avoid possible conflicts with the user's application, all symbols contained in Magick++ (included by the header <tt><font color="#663366"><Magick++.h></font></tt>) are scoped to the <span lang="en-US">namespace</span> <i>Magick</i>. Symbols from the ImageMagick C library are imported under the <i>MagickCore</i> namespace to avoid possible conflicts and ImageMagick macros are only included within the Magick++ implementation so they won't impact the user's application.</p> |
| <p>The core class in Magick++ is the <a href="Image++.html">Image</a> class. The Image class provides methods to manipulate a single image frame (e.g. a JPEG image). Standard Template Library (STL)<span lang="en-US">compatible</span> <a href="../../api/STL.html">algorithms and function objects</a> are provided in order to manipulate multiple image frames or to read and write file formats which support multiple image frames (e.g. GIF animations, MPEG animations, and Postscript files).</p> |
| <p>The Image class supports reference-counted memory management which supports the semantics of an intrinsic variable type (e.g. 'int') with an extremely efficient <tt>operator =</tt> and copy constructor (only a pointer is assigned) while ensuring that the image data is replicated as required so that it the image may be modified without impacting earlier generations. Since the Image class manages heap memory internally, images are best allocated via C++ automatic (stack-based) memory allocation. This support allows most programs using Magick++ to be written without using any pointers, simplifying the implementation and avoiding the risks of using pointers. When a program uses automatic memory allocation to allocate Magick++ images, that aspect of the program becomes naturally exception-safe and thread-safe.</p> |
| <p>The image class uses a number of supportive classes in order to specify arguments. Colors are specified via the <a href="http://www.imagemagick.org/Magick++/Color.html">Color</a> class. Colors specified in X11-style string form are implicitly converted to the Color class. Geometry arguments (those specifying width, height, and/or x and y offset) are specified via the <a href="../../api/Geometry.html">Geometry</a> class. Similar to the Color class, geometries specified as an X11-style string are implicitly converted to the Geometry class. Two dimensional drawable objects are specified via the <a href="../../api/Drawable.html">Drawable</a> class. Drawable objects may be provided as a single object or as a list of objects to be rendered using the current image options. Montage options (a montage is a rendered grid of thumbnails in one image) are specified via the <a href="../../api/Montage.html">Montage</a> class.</p> |
| <p>Errors are reported using C++ exceptions derived from the <a href="http://www.imagemagick.org/Magick++/Exception.html">Exception</a> class, which is itself derived from the standard C++ exception class. Exceptions are reported synchronous with the operation and are caught by the first matching <i>try</i> block as the stack is unraveled. This allows a clean coding style in which multiple related Magick++ commands may be executed with errors handled as a unit rather than line-by-line. Since the Image object provides reference-counted memory management, unreferenced images on the stack are automagically cleaned up, avoiding the potential for memory leaks.</p> |
| <p style="margin-bottom: 0cm">For ease of access, the documentation for the available user-level classes is available via the following table.</p> |
| <br /> |
| <ul><table border="1" class="docutils"> |
| <caption><em>Magick++</em> User-Level Classes</caption> |
| <colgroup> |
| <col width="18%" /> |
| <col width="82%" /> |
| </colgroup> |
| <tbody valign="top"> |
| <tr><td><a class="reference external" href="http://www.imagemagick.org/Magick++/Blob.html">Blob</a></td> |
| <td>Binary Large OBject container.</td> |
| </tr> |
| <tr><td><a class="reference external" href="http://www.imagemagick.org/Magick++/CoderInfo.html">CoderInfo</a></td> |
| <td>Report information about supported image formats (use with |
| <a class="reference external" href="http://www.imagemagick.org/Magick++/STL.html#coderInfoList">coderInfoList</a>())</td> |
| </tr> |
| <tr><td><a class="reference external" href="http://www.imagemagick.org/Magick++/Color.html">Color</a></td> |
| <td>Color specification.</td> |
| </tr> |
| <tr><td><a class="reference external" href="http://www.imagemagick.org/Magick++/Drawable.html">Drawable</a></td> |
| <td>Drawable shape (for input to 'draw').</td> |
| </tr> |
| <tr><td><a class="reference external" href="http://www.imagemagick.org/Magick++/Exception.html">Exception</a></td> |
| <td>C++ exception objects.</td> |
| </tr> |
| <tr><td><a class="reference external" href="http://www.imagemagick.org/Magick++/Geometry.html">Geometry</a></td> |
| <td>Geometry specification.</td> |
| </tr> |
| <tr><td><a class="reference external" href="http://www.imagemagick.org/Magick++/Image++.html">Image</a></td> |
| <td>Image frame. This is the primary object in <em>Magick++</em>.</td> |
| </tr> |
| <tr><td><a class="reference external" href="http://www.imagemagick.org/Magick++/Montage.html">Montage</a></td> |
| <td>Montage options for montageImages().</td> |
| </tr> |
| <tr><td><a class="reference external" href="http://www.imagemagick.org/Magick++/Pixels.html">Pixels</a></td> |
| <td>Low-level access to image pixels.</td> |
| </tr> |
| <tr><td><a class="reference external" href="http://www.imagemagick.org/Magick++/STL.html">STL</a></td> |
| <td>STL algorithms and function objects for operating on |
| containers of image frames.</td> |
| </tr> |
| <tr><td><a class="reference external" href="http://www.imagemagick.org/Magick++/TypeMetric.html">TypeMetric</a></td> |
| <td>Container for font type metrics (use with |
| <a class="reference external" href="http://www.imagemagick.org/Magick++/Image.html#fonttypemetrics">Image::fontTypeMetrics</a>).</td> |
| </tr> |
| </tbody> |
| </table> |
| </ul> |
| </div> |
| </div> |
| </main><!-- /.container --> |
| <footer class="magick-footer"> |
| <div class="container-fluid"> |
| <a href="../../www/security-policy.html">Security</a> • |
| <a href="../../www/news.html">News</a> |
| |
| <a href="magick++-classes.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="../../www/links.html">Related</a> • |
| <a href="../../www/sitemap.html">Sitemap</a> |
| <br/> |
| <a href="../../www/support.html">Sponsor</a> • |
| <a href="../../www/cite.html">Cite</a> • |
| <a href="http://pgp.mit.edu/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> • |
| <a href="../../www/contact.html">Contact Us</a> |
| <br/> |
| <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> • |
| <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> |
| <br/> |
| <small>© 1999-2021 ImageMagick Studio LLC</small> |
| </div> |
| </footer> |
| |
| <!-- Javascript assets --> |
| <script src="../../assets/magick.js" ></script> |
| </body> |
| </html> |
