Powered by NetworkEleven ImageMagick logo


NAME

color - Count the Colors in an Image


SYNOPSIS

const ColorInfo ** GetColorInfoList( const char *pattern, unsigned long *number_colors );

char ** GetColorList( const char *pattern, unsigned long *number_colors );

unsigned long GetImageHistogram( const Image *image, unsigned long *number_colors, ExceptionInfo *exception );

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 LoadColorLists( const char *filename, 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 );

unsigned int QueryMagickColor( const char *name, MagickPixelPacket *color, ExceptionInfo *exception );


FUNCTION DESCRIPTIONS

GetColorInfoList

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

The format of the GetColorInfoList function is:

const ColorInfo **GetColorInfoList ( const char *pattern, unsigned long *number_colors );

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.

GetColorList

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

The format of the GetColorList function is:

char **GetColorList ( const char *pattern, unsigned long *number_colors );

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.

GetImageHistogram

GetImageHistogram() returns the unique colors in an image.

The format of the GetImageHistogram method is:

unsigned long GetImageHistogram ( const Image *image, unsigned long *number_colors, ExceptionInfo *exception );

A description of each parameter follows.

image:
The image.

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

exception:
Return any errors or warnings in this structure.

GetNumberColors

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.

image:
The image.

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

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:

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

image:
The image.

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:

image:
The image.

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:

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

image:
The image.

exception:
Return any errors or warnings in this structure.

IsPaletteImage

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.

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

image:
The image.

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.

file:
List color names to this file handle.

exception:
Return any errors or warnings in this structure.

LoadColorLists

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:

unsigned int 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:

unsigned int 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 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.

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.

QueryMagickColor

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

The format of the QueryMagickColor method is:

unsigned int 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.

Top of page
"Image manipulation software that works like magick"