mcGraphObjBitmapOptions Enumeration |
|
Legal values for the McGraphObjBitmap.SetBitmap method's OptionFlags argument.
Namespace: MediaCy.IQL.Display.Overlays
Assembly: MediaCy.IQL.Display.Overlays (in MediaCy.IQL.Display.Overlays.dll) Version: 10.0.6912.0
SyntaxVB
Public Enumeration mcGraphObjBitmapOptions
Members| Member name | Value | Description | |
|---|---|---|---|
| mcgboNone | 0 | No options, this is the default state. | |
| mcgboApplyColorCorrection | 1 | If this option flag is set,then when a file name or IStream is supplied as the BitmapSource parameter, any color management information that is embedded in the image file is used to apply a color correction. Embedded information can include International Color Consortium (ICC) profiles, gamma values, and chromaticity information. For McImage BitmapSource, if this flag is set, the McImage.LookupTable is used to adjust the colors of the display; if not set, then no color adjustment is done for McImage sources. For McBitMask sources on a SetBitmap call, if this bit is set then foreground bits in the bit mask are given the McGraphObjBitmap.FillColor; if the bit is not set, then foreground bits are white (both foreground and background colors can be changed by calling the McGraphObjBitmap.SetPalette method). | |
| mcgboZeroIsTransparent | 2 | If this option flag is set,then for indexed-color bitmaps (which includes 8-bit monochrome McImage sources as well as McBitMask sources), then the zero'th index is made transparent (indexed-color bitmaps will have a non-zero McGraphObjBitmap.PaletteCount property). For true-color bitmaps (ones with a zero McGraphObjBitmap.PaletteCount property), setting this bit will cause black displayed colors to be transparent; i.e., it effectively sets the TransparentColorRange to zero and zero. | |
| mcgboIgnoreAoi | 16 | If this option flag is set,then the default SourceRect for a McImage source is the full image, and no AOI masking is performed. If the flag is clear, then the default SourceRect is the full source McImage.Aoi bounds, and the resulting bitmap will be masked by any AOI (if any non-rectangular masking needs to be done, then the resulting bitmap will always be a full-color, non-indexed bitmap, even if the McImage source is a monochrome image). In any case, if a SourceRect is supplied, no AOI masking is done. | |
| mcgboDestXYSizeIsMaxAllowed | 32 | If this option flag is set,then the any given DestXYSize is a maximum allowed size for the stored bitmap. No scaling will be done unless the SourceRect is larger than this size either horizontally or vertically. If the SourceRect is larger than the DestXYSize along either dimension, then the SourceRect is scaled uniformly (i.e., preserving its aspect ratio) so that the final bitmap does not exceed the given DestXYSize along either axis. | |
| mcgboDynamicImageSource | 64 | When when this bit is set or a largebitmap needs to be created from an IMcImage source, then the image data itself is referenced as the bitmap data and an actual bitmap is created only as necessary for display or other purposes. Keeping the data as an image allows updates to the bitmap display when the image data is changed, use of managed image memory for the data and also overcomes an operating system size limitation for bitmaps. If this option flag is not set (the default) and if the bitmap needs to be kept as image data (because the bitmap is large), then a copy is made of the BitmapSource image as necessary. In this case, subequent changes to the BitmapSource image will not be reflected in the McGraphObjBitmap. Unless the mcgboTrackActiveFrame bit is set, changes in the ActiveFrameIndex are not tracked. If the mcgboIgnoreAoi flag is not set, then changes in the Aoi are tracked and the display is updated when the AOI changes. | |
| mcgboTrackActiveFrame | 128 | When when this bit is set and themcgboDynamicImageSource bit is also set, then the ActiveFrameIndex of an IMcImage source is tracked and the bitmap is linked to display the active frame. If the mcgboIgnoreAoi bit is not set, then changes in the AOI are also tracked. Setting this bit forces the mcgboDynamicImageSource bit to be set as well. |
See Also