inq_rad_energy(3G)
NAME
inq_rad_energy − inquire the amount of light energy in a scene that is not yet accounted for in the latest radiosity solution
SYNOPSIS
C Syntax:
void inq_rad_energy(fildes,scene_id,percent_remaining);
int fildes,scene_id;
float *percent_remaining;
FORTRAN77 Syntax:
subroutine inq_rad_energy(fildes,scene_id,percent_remaining)
integer*4 fildes,scene_id
real percent_remaining
Pascal Syntax:
procedure inq_rad_energy(fildes,scene_id:integer;
var percent_remaining:real);
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
percent_remaining
Percentage of total radiosity remaining in the scene following the most recent call to render_scene.
Discussion
This command inquires how much light energy in a scene remains unaccounted for at the current stage of the progressive radiosity solution. The energy remaining, given as a percentage of the energy originally emitted by the light sources, can be used to evaluate the completeness of the radiosity solution after any number of iterations. If inq_rad_energy is called before any iterations of the radiosity solution have been done, percent_remaining will be 100. As iterations are done, the percent_remaining will decrease, reaching 0 when the complete solution is achieved.
NOTES
This command cannot be stored in a segment.
ERRORS
Invalid file descriptor.
Invalid scene_id.
SEE ALSO
— July 12, 1991