NAME

delete_scene − delete a global rendering scene and reclaim its storage

SYNOPSIS

C Syntax:

void delete_scene(fildes,scene_id);
int fildes,scene_id;

FORTRAN77 Syntax:

subroutine delete_scene(fildes,scene_id)
integer*4 fildes,scene_id

Pascal Syntax:

procedure delete_scene(fildes,scene_id:integer);

DESCRIPTION

Input Parameters

fildes Integer file descriptor returned by gopen when an I/O path to a graphics device is opened. 

scene_id Scene identifier; as returned by create_scene. 

Discussion

delete_scene deletes the global rendering scene specified by scene_id and returns all storage to the host. 

The given scene structure and all rendering data and results associated with it are deleted.  Any open temporary files associated with the environment (the ray trace bitmap file, for example) are closed and deleted.  delete_scene does not delete the model segment network associated with scene_id. 

If scene_id does not specify an existing scene, an error is generated and no other action taken. 

NOTES

If the environment variable USR_TMP_SBRR is set appropriately, the ray tracer can store the rendering results for a scene in a user-defined file that is not associated with the scene itself.  If this is done, the rendering results will not be removed when delete_scene is called to remove that scene, though all other parts of the scene will be deleted.  See the documentation for render_scene for more information on USR_TMP_SBRR. 

This command may not be stored in a segment. 

ERRORS

Invalid file descriptor. 
Invalid scene_id. 

SEE ALSO

create_scene(3G), render_scene(3G). 

  —  July 12, 1991