Show.pic

From AGI Wiki
Jump to: navigation, search

The show.pic command copies the visual screen created in memory onto the actual display screen.

Syntax

show.pic();

Remarks

AGI does not draw picture resources directly to the screen. The draw.pic command creates the picture image in shadow memory, which is copied to the video display memory by the show.pic command.

The show.piccommand resets reserved flag f15 (no pause windows) before the image is displayed. It is not known why Sierra felt it was necessary to add this.

If the text screen is currently active, the show.pic command will not change the display mode to the graphics screen.

See the Working with Pictures topic for additional information on drawing and displaying picture resources.

Possible Errors

None.

Example

Code:
[ load and display the current room's picture:
load.pic(currentRoom);    [ first load the picture resource
draw.pic(currentRoom);    [ then draw the picture to memory
discard.pic(currentRoom); [ resource no longer needed, so discard it
...
show.pic();               [ now display the picture on screen

Technical Information

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

See Also

Picture Commands
Working with Pictures