Show.pri.screen

The show.pri.screen command displays the current room's priority screen on the display monitor.

Syntax

show.pri.screen();

Remarks

This command pauses the game, and displays the current room's priority screen. The displayed image includes the effects on priority by all screen objects, add.to.pic commands, overlay.pic commands, etc. Pressing the ESC or RETURN key will resume the game, and switch back to the visual screen.

If the show.pri.screen is used on the text screen, the game is still paused until ESC or RETURN is pressed, but nothing happens to the display.

This command was typically used during debugging, to allow programmers to verify proper interaction of screen objects with the background picture.

Possible Errors

None.

Example

Code:

#define debug_mode f82
if(isset(debug_mode) && said("show", "pri"))
  {
  show.pri.screen();
  }

Technical Information

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

See Also

Debugging Commands
Priority Screen
AGI Debugging Information