VIVOTEK
User's Manual - 377
© 2022 VIVOTEK INC. All Right Reserved
238
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>][&direction=<value>][&position=
<value>][&steps=<value>][&iris]
PARAMETER VALUE
DESCRIPTION
channel
0~"capability_nvideoin"-1 Channel of the video source.
© 2022 VIVOTEK INC. All Right Reserved
239
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>]