View source for Show.pic

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 Resource (AGI)|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.pic'''command 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 ==

<div class="CodeBlockHeader">Code:</div>
<syntaxhighlight lang="agi">
[ 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
</syntaxhighlight>

== Technical Information ==

{| border="1" cellpadding="2"
| style="background-color: #efefef" width="200" | '''Required Interpreter Version:'''
| width="175" | Available in all AGI versions.
|-
| style="background-color: #efefef" | '''Byte-Code Value:'''
| 26 (0x1A hex)
|}

== See Also ==

[[Picture Commands]]<br />
[[Working with Pictures]]<br />
[[Category:Commands]]<br />