SHIP:Sail:image

Function	Returns	Introduced	Description
image	Integer err	v5.1.2	Display an image

See Also:

• Sail Home
• Sail Functions
• Sail Numeric Functions
• draw, qr

Prototype

Integer err = image(Node canvas, String file, Boolean &result[, Integer posX, Integer posY, Integer offsetX, Integer offsetY, Integer clipW, Integer clipH]);

Parameters/Return Value

Parameter	Data Type	Description
canvas	Node	Canvas to draw on
file	String	name of file in 8.3 format
result	Boolean	Operation pass/fail
posX	Integer	X coordinate on canvas
posY	Integer	y coordinate on canvas
offsetX	Integer	x offset to place image
offsetY	Integer	y offset to place image
clipW	Integer	number of pixels to clip the image width
clipH	Integer	number of pixels to clip the image height
Return	Integer	error code

Detailed Description

This function takes the image pointed to by the string file and displays it on the canvas in the location resolved by position and offset. The image will be clipped according to the clip arguments.

Examples

Example	Results	Notes
err = image(homeCanvas, kite.jpg, &pass, 0, 0, ow/2, oh/2, 0, 0);	Success	Display the pic in the bottom right