Lingo Dictionary > S > setPixel() |
![]() ![]() ![]() |
setPixel()
Syntax
imageObject
.setPixel(
x
,
y
,
colorObject
)
imageObject
.setPixel(point(x
,y
),colorObject
)imageObject
.setPixel(x
,y
,integerValue
)imageObject
.setPixel(point(x
,y
),integerValue
)
Description
Function; sets the color value of the pixel at the specified point in the given image object, to either colorObject
or to a raw integer with integerValue
. If you are setting many pixels to the color of another pixel with getPixel()
, it is faster to set them as raw integers.
For best performance with color objects, with 8-bit or lower images use an indexed color object, and with 16-bit or higher images, use an RGB color object.
The setPixel()
function returns FALSE
if the specified pixel falls outside the specified image.
To see an example of setPixel()
used in a completed movie, see the Imaging movie in the Learning\Lingo Examples folder inside the Director application folder.
Example
This Lingo statement draws a horizontal black line 50 pixels from left to right in cast member 5.
repeat with x = 1 to 50 member(5).image.setPixel(x, 0, rgb(0, 0, 0)) end repeat
See also
getPixel()
, draw()
, fill()
, color()
![]() ![]() ![]() |