Description
Controls optional aspects of the profile weighting analysis.
-
Property type
-
A mcProfileEdgesWeightingFlags enumeration.
-
Syntax
-
object.WeightingFlags [= value]
The WeightingFlags Property syntax has these parts: Settings The settings for value are:
|
 | mcpewfNoWeightingFlags | 0 |
No flags
|
| mcpewfReflectAtEnds | 0 |
Edges are found assuming that the profile continues beyond its start or end as it did before (i.e., is reflected). Edges found at the extreme start or end of the profile might occasionally represent artifacts (a reflected falling luminance looks like a valley, while a reflected rising luminance looks like a peak). This is the behavior for profiles based on ancestor McLines (e.g., open lines or polylines). This flag cannot be changed by assignment.
|
| mcpewfWrapAtEnds | 1 |
Edges are found assuming that the profile wraps from its end back to its start. Edges found at the extreme start or end of the profile will be based on luminance patterns that wrap. This is the behavior for profiles based on ancestor McRegions (e.g. closed polygons). This flag cannot be changed by direct assignment. It is set automatically based on the ancestor McFeatures type (set for McRegions), and for global McProfileEdges by the bClosedProfiles argument to the McProfileEdges.RawProfiles assignment.
|
| mcpewfPointsForSameSize | 16 |
When the McProfilesEdges.EdgeFindingMethod property is mcpefmMatchPattern (so that edges are found based on matches to the Pattern property), then setting this WeightingFlags bit will cause profile patterns that are the same amplitude as the Pattern property to be favored over either smaller or larger amplitudes. The strength of the effect depends on the SizeWeighting property (stronger with greater SizeWeighting). You might use this option if you were looking for medium sized luminance peaks, but you wanted to exclude very bright spots. This flag may be combined with the mcpewfPointsForSameOffset flag to try to exactly match the Pattern in both size and offset. The flag is off by default.
|
| mcpewfPointsForSameOffset | 32 |
When the McProfilesEdges.EdgeFindingMethod property is mcpefmMatchPattern (so that edges are found based on matches to the Pattern property), then setting this WeightingFlags bit will cause profile patterns that are the same mean luminanance as the Pattern property's mean luminance to be favored over either dimmer or brighter sections of the pattern. You might use this option if you were looking for a “W” shaped pattern on top of bright sections of the profile, but you wanted to exclude such profile patterns where the image was dark. This flag may be combined with the mcpewfPointsForSameSize flag to try to exactly match the Pattern in both size and offset. The flag is off by default.
|
Remarks
The WeightingFlags reflect and control aspects of the first, weighting phase of the FindEdges analysis. The first aspect has to do with how profile should be weighted at the ends where the pattern stops. The mutually exclusive mcpewfWrapAtEnds and mcpewfReflectAtEnds flags reflect this behavior, which is dependent on the type of ancestor McFeatures that the ProfileAncestor has. The flag will be mcpewfWrapAtEnds if the ProfileAncestor is a descendent of a McRegions object, otherwise the flag will be mcpewfReflectAtEnds in the case of a McLines ancestor. These flags cannot be changed on assignment. See MatchLength for more discussion.
The other behaviors controlled by WeightingFlags bits have to do with optional aspects of how profile amplitude variations and overall luminance are taken into account when applying the pattern match for the mcpefmMatchPattern EdgeFindingMethod. The flags that invoke these optional weightings are the mcpewfPointsForSameSize and mcpewfPointsForSameOffset flags. Both are off by default. See SizeWeighting for a discussion of the effect of these flags and how the SizeWeighting property affects their strength.
|
WeightingFlags Property
