Description
Get or set the user defined response curve, or one element of the curve.
-
Property type
-
A Variant value.
-
Syntax
-
object.FreeForm([Index]) [= value]
The FreeForm Property syntax has these parts: |
| object | An expression evaluating to an object of type McLookupTable. | | Index | Optional. A Long value. long : Optional. A 0-based index indicating which element of the free form curve is being read. Index = -1 indicates that the entire free form curve is returned or supplied. By default Index = -1.
| | value | A Variant value. | Remarks
The final response curve will be calculated by combining brightness, contrast, and gamma values, and the free-form LUT. The response curve will be applied during display when EnableResponse is TRUE. This transform is applied to all pixels between the BlackLevel and the WhiteLevel when EnableBWLevels is TRUE, or to the entire dynamic range (RangeMin to RangeMax) when the B&W levels are disabled.
Notes
When getting this property, the return will contain either a single numerical value (0 <= Index < FreeFormLength), or an array containing the entire free-form curve (Index = -1). This array will contain 256 integer values. The default free-form curve is such that FreeForm(i) = i. When setting this property, supply an integer or array containing the value(s) being set. A single numerical value may be supplied when (0 <= Index < FreeFormLength), or for the default case (Index = -1) an array must be supplied containing the entire new free-form curve, in which case the array must contain 256 elements.
|