create_scene(3G)

NAME

create_scene − initialize a global rendering scene structure for a given segment network and return the scene descriptor

SYNOPSIS

C Syntax:

void create_scene(fildes,root_seg,scene_id);
int fildes,root_seg,*scene_id;

FORTRAN77 Syntax:

subroutine create_scene(fildes,root_seg,scene_id)
integer*4 fildes,root_seg,scene_id

Pascal Syntax:

procedure create_scene(fildes,root_seg:integer;var scene_id:
integer);

DESCRIPTION

Input Parameters

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

root_seg Number of a display list segment which is to be the root segment for this scene.

Output Parameters

scene_id Integer id assigned to the created scene.

Discussion

create_scene allocates a global rendering control structure (a scene) and associates it with the model segment network headed by the segment root_seg.

create_scene merely initializes a scene structure that can be rendered and output with later calls to render_scene and output_scene. Associating a model segment with a scene does not preclude the user from subsequent editing of that segment. The model segment is not actually traversed to create the global rendering database until render_scene is issued.

A currently unused scene_id is assigned to the newly created scene and returned to the user. The scene_id is used in all subsequent global rendering commands to refer to that scene. There is no practical limit to the number of scenes that may be created under a given file descriptor. Different scenes may have the same or different root segments.

NOTES

The root segment referenced by create_scene should not be renamed prior to calling render_scene.

The scene_id returned by this call will always be a positive integer in the range 1...231.

This command may not be stored in a segment.

ERRORS

Invalid file descriptor.
Not enough memory.
Root_seg does not exist.

DEFAULTS

The default values of all applicable global rendering parameters are assigned to the newly created scene.

Museum

Related Articles