ImageMagick: MagickCore, C API for ImageMagick: Count the Colors in an Image
Author: ImageMagick Studio LLC
Description: ImageMagick is a software suite to create, edit, compose, or convert bitmap images in a variety of formats. Use ImageMagick to scale, rotate, shear, distort and transform images.
Keywords: magickcore, c, api, for, imagemagick:, count, the, colors, in, an, image, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing

Unix
Mac OS X
Windows
Processing
Options
Usage
MagickWand
MagickCore
PerlMagick
Magick++
Unix
Windows
Links

# Module color Methods

## GetColorInfoList

GetColorInfoList() returns any colors that match the specified pattern.

The format of the GetColorInfoList function is:

      const ColorInfo **GetColorInfoList(const char *pattern,
        size_t *number_colors,ExceptionInfo *exception)

A description of each parameter follows:

##### pattern

Specifies a pointer to a text string containing a pattern.

##### number_colors

This integer returns the number of colors in the list.

##### exception

return any errors or warnings in this structure.

## GetColorList

GetColorList() returns any colors that match the specified pattern.

The format of the GetColorList function is:

      char **GetColorList(const char *pattern,size_t *number_colors,
        ExceptionInfo *exception)

A description of each parameter follows:

##### pattern

Specifies a pointer to a text string containing a pattern.

##### number_colors

This integer returns the number of colors in the list.

##### exception

return any errors or warnings in this structure.

## ListColorInfo

ListColorInfo() lists color names to the specified file. Color names are a convenience. Rather than defining a color by its red, green, and blue intensities just use a color name such as white, blue, or yellow.

The format of the ListColorInfo method is:

      MagickBooleanType ListColorInfo(FILE *file,ExceptionInfo *exception)

A description of each parameter follows.

##### file

List color names to this file handle.

##### exception

return any errors or warnings in this structure.

## LoadColorList

LoadColorList() loads one or more color configuration file which provides a mapping between color attributes and a color name.

The format of the LoadColorLists method is:

      MagickBooleanType LoadColorLists(const char *filename,
        ExceptionInfo *exception)

A description of each parameter follows:

##### filename

the font file name.

##### exception

return any errors or warnings in this structure.

## QueryColorDatabase

QueryColorDatabase() returns the red, green, blue, and opacity intensities for a given color name.

The format of the QueryColorDatabase method is:

      MagickBooleanType QueryColorDatabase(const char *name,
        const ComplianceType compliance,PixelPacket *color,
        ExceptionInfo *exception)

A description of each parameter follows:

##### name

the color name (e.g. white, blue, yellow).

##### compliance

Adhere to this color standard: SVG, X11, or XPM.

##### color

the red, green, blue, and opacity intensities values of the named color in this structure.

##### exception

return any errors or warnings in this structure.

## QueryColorDatabase

QueryColorDatabase() returns the red, green, blue, and opacity intensities for a given color name.

The format of the QueryColorDatabase method is:

      MagickBooleanType QueryColorDatabase(const char *name,PixelPacket *color,
        ExceptionInfo *exception)

A description of each parameter follows:

##### name

the color name (e.g. white, blue, yellow).

##### color

the red, green, blue, and opacity intensities values of the named color in this structure.

##### exception

return any errors or warnings in this structure.

## QueryColorname

QueryColorname() returns a named color for the given color intensity. If an exact match is not found, a rgb() color is returned instead.

The format of the QueryColorname method is:

      MagickBooleanType QueryColorname(const Image *image,
        const PixelPacket *color,const ComplianceType compliance,char *name,
        ExceptionInfo *exception)

A description of each parameter follows.

##### image

the image.

##### color

the color intensities.

##### compliance

Adhere to this color standard: SVG, X11, or XPM.

##### name

Return the color name or hex value.

##### exception

return any errors or warnings in this structure.

## QueryMagickColorCompliance

QueryMagickColorCompliance() returns the red, green, blue, and opacity intensities for a given color name and standards compliance.

The format of the QueryMagickColor method is:

      MagickBooleanType QueryMagickColor(const char *name,
        const ComplianceType compliance,MagickPixelPacket *color,
        ExceptionInfo *exception)

A description of each parameter follows:

##### name

the color name (e.g. white, blue, yellow).

##### compliance

Adhere to this color standard: SVG, X11, or XPM.

##### color

the red, green, blue, and opacity intensities values of the named color in this structure.

##### exception

return any errors or warnings in this structure.

## QueryMagickColor

QueryMagickColor() returns the red, green, blue, and opacity intensities for a given color name.

The format of the QueryMagickColor method is:

      MagickBooleanType QueryMagickColor(const char *name,
        MagickPixelPacket *color,ExceptionInfo *exception)

A description of each parameter follows:

##### name

the color name (e.g. white, blue, yellow).

##### color

the red, green, blue, and opacity intensities values of the named color in this structure.

##### exception

return any errors or warnings in this structure.

## QueryMagickColorname

QueryMagickColorname() returns a named color for the given color intensity. If an exact match is not found, a hex value is returned instead. For example an intensity of rgb:(0,0,0) returns black whereas rgb:(223,223,223) returns #dfdfdf.

The format of the QueryMagickColorname method is:

      MagickBooleanType QueryMagickColorname(const Image *image,
        const PixelPacket *color,const ComplianceType compliance,char *name,
        ExceptionInfo *exception)

A description of each parameter follows.

##### image

the image.

##### color

the color intensities.

##### Compliance

Adhere to this color standard: SVG, X11, or XPM.

##### name

Return the color name or hex value.

##### exception

return any errors or warnings in this structure.

Discourse Server • Studio