Enum ObjectDetectorSearchMode
- Assembly
- VisioForge.Core.dll
Specifies the search mode for object detection algorithms. This enumeration defines how the detector scans an image or video frame for objects.
public enum ObjectDetectorSearchModeFields
Default = 0-
The entire image or video frame will be scanned for objects. This is the default and most comprehensive search mode.
Single = 1-
Only a single object will be retrieved. The search stops after the first object is found. This mode is useful for performance optimization when only the presence of an object matters.
NoOverlap = 2-
If an object has already been detected within an area, that area will not be scanned again for inner or overlapping objects. This can save computation time and prevent redundant detections.
Average = 3-
If several objects are located within one another (overlapping detections), their bounding boxes will be averaged into a single result. This helps in consolidating multiple detections of the same object.
Remarks
The choice of search mode can significantly affect the performance and the number of detected objects. For example, VisioForge.Core.Types.VideoProcessing.ObjectDetectorSearchMode.Single mode is faster if only one object is expected, while VisioForge.Core.Types.VideoProcessing.ObjectDetectorSearchMode.Default (full scan) is more comprehensive. Default mode performs comprehensive full-frame scanning, detecting all objects regardless of overlap or redundancy. Single mode stops after first detection, significantly faster when only presence/absence matters (security triggers, activation detection). NoOverlap mode skips regions already containing detections, reducing computation and preventing nested redundant detections. Average mode consolidates overlapping detections by averaging bounding boxes, useful for reducing duplicate detections of the same object. Search mode selection impacts both performance (processing time) and results (detection count and precision). Default mode is recommended for accurate counting, multi-object tracking, or comprehensive scene analysis. Single mode is optimal for wake-up systems, presence detection, or resource-constrained applications. Average mode helps with detector stability when multiple scales or positions trigger overlapping detections. These modes are particularly relevant for cascade classifiers and sliding-window detectors that may produce multiple detections per object.