The Features Menu :: Pan & Tilt

param.cgi?cmd=ptzmove

Pan, Tilt & Zoom Control

  • [left, right, down, up, focusin, focusout, zoomout, zoomin]: Pan, tilt, zoom or focus your camera - 0 continuous movement or number of steps [0-2500]
  • stop: pan&tilt, zoom&focus or both [pt, zf, all]
  • speed: Speed of the movement [0-10]
  • timeout: Move until timeout - 0 to deactivate timeout [0-60]

See also: Limitations for the extended PTZ command set:

Model
ptzmove + pan/tilt + timeout
ptzmove + zoom/focus + timeout
ptzmove + pan/tilt
ptzmove + zoom/focus
e.g. IN-8415supportednot supportedsupportednot supported
e.g. IN-9420supportedsupportedmove to hard stopsupported

Example

SET: http://admin:instar@192.168.2.168/param.cgi?cmd=ptzmove&left=0&timeout=3

cmd="ptzmove";
response="200";
SET: http://admin:instar@192.168.2.168/param.cgi?cmd=ptzmove&right=1000&down=250

cmd="ptzmove";
response="200";
SET: http://admin:instar@192.168.2.168/param.cgi?cmd=ptzmove&zoomin=20&speed=10

cmd="ptzmove";
response="200";

param.cgi?cmd=getptzstate

Get relative PTZ position

  • [pan, tilt, zoom, focus]: Position between [1-100] %. The value returned is -1 if function is not supported - e.g. zoom / focus is not supported by the model IN-8415 2K+ and pan / tilt is not supported by the model IN-9420 2K+.
  • index: If the current pan&tilt position equals a position saved with param.cgi?cmd=setptzpreset it will be returned here 1-8. If the current position is not among the saved positions a value -1 will be returned [-1, 1-8]

Example

SET: http://admin:instar@192.168.2.168/param.cgi?cmd=getptzstate

cmd="getptzstate";
pan="20";
tilt="50";
zoom="-1";
focus="-1";
index="1";
response="200";

param.cgi?cmd=gotorelposition

Pan, Tilt & Zoom Control (Relative Positions)

  • [pan, tilt, zoom, focus]: Pan, tilt, zoom or focus your camera to a relative position between [0-100] %
  • speed: Speed of the movement [0-10]

See also: Limitations for the extended PTZ command set:

Model
gotorelposition + pan/tilt
gotorelposition + zoom/focus
e.g. IN-8415supportednot supported
e.g. IN-9420not supportedsupported

Example

SET: http://admin:instar@192.168.2.168/param.cgi?cmd=gotoRelPosition&speed=10&tilt=50

cmd="gotorelposition";
response="200";
SET: http://admin:instar@192.168.2.168/param.cgi?cmd=gotoRelPosition&pan=50&tilt=0

cmd="gotorelposition";
response="200";
SET: http://admin:instar@192.168.2.168/param.cgi?cmd=gotoRelPosition&zoom=100&focus=25

cmd="gotorelposition";
response="200";

param.cgi?cmd=getptzpreset

Pan, Tilt Preset

  • act: Go to preset goto or get positions get
  • index: Preset position slot [1-8]
  • set: Is preset set to a position [0,1]
  • name: Custom position name

Example

SET: http://admin:instar@192.168.2.168/param.cgi?cmd=getptzpreset&act=goto&index=2

cmd="getptzpreset";
response="200";
SET: http://192.168.2.168/param.cgi?cmd=getptzpreset&act=get&user=admin&pwd=instar

cmd="getptzpreset";
set[1]="1";
name[1]="position name 1";
set[2]="1";
name[2]="position name 2";
set[3]="1";
name[3]="position name 3";
set[4]="1";
name[4]="position name 4";
set[5]="1";
name[5]="position name 5";
set[6]="0";
name[6]="";
set[7]="0";
name[7]="";
set[8]="0";
name[8]="";
response="200";
SET: http://192.168.2.168/param.cgi?cmd=getptzpreset&act=get&index=1&user=admin&pwd=instar

cmd="getptzpreset";
set="1";
name="12345";
response="200";

param.cgi?cmd=setptzpreset

Pan, Tilt Preset

  • act: Delete the specified preset del, save the current position to preset set or rename the specified preset rename
  • index: Preset position slot [1-8]
  • set: Is preset set to a position [0,1]
  • name: Custom position name

Example

SET: http://admin:instar@192.168.2.168/param.cgi?cmd=setptzpreset&act=set&index=2&name=position2

cmd="setptzpreset";
response="200";
SET: http://192.168.2.168/param.cgi?cmd=setptzpreset&act=del&index=8&user=admin&pwd=instar

