VIVOTEK
User's Manual - 407
Ā© 2020 VIVOTEK INC. All Right Reserved
267
function getstatus Information of motors, return value as below:
remote_focus_zoom_motor_max: Maximum steps of zoom
motor
remote_focus_focus_motor_max: Maximum steps of focus
motor
remote_focus_zoom_motor_start: Start point of zoom motor
remote_focus_zoom_motor_end: End point of zoom motor
remote_focus_focus_motor_start: Start point of effective focal
length
remote_focus_focus_motor_end: End point of effective focal
length
remote_focus_zoom_motor: Current position of zoom motor
remote_focus_focus_motor: Current position of focus motor
remote_focus_zoom_enable: Current function of zoom motor
remote_focus_focus_enable: Current function of focus motor
remote_focus_iris_open: The current status of iris. 0: irisenable,
1: irisopen
Current function of zoom/focus motor, return value as below:
0: no service
1: zooming
2. focusing
3: auto focus
4: focus scan
5: positioning (both zoom motor and focus motor)
12: reset focus
8.20 BackFocus (capability_image_c<0~(n-1)>_remotefocus=4)
Note: This request requires Administrator privileges.
Method: GET/POST
Syntax: (for control API)
http://<servername>/cgi-bin/admin/remotefocus.cgi?channel=<value>&[function=<value>][&direct
ion=<value>][&position=<value>][&steps=<value>][&iris]
PARAMETER VALUE DESCRIPTION
channel 0~"capability_nvideoin"-1
Channel of the video source.
Ā© 2020 VIVOTEK INC. All Right Reserved
268
PARAMETER VALUE DESCRIPTION
function focus,
auto,
scan,
stop,
positioning,
irisopen,
irisenable,
resetfocus
focus ā Move focus motor
auto ā Perform auto focus
scan ā Perform focus scan
stop ā Stop current operation
positioning ā Position the motors
resetfocus ā reset focus position to default
irisopen ā Fully open iris. It will maintain fully open iris
status until sending function=irisenable cgi.
irisenable ā return back to user setting status of iris.
direction direct,
forward,
backward
Motorās moving direction.
It works only if function= focus.
position <motor_start> ~
<motor_end>
Motorās position.
It works only if function=focus and direction=direct.
<motor_start> : remote_focus_zoom_motor_start or
remote_focus_focus_motor_start,
<motor_end> : remote_focus_zoom_motor_end or
remote_focus_focus_motor_end replied from
"function=getstatus"
steps 1 ~ 30 Motorās moving steps.
It works only if function=focus and direction=forward or
direction=backward.
* Motor will stop when it reaches to <motor_start> or
<motor_end>.
* This parameter is for additional fine-
tune, the value is from 1
to 30.
iris N/A Open iris or not.
It works only if function=auto or function=scan.
Syntax: (for query API)
http://<servername>/cgi-bin/admin/remotefocus.cgi?channel=<value>&[function=<value>]