inq_scene(3G)

NAME

inq_scene − inquire data about a global rendering scene structure

SYNOPSIS

C Syntax:

void inq_scene(fildes,scene_id,root_seg,compute_type);
int fildes,scene_id,*root_seg,*compute_type;

FORTRAN77 Syntax:

subroutine inq_scene(fildes,scene_id,root_seg,compute_type)
integer*4 fildes,scene_id,root_seg,compute_type

Pascal Syntax:

procedure inq_scene(fildes,scene_id:integer;var root_seg,
compute_type: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.

Output Parameters

root_seg Number of the root segment given when the scene structure was created.

compute_type
COMPUTE_RAY_TRACE, COMPUTE_RAD_FIRST, or COMPUTE_RAD_STEP. COMPUTE_RAD_FIRST may be ORed together with ALL_LIGHTS_ON or RAD_SPECULAR. If no global rendering has been computed, NO_COMPUTE is returned.

Discussion

inq_scene returns to the user the values of two attributes of a given global rendering scene structure. Root_seg specifies the display list segment number for the root segment of the model associated with the scene. The compute_type returns the type of rendering (if any) most recently computed by render_scene for this scene.

NOTES

This command may not be stored in a segment.

ERRORS

Invalid file descriptor.
Invalid scene_id.

Museum

Related Articles