Image Data Model: _setPixel

Image Data Model: _setPixel

Assigns the pixel value in an image at the position indicated

Syntax
Details

Syntax

CALL SEND (object-id, '_setPixel', x, y, pix-val|red, green, blue);

Argument Type Description

x
N the row location in the image

y N the column location in the image

pix-val N for images of type CMAP, a pixel value in the range 0...255 that is the index of a color; for images of type GRAY, a pixel value that is either 1 or 0

red, green, blue N for images of type RGBA, red, green, and blue values of a color; each value must be in the range 0...255

Argument	Type	Description
x	N	the row location in the image
y	N	the column location in the image
pix-val	N	for images of type CMAP, a pixel value in the range 0...255 that is the index of a color; for images of type GRAY, a pixel value that is either 1 or 0
red, green, blue	N	for images of type RGBA, red, green, and blue values of a color; each value must be in the range 0...255

Details

The _setPixel method returns an error if any value is outside the range. This method can be used with a new or existing image.

CAUTION:: Image data can be destroyed. Use this method carefully, or you can destroy your image data.

Chapter Contents
Previous
Next
Top of Page