ImageMagick – MagickWand, C API: Pixel Wand Methods
Author: ImageMagick Studio LLC
Description: ImageMagick is a powerful, open-source software suite for creating, editing, converting, and manipulating images in over 200 formats. Ideal for web developers, graphic designers, and researchers, it offers versatile tools for image processing, including batch processing, format conversion, and complex image transformations.
Keywords: MagickWand, C API: Pixel Wand Methods, Image Processing, Digital Image Editing, Image Conversion, Open-Source Software, Image Manipulation, Command-Line Image Tools

# Pixel-wand

## 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() returns 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:

    IndexPacket 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,MagickPixelPacket *color)

A description of each parameter follows:

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

## PixelGetOpacity

PixelGetOpacity() returns the normalized opacity value of the pixel wand.

The format of the PixelGetOpacity method is:

    double PixelGetOpacity(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetOpacityQuantum

PixelGetOpacityQuantum() returns the opacity value of the pixel wand.

The format of the PixelGetOpacityQuantum method is:

    Quantum PixelGetOpacityQuantum(const PixelWand *wand)

A description of each parameter follows:

wand
  the pixel wand.

## PixelGetQuantumColor

PixelGetQuantumColor() gets the color of the pixel wand as a PixelPacket.

The format of the PixelGetQuantumColor method is:

    void PixelGetQuantumColor(PixelWand *wand,PixelPacket *color)

A description of each parameter follows:

wand
  the pixel wand.
color
  The pixel wand color 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 opacity)

A description of each parameter follows:

wand
  the pixel wand.
opacity
  the opacity 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 IndexPacket 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.

## PixelSetMagickColor

PixelSetMagickColor() sets the color of the pixel wand.

The format of the PixelSetMagickColor method is:

    void PixelSetMagickColor(PixelWand *wand,const MagickPixelPacket *color)

A description of each parameter follows:

wand
  the pixel wand.
color
  the pixel wand color.

## PixelSetOpacity

PixelSetOpacity() sets the normalized opacity value of the pixel wand.

The format of the PixelSetOpacity method is:

    void PixelSetOpacity(PixelWand *wand,const double opacity)

A description of each parameter follows:

wand
  the pixel wand.
opacity
  the opacity value.

## PixelSetOpacityQuantum

PixelSetOpacityQuantum() sets the opacity value of the pixel wand.

The format of the PixelSetOpacityQuantum method is:

    void PixelSetOpacityQuantum(PixelWand *wand,
      const Quantum opacity)

A description of each parameter follows:

wand
  the pixel wand.
opacity
  the opacity value.

## PixelSetQuantumColor

PixelSetQuantumColor() sets the color of the pixel wand.

The format of the PixelSetQuantumColor method is:

    void PixelSetQuantumColor(PixelWand *wand,const PixelPacket *color)

A description of each parameter follows:

wand
  the pixel wand.
color
  the pixel wand color.

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