mcAutoTraceTraceControl Enumeration |
|
Legal values for the McAutoTrace.TraceControl property and the ResultsControl
argument for the McAutoTrace.GetTraceResults method.
Namespace: MediaCy.IQL.Display.Overlays
Assembly: MediaCy.IQL.Display.Overlays (in MediaCy.IQL.Display.Overlays.dll) Version: 10.0.6912.0
SyntaxVB
Public Enumeration mcAutoTraceTraceControl
Members| Member name | Value | Description | |
|---|---|---|---|
| mcatctNoFlags | 0 | no flags | |
| mcatctEnableTrace | 1 | Clear this bit to disabletracing (it is set by default). The caller is responsible for checking this bit to see if tracing is disabled; it has no effect on the functionality of the McAutoTrace object | |
| mcatctTrimLeadingResultPoints | 2 | If this bit is set in theTraceControl property and also in the ResultsControl argument to a GetTraceResults method call, and the trace termination state is mcattsTerminatedNearStart, then any points in the Results before the intersection point are removed in the results points. | |
| mcatctSmoothTracedResultPoints | 4 | If this bit is set in theTraceControl property and also in the ResultsControl argument to a GetTraceResults method call, then Results points are smoothed based on the ResultsSmoothing parameter. Only traced points are smoothed; base points are not. However, if the mcatctConstantAreaResultPolygon bit is set, then all points, including the base points are scaled to maintain a constant area across the smoothing. | |
| mcatctConstantAreaResultPolygon | 8 | If this bit is set in theTraceControl property and also in the ResultsControl argument to a GetTraceResults method call, and the mcatctSmoothTracedPoints bit is also set, then the Results (both base and traced points) are assumed to be a closed polygon so total polygon area is maintained constant when smoothing the results. The scaling to maintain constant area across the smoothing will affect the base points as well as the traced points. | |
| mcatctIntegralResultPoints | 16 | If this bit is set in theTraceControl property and also in the ResultsControl argument to a GetTraceResults method call, then only integral Result points are returned. Traced points are inherently integral, but smoothing may result in non-integral traced points. Base points are also rounded to the nearest integral point if this bit is set. | |
| mcatctCompressResultPoints | 32 | If this bit is set in theTraceControl property and also in the ResultsControl argument to a GetTraceResults method call, then horizontal, vertical and repeating ramps in the Result points removed. | |
| mcatctAutoStartTrace | 256 | If this bit is set, then the caller isexpected to start tracing with a simple click rather than a Ctrl-click. This bit is actually ignored by the McAutoTrace object; it is to be used by the caller. | |
| mcatctAutoClosePolygon | 512 | If this bit is set, then the caller isexpected to complete polygon creation whenever the trace returns to its starting point or intersects the boundary. This bit is actually ignored by the McAutoTrace object; it is to be used by the caller. | |
| mcatctAutoScaling | 1024 | If this bit is set, then the caller isexpected to assign values to McAutoTrace.SizeRatio that are appropriately scaled for the magnification of the view on which the tool is being run. SizeRatio values are always one or greater and represent the degree of subsampling to perform before starting the trace; setting this value to other than 1 makes sense only when views are zoomed out substantially (Magnification < 0.5). This bit is actually ignored by the McAutoTrace object; it is to be used by the caller. | |
| mcatctHonorAoiBounds | 4096 | If this bit is set, andTraceBounds is set to the default (Empty, Missing, or left >= right), then the bounds for tracing will be taken from the bounds of the TracedImage.Aoi. If this bit is set, whether the TraceBounds is the default or not, the trace will not be allowed to cross out of any irregularly shaped Aoi. If the bit is clear (the default) then the default TraceBounds are the bounds of the TracedImage and the Aoi is ignored when doing bounds testing.. | |
| mcatctUseRangeMinMaxForDefaultEdgeRange | 8192 | If this bit is set, andEdgeLuminanceRange is set to the default (Empty, Missing, or start >= end), then the 100% luminance range for edge thresholds will be taken from the TracedImage.RangeMin and RangeMax properties. If the bit is clear (the default) then the default EdgeLuminanceRange is taken from the TracedImage.LookupTable.BlackLevel and WhiteLevel properties. | |
| mcatctMonochromeInterpretation | 16384 | If this bit is set thenluminance data is cast to monochrome grayscale for gradient computations. If the bit is clear (the default), then for color TracedImage.Type, the sign and strengths of each color channel's luminance gradients are used for determining edge quality. The default will work well for traces drawn either clockwise or counter-clockwise if the interior and background colors are uniform, even though the interior and background luminances may be similar. Use the mcatctClockwiseInterpretation if the background color varies. | |
| mcatctClockwiseInterpretation | 32768 | This bit has any effectonly if the mcatctMonochromeInterpretation bit is clear (that is it affects only color gradient computations). If this bit is set then it is assumed that the state traces are started in a clockwise direction, so that an "interior" color can be assumed and deviations from this color can be used for detecting the edge to be traced. The assumption of an interior color is necessary if the background color varies substantially. For example, when tracing a Red-Green boundary the magnitude of color transitions are the same at a juncture that has a Red-Yellow boundary going one way and a Green-Yellow one the other way. Without assuming which color (Red or Green) is the interior color, there is no way to decide which way to turn at this juncture. | |
| mcatctInterrupt | 1048577 | Assign this with mcatctNoFlags Mask tointerrupt tracing (if the TraceState is mcattsTracing) and place it in the mcattsStepTerminated state with the mcattsTerminatedInterrupt termination condition set. | |
| mcatctShutdown | 1048578 | Assign this with mcatctNoFlags Mask toshut-down tracing and free all resources. |
RemarksOnly the mcatctTrimLeadingResultPoints, mcatctSmoothTracedResultPoints,
mcatctConstantAreaResultPolygon, mcatctIntegralResultPoints and
mcatctCompressResultPoints are legal for the ResultsControl argument for the
McAutoTrace.GetTraceResults method.
See Also