Object Tracker Element

Modified on 2018/08/29 03:54 by Administrator — Categorized as: Elements, Object Tracking

Summary

Element Icon Object Tracker
Info
Category: Object Tracking AddIn: Object Tracking
Creator: OkazoLab Scope: Parent event
Owns Snippets: None Usage: Stimulus screen

Properties

NameDescription                              ConstraintsTypeOn
runtime
change
Settings
Detection Pace        Defines the minimal pace (in ms) of the auto-detection passes in response to visual changes in the parent event. If the visual changes are frequent, e.g. due to playing movie, the pace should not be less than the detection processing time.                Double         
Downscale Ratio        Defines the percentage of image downscaling, which is applied on before object detection. Smaller ratio leads to faster processing time in an exchange for worse positional accuracy.                Double         
Confidence Threshold        Defines the confidence threshold that marks the successful object detection. If the detection results in lower confidence, the detected size and position are rest to zeros                Double         
Scale Adaptation        Defines whether adaptation to target's size changes is included into the object detection process. If true, the object detection also checks the zoomed-in and zoomed-out versions of the target object for a better match. If a change in the target size is detected, the element's frame size is adjusted too. Enabling the scale adaptation increase the processing time by 3 times.                Boolean         
Scale Adaptation Step        Defines the percentage difference for the zoomed-in and zoomed-out versions of the target object. The zoomed versions are utilized when the scale adaptation is enabled.                Double         
Grab Object Now        Represents the command that grabs the target for object detection. The target object is extracted from the event surface, as an area below the current element's viewport                Boolean         
Border Visible        Defines whether a border is shown around the element's viewport at runtime                Boolean         
Runtime Status
Current Scale        Returns the last detected scale of the target object.                Double         
Detection Confidence        Returns the confidence score (%) of the last detection pass.                Double         
Processing Time        Returns the time spend by the last detection pass.                clTime         
Detection
Test Detection Now        Runs an emulation of the detection pass on the current event surface.                Boolean         
Trajectory Control
Reset Trajectory Now                        Boolean         
Save Trajectory Now        Assign a filename to save the object trajectory recorded at runtime                String         
Preview Trajectory                        Boolean         
Export To Library                        Boolean         
Visual Appearance
Alpha Masking        Defines, whether the visual content is used to create an opacity mask on the event surface. If masking is on, the content's pixel luminance (or, its inverse) defines transparency within element's viewport. The alpha masking allows, for example, create transparent holes on the event surface.                Int32         
AntiAliasing        if true, the rendered content will be antialiased for smoother visual appeariance. If false, rendering will be authentic to its source, e.g. a bitmap.                Boolean         
Position        Defines a position of the rendering viewport on the screen                clPoint         
Size        Defines a size of the element's rendering viewport on the screen                clSize         
Z Order        Indicates Z Order of the element on the given event                Int32         
Pivot Point        Defines alignment of the pivot point (or, element's position) relative to element's rendering area. The pivot point sets the center of element's rotation and scale directions.                stAlig..         
Visible        Defines whether the element is visible                Boolean         
Effects
Transparent Color        The color of the original pixels of rendered content that will be set as transparent                stColor         
Transparent Tolerance        Tolerance ratio for choosing colors that become transparent. Zero means that effect is not applied, 1 denotes that all colors will become trasparent                Int32         
Color Mask        Produces a multiplicative combination of the original pixels and the selected mask color (except the alpha channel).  The effect emulates a look through a colored glass.  White or transparent mask color dont change the original pixels                stColor         
Opacity        Opacity of the rendered content                Int32         
Contrast        Contrast of the rendered content                Int32         
Brightness        Brightness the rendered content                Int32         
Saturation        Saturation of the rendered content                Double         
Pixelation        Pixelation of the rendered content                Int32         
Blurring        The radius used in the gaussian blur of rendered content, as a pixel-based factor. The default is 0 which means no blurring.                Int32         
Scrambling                        Double         
Scrambling Grid Size        Defines a size of the scrambling grid                clSize         
Positional Jitter
Reset Jitter Now        Runtime command that resets the positional jitter.                Boolean         
Current Jitter        Returns the current jitter                clPoint         
Jitter Range        Defines a possible range for the random jitter. The range is centered to the position of the element.                clSize         
Control
Is Enabled        If set to false the element is completely omitted when the experiment is run                Boolean         
Title        Title of the element                String         

Object Tracker Element performs automatic tracking of selected visual object on the event surface. The tracking process returns the object position and size over time. The results can be used in runtime, e.g. to move the ROI area, or recorded as a time-line trajectory.