i-Catcher Console 3.0 HTTP SDK

Contents

Live views

JPEG images

/image.jpg

ParameterValueDescription
feedfeedidThe name or ID of the requested feed
width/height...Width and Height of the image
quality1 to 100JPEG quality level
factor-3 to 3Scaling factor of the image (current size x 2 ^ factor)
scale...Scaling factor of the image (current size x scale)

Motion JPEG video

/video.mjpg

ParameterValueDescription
feedfeedidThe name or ID of the requested feed
width/height...Width and Height of the image stream
quality1 to 100JPEG quality level
noupsample0 or 1If this is set to 1, then i-Catcher will not increase the size of the frame beyond its native size.

/setstreamparams.cgi

ParameterValueDescription
idstreamidThe ID of the Motion JPEG stream to change
width/height...New Width and Height of the image stream
quality1 to 100New JPEG quality level
noupsample0 or 1If this is set to 1, then i-Catcher will not increase the size of the frame beyond its native size.
slot1 to slotNfeedidAllows i-Catcher to send multiple feeds out on a single Motion JPEG stream. Any unspecified or empty slots will be deleted and you MUST specify slot1 otherwise it will ignore the rest.
doubleslot1 or 16Any image sent out on this slot will be doubled in size relative to to width/height and subject to the noupsample parameter.

Live view page

/ and /index.htm

ParameterValueDescription
feedfeedidThe name or ID of the requested feed
mode0 (MJPEG Java applet)
1 (JavaScript)
Mode used to view the live stream from the Console.
If the web browser won't display Java applets, this is forced to JavaScript mode.
quality0 (Highest)
to
4 (Lowest)
The image quality to view. The lower the quality, the less bandwidth will be used.

/simple.htm

ParameterValueDescription
feedfeedidThe name or ID of the requested feed
mode0 (MJPEG Java applet)
1 (JavaScript)
Mode used to view the live stream from the Console.
If the web browser won't display Java applets, this is forced to JavaScript mode.
quality0 (Highest)
to
4 (Lowest)
The image quality to view. The lower the quality, the less bandwidth will be used.

This page is designed to be embedded in an IFrame with code similar to the following:
<iframe name="live" src="http://ip.ad.dre.ss/simple.htm?feed=local" width="320" height="240" frameborder="0" scrolling="no"></iframe>
The scrolling is disabled as IE adds a 4 pixel margin at the bottom of the page. The view will resize to fit the entire iframe and the borders are included in the size if they are visible.

Feed lists

/feedlist.xml, /feedlist.js, and feedlist.txt

These three URLs will return a list of feeds that the user has permission to see, and depending on the parameters, include stopped feeds.
The XML list includes feed ID and associated name, and the JavaScript file includes JS arrays of IDs, names, and PTZ capabilities. Use of feedlist.txt is deprecated and for backwards compatibility only.

ParameterValueDescription
showstoppedIf this parameter is included, all stopped feeds will be shown in the list

Playback

Playback page

/playback/ and /playback/index.htm

ParameterValueDescription
feedfeedidThe name or ID of the requested feed
datedateDate for the requested playback session
year/month/day...The individual year, month, and day for the requested playback session
timetimeTime for the requested playback session
hour/minute...The individual hour, and minute for the requested playback session
mode0 (MJPEG Java applet)
1 (JavaScript)
Mode used to view/control the playback stream from the Console.
If the web browser won't display Java applets, this is forced to JavaScript mode.

PTZ

PTZ control page

/ptz/control.htm

ParameterValueDescription
feedfeedidThe ID of the requested feed
moveup
upleft
upright
down
downleft
downright
left
right
home (Preset home position)
to (Specified position)
Command to carry out
angle...Angle to move in degrees. The direction is specified in the move parameter.
If this is omitted, it defaults to 5 degrees.
pan/tilt...The pan/tilt position in degrees from the centre. Negative values are down and left
zoomin
out
to
Zoom operation to carry out
level...The magnification level to zoom to. A value of 0 is wide angle, 1 shows half the image, etc...
returnstatus
nocontent
Specifies what data to return after the operation. "nocontent" allows you to link direct to it and the browser not go to a new page. Defaults to returning the status.

Last updated 03/01/2007 by Dean Earley. © 2007 iCode Systems Ltd.