Download VisionWare Reference Guide, Version 3.0

PR.AUTO_BRIGHTN
Calling Sequence
CALL pr.auto_brightn (args[], step, fail, error)
Function
Preruntime statement routine for the AUTO_BRIGHTNESS statement.
Usage Considerations
vw.precs[,] is changed.
vw.ab.next.time is initialized to 1.
Input Parameters
args[ ]
Real array containing the arguments for this statement. The individual
elements are described below:
[0] Statement ID number.
[1] Window inspection record.
[2] Number of the output signal (hardware or software) to access to
indicate the result. The value zero indicates no output.
step
Real variable containing the sequence step number for this statement.
This will need to be used to process errors as an argument to rn.error( )
(see the AIM Customizer’s Reference Guide).
Output Parameters
args[ ]
If args[0]=0, the AUTO_BRIGHTNESS statement is disabled.
fail
TRUE if there were any problems.
error
Standard AIM error response code.
Global Variables
vw.precs[TASK( ), logical.rec]
List of physical record numbers.
vw.ab.next.time
Counter for how often to check and adjust the brightness.
Details
This routine will prefetch the physical record number for each argument and make sure it has an
entry in the logical-to-physical mapping array.
It will also check the record type for each argument to make sure that it is in the inspection class
and that it inspects a window record for average graylevel.
CAUTION: This is a runtime routine.
It is performed after linking as one of the first steps in runtime. Errors must be handled by calling
rn.error( ). Pop-ups are not allowed.
Related Routine
auto_brightness
VisionWare Reference Guide, Rev. A
127