Description

Specifies overall optional behaviors.

Property type

A mcProfileEdgesOptionFlags enumeration.  

Syntax

object.OptionFlags [= value]

The OptionFlags Property syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McProfileEdges.
valueA mcProfileEdgesOptionFlags enumeration, as described in settings.

Settings

The settings for value are:

ConstantValueDescription
 mcpeofNoOptionFlags0

No flags

 mcpeofAutoClearOnProfileMove1

Edges are automatically removed from any profile where the underlying McLines or McRegions feature moves. The effect is that edges and tic marks will disappear after a line feature is edited or moved, but will not disappear on other line features that have not changed. Edges are always removed when the ancestor feature is removed irrespective of the state of this flag. Note that this flag does not cause edges to be removed when the underlying McImage luminance data changes; the mcpeofAutoClearOnLuminanceChange does that. This flag is set by default.

 mcpeofAutoClearOnLuminanceChange2

Edges are automatically removed from all profiles where the ancestor luminance profile data changes. The effect is that edges and tic marks will disappear after an ancestor McImage luminance change or after one of the ancestor McLineProfiles properties or ProfileValues changes. Note that this flag will always cause edges to disappear when the underlying McLines or McRegions feature is moved (that is, it acts as if the mcpeofAutoClearOnProfileMove bit is also set). This flag is clear by default.

 mcpeofAbsoluteThresholding16

During edge detection on the WeightedProfile, if the mcpeofAbsoluteThresholding OptionFlags bit is set, then the McProfilesEdges.ThresholdForEdge value is an absolute percentage of the best possible profile pattern for the ancestor image's maximum luminance range and the current set of weighting parameters. This "best weighted value" is the McProfilesEdges.AbsoluteMaxWeightValue property. If the flag is clear (the default case), then the ThresholdForEdge is a percentage of the peak weighted values for each profile, with some minimum constraints applied if the MinEdgesPerProfile property is zero (so that no edges will be found for very weak weighted profiles). When this flag is set, appropriate values for the McProfilesEdges.ThresholdForEdge property can be very low (that is interesting “edges” often result in a weighted profile peak that is a small percentage of the best possible peak).

Note that this flag is almost never appropriate when the McProfilesEdges.EdgeFindingMethod is mcpefmPeaks or mcpefmValleys, because in those cases a weighted average is being done of raw luminance. In these cases, a low threshold value may miss all luminance transitions because it is underneath them all. Thus, this flag is forced off whenever the McProfilesEdges.EdgeFindingMethod is assigned mcpefmPeaks or mcpefmValleys. You may turn it on again after the assignment to McProfilesEdges.EdgeFindingMethod. If you are presenting this bit as an option in a user interface, it should generally be disabled when the McProfilesEdges.EdgeFindingMethod is mcpefmPeaks or mcpefmValleys.

 mcpeofDefault1

Remarks

The OptionFlags can be set to automatically clear existing edges when the ancestor McLines or McRegions move and/or when the parent McLineProfiles changes.

When moving lines that have edges marked on them, you will generally need to hide the edges before the line is moved, so that they are not left behind as orphans while the line is dragged around by the user. When the line or handle is finally placed in a new spot, then the edges are actually removed. The example shows how you might monitor these events to hide and then reshow the tic marks on lines that were not moved.