ImageMagick - MagickWand, C API: Pixel Wand Methods
Author: ImageMagick Studio LLC
Description: Use ImageMagick® to create, edit, compose, and convert bitmap images. Resize an image, crop it, change its shades and colors, add captions, and more.
Keywords: magickwc, api:, pixel, wmethods, image converter, image resizer, image editor, photo editor, jpg converter, png converter, tiff converter, vector images, online, free, swiss army

ClearPixelWand • ClonePixelWand • ClonePixelWands • DestroyPixelWand • DestroyPixelWands • IsPixelWandSimilar • IsPixelWand • NewPixelWand • NewPixelWands • PixelClearException • PixelGetAlpha • PixelGetAlphaQuantum • PixelGetBlack • PixelGetBlackQuantum • PixelGetBlue • PixelGetBlueQuantum • PixelGetColorAsString • PixelGetColorAsNormalizedString • PixelGetColorCount • PixelGetCyan • PixelGetCyanQuantum • PixelGetException • PixelGetExceptionType • PixelGetFuzz • PixelGetGreen • PixelGetGreenQuantum • PixelGetHSL • PixelGetIndex • PixelGetMagenta • PixelGetMagentaQuantum • PixelGetMagickColor • PixelGetPixel • PixelGetQuantumPacket • PixelGetQuantumPixel • PixelGetRed • PixelGetRedQuantum • PixelGetYellow • PixelGetYellowQuantum • PixelSetAlpha • PixelSetAlphaQuantum • PixelSetBlack • PixelSetBlackQuantum • PixelSetBlue • PixelSetBlueQuantum • PixelSetColor • PixelSetColorCount • PixelSetColorFromWand • PixelSetCyan • PixelSetCyanQuantum • PixelSetFuzz • PixelSetGreen • PixelSetGreenQuantum • PixelSetHSL • PixelSetIndex • PixelSetMagenta • PixelSetMagentaQuantum • PixelSetPixelColor • PixelSetQuantumPixel • PixelSetRed • PixelSetRedQuantum • PixelSetYellow • PixelSetYellowQuantum

## ClearPixelWand

ClearPixelWand() clears resources associated with the wand.

