Get info of degrees of freedom
GET http://IP-Address:port/prefix/control/telemetry/info/TELEMETRYCONTROLID - Gets info about supported controllable degrees of freedom and the ways of controlling them (continuous, relative, discrete) and their max values.
Sample response:
{
"degrees":
{
"tilt":
{
"relative": {"min": "-45", "max": "45"},
"continuous": {"min": "-10", "max": "10"}
},
"pan":
{
"absolute": {"min": "-170", "max": "170"},
"continuous": {"min": "-10", "max": "10"}
},
"zoom":
{
"absolute": {"min": "0", "max": "20"}
}
},
"feature": ["autoFocus", "areaZoom", "pointMove"]
}
degrees – information about degrees of freedom. (tilt, pan, zoom, focus, iris). Every degree of freedom contains the list of supported ways of control (absolute, relative, continuous).
feature – list of supported functions (autoFocus, autoIris, areaZoom, pointMove).
Edit tilt and pan
GET http://IP-Address:port/prefix/control/telemetry/move/TELEMETRYCONTROLID?parameters&session_id=N – changes tilt, pan.
Parameters:
mode – way of control (absolute, relative, continuous);
pan, tilt – values for corresponding degrees of freedom;
hereinafter session_id=N - session id (see Acquire telemetry control session).
Sample request: GET http://IP-Address:port/prefix/control/telemetry/move/HOSTNAME/DeviceIpint.25/TelemetryControl.0?mode=absolute&pan=-99&tilt=10&session_id=0
Edit degree of freedom
GET http://IP-Address:port/prefix/control/telemetry/{degree}/TELEMETRYCONTROLID?parameters&session_id=N – changes one of degrees (zoom, focus, iris).
Parameters:
{degree} – degree of freedom to be updated (zoom, focus, iris);
mode – way of control (absolute, relative, continuous);
value - value.
Sample request:
GET http://IP-Address:port/prefix/control/telemetry/zoom/HOSTNAME/DeviceIpint.25/TelemetryControl.0?mode=absolute&value=6&session_id=0 - zoom change;
GET http://IP-Address:port/prefix/control/telemetry/focus/HOSTNAME/DeviceIpint.25/TelemetryControl.0?mode=relative&value=3&session_id=0 - focus change;
GET http://IP-Address:port/prefix/control/telemetry/iris/HOSTNAME/DeviceIpint.25/TelemetryControl.0?mode=continuous&value=1&session_id=0 - iris change.
Capture screen point
GET http://IP-Address:port/prefix/control/telemetry/move/point/TELEMETRYCONTROLID?parameters&session_id=N – captures the screen point.
Parameter:
x,y – values of vertical and horizontal coordinates, specified in relation to image size;
Sample request: GET http://IP-Address:port/prefix/control/telemetry/move/point/HOSTNAME/DeviceIpint.23/TelemetryControl.0?x=0.14&y=0.32&session_id=0
Zoom image area
GET http://IP-Address:port/prefix/control/telemetry/zoom/area/TELEMETRYCONTROLID?parameters&session_id=0 – zooms selected image area.
Parameters:
x,y – left upper corner of selected area;
w,h – width and height of area.
Coordinates and dimensions are specified in relation to image size.
Sample request:
GET http://IP-Address:port/prefix/control/telemetry/zoom/area/HOSTNAME/DeviceIpint.24/TelemetryControl.0?x=0.23&y=0.089&w=0.25&h=0.25&session_id=0
Auto focus and iris
GET http://IP-Address:port/prefix/control/telemetry/auto/TELEMETRYCONTROLID?parameters&session_id=0 – auto focus/iris.
Parameters:
degree – is focus or iris.
Sample request:
GET http://IP-Address:port/prefix/control/telemetry/auto/HOSTNAME/DeviceIpint.24/TelemetryControl.0?degree=iris&session_id=0