FutureBasic Logo

<<    Index    >> FutureBasic 5

picture   function

pictureHandle& = picture

This function returns a handle to the picture recorded with the most recent pair of picture on/picture off statements. This handle is the same handle returned by:
   picture off, pictureHandle&
You can specify this handle in the picture statement when you want to draw the picture. You can also pass the picture handle to any of a number of Toolbox routines which require a picture handle as a parameter.

Your program is responsible for releasing the memory occupied by pictures created with the picture on/picture off statements. You should normally use the kill picture statement to do this, once you're finished using the picture handle. However, if you turn the picture into a resource (using the Toolbox routine AddResource or PG's FNpGreplaceRes) then you should not dispose of the picture.

See Also:
picture on/off; picture statement