Automation Help
Automation Reference
MediaCy.IQL.Sets
DIMcImageSetEvents Interface
DIMcImageSetTemplateEvents Interface
IMcImageSet Interface
IMcImageSet2 Interface
IMcImageSetAudioChannel Interface
IMcImageSetChannel Interface
IMcImageSetChannels Interface
IMcImageSetDoubleDataChannel Interface
IMcImageSetExtent Interface
IMcImageSetExtents Interface
IMcImageSetImageChannel Interface
IMcImageSetLocation Interface
IMcImageSetLocations Interface
IMcImageSetLongDataChannel Interface
IMcImageSetMcImageLibLibExtendedProperties Interface
IMcImageSetRegion Interface
IMcImageSetResolution Interface
IMcImageSetResolutions Interface
IMcImageSets Interface
IMcImageSetScanPositions Interface
IMcImageSetSection Interface
IMcImageSetSections Interface
IMcImageSetSite Interface
IMcImageSetSites Interface
IMcImageSetSource Interface
IMcImageSetSources Interface
IMcImageSetStringDataChannel Interface
IMcImageSetTemplate Interface
IMcImageSetTemplates Interface
IMcImageSetTimePhase Interface
IMcImageSetTimePhases Interface
IMcImageSetTimePoint Interface
IMcImageSetTimePoints Interface
IMcImageSetUserPosition Interface
IMcImageSetUserPositions Interface
IMcImageSetVariantDataChannel Interface
IMcImageSetZPositions Interface
mcExposeAsImageCreationFlags Enumeration
mcExposedImageStateEnum Enumeration
McImageSet Interface
mcImageSetActivePortionTypes Enumeration
McImageSetAudioChannel Interface
McImageSetChannel Interface
McImageSetChannels Interface
mcImageSetChannelTypes Enumeration
mcImageSetConstants Enumeration
mcImageSetCoordinateTypes Enumeration
mcImageSetDimensions Enumeration
mcImageSetDisplayFlags Enumeration
McImageSetDoubleDataChannel Interface
McImageSetExtent Interface
McImageSetExtents Interface
McImageSetImageChannel Interface
mcImageSetImageMembershipTypes Enumeration
McImageSetLocation Interface
mcImageSetLocationMatchTypes Enumeration
McImageSetLocations Interface
McImageSetLongDataChannel Interface
mcImageSetNavWrapTypes Enumeration
mcImageSetPropertyIDs Enumeration
McImageSetRegion Interface
McImageSetResolution Interface
McImageSetResolutions Interface
McImageSets Interface
McImageSetScanPositions Interface
mcImageSetScanTypes Enumeration
McImageSetSection Interface
McImageSetSections Interface
McImageSetSite Interface
McImageSetSites Interface
McImageSetSource Interface
McImageSetSources Interface
mcImageSetsPropertyIDs Enumeration
mcImageSetState Enumeration
McImageSetStorage Interface
McImageSetStorageClass Class
McImageSetStringDataChannel Interface
McImageSetTemplate Interface
mcImageSetTemplatePropertyIDs Enumeration
McImageSetTemplates Interface
mcImageSetTemplatesPropertyIDs Enumeration
McImageSetTimePhase Interface
McImageSetTimePhases Interface
McImageSetTimePoint Interface
McImageSetTimePoints Interface
McImageSetUserPosition Interface
McImageSetUserPositions Interface
McImageSetVariantDataChannel Interface
McImageSetZPositions Interface
mcImageSetZPositionTypes Enumeration
mcMcImageSetCommandFlags Enumeration
mcMcImageSetRegionCommandFlags Enumeration
mcValidWhere Enumeration
Click or drag to resize

mcExposeAsImageCreationFlags Enumeration
Special legal flag values for the IMcImageSet2.ExposeAsImage method's ImageCreateFlags argument. These flags occupy the same bits in the mcImageCreateFlags enum that the mcImageCreateFlags.mcipfImportPropertiesMask occupies. The normal import properties flags are ignored, since standard image properties are always imported to the exposed McImage and its frames.

Namespace:  MediaCy.IQL.Sets
Assembly:  MediaCy.IQL.Sets (in MediaCy.IQL.Sets.dll) Version: 10.0.6912.0
Syntax
VB
Copy
Public Enumeration mcExposeAsImageCreationFlags
Members
  Member nameValueDescription
