Description

Calibrates an array luminance values, filling an array of Double calibrated results

Return Type

A Long value.  

The number of values converted (EndIndex-StartIndex+1).

Syntax

object.CalibrateValues (LuminanceValues, CalibratedValues, [StartIndex], [EndIndex])

The CalibrateValues Method syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McIntensityCalib.
LuminanceValuesRequired. A Variant value.

An single scalar luminance value or an array of such values to be calibrated.

CalibratedValuesRequired. A Variant value.

An array of Double type, filled with the calibrated luminance values. An existing Double array is not resized if it is large enough to hold the results.

StartIndexOptional. A Long value.

If given, an index into the LuminanceValues array indicating the first value to calibrate. This will be placed in the first (0'th) location in the CalibratedValues output array.

EndIndexOptional. A Long value.

If given, an index into the LuminanceValues array indicating the last value to calibrate; if not given, then LuminanceValues up to the end of the array are calibrated.

Remarks

This method takes an array or scalar value of any numeric type and applies the current intensity calibration to it. An output array will be filled with Double type (64-bit IEEE floating point values) calibrated results.

The source LuminanceValues argument and the destination CalibratedValues argument may point to the same Variant, in which case, the LuminanceValues are replaced by the array of Double calibrated values. In this case, the StartIndex argument must be zero (the default).