Magick::Pixels

   // Create base image
   Image image(Geometry(254,218), "white");

     // Set the image type to TrueColor DirectClass representation.
   image.type(TrueColorType);

   // Ensure that there is only one reference to underlying image
   // If this is not done, then image pixels will not be modified.
   image.modifyImage();

   // Allocate pixel view
   Pixels view(image);

   // Set all pixels in region anchored at 38x36, with size 160x230 to green.
   unsigned int columns = 196; unsigned int rows = 162;
   Color green("green");
   PixelPacket *pixels = view.get(38,36,columns,rows);
   for ( int row = 0; row < rows ; ++row )
     for ( int column = 0; column < columns ; ++column )
       *pixels++=green; 

   // Save changes to image.
   view.sync();

   // Set all pixels in region anchored at 86x72, with size 108x67 to yellow.
   columns = 108; rows = 67;
   Color yellow("yellow");
   pixels = view.get(86,72,columns,rows);
   for ( int row = 0; row < rows ; ++row )
      for ( int column = 0; column < columns ; ++column )
         *pixels++=yellow;
    view.sync();

   // Set pixel at position 108,94 to red
   *(view.get(108,94,1,1)) = Color("red"); 

   // Save changes to image.
   view.sync();

Method

Returns

Signature

Description

get

PixelPacket*

const int x_, const int y_, const unsigned const int columns_, const unsigned int rows_

Transfers read-write pixels from the image to the pixel cache as defined by the specified rectangular region. Modified pixels may be subsequently transferred back to the image via sync. The value returned is intended for pixel access only. It should never be deallocated.

getConst

const PixelPacket*

const int x_, const int y_, const unsigned int columns_, const unsigned int rows_

Transfers read-only pixels from the image to the pixel cache as defined by the specified rectangular region.

set

PixelPacket*

const int x_, const int y_, const unsigned int columns_, const unsigned int rows_

Allocates a pixel cache region to store image pixels as defined by the region rectangle.  This area is subsequently transferred from the pixel cache to the image via sync. The value returned is intended for pixel access only. It should never be deallocated.

sync

void

void

Transfers the image cache pixels to the image.

indexes

IndexPacket*

void

Returns the PsuedoColor pixel indexes corresponding to the pixel region defined by the last get , getConst, or set call. Only valid for PseudoColor and CMYKA images. The pixel indexes (an array of type IndexPacket, which is typedef Quantum, which is itself typedef unsigned char, or unsigned short, depending on the value of the QuantumDepth define) provide the colormap index (see colorMap) for each pixel in the image. For CMYKA images, the indexes represent the black channel. The value returned is intended for pixel access only. It should never be deallocated.

x

int

void

Left ordinate of view

y

int

void

Top ordinate of view

columns

unsigned int

void

Width of view

rows

unsigned int

void

Height of view