mceascfNoFlags0no command flags
mceascfFailOnNoOp4096The ExposeAsImage method willreturn Nothing with a S_FALSE return value if the specified range has a maximum mcisdScan dimension length of 1 and also the mcisdResolutions dimension is not greater than 1. That is, it will fail if the returned image would just be a copy of the frames in the range without reducing the dimensionality of the range at all. This flag is ignored if the mceascfDoNotCollapseDims flag is set. The IMcImageSet2.CommandFlags mcMcImageSetCommandFlags.mcmiscfLastExposeAsImageState will return a mcExposedImageStateEnum with the mceisWarningDegenerateTiling flag set.
mceascfDoNotCollapseDims8192Normally, with this flag clear,the IMcImageSet2.ExposeAsImage method will collapse the mcisdScan dimension and use the mcisdResolutions dimension as a parallel set of sub-sampled sources (where all dimensions other than the mcisdScan match along the mcisdResolutions dimension). However, with this flag set, the sources in the Region passed to the ExposeAsImage method are not collapsed along the scan dimension: instead sources long the Region become frames in the exposed image. All source images in the exposed Range must have the same McImage.Type and size. And the source images must have the same IMcImageStorage.Capabilities (e.g., if one is a Very Large Image, then all must be).
mceascfCopyImageSetAoi16384If set, the McImage.Aoi exposedby the IMcImageSet2.ExposeAsImage method will be a copy of the McImageSet.Aoi. If both the mceascfCopyImageSetAoi and mceascfCopyCurrentLocAoi, then the exposed McImage.Aoi will be the McImageSet.Aoi unless it is empty, in which case it will be the CurrentLocation source Aoi.
mceascfCopyCurrentLocAoi32768If set, the McImage.Aoi exposedby the IMcImageSet2.ExposeAsImage method will be a copy of the source image Aoi at the McImageSet.CurrentLocation, whether or not it is included in the exposed Range. If both the mceascfCopyImageSetAoi and mceascfCopyCurrentLocAoi, then the exposed McImage.Aoi will be the McImageSet.Aoi unless it is empty, in which case it will be the CurrentLocation source Aoi.
mceascfNoAddRefOnOwningSet65536If this flag is set, theMcImage returned by the ExposeAsImage method will not hold an AddRef on the owning McImageSet. This will avoid a cross-lock if the returned McImage is going to be used as a source in the owning McImageSet. In other situations, this flag should not be used, since the returned McImage will need to keep the owning McImageSet alive to access the exposed frame data.
mceascfInvertTilingY131072When collapsing the mcisdScandimension by tiling the scan frames, the ordering of the vertical dimension is swapped from the positions given by the McFrame.PositionY property (by negating it). This flag will have no effect if the mceascfDoNotCollapseDims flag is set.
mceascfInvertTilingX262144When collapsing the mcisdScandimension by tiling the scan frames, the ordering of the horizonatal dimension is swapped from the positions given by the McFrame.PositionX property (by negating it). This flag will have no effect if the mceascfDoNotCollapseDims flag is set.
mceascfNoTileBlending524288When collapsing the mcisdScandimension by tiling the scan frames, if the tiling is not perfect, then tiles will be placed with a random source tile being used for areas of tile overlap. If this flag is clear, areas of tile overlap are blended, usually a time-costly operation. This flag will have no effect if the mceascfDoNotCollapseDims flag is set.
mceascfExposeTiledFrames1048576When themceascfDoNotCollapseDims flag is set (so as to expose uncollapsed sources) and the mcImageSetState.mcissCollapseScanAndResDims state is in effect (so that the parent McImageSet appears to have collapsed mcisdScan dimension), then this flag will cause the ExposedAsImage frames to be the collapsed mcisdScan and mcisdResolution frames. If this flag is clear, then the uncollapsed frames are exposed.
mceascfExposeAsMultiband2097152This flag forces themceascfDoNotCollapseDims flag also to be set (so as to expose uncollapsed sources); the mceascfExposeTiledFrames may or may not be set, though typically you would want it to be. The effect of this flag is to combine sources along the Channel dimension in the requested region so as to expose a multi-band McImage sequence. That is, the Channel dimension is effectively collapsed into as many multi-band channels as necessary to hold all of the channels at a single location in one frame of the sequence. Each monochrome channel is one band; if the channels are RGB then each channel will add three bands.
mceascfIgnoreChannelOffsets4194304When themceascfExposeAsMultiband flag is set (so that a multi-band McImage is exposed), this flag causes the X,Y,Z offsets in the McImageSetImageChannel properties to be ignored. By default, without this flag, these offsets are honored so that a channel Z offset causes frames to be shifted while X and Y offsets cause pixel values to be shifted.
mceascfDisplayOnImageSet8388608If this flag is set, theMcImage returned by the ExposeAsImage method will be marked such that its overlays will display as if they were overlays of the creating McImageSet (which will be the exposed McImage.ImageSet property).
mceascfTrimSizeForOffsets16777216When the mceascfExposeAsMultibandflag is set, this flag causes the Width and Height and Number of Frames in the exposed McImage to be set to the largest bounds and frame Z range that will avoid any missing image data in any channel. If any channels in the range are offset, then this size will be smaller that the image set channel images. The mceascfTrimSizeForOffsets, mceascfCloneSizeForOffsets and mceascfExtendSizeForOffsets flags are mutually exclusive.
mceascfCloneSizeForOffsets0When the mceascfExposeAsMultibandflag is set, this flag (the default) causes the Width and Height and Number of Frames in the exposed McImage to be set to the same bounds and frame Z range as in the original channel images. The mceascfTrimSizeForOffsets, mceascfCloneSizeForOffsets and mceascfExtendSizeForOffsets flags are mutually exclusive.
mceascfExtendSizeForOffsets33554432When the mceascfExposeAsMultibandflag is set, this flag causes the Width and Height and Number of Frames in the exposed McImage to be set to the smallest bounds and frame Z range that will encompass the shifted frames from all channels. The mceascfTrimSizeForOffsets, mceascfCloneSizeForOffsets and mceascfExtendSizeForOffsets flags are mutually exclusive.
mceascfHonorDimensionOrder67108864If this flag is set,the order of Sections added to the McImageSetRegion to be exposed is honored in the ordering of the dimensions in the exposed frames. If this flag is not set then frames are exposed in the standard ordering of mcisdChannel (0), mcisdZ (1), mcisdScan (2), mcisdSite (3), mcisdTime (4), mcisdResolution (5 AKA mcisdUser1) and mcisdUser2 (6).
mceascfMask268431360Mask for the allowed flag bits.
See Also