Description
Defines the charactereistics of an image, including color model and memory layout.
-
Return Type
-
None
-
Syntax
-
object.Initialize eOrganization, ePixelDataType, eInterpretation, eBitsPerChannel, eNumberOfChannels
The Initialize Method syntax has these parts: |
| object | An expression evaluating to an object of type McImageType. | | eOrganization | Required. A mcOrganization enumeration, as described in settings. mcOrganization : Image Array format. (DIB, flat, etc.)
| | ePixelDataType | Required. A mcPixelDataType enumeration, as described in settings. mcPixelDataType : Integer or Float.
| | eInterpretation | Required. A mcInterpretation enumeration, as described in settings. mcInterpretation : Monochrome, RGB, etc.
| | eBitsPerChannel | Required. A mcBitsPerChannel enumeration, as described in settings. mcBitsPerChannel : Dynamic range of each pixel.
| | eNumberOfChannels | Required. A Long value. long : Number of elements, or channels, per pixel. For example, RGB has 3 elements.
|
Settings The settings for eOrganization are:
|
 | mcoAnyArray | 0 |
to retrieve current array type
|
| mcoFlatArray | 1 |
simple block of bytes (i.e. legacy Frame Grabbers)
|
| mcoInverted | 2 |
Flat Array reads bottom to top
|
| mcoDIBArray | 3 |
DWORD aligned, and inverted
|
| mcoBMPArray | 4 |
rows are INT aligned (as in Bit Map)
|
| mcoNewDIBArray | 5 |
new format DIB - DWORD aligned, not inverted
|
The settings for ePixelDataType are:
|
| mcpdtAnyType | 0 |
current band type
|
| mcpdtInteger | 1 |
pixels hold integral values
|
| mcpdtFloat | 2 |
numbers are floating point
|
The settings for eInterpretation are:
|
| mciAnyInterp | 0 |
current interpretation
|
| mciMonochrome | 1 |
only one channel
|
| mciIndexedColor | 2 |
8 bits per pixel, pseudo-colored
|
| mciGenericMultiBand | 3 |
multichannel, when needed, pixel luminance is averaged across the channels
|
| mciRGB | 4 |
normal color model, 3 channels arranged as “RGBRGBRGB...”
|
| mciBGR | 5 |
Similar to RGB, except the channels are reversed for DIBs as “BGRBGRBGR...”
|
| mciHSL | 6 |
Three channels, Hue, Saturation, and Luminance
|
| mciHSI | 7 |
Three channels, Hue, Saturation, and Intensity
|
| mciComplex | 8 |
Two channels, real and imaginary arranged as “RIRIRI...”, only supported with McFloat
|
| mciPolar | 9 |
Two channels, magnitude and phase arranged as “MPMPMP...”, only supported with McFloat
|
The settings for eBitsPerChannel are:
|
| mcbpcAnyBits | 0 |
don't care
|
| mcbpc8Bits | 8 |
integer only, values range from 0 to 255
|
| mcbpc12Bits | 12 |
integer only, needs 16 bits, values range from 0 to 4095
|
| mcbpc16Bits | 16 |
integer only, values range from 0 to 65535
|
| mcbpc32Bits | 32 |
can be either integer or float. If integer, values range from 0 to 4Gig.
|
| mcbpc64Bits | 64 |
float only
|
Remarks
Allows the caller to set all ImageType properties at once. For performance reasons, the parameters are not verified; instead, the user should call IsValid() when needed to verify the ImageType object.
Exceptions
| Exception: |
Meaning: |
None.
|
|
|
Initialize Method (McImageType)
