Description
Get the composite response curve LUT in one of two formats.
-
Property type
-
A Variant value.
-
Syntax
-
object.ExtendedLut(Type)
The ExtendedLut Property syntax has these parts: |
| object | An expression evaluating to an object of type McLookupTable. | | Type | Required. A mcExtendedLUTType enumeration, as described in settings. mcExtendedLUTType : The type of LUT to return. When using mceltDisplay, the array returned will contain one byte per possible pixel intensity, while mceltConversion will result in one double per pixel intensity. As the names imply, the conversion LUT is most useful when applying all of the current LUT settings to the image, while the display LUT is most often used for display. The display LUT is cached - the conversion LUT is always generated on demand.
|
Settings The settings for Type are:
|
 | mceltDisplay | 0 |
Return a byte-per-value lookup of pixel display with all applied
|
| mceltDisplayLinear | 1 |
Return a byte-per-value lookup of pixel display with only Black and White levels applied
|
| mceltConversion | 2 |
Return a double-per-value lookup of pixel values with all applied
|
Remarks
This property can be used to get a response curve LUT for either display or image conversion. It differs from the LUT property in that the response curve is returned in the proper length to fit the dynamic range of the image (or the LUT length for floating point images), it applies the luminance channel response curve (for multi-channel images), it applies the black and white levels, and it always returns the entire LUT. Important note: For display LUTs for grayscale images, the LUT returned may be the expected size (e.g. 256 values for 8-bit grayscale) or 3 times the expected size if pseudo-coloring is applied. This is dealt with in the display color casting code which can tell the difference from the size difference. Note: Although you can request the extended LUT for the luminance channel of multi-channel images, it is not very useful since it will only reflect the response curve applied to ALL channels. Normal usage for multi-channel images is to request the extended LUT for all the “real” channels (e.g. channels 1 - 3 for RGB images).
Notes
When getting this property, the return will contain byte or double values representing the response for each possible pixel value. For integral pixel types, the number of values will be equal to the number of possible pixel values in the corresponding image channel (e.g. 256 values for 8-bit per channel images). Floating point images have 64K LUT elements by default, or the number set to the Length property.
|
ExtendedLut Property
