NAME SYNOPSIS FUNCTION DESCRIPTIONS GetColorInfoList GetColorList GetImageHistogram GetNumberColors IsGrayImage IsMonochromeImage IsOpaqueImage IsPaletteImage ListColorInfo LoadColorLists QueryColorDatabase QueryColorname QueryMagickColor # 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. "Image manipulation software that works like magick"