User's Manual

VIVOTEK
User's Manual - 417
© 2020 VIVOTEK INC. All Right Reserved
268
PARAMETER VALUE DESCRIPTION
focus auto Auto focus.
far
Focus on further distance.
near Focus on closer distance.
focusseting sync Applies the selected focus mode in
camctrl_c<0~(n-1)>_focusmode to this preset.
fixcurrent
Applies the current focus position to this preset.
* We support this function when the version number of the PTZ control
module is
equal or greater than 5.0.0.20.
cam getsetpreset Adds a named preset at current position, and return the
preset index.
* We support this function when the version number of
the PTZ control module is equal or greater than 5.0.0.20.
Syntax: (for query API)
http://<servername>/cgi-bin/camctrl/camctrl.cgi?[<parameter>] [&<parameter>...]
Example:
http://myserver/cgi-bin/camctrl/camctrl.cgi?getpan
Response:
HTTP/1.0 200 OK\r\n
Cache-control: no-cache\r\n
Pragma: no-cache\r\n
\r\n
pan=4117\r\n
PARAMETER VALUE DESCRIPTION
getversion <string> Get the version of the PTZ control module.
getaction idle,
autopan,
tracking,
tou r,
patrol,
Get the current status of the camera.
* We support this parameter when the version number
(getversion) is equal or greater than 5.0.0.12
getpan 0, <positive integer> Get the current pan position.
*Only available when bit0 of
"capability_camctrl_c<0~(n-1)>_buildinpt" is "1"
© 2020 VIVOTEK INC. All Right Reserved
269
PARAMETER VALUE DESCRIPTION
getpanangle
<integer>
Get the current pan angle.
*Only available when bit0 of
"capability_camctrl_c<0~(n-1)>_buildinpt" is "1"
gettilt 0, <positive integer> Get the current tilt position.
*Only available when bit1 of
"capability_camctrl_c<0~(n-1)>_buildinpt" is "1"
gettiltangle
<integer>
Get the current tilt angle.
*Only available when bit1 of
"capability_camctrl_c<0~(n-1)>_buildinpt" is "1"
getzoom 0, <positive integer> Get the current zoom position.
getratio
<decimal>
Get the current zoom ratio.
getfocus 0, <positive integer> Get the current focus position.
getminspeedlv
0, <positive integer>
Get the minimum speed level of the PTZ control. Normally,
the speed level is ‘0,’ which denotes halting a continuous
movement.
getmaxptspeedlv 0, <positive integer> Get the maximum speed level of pan/tilt moving.
*Only available when
"capability_camctrl_c<0~(n-1)>_buildinpt" > 0
getmaxzspeedlv
0, <positive integer>
Get the maximum speed level of zoom moving.
getmaxfspeedlv 0, <positive integer> Get the maximum speed level of focus moving.
getminpan
0, <positive integer>
Get the lower limit for pan position.
*Only available when bit0 of
"capability_camctrl_c<0~(n-1)>_buildinpt" is "1"
getmaxpan 0, <positive integer> Get the upper limit for pan position.
*Only available when bit0 of
"capability_camctrl_c<0~(n-1)>_buildinpt" is "1"
getminpanangle
<integer>
Get the lower limit for pan angle.
*Only available when bit0 of
"capability_camctrl_c<0~(n-1)>_buildinpt" is "1"
getmaxpanangle <integer> Get the upper limit for pan angle.
*Only available when bit0 of
"capability_camctrl_c<0~(n-1)>_buildinpt" is "1"
getmintilt
0, <positive integer>
Get the lower limit for tilt position.
*Only available when bit1 of
"capability_camctrl_c<0~(n-1)>_buildinpt" is "1"
getmaxtilt 0, <positive integer> Get the upper limit for tilt position.
*Only available when bit1 of