Overlay.pic

The overlay.pic command draws a picture in memory without first clearing the existing picture.

Syntax

overlay.pic(var vPICNUM);

Remarks

overlay.pic is similar to draw.pic, except the visual and priority screens are not cleared. This means that picture vPICNUM is overlayed and drawn on top of the existing picture.

Note that because fill commands in the picture resources only work on white portions of the screen, fills on the overlayed picture may not work if they overlap an area already set to a non-white color.

The show.pic command must still be used to display the drawn image on the screen once the picture has been overlayed.

AGI adds a script entry to the script stack each time an overlay.pic command is executed.

Possible Errors

Attempting to overlay a picture that has not been loaded will raise trappable error #18.

Example

Code:

load.pic(v0); [ load and draw the current room's picture:
draw.pic(v0);
discard.pic(v0);
[ then overlay another picture on it
v50 = 99;
load.pic(v50);
overlay.pic(v50); [ adds picture 99
discard.pic(v50);
...
show.pic();

Technical Information

Required Interpreter Version:	Available in all AGI versions.
Byte-Code Value:	28 (0x1C hex)

See Also

Picture Commands
Working with Pictures