- NAME
- SYNOPSIS
- FUNCTION DESCRIPTIONS

- GetColorlist
- GetNumberColors
- IsGrayImage
- IsMonochromeImage
- IsOpaqueImage
- IsPaletteImage
- ListColorInfo
- QueryColorDatabase
- QueryColorname

# NAME

color - Methods to Count the Colors in an Image

# SYNOPSIS

unsigned long GetNumberColors( const Image *image, FILE *file, ExceptionInfo *exception );

unsigned int IsGrayImage( const Image *image, ExceptionInfo *exception );

unsigned int IsMonochromeImage( const Image *image, ExceptionInfo *exception );

unsigned int IsOpaqueImage( const Image *image, ExceptionInfo *exception );

unsigned int IsPaletteImage( const Image *image, ExceptionInfo *exception );

unsigned int ListColorInfo( FILE *file, ExceptionInfo *exception );

unsigned int QueryColorDatabase( const char *name, PixelPacket *color, ExceptionInfo *exception );

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

# FUNCTION DESCRIPTIONS

## GetColorlist

Method GetColorList returns any colors that match the specified pattern and color standard.

The format of the GetColorList function is:

        filelist=GetColorList(const char *pattern,unsigned long *number_colors)

A description of each parameter follows:

o filelist:
  Method GetColorList returns a list of colors that match the specified pattern and color standard.

o pattern:
  Specifies a pointer to a text string containing a pattern.

o number_colors:
  This integer returns the number of colors in the list.

## GetNumberColors

Method GetNumberColors returns the number of unique colors in an image.

The format of the GetNumberColors method is:

> unsigned long GetNumberColors ( const Image *image, FILE *file, ExceptionInfo *exception );

A description of each parameter follows.

o image:
  The image.

o file:
  Write a histogram of the color distribution to this file handle.

o exception:
  Return any errors or warnings in this structure.

## IsGrayImage

> IsGrayImage() returns True if all the pixels in the image have the same red, green, and blue intensities.

The format of the IsGrayImage method is:

> unsigned int IsGrayImage ( const Image *image, ExceptionInfo *exception );

A description of each parameter follows:

o status:
  Method IsGrayImage returns True if the image is grayscale otherwise False is returned.

o image:
  The image.

o exception:
  Return any errors or warnings in this structure.

## IsMonochromeImage

> IsMonochromeImage() returns True if all the pixels in the image have the same red, green, and blue intensities and the intensity is either 0 or MaxRGB.

The format of the IsMonochromeImage method is:

> unsigned int IsMonochromeImage ( const Image *image, ExceptionInfo *exception );

A description of each parameter follows:

o image:
  The image.

o exception:
  Return any errors or warnings in this structure.

## IsOpaqueImage

> IsOpaqueImage() returns True if none of the pixels in the image have an opacity value other than opaque ( 0 ) .

The format of the IsOpaqueImage method is:

> unsigned int IsOpaqueImage ( const Image *image, ExceptionInfo *exception );

A description of each parameter follows:

o status:
  Method IsOpaqueImage returns False if the image has one or more pixels that are transparent otherwise True is returned.

o image:
  The image.

o exception:
  Return any errors or warnings in this structure.

## IsPaletteImage

Method IsPaletteImage returns True if the image is PseudoClass and has 256 unique colors or less.

The format of the IsPaletteImage method is:

> unsigned int IsPaletteImage ( const Image *image, ExceptionInfo *exception );

A description of each parameter follows.

o status:
  Method IsPaletteImage returns True is the image is PseudoClass or has 256 color or less.

o image:
  The image.

o 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:

> unsigned int ListColorInfo ( FILE *file, ExceptionInfo *exception );

A description of each parameter follows.

o file:
  List color names to this file handle.

o 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:

> unsigned int QueryColorDatabase ( const char *name, PixelPacket *color, ExceptionInfo *exception );

A description of each parameter follows:

o name:
  The color name (e.g. white, blue, yellow).

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

o 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 hex value is return instead. For example an intensity of rgb: ( 0, 0, 0 ) returns black whereas rgb: ( 223, 223, 223 ) returns #dfdfdf.

The format of the QueryColorname method is:

> unsigned int QueryColorname ( const Image *image, const PixelPacket *color, const ComplianceType compliance, char *name, ExceptionInfo *exception );

A description of each parameter follows.

o image:
  The image.

o color:
  The color intensities.

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

o name:
  Return the color name or hex value.

o exception:
  Return any errors or warnings in this structure.