DvInqRadiosityConvergence(3D)

NAME
DvInqRadiosityConvergence - Return the radiosity convergence criterion for a view

SYNOPSIS
C:
void DvInqRadiosityConvergence(view, type, parms)
DtObject view ;
DtRadiosityConvType *type;
DtReal parms[];

FORTRAN:
CALL DVQRDC(VIEW,TYPE,PARMS)
INTEGER*4 VIEW
INTEGER*4 TYPE
REAL*8 PARMS(*)

DESCRIPTION
DvInqRadiosityConvergence returns the radiosity convergence criterion for the view specified by the parameter view. This applies to progressive radiosity techniques in which intermediate images are computed until a certain criterion or threshold is met. Possible type values are:

DcConvFixedIterations <DCCVFI>
    Perform a fixed number of iterations specified in parms[0].

DcConvGlobalRel <DCCVGR>
    Stop when the ratio of the total unshot energy over the total energy in the scene is smaller or equal to parms[0].

DcConvGlobalAbs <DCCVGA>
    Stop when the total unshot energy in the scene is smaller or equal to parms[0].

DcConvPatchRel <DCCVPR>
    Stop when the ratio of the unshot energy of the brightest patch over the total energy in the scene is smaller or equal to parms[0]. The brightest patch is the patch with the maximum unshot energy.

DcConvPatchAbs <DCCVPA>
    Stop when the unshot energy of the brightest patch in the scene is smaller or equal to parms[0].

ERRORS
DvInqRadiosityConvergence will fail if the view handle is invalid.

[WARNING - invalid view handle]

SEE ALSO
DvSetRadiosityConvergence(3D)