# ImageMagick – MagickCore, C API: Colormap Methods
ImageMagick is a powerful, open-source software suite for creating, editing, converting, and manipulating images in over 200 formats. Ideal for web developers, graphic designers, and researchers, it offers versatile tools for image processing, including batch processing, format conversion, and complex image transformations.
Author: ImageMagick Studio LLC
Keywords: MagickCore, C API: Colormap Methods, Image Processing, Digital Image Editing, Image Conversion, Open-Source Software, Image Manipulation, Command-Line Image Tools

# Colormap

## AcquireImageColormap

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.

The format of the AcquireImageColormap method is:

    MagickBooleanType AcquireImageColormap(Image *image,const size_t colors)

A description of each parameter follows:

image
  the image.
colors
  the number of colors in the image colormap.

## CycleColormap

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.

The format of the CycleColormapImage method is:

    MagickBooleanType CycleColormapImage(Image *image,const ssize_t displace)

A description of each parameter follows:

image
  the image.
displace
  displace the colormap this amount.