cmd="setptzpreset";
response="200";

param.cgi?cmd=getptzattr

Park Position, Alarm Position and Home Position Parameter

  • selfdet: Activate PTZ self-calibration (Required for Preset Postions and PTZ Tour) [0,1]
  • movehome: Activate PTZ home position (go to preset position after reboot) [0,1]
  • home: Set home position [1-8]
  • alarmmask: Surpress motion detection during pan&tilt an zoom [0,1]
  • gotoalarmpos: Activate alarm position (go to preset position during alarm) [0,1]
  • alarmpos: Set alarm position [1-8]
  • speed: Speed of the movement [0-10]
  • mirror: Mirror pan&tilt movement when camera is inverted
  • flip: Flip pan&tilt movement when camera is inverted
  • autofocus: Autofocus mode 0 to deactivate the autofocus. Mode 1 only triggers the auto-focus after the mechanical lense zoom was activated. The default mode is 2 and triggers the auto-focus after every pan, tilt and zoom movement [0-2]
  • afalg: Auto-focus algorithm - 0 (default) use fast auto-focus algorithm in day mode and switch the high precision algorithm when the camera is in night mode. Use 1 to always use fast algorithm and 2 to always use the high-precision algorithm [0-2]

Example

GET: http://admin:instar@192.168.2.168/param.cgi?cmd=getptzattr

cmd="getptzattr";
selfdet="1";
movehome="0";
home="1";
alarmmask="1";
gotoalarmpos="0";
alarmpos="1";
speed="10";
mirror="0";
flip="0";
autofocus="2";
afalg="0";
response="200";
GET: http://192.168.2.168/param.cgi?cmd=getptzattr&user=admin&pwd=instar

cmd="getptzattr";
selfdet="1";
movehome="0";
home="1";
alarmmask="1";
gotoalarmpos="0";
alarmpos="1";
speed="10";
mirror="0";
flip="0";
autofocus="2";
afalg="0";
response="200";
GET: http://admin:instar@192.168.2.168/param.cgi?cmd=setptzattr&movehome=1&home=8

cmd="getptzattr";
response="200";

param.cgi?cmd=getptztimerpreset

Get Timed Preset Position Parameter

  • tp_enable: Activate PTZ park position (go to preset position after interval) [0,1]
  • tp_index: Set park position [1-8]
  • tp_interval: Set park interval in seconds [1-120]

Example

GET: http://admin:instar@192.168.2.168/param.cgi?cmd=getptztimerpreset

cmd="getptztimerpreset";
tp_enable="0";
tp_index="7";
tp_interval="50";
response="200";
GET: http://192.168.2.168/param.cgi?cmd=getptztimerpreset&user=admin&pwd=instar

cmd="getptztimerpreset";
tp_enable="0";
tp_index="7";
tp_interval="50";
response="200";
GET: http://admin:instar@192.168.2.168/param.cgi?cmd=setptztimerpreset&tp_enable=1&tp_index=8

cmd="setptztimerpreset";
response="200";

param.cgi?cmd=ptzctrl (deprecated)

Pan, Tilt & Zoom Control

  • act: Camera movement: [left, right, down, up, stop, focusin, focusout, zoomout, zoomin, tour, home, autofocus, stop, hscan, vscan]
  • step: 0 continuous movement or number of steps [0-100]
  • speed: Speed of the movement [0-10]
  • timeout: Move until timeout - 0 to deactivate timeout [0-60]

Example

SET: http://admin:instar@192.168.2.168/param.cgi?cmd=ptzctrl&step=0&act=right&speed=10&timeout=3

cmd="ptzctrl";
response="200";
SET: http://admin:instar@192.168.2.168/param.cgi?cmd=ptzctrl&act=stop

cmd="ptzctrl";
response="200";
SET: http://admin:instar@192.168.2.168/param.cgi?cmd=ptzctrl&step=100&act=up&speed=10

cmd="ptzctrl";
response="200";

param.cgi?cmd=ptzpreset (deprecated)

Pan, Tilt Preset

  • act: Go to preset goto, delete postion del, get postion information get or save current position to preset set
  • index: Preset position slot [1-8]
  • set: Is preset set to a position [0,1]
  • name: Custom position name

Example

SET: http://admin:instar@192.168.2.168/param.cgi?cmd=ptzpreset&act=goto&index=2

cmd="ptzpreset";
response="200";
SET: http://192.168.2.168/param.cgi?cmd=ptzpreset&act=set&index=8&user=admin&pwd=instar

cmd="ptzpreset";
response="200";