Click or drag to resize

mcOptionFlags Enumeration

Allowed bit values for the OptionFlags property

Namespace:  MediaCy.IQL.Features
Assembly:  MediaCy.IQL.Features (in MediaCy.IQL.Features.dll) Version: 10.0.6912.0
Syntax
VB
Public Enumeration mcOptionFlags
Members
  Member nameValueDescription
mcofNoFlags0No flags
mcofKeepRegionsAsUnion1If set, regions are kept as asingle union scan list (bit mask); thus no overlapping regions are allowed. If clear, regions are maintained as outlines which may overlap. When the state of this flag is changed, the Count property may also change. This flag is clear by default.
mcofConnect82If set, regions are consideredconnected using 8-connected test. Otherwise, a 4-connected test is used for the test. When the state of this flag is changed, the Count property may change. This flag is clear by default except for McLines, in which case it is set by default.
mcofOutlinePixelTiles4If set, then the boundary polygonfor McRegions features of Type mcftScanList (ones created by a call to McThreshold.Execute or McFeatures.SetFromMask) is placed on the outer border of the blob's border pixels, treated as a tile. If clear (the default state), then the boundary polygon is placed on the center of the border pixels of the blob. The boundary polygon is accessed by the McFeatures.GetFeaturePoints, and is the basis many of the region measurements (e.g., mRgnPolygonialArea). See also mcofOutlineOutsidePixels.
mcofKeepDuplicatesOnMerge8If set, then theMcFeatures.Merge method will not eliminate duplicate features from the source McFeatures. That is, setting this option bit changes the Merge method into an "Append" method. If the mcofKeepDuplicatesOnMerge OptionFlags bit is off (the default case), then features that are identical to source features are removed before the merge. This bit is ignored if the mcofKeepRegionsAsUnion bit is set, since in that case all region features are maintained as a single bitmap so duplicate features are intrinsically impossible.
mcofOneFeatureOnly16If set, then tool-createdMcGraphObj objects with the AutoDisplayTemplateID (see DisplayOverlays) will Reset the the features to the IsReset state before creating the new feature, thus limiting the number of features to one. Also if this flag is set and the last feature is deleted from the overlay, then the McFeatures is placed in the IsReset state (rather than the IsEmpty state). For example, this flag is set to prevent the user from creating more than one AOI region. The flag is clear by default, so that multiple regions can be created by the user. For the McImage.Aoi McRegions, the default state of this flag can controlled by a McApplication.Settings as follows: Settings("Aoi","Defaults").Set( "OneFeatureOnly", bDesiredState) where bDesiredState is True or False.
mcofEmptyIsReset32If set, any zero Count situationis reported as IsReset and never as IsEmpty. AOI McRegions have this bit set, otherwise it is clear by default.
mcofClipToParentImage64If set, and the McFeaturesoperator has an ancestor McImage, then CopyFrom, Merge, Intersect or Duplicate operations will clip the source McFeatures to the ancestor McImage's bounds before performing the operation. AOI McRegions have this bit set, otherwise it is clear by default. In addition, the AccessMaskedImageData will also honor this flag and so will limit any operation that uses the Aoi to the image bounds. This will affect things such as CleanBordersAndNoise as well as filters, histograms and all other operations that operate on pixel data as masked by the Aoi.
mcofSnapToPixelCenters128If set, then for allDisplayOverlays collection overlays, including the AutoDisplayOverlay, the McGraphOverlay.SnapToGrid property is automatically set to 1. If cleared then SnapToGrid is set to 0 for DisplayOverlays members. The effect is to prevent users from placing handles between pixels when editing or creating linked features on zoomed-in views. For non-AOI McRegions, the flag is clear by default, so that features can be placed at sub-pixel locations on zoomed-in views; for AOI regions the flag is set by default so that AOI's are always placed on pixel centers. For the McImage.Aoi McRegions, the default state of this flag can controlled by a McApplication.Settings as follows: Settings("Aoi","Defaults").Set( "SnapToPixelCenters", bDesiredState) where bDesiredState is True or False.
mcofAoiOptions224McRegionsobjects used as McImage.AOI's have the mcofEmptyIsReset, mcofClipToParentImage and mcofSnapToPixelCenters OptionFlags bits set by default. All other McRegions have these bits clear by default. For McImage.Aoi objects, the default state of the mcofOneFeatureOnly and mcofSnapToPixelCenters flags can be controlled by a McApplication.Settings
mcofDisplayRegionHoles256When set, McRegions features of overallType mcftScanList are show with their owned Holes in a linked AutoDisplay McGraphObjBitmap instead of a McGraphObjPoly based on the outline of the scan list.
mcofFullCoverageIntersectionTest512When set, the test usedfor deciding which features a McFeatures or McBitMask selector intersects is made more stringent so that a feature is selected only if it is fully covered by the selector bit mask. If clear, then any intersection of the feature with the selector bit mask selects the feature. See, for example, the McFeatures.GetFeatures method's Selector parameter for more discussion.
mcofCopyDisplayedObjects1024the flags below MUST correspond to the similar mcFeatureStatusFlags They occupy bits from 0x00000800 through 0x00100000 (mcofDefaultTrackDragging).
mcofDefaultXorOnMerge2048If set, feature pixels are bydefault Xor'ed when merging, else they are Or'ed (see also mcfsfXorOnMerge). The effect is to create holes where regions overlap (see McRegions.Holes) This flag is clear by default.
mcofDefaultPolyline4096If set, McLines line features arealways treated as polylines (type mcftPolyline) even if they have only one segment. If clear, line features with one line segment are treated as mcftLine type, while lines with more than one segment are treated as mcftPolyline. The major effect of this difference is that it determines the type of linked McGraphObj that will be used to display line features with one segment. Assigning a new value to this flag will not redisplay existing lines. This flag is clear by default.
mcofDefaultCircle65536If set, circular ellipses createdby McRegions.SetEllipse are by default treated as mcftCircle (see also mcfsfCircle). Setting this flag also has the effect of causing the AutoDisplayOverlay's Template for McGraphObjEllipse to have its Square property set True. The effect of this is to cause all user created ellipses to be circles. To turn off this constraint, do the following: myMcRegions.AutoDisplayOverlay.Template("McGraphObjEllipse",mcgtStandardAutoDisplay).Square = False
mcofDefaultFreeEllipse131072If set, angle 0 ellipses createdby McRegions.SetEllipse are by default treated as mcftFreeEllipse (see also mcfsfFreeEllipse), Clearing this flag also has the effect of causing the AutoDisplayOverlay's Template for McGraphObjEllipse to have the mcgsAllowRotate bit in its Style property cleared. The effect of this is to cause all user created ellipses to be to be flat (not able to rotate). To turn off this constraint, do the following: myMcRegions.AutoDisplayOverlay.Template("McGraphObjEllipse",mcgtStandardAutoDisplay).Style(mcgsAllowRotate) = mcgsAllowRotate
mcofDefaultFreeBox262144If set, angle 0 boxes createdby McRegions.SetRotatableBox or McRegions.SetRoundedRect are by default treated as mcftFreeBox or mcftFreeRoundedBox (see also mcfsfFreeBox), Clearing this flag also has the effect of causing the AutoDisplayOverlay's Template for McGraphObjRect and McGraphObjRRect to have the mcgsAllowRotate bit in its Style property cleared. The effect of this is to cause all user created rectangles to be to be flat (not able to rotate). To turn off this constraint, do the following: myMcRegions.AutoDisplayOverlay.Template("McGraphObjRect",mcgtStandardAutoDisplay).Style(mcgsAllowRotate) = mcgsAllowRotate myMcRegions.AutoDisplayOverlay.Template("McGraphObjRRect",mcgtStandardAutoDisplay).Style(mcgsAllowRotate) = mcgsAllowRotate
mcofDefaultSquare524288If set, square boxes created byMcRegions.SetBox are by default made squares (see also mcfsfSquare). Setting this flag also has the effect of causing the AutoDisplayOverlay's Template for McGraphObjRect to have its Square property set True. The effect of this is to cause all user created boxes to be squares. To turn off this constraint, do the following: myMcRegions.AutoDisplayOverlay.Template("McGraphObjRect",mcgtStandardAutoDisplay).Square = False
mcofDefaultTrackDragging1048576When set, featurecoordinates will by default be updated continuously during dragging of any AutoDisplay linked McGraphObj (see also mcfsfTrackDragging). If not set (the default state), then the feature coordinates will by default be updated only when the dragging of the linked McGraphObj ends. McGraphObj.AngleOfRotation changes made by the user are never updated during dragging, irrespective of the state of this bit.
mcofPrivateAppearance16777216Used for AOI McRegions to note which have a privately assigned appearance
mcofNoIndexOnFeatureName33554432If set, the defaultMcBasicFeatures.Name and McBasicFeatures.Description will not include the feature index.
mcofInvertFeatureMask67108864If set, the GetBounds methodwill report bounds that encompass the whole of any ancestor image. Similarly, the GetFeatureBoundingBox method will report ancestor image bounds. If there is no ancestor image, then in these cases, the bounds of the features is reported. In addition, the foreground bits will be inverted when reported by the following methods: AccessMaskedImageData, GetLineSegments and CreateFeatureMask with a Selector argument either missing or a negative scalar. If there is no ancestor image, then the foregound bits are still inverted, but only within the bounds of the features.
mcofOutlineOutsidePixels134217728If set, then the boundary polygon forMcRegions features of Type mcftScanList (ones created by a call to McThreshold.Execute or McFeatures.SetFromMask) is placed on the background pixels adjacent to the the blob's border pixels. If clear (the default state), then the boundary polygon is placed on the center of the border pixels of the blob. The boundary polygon is accessed by the McFeatures.GetFeaturePoints, and is the basis many of the region measurements (e.g., mRgnPolygonialArea). If the mcofOutlinePixelTiles flag is set, then that flag takes precedence over this one.
mcofMarkLinkedMcGraphObj268435456When set, for features createdprogramatically (that is, not via a link from a graphic object) when a linked graphic object is created from the created feature, the the McGraphObjEx.ExtendedStyle mcGraphObjExtendedStyle.mcgesMcFeaturesCreated bit assigned, and in the process may have the McGraphObj.ZoomWithImageLimit set based on a size-related algorithm; this algorthm will not be applied to McGraphObjPoint linked graphic objects.
mcofAllFlags-1all flags
See Also