-- Lingo syntaximageObjRef.draw(x1,y1,x2,y2,colorObjOrParamList)imageObjRef.draw(point(x, y),point(x, y),colorObjOrParamList)imageObjRef.draw(rect,colorObjOrParamList) // JavaScript syntaximageObjRef.draw(x1,y1,x2,y2,colorObjOrParamList);imageObjRef.draw(point(x, y),point(x, y),colorObjOrParamList);imageObjRef.draw(rect,colorObjOrParamList);
Image method. Draws a line or an unfilled shape with a specified color in a rectangular region of a given image object.
This method returns a value of 1 if there is no error.
If the optional parameter list is not provided, draw() draws a 1-pixel line between the first and second points given or between the upper left and lower right corners of the given rectangle.
For best performance, with 8-bit or lower images the color object should contain an indexed color value. For 16- or 32-bit images, use an RGB color value.
To fill a solid region, use the fill() method.
x1 Required if drawing a line using x and y coordinates. An integer that specifies the x coordinate of the start of the line.
y1 Required if drawing a line using x and y coordinates. An integer that specifies the y coordinate of the start of the line.
x2 Required if drawing a line using x and y coordinates. An integer that specifies the x coordinate of the end of the line.
y2 Required if drawing a line using x and y coordinates. An integer that specifies the y coordinate of the end of the line.
colorObjOrParamList Required. A color object or parameter list that specifies the color of the line or shape's border. The parameter list can be used instead of a simple color object to specify the following properties.
| Property | Description |
|---|---|
#shapeType |
A symbol value of |
#lineSize |
The width of the line to use in drawing the shape. |
#color |
A color object, which determines the color of the shape's border. |
point(x, y), point(x, y) Required if drawing a line using points. Two points that specify the start and end points of the line.
rect Required if drawing a shape. A rectangle that specifies the rectangular region in which a shape is drawn.
This statement draws a 1-pixel, dark red, diagonal line from point (0, 0) to point (128, 86) within the image of member Happy.
The following statement draws a dark red, 3-pixel unfilled oval within the image of member Happy. The oval is drawn within the rectangle (0, 0, 128, 86).
color(), copyPixels(), fill(), image(), setPixel()