136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<!DOCTYPE html>
636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<html lang="en">
736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<head>
836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    <title>ImageMagick: MagickCore, C API for ImageMagick: Colormap Methods</title>
1036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
1136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="application-name" content="ImageMagick"/>
1236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <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."/>
1336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="application-url" content="http://www.imagemagick.org"/>
1436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="generator" content="PHP"/>
1536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="keywords" content="magickcore, c, api, for, imagemagick:, colormap, methods, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert"/>
1636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="rating" content="GENERAL"/>
1736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="robots" content="INDEX, FOLLOW"/>
1836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="generator" content="ImageMagick Studio LLC"/>
1936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="author" content="ImageMagick Studio LLC"/>
2036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="revisit-after" content="2 DAYS"/>
2136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="resource-type" content="document"/>
227ce65e7125a4e1df1a274ce373c537a9df9c16cdCristy  <meta name="copyright" content="Copyright (c) 1999-2016 ImageMagick Studio LLC"/>
2336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="distribution" content="Global"/>
2436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1"/>
25882d9f4ab22246b0110b960e923614ae9c53702aCristy  <link rel="icon" href="../image/wand.png"/>
26882d9f4ab22246b0110b960e923614ae9c53702aCristy  <link rel="shortcut icon" href="../image/wand.ico"/>
27882d9f4ab22246b0110b960e923614ae9c53702aCristy  <link rel="stylesheet" href="../css/magick.php"/>
2836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</head>
2936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<body>
3036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<div class="main">
3136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<div class="magick-masthead">
3236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <div class="container">
33882d9f4ab22246b0110b960e923614ae9c53702aCristy    <script async="async" src="http://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>    <ins class="adsbygoogle"
3436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy         style="display:block"
3536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy         data-ad-client="ca-pub-3129977114552745"
3636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy         data-ad-slot="6345125851"
3736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy         data-ad-format="auto"></ins>
3836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    <script>
39882d9f4ab22246b0110b960e923614ae9c53702aCristy      (adsbygoogle = window.adsbygoogle || []).push({});
4036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    </script>
4136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    <nav class="magick-nav">
4236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy      <a class="magick-nav-item " href="../index.php">Home</a>
4336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy      <a class="magick-nav-item " href="../script/binary-releases.php">Download</a>
4436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy      <a class="magick-nav-item " href="../script/command-line-tools.php">Tools</a>
4536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy      <a class="magick-nav-item " href="../script/command-line-options.php">Options</a>
4636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy      <a class="magick-nav-item " href="../script/resources.php">Resources</a>
4736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy      <a class="magick-nav-item " href="../script/api.php">Develop</a>
4836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy      <a class="magick-nav-item " href="../script/search.php">Search</a>
4936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy      <a class="magick-nav-item pull-right" href="http://www.imagemagick.org/discourse-server/">Community</a>
5036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    </nav>
5136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  </div>
5236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</div>
5336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<div class="container">
5436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<div class="magick-header">
5536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<p class="text-center"><a href="colormap.php#AcquireImageColormap">AcquireImageColormap</a> &bull; <a href="colormap.php#CycleColormap">CycleColormap</a></p>
5636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
5736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<h2><a href="http://nextgen.imagemagick.org/api/MagickCore/colormap_8c.html" id="AcquireImageColormap">AcquireImageColormap</a></h2>
5836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
5936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<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>
6036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
6136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<p>The format of the AcquireImageColormap method is:</p>
6236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
6336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<pre class="text">
6436421ee45722da418b8ab99d7e6358e4f86b9f1eCristyMagickBooleanType AcquireImageColormap(Image *image,const size_t colors,
6536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  ExceptionInfo *exception)
6636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</pre>
6736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
6836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<p>A description of each parameter follows:</p>
6936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
7036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>
7136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</dd>
7236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
7336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd> </dd>
7436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dl class="dl-horizontal">
7536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dt>image</dt>
7636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>the image. </dd>
7736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
7836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd> </dd>
7936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dt>colors</dt>
8036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>the number of colors in the image colormap. </dd>
8136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
8236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd> </dd>
8336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dt>exception</dt>
8436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>return any errors or warnings in this structure. </dd>
8536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
8636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>  </dd>
8736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</dl>
8836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<h2><a href="http://nextgen.imagemagick.org/api/MagickCore/colormap_8c.html" id="CycleColormap">CycleColormap</a></h2>
8936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
9036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<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>
9136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
9236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<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>
9336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
9436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<p>The format of the CycleColormapImage method is:</p>
9536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
9636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<pre class="text">
9736421ee45722da418b8ab99d7e6358e4f86b9f1eCristyMagickBooleanType CycleColormapImage(Image *image,const ssize_t displace,
9836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  ExceptionInfo *exception)
9936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</pre>
10036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
10136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<p>A description of each parameter follows:</p>
10236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
10336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>
10436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</dd>
10536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
10636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd> </dd>
10736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dl class="dl-horizontal">
10836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dt>image</dt>
10936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>the image. </dd>
11036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
11136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd> </dd>
11236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dt>displace</dt>
11336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd> displace the colormap this amount. </dd>
11436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
11536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd> </dd>
11636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dt>exception</dt>
11736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>return any errors or warnings in this structure. </dd>
11836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
11936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy<dd>  </dd>
12036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</dl>
12136421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</div>
12236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <footer class="magick-footer">
12336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    <p><a href="../script/support.php">Donate</a> •
12436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy     <a href="../script/sitemap.php">Sitemap</a> •
12536421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    <a href="../script/links.php">Related</a> •
12636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    <a href="../script/architecture.php">Architecture</a>
12736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</p>
12836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    <p><a href="colormap.php#">Back to top</a> •
12936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> •
13036421ee45722da418b8ab99d7e6358e4f86b9f1eCristy    <a href="../script/contact.php">Contact Us</a></p>
1317ce65e7125a4e1df1a274ce373c537a9df9c16cdCristy        <p><small>©  1999-2016 ImageMagick Studio LLC</small></p>
13236421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  </footer>
13336421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</div><!-- /.container -->
13436421ee45722da418b8ab99d7e6358e4f86b9f1eCristy
135882d9f4ab22246b0110b960e923614ae9c53702aCristy  <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
13636421ee45722da418b8ab99d7e6358e4f86b9f1eCristy  <script src="http://nextgen.imagemagick.org/js/magick.php"></script>
13736421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</div>
13836421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</body>
13936421ee45722da418b8ab99d7e6358e4f86b9f1eCristy</html>
140