The format of the ClearPixelWand method is:

    void ClearPixelWand(PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## ClonePixelWand

ClonePixelWand() makes an exact copy of the specified wand.

The format of the ClonePixelWand method is:

    PixelWand *ClonePixelWand(const PixelWand *wand)

A description of each parameter follows:

wand
  the magick wand.

## ClonePixelWands

ClonePixelWands() makes an exact copy of the specified wands.

The format of the ClonePixelWands method is:

    PixelWand **ClonePixelWands(const PixelWand **wands,
      const size_t number_wands)

A description of each parameter follows:

wands
  the magick wands.
number_wands
  the number of wands.

## DestroyPixelWand

DestroyPixelWand() deallocates resources associated with a PixelWand.

The format of the DestroyPixelWand method is:

    PixelWand *DestroyPixelWand(PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## DestroyPixelWands

DestroyPixelWands() deallocates resources associated with an array of pixel wands.

The format of the DestroyPixelWands method is:

    PixelWand **DestroyPixelWands(PixelWand **wand,
      const size_t number_wands)

A description of each parameter follows:

wand
  the pixel wand.
number_wands
  the number of wands.

## IsPixelWandSimilar

IsPixelWandSimilar() returns MagickTrue if the distance between two colors is less than the specified distance.

The format of the IsPixelWandSimilar method is:

    MagickBooleanType IsPixelWandSimilar(PixelWand *p,PixelWand *q,
      const double fuzz)

A description of each parameter follows:

p
  the pixel wand.
q
  the pixel wand.
fuzz
  any two colors that are less than or equal to this distance squared are consider similar.

## IsPixelWand

IsPixelWand() returns MagickTrue if the wand is verified as a pixel wand.

The format of the IsPixelWand method is:

    MagickBooleanType IsPixelWand(const PixelWand *wand)

A description of each parameter follows:

wand
  the magick wand.

## NewPixelWand

NewPixelWand() returns a new pixel wand.

The format of the NewPixelWand method is:

    PixelWand *NewPixelWand(void)

## NewPixelWands

NewPixelWands() returns an array of pixel wands.

The format of the NewPixelWands method is:

    PixelWand **NewPixelWands(const size_t number_wands)

A description of each parameter follows:

number_wands
  the number of wands.

## PixelClearException

PixelClearException() clear any exceptions associated with the iterator.

The format of the PixelClearException method is:

    MagickBooleanType PixelClearException(PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetAlpha

PixelGetAlpha() returns the normalized alpha value of the pixel wand.

The format of the PixelGetAlpha method is:

    double PixelGetAlpha(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetAlphaQuantum

PixelGetAlphaQuantum() returns the alpha value of the pixel wand.

The format of the PixelGetAlphaQuantum method is:

    Quantum PixelGetAlphaQuantum(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetBlack

PixelGetBlack() returns the normalized black color of the pixel wand.

The format of the PixelGetBlack method is:

    double PixelGetBlack(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetBlackQuantum

PixelGetBlackQuantum() returns the black color of the pixel wand.

The format of the PixelGetBlackQuantum method is:

    Quantum PixelGetBlackQuantum(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetBlue

PixelGetBlue() returns the normalized blue color of the pixel wand.

The format of the PixelGetBlue method is:

    double PixelGetBlue(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetBlueQuantum

PixelGetBlueQuantum() returns the blue color of the pixel wand.

The format of the PixelGetBlueQuantum method is:

    Quantum PixelGetBlueQuantum(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetColorAsString

PixelGetColorAsString() returnsd the color of the pixel wand as a string.

The format of the PixelGetColorAsString method is:

    char *PixelGetColorAsString(PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetColorAsNormalizedString

PixelGetColorAsNormalizedString() returns the normalized color of the pixel wand as a string.

The format of the PixelGetColorAsNormalizedString method is:

    char *PixelGetColorAsNormalizedString(PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetColorCount

PixelGetColorCount() returns the color count associated with this color.

The format of the PixelGetColorCount method is:

    size_t PixelGetColorCount(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetCyan

PixelGetCyan() returns the normalized cyan color of the pixel wand.

The format of the PixelGetCyan method is:

    double PixelGetCyan(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetCyanQuantum

PixelGetCyanQuantum() returns the cyan color of the pixel wand.

The format of the PixelGetCyanQuantum method is:

    Quantum PixelGetCyanQuantum(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetException

PixelGetException() returns the severity, reason, and description of any error that occurs when using other methods in this API.

The format of the PixelGetException method is:

    char *PixelGetException(const PixelWand *wand,ExceptionType *severity)

A description of each parameter follows:

wand
  the pixel wand.
severity
  the severity of the error is returned here.

## PixelGetExceptionType

PixelGetExceptionType() the exception type associated with the wand. If no exception has occurred, UndefinedExceptionType is returned.

The format of the PixelGetExceptionType method is:

    ExceptionType PixelGetExceptionType(const PixelWand *wand)

A description of each parameter follows:

wand
  the magick wand.

## PixelGetFuzz

PixelGetFuzz() returns the normalized fuzz value of the pixel wand.

The format of the PixelGetFuzz method is:

    double PixelGetFuzz(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetGreen

PixelGetGreen() returns the normalized green color of the pixel wand.

The format of the PixelGetGreen method is:

    double PixelGetGreen(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetGreenQuantum

PixelGetGreenQuantum() returns the green color of the pixel wand.

The format of the PixelGetGreenQuantum method is:

    Quantum PixelGetGreenQuantum(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetHSL

PixelGetHSL() returns the normalized HSL color of the pixel wand.

The format of the PixelGetHSL method is:

    void PixelGetHSL(const PixelWand *wand,double *hue,double *saturation,
      double *lightness)

A description of each parameter follows:

wand
  the pixel wand.
hue,saturation,lightness
  Return the pixel hue, saturation, and brightness.

## PixelGetIndex

PixelGetIndex() returns the colormap index from the pixel wand.

The format of the PixelGetIndex method is:

    Quantum PixelGetIndex(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetMagenta

PixelGetMagenta() returns the normalized magenta color of the pixel wand.

The format of the PixelGetMagenta method is:

    double PixelGetMagenta(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetMagentaQuantum

PixelGetMagentaQuantum() returns the magenta color of the pixel wand.

The format of the PixelGetMagentaQuantum method is:

    Quantum PixelGetMagentaQuantum(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetMagickColor

PixelGetMagickColor() gets the magick color of the pixel wand.

The format of the PixelGetMagickColor method is:

    void PixelGetMagickColor(PixelWand *wand,PixelInfo *color)

A description of each parameter follows:

wand
  the pixel wand.
color
  The pixel wand color is returned here.

## PixelGetPixel

PixelGetPixel() returns the pixel wand pixel.

The format of the PixelGetPixel method is:

    PixelInfo PixelGetPixel(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetQuantumPacket

PixelGetQuantumPacket() gets the packet of the pixel wand as a PixelInfo.

The format of the PixelGetQuantumPacket method is:

    void PixelGetQuantumPacket(PixelWand *wand,PixelInfo *packet)

A description of each parameter follows:

wand
  the pixel wand.
packet
  The pixel wand packet is returned here.

## PixelGetQuantumPixel

PixelGetQuantumPixel() gets the pixel of the pixel wand as a PixelInfo.

The format of the PixelGetQuantumPixel method is:

    void PixelGetQuantumPixel(const Image *image,const PixelWand *wand,
      Quantum *pixel)

A description of each parameter follows:

wand
  the pixel wand.
pixel
  The pixel wand pixel is returned here.

## PixelGetRed

PixelGetRed() returns the normalized red color of the pixel wand.

The format of the PixelGetRed method is:

    double PixelGetRed(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetRedQuantum

PixelGetRedQuantum() returns the red color of the pixel wand.

The format of the PixelGetRedQuantum method is:

    Quantum PixelGetRedQuantum(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetYellow

PixelGetYellow() returns the normalized yellow color of the pixel wand.

The format of the PixelGetYellow method is:

    double PixelGetYellow(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetYellowQuantum

PixelGetYellowQuantum() returns the yellow color of the pixel wand.

The format of the PixelGetYellowQuantum method is:

    Quantum PixelGetYellowQuantum(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelSetAlpha

PixelSetAlpha() sets the normalized alpha value of the pixel wand.

The format of the PixelSetAlpha method is:

    void PixelSetAlpha(PixelWand *wand,const double alpha)

A description of each parameter follows:

wand
  the pixel wand.
alpha
  the level of transparency: 1.0 is fully opaque and 0.0 is fully transparent.

## PixelSetAlphaQuantum

PixelSetAlphaQuantum() sets the alpha value of the pixel wand.

The format of the PixelSetAlphaQuantum method is:

    void PixelSetAlphaQuantum(PixelWand *wand,const Quantum alpha)

A description of each parameter follows:

wand
  the pixel wand.
alpha
  the alpha value.

## PixelSetBlack

PixelSetBlack() sets the normalized black color of the pixel wand.

The format of the PixelSetBlack method is:

    void PixelSetBlack(PixelWand *wand,const double black)

A description of each parameter follows:

wand
  the pixel wand.
black
  the black color.

## PixelSetBlackQuantum

PixelSetBlackQuantum() sets the black color of the pixel wand.

The format of the PixelSetBlackQuantum method is:

    void PixelSetBlackQuantum(PixelWand *wand,const Quantum black)

A description of each parameter follows:

wand
  the pixel wand.
black
  the black color.

## PixelSetBlue

PixelSetBlue() sets the normalized blue color of the pixel wand.

The format of the PixelSetBlue method is:

    void PixelSetBlue(PixelWand *wand,const double blue)

A description of each parameter follows:

wand
  the pixel wand.
blue
  the blue color.

## PixelSetBlueQuantum

PixelSetBlueQuantum() sets the blue color of the pixel wand.

The format of the PixelSetBlueQuantum method is:

    void PixelSetBlueQuantum(PixelWand *wand,const Quantum blue)

A description of each parameter follows:

wand
  the pixel wand.
blue
  the blue color.

## PixelSetColor

PixelSetColor() sets the color of the pixel wand with a string (e.g. "blue", "#0000ff", "rgb(0,0,255)", "cmyk(100,100,100,10)", etc.).

The format of the PixelSetColor method is:

    MagickBooleanType PixelSetColor(PixelWand *wand,const char *color)

A description of each parameter follows:

wand
  the pixel wand.
color
  the pixel wand color.

## PixelSetColorCount

PixelSetColorCount() sets the color count of the pixel wand.

The format of the PixelSetColorCount method is:

    void PixelSetColorCount(PixelWand *wand,const size_t count)

A description of each parameter follows:

wand
  the pixel wand.
count
  the number of this particular color.

## PixelSetColorFromWand

PixelSetColorFromWand() sets the color of the pixel wand.

The format of the PixelSetColorFromWand method is:

    void PixelSetColorFromWand(PixelWand *wand,const PixelWand *color)

A description of each parameter follows:

wand
  the pixel wand.
color
  set the pixel wand color here.

## PixelSetCyan

PixelSetCyan() sets the normalized cyan color of the pixel wand.

The format of the PixelSetCyan method is:

    void PixelSetCyan(PixelWand *wand,const double cyan)

A description of each parameter follows:

wand
  the pixel wand.
cyan
  the cyan color.

## PixelSetCyanQuantum

PixelSetCyanQuantum() sets the cyan color of the pixel wand.

The format of the PixelSetCyanQuantum method is:

    void PixelSetCyanQuantum(PixelWand *wand,const Quantum cyan)

A description of each parameter follows:

wand
  the pixel wand.
cyan
  the cyan color.

## PixelSetFuzz

PixelSetFuzz() sets the fuzz value of the pixel wand.

The format of the PixelSetFuzz method is:

    void PixelSetFuzz(PixelWand *wand,const double fuzz)

A description of each parameter follows:

wand
  the pixel wand.
fuzz
  the fuzz value.

## PixelSetGreen

PixelSetGreen() sets the normalized green color of the pixel wand.

The format of the PixelSetGreen method is:

    void PixelSetGreen(PixelWand *wand,const double green)

A description of each parameter follows:

wand
  the pixel wand.
green
  the green color.

## PixelSetGreenQuantum

PixelSetGreenQuantum() sets the green color of the pixel wand.

The format of the PixelSetGreenQuantum method is:

    void PixelSetGreenQuantum(PixelWand *wand,const Quantum green)

A description of each parameter follows:

wand
  the pixel wand.
green
  the green color.

## PixelSetHSL

PixelSetHSL() sets the normalized HSL color of the pixel wand.

The format of the PixelSetHSL method is:

    void PixelSetHSL(PixelWand *wand,const double hue,
      const double saturation,const double lightness)

A description of each parameter follows:

wand
  the pixel wand.
hue,saturation,lightness
  Return the pixel hue, saturation, and brightness.

## PixelSetIndex

PixelSetIndex() sets the colormap index of the pixel wand.

The format of the PixelSetIndex method is:

    void PixelSetIndex(PixelWand *wand,const Quantum index)

A description of each parameter follows:

wand
  the pixel wand.
index
  the colormap index.

## PixelSetMagenta

PixelSetMagenta() sets the normalized magenta color of the pixel wand.

The format of the PixelSetMagenta method is:

    void PixelSetMagenta(PixelWand *wand,const double magenta)

A description of each parameter follows:

wand
  the pixel wand.
magenta
  the magenta color.

## PixelSetMagentaQuantum

PixelSetMagentaQuantum() sets the magenta color of the pixel wand.

The format of the PixelSetMagentaQuantum method is:

    void PixelSetMagentaQuantum(PixelWand *wand,
      const Quantum magenta)

A description of each parameter follows:

wand
  the pixel wand.
magenta
  the green magenta.

## PixelSetPixelColor

PixelSetPixelColor() sets the color of the pixel wand.

The format of the PixelSetPixelColor method is:

    void PixelSetPixelColor(PixelWand *wand,const PixelInfo *color)

A description of each parameter follows:

wand
  the pixel wand.
color
  the pixel wand color.

## PixelSetQuantumPixel

PixelSetQuantumPixel() sets the pixel of the pixel wand.

The format of the PixelSetQuantumPixel method is:

    void PixelSetQuantumPixel(const Image *image,const Quantum *pixel,
      PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.
pixel
  the pixel wand pixel.

## PixelSetRed

PixelSetRed() sets the normalized red color of the pixel wand.

The format of the PixelSetRed method is:

    void PixelSetRed(PixelWand *wand,const double red)

A description of each parameter follows:

wand
  the pixel wand.
red
  the red color.

## PixelSetRedQuantum

PixelSetRedQuantum() sets the red color of the pixel wand.

The format of the PixelSetRedQuantum method is:

    void PixelSetRedQuantum(PixelWand *wand,const Quantum red)

A description of each parameter follows:

wand
  the pixel wand.
red
  the red color.

## PixelSetYellow

PixelSetYellow() sets the normalized yellow color of the pixel wand.

The format of the PixelSetYellow method is:

    void PixelSetYellow(PixelWand *wand,const double yellow)

A description of each parameter follows:

wand
  the pixel wand.
yellow
  the yellow color.

## PixelSetYellowQuantum

PixelSetYellowQuantum() sets the yellow color of the pixel wand.

The format of the PixelSetYellowQuantum method is:

    void PixelSetYellowQuantum(PixelWand *wand,const Quantum yellow)

A description of each parameter follows:

wand
  the pixel wand.
yellow
  the yellow color.