RASTERIMAGE

A picture (photograph, scan, logo …) on four corner points.

Syntax

RASTERIMAGE p1,p2,p3,p4,"data"
RASTERIMAGE @id,p1,p2,p3,p4,"data",layer
RASTERIMAGE @id,p1,p2,p3,p4,"data",layer,SOURCE="file"
RASTERIMAGE @id,p1,p2,p3,p4,"",layer,SOURCE="file",EMBEDDED=FALSE

Argument	Meaning
p1 … p4	The corners: bottom left, bottom right, top right, top left.
"data"	The PNG, WebP or JPEG file, base64url encoded; `""` when it is linked.
`SOURCE="file"`	Where the picture came from: a path (relative to the drawing's folder, or full) or a web address (optional).
`EMBEDDED=FALSE`	Linked: the picture isn't kept in the drawing but read from its source whenever the drawing is read (optional: kept).

The id, layer and any settings after it are the element settings.

Examples

RASTERIMAGE P0,P1,P2,P3,"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk-M9QDwADhgGAWjR9awAAAABJRU5ErkJggg"

A one-pixel image stretched over the box.

Notes

You will rarely type this: place pictures with the Raster Image Tool, and this is how they are written in the drawing file. Move a corner and the picture stretches with it.

A linked picture shows its source as it is now: change the file and the drawing shows the new picture when it is next opened (or at once, with Edit › Links › Update). If the source can't be read, a placeholder naming it is drawn instead. See Linked files and web addresses.