Home | History | Annotate | Download | only in api
      1 
      2 
      3 
      4 
      5 <!DOCTYPE html>
      6 <html lang="en">
      7 <head>
      8   <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
      9     <title>ImageMagick: MagickCore, C API for ImageMagick: Colormap Methods</title>
     10   <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
     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 Bzier curves."/>
     13   <meta name="application-url" content="http://www.imagemagick.org"/>
     14   <meta name="generator" content="PHP"/>
     15   <meta name="keywords" content="magickcore, c, api, for, imagemagick:, colormap, methods, 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-2016 ImageMagick Studio LLC"/>
     23   <meta name="distribution" content="Global"/>
     24   <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1"/>
     25   <link rel="icon" href="../image/wand.png"/>
     26   <link rel="shortcut icon" href="../image/wand.ico"/>
     27   <link rel="stylesheet" href="../css/magick.php"/>
     28 </head>
     29 <body>
     30 <div class="main">
     31 <div class="magick-masthead">
     32   <div class="container">
     33     <script async="async" src="http://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>    <ins class="adsbygoogle"
     34          style="display:block"
     35          data-ad-client="ca-pub-3129977114552745"
     36          data-ad-slot="6345125851"
     37          data-ad-format="auto"></ins>
     38     <script>
     39       (adsbygoogle = window.adsbygoogle || []).push({});
     40     </script>
     41     <nav class="magick-nav">
     42       <a class="magick-nav-item " href="../index.php">Home</a>
     43       <a class="magick-nav-item " href="../script/binary-releases.php">Download</a>
     44       <a class="magick-nav-item " href="../script/command-line-tools.php">Tools</a>
     45       <a class="magick-nav-item " href="../script/command-line-options.php">Options</a>
     46       <a class="magick-nav-item " href="../script/resources.php">Resources</a>
     47       <a class="magick-nav-item " href="../script/api.php">Develop</a>
     48       <a class="magick-nav-item " href="../script/search.php">Search</a>
     49       <a class="magick-nav-item pull-right" href="http://www.imagemagick.org/discourse-server/">Community</a>
     50     </nav>
     51   </div>
     52 </div>
     53 <div class="container">
     54 <div class="magick-header">
     55 <p class="text-center"><a href="colormap.php#AcquireImageColormap">AcquireImageColormap</a> &bull; <a href="colormap.php#CycleColormap">CycleColormap</a></p>
     56 
     57 <h2><a href="http://nextgen.imagemagick.org/api/MagickCore/colormap_8c.html" id="AcquireImageColormap">AcquireImageColormap</a></h2>
     58 
     59 <p>AcquireImageColormap() allocates an image colormap and initializes it to a linear gray colorspace.  If the image already has a colormap, it is replaced.  AcquireImageColormap() returns MagickTrue if successful, otherwise MagickFalse if there is not enough memory.</p>
     60 
     61 <p>The format of the AcquireImageColormap method is:</p>
     62 
     63 <pre class="text">
     64 MagickBooleanType AcquireImageColormap(Image *image,const size_t colors,
     65   ExceptionInfo *exception)
     66 </pre>
     67 
     68 <p>A description of each parameter follows:</p>
     69 
     70 <dd>
     71 </dd>
     72 
     73 <dd> </dd>
     74 <dl class="dl-horizontal">
     75 <dt>image</dt>
     76 <dd>the image. </dd>
     77 
     78 <dd> </dd>
     79 <dt>colors</dt>
     80 <dd>the number of colors in the image colormap. </dd>
     81 
     82 <dd> </dd>
     83 <dt>exception</dt>
     84 <dd>return any errors or warnings in this structure. </dd>
     85 
     86 <dd>  </dd>
     87 </dl>
     88 <h2><a href="http://nextgen.imagemagick.org/api/MagickCore/colormap_8c.html" id="CycleColormap">CycleColormap</a></h2>
     89 
     90 <p>CycleColormap() displaces an image's colormap by a given number of positions.  If you cycle the colormap a number of times you can produce a psychodelic effect.</p>
     91 
     92 <p>WARNING: this assumes an images colormap is in a well know and defined order. Currently Imagemagick has no way of setting that order.</p>
     93 
     94 <p>The format of the CycleColormapImage method is:</p>
     95 
     96 <pre class="text">
     97 MagickBooleanType CycleColormapImage(Image *image,const ssize_t displace,
     98   ExceptionInfo *exception)
     99 </pre>
    100 
    101 <p>A description of each parameter follows:</p>
    102 
    103 <dd>
    104 </dd>
    105 
    106 <dd> </dd>
    107 <dl class="dl-horizontal">
    108 <dt>image</dt>
    109 <dd>the image. </dd>
    110 
    111 <dd> </dd>
    112 <dt>displace</dt>
    113 <dd> displace the colormap this amount. </dd>
    114 
    115 <dd> </dd>
    116 <dt>exception</dt>
    117 <dd>return any errors or warnings in this structure. </dd>
    118 
    119 <dd>  </dd>
    120 </dl>
    121 </div>
    122   <footer class="magick-footer">
    123     <p><a href="../script/support.php">Donate</a> 
    124      <a href="../script/sitemap.php">Sitemap</a> 
    125     <a href="../script/links.php">Related</a> 
    126     <a href="../script/architecture.php">Architecture</a>
    127 </p>
    128     <p><a href="colormap.php#">Back to top</a> 
    129     <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> 
    130     <a href="../script/contact.php">Contact Us</a></p>
    131         <p><small>  1999-2016 ImageMagick Studio LLC</small></p>
    132   </footer>
    133 </div><!-- /.container -->
    134 
    135   <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
    136   <script src="http://nextgen.imagemagick.org/js/magick.php"></script>
    137 </div>
    138 </body>
    139 </html>
    140