Module color Methods

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() 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() 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() 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() 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() 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() 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() 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() 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() 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.