[Home] [Mission Statement] [Development Process] [Download] [Installation] [CVS] [Mailing Lists] [FAQ] [Formats] [News ] [ChangeLog] [Report Bugs] [Utilities] [Programming] [Books] [Links] |
Search GraphicsMagick site

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

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

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

  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.

  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

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.

  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.

### 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.