SightLine Applications Command, Control, and Script API
v3.5
|
Deprecated, use SLALensParameters_t Set the current parameters for controlling the lens/focus.
A set of known lenses or cameras with integrated lenses for which command and control has been implemented. Assumes the lens is connected to a known serial port (e.g. Tamron SC001 is connected to Serial 1 on 1500-OEM), but can be overridden using the comPortNum parameter. This serial port will be automatically configured to the correct baud rate, etc. Command passthrough and similar commands will not be available. Corresponding serial port must be set to Port not used via SLASetPortConfiguration_t.
Start by moving the focus to the far focus limit. Scan the full range to the near focus limit. Look for the peak focus metric over the entire range. This method may be problematic due to defocused imagery at the limits of the focus travel being noisy. Depending on the focus metric chosen, this noise can produce high metric values.
Searches near current focus. Start by moving the focus in the far direction until the focus metric changes more than the value set in autofocusChangePct.
Set the focus metric algorithm using SLASetSystemValue_t. Focus metrics are reported using SLAFocusStats_t.
Message ID 0x6E
Byte Offset | Name | Description | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
4 | lensType |
| ||||||||||||||||||
5 | afMetricRegionSize | Deprecated, use Roi controls below. AutoFocus Metric Region Size % of screen (0 to 100) | ||||||||||||||||||
6 | zoomTrackFocus | Zoom Track Focus (0= disabled, 1= enabled). Stops when focus metric reaches peak threshold. | ||||||||||||||||||
7 | autofocusMethod | Autofocus method (0=scan far to near, 1=seek, 128 and above reserved for customer use) | ||||||||||||||||||
8-9 | autofocusRateAdjust | Autofocus Rate Adjust (0 to 65535) 100 = default speed of motion | ||||||||||||||||||
10 | autofocusChangePct | Autofocus Change Percent (0 to 255) in 1/10ths of a percent. 40 (default) = 4% When using Seek in AutoFocus Method, this value (0 to 100) is the percentage of change in the focus metric that is considered significant enough to indicate that the focus metric is going in the right (or wrong) direction. | ||||||||||||||||||
11 | zoomSpeed | Zoom speed (1-255 with 0 being the default) | ||||||||||||||||||
12 | focusSpeed | Focus speed (1-255 with 0 being the default) | ||||||||||||||||||
13 | comPortNum | Serial port number for lens control see SLASetPortConfiguration_t | ||||||||||||||||||
14 | colRoiFrac | Row ROI for focus stats. Row Offset in % of image width (255=100%); Full image(default) = 0 | ||||||||||||||||||
15 | rowRoiFrac | Col ROI for focus stats. Column Offset in % of image height (255=100%); Full image(default) = 0 | ||||||||||||||||||
16 | wideRoiFrac | High ROI for focus stats. Height in % of image height (255=100%); Full image(default) = 255 | ||||||||||||||||||
17 | highRoiFrac | Wide ROI for focus stats. Width in % of image width (255=100%); Full image(default) = 255 |