Maintenance script: Initial automated import

2016-02-24T18:24:39Z

Initial automated import

New page

{{Template:TI-BASIC:Command
|picture=RECALLPIC.GIF
|summary=Recalls a saved picture (one of Pic1, Pic2, ..., Pic0) to the graph screen.
|syntax=RecallPic ''number''
|location=Press:
# 2nd DRAW to access the draw menu.
# LEFT to access the STO submenu.
# 2 to select RecallPic, or use arrows and ENTER.
|compatibility=TI-83/84/+/SE
|size=1 byte
}}

RecallPic draws a saved picture to the graph screen (to save a picture, draw it on the graph screen, then save it with [[TI-BASIC:Storepic|StorePic]]). If something is already drawn on the graph screen, RecallPic will draw new pixels where needed, but it will not erase anything. As a result, you often want to [[TI-BASIC:Clrdraw|ClrDraw]] before recalling a picture.

The number passed to RecallPic must be one of 0 through 9. It has to be a number: RecallPic X will not work, even if X contains a value 0 through 9.

= Advanced Uses =

A combination of StorePic and RecallPic can be used to maintain a background over which another [[TI-BASIC:Glossary#s|sprite]] moves:

# Draw the background, and save it to a picture file with StorePic.
# Next, draw the sprite to the screen.
# When you want to move the sprite, erase it, then use RecallPic to draw the background again.
# Then draw the sprite to its new location on the screen again (this can be done before or after using RecallPic).

Also, if a screen in your program takes more than a second to draw, and is displayed several times, you might want to consider storing it to a picture the first time it's drawn, and then recalling it every next time you want to draw it.

= Error Conditions =

* '''[[TI-BASIC:Errors#datatype|ERR:DATA TYPE]]''' is thrown if the argument is not a '''number''' 0 through 9.
* '''[[TI-BASIC:Errors#undefined|ERR:UNDEFINED]]''' is thrown if the requested picture does not exist.

= Related Commands =

* [[TI-BASIC:Clrdraw|ClrDraw]]
* [[TI-BASIC:Storepic|StorePic]][[Category:TI-BASIC]]
[[Category:TIBD]]

TI-BASIC:Recallpic - Revision history

Maintenance script: Initial automated import