ImageMagick Logo ImageMagick Sprite
Unix
Mac OS X
iOS
Windows
Processing
Options
Usage
MagickWand
MagickCore
PerlMagick
Magick++
Unix
Windows
Links

Module composite Methods

CompositeImageChannel

CompositeImageChannel() returns the second image composited onto the first at the specified offset, using the specified composite method.

The format of the CompositeImageChannel method is:

  MagickBooleanType CompositeImage(Image *image,
    const CompositeOperator compose,Image *composite_image,
    const ssize_t x_offset,const ssize_t y_offset)
  MagickBooleanType CompositeImageChannel(Image *image,
    const ChannelType channel,const CompositeOperator compose,
    Image *composite_image,const ssize_t x_offset,const ssize_t y_offset)

A description of each parameter follows:

image

the destination image, modified by he composition

channel

the channel.

compose

This operator affects how the composite is applied to the image. The operators and how they are utilized are listed here http://www.w3.org/TR/SVG12/#compositing.

composite_image

the composite (source) image.

x_offset

the column offset of the composited image.

y_offset

the row offset of the composited image.

Extra Controls from Image meta-data in 'composite_image' (artifacts)

o "compose:args" A string containing extra numerical arguments for specific compose methods, generally expressed as a 'geometry' or a comma separated list of numbers.

Compose methods needing such arguments include "BlendCompositeOp" and "DisplaceCompositeOp".

o "compose:outside-overlay" Modify how the composition is to effect areas not directly covered by the 'composite_image' at the offset given. Normally this is dependant on the 'compose' method, especially Duff-Porter methods.

If set to "false" then disable all normal handling of pixels not covered by the composite_image. Typically used for repeated tiling of the composite_image by the calling API.

Previous to IM v6.5.3-3 this was called "modify-outside-overlay"

TextureImage

TextureImage() repeatedly tiles the texture image across and down the image canvas.

The format of the TextureImage method is:

  MagickBooleanType TextureImage(Image *image,const Image *texture)

A description of each parameter follows:

image

the image.

texture

This image is the texture to layer on the background.