CGI parameters

The CGI parameters within the camera server allow you to define special snapshot features within an embedded URL request. You generate these requests in the form of query strings appended to the URL of your camera server. You can also use the CGI parameters for simple input/output operations on the Pan/Tilt port.

Snapshot requests

For snapshot requests, use the following syntax:

http://<cameraname>/<image type>.jpg?<parameter>=<value>[&<parameter>=<value>...]

On the Settings page, you specify the default appearance of your images (compression, rotation, time stamp, etc.). By appending CGI image parameters, you override the default settings.

These CGI image parameters are available for snapshot requests:

Parameter Description

camera Specifies the camera source.
Values: [ 1 | 2 | 3 | 4 | 5 ]

compression Adjusts the image quality and file size.
Values: [ medium | high | low ]

color Selects color or grayscale image.
Values: [ normal | none ]

axislogo Shows/hides the Axis logotype.
Values: [ off | on ]

clock Shows/hides the timestamp.
Values: [ off | on ]

rotation Rotates the image.
Values: [ normal | upsidedown | 90deg | 270deg ]

mirror Mirrors the image horizontally.
Values: [ off | on ]

cropping Crops a ‘hugesize’ type image.
Parameters: top, left, width, height
Values: No. of pixels (in multiples of 8.)

move Moves the Pan/Tilt device about 5 degrees in the specified direction. *
Values: [ up | down | left | right | home ]

pan Turns the Pan/Tilt device degrees relative to the home position. *
Values: [ -180 ... 180 ]

tilt Tilts the Pan/Tilt device degrees relative to the home position. *
Values: [ -180 ... 180 ]

rpan Turns the Pan/Tilt device degrees relative to the current position. *
Values: [ -180 ... 180 ]

rtilt Tilts the Pan/Tilt device degrees relative to the current position. *
Values: [ -180 ... 180 ]

zoom Adjusts the camera zoom to the specified angle. *
Values: [ 1 ... 999 ]

presetposno Enters the preset position directly in your URL.
Values: [ 1 ... 10 ]

presetposname Enters the preset position directly in your URL.
Values: [ {name of the preset position} ]

* ) The CGI parameters that adjust the camera position are only applicable when using one of the supported Pan/Tilt devices. Refer to the Pan/Tilt documentation on how to define the camera home position.

Input/output operations

For input/output operations for the HTTP driver on the Pan/Tilt port, you use the following syntax:

http://<cameraname>/cgi-bin/control?<parameter>=<value>[&<parameter>=<value>...]

These CGI image parameters are available for input/output operations:

dataout Writes the specified data string to the Pan/Tilt serial port. Hexadecimal coded bytes. Maximum 128 bytes.
Values: {0, 1, 2, 3, 4, 5, 6, 7, 8, 9, A, B, C, D, E, F, a, b, c, d, e, f}

read Reads the specified number of bytes from the Pan/Tilt port. The returned value will be hexadecimal coded and placed between #'s, e.g. #3A#.
Values: {1 ... 128}

wait Waits the specified number of seconds before reading from the Pan/Tilt port. Used together with the "read" parameter.
Values: {1 ... 9}

flush Empties the input buffer for the Pan/Tilt port. Always performed first when combined with other parameters.
Values: {yes, no}

Note: To enable input/output operations, the Pan/Tilt device must be set to HTTP input/output on the Configuration - Pan/Tilt page.

Parameter	Description
camera	Specifies the camera source. Values: [ 1 \| 2 \| 3 \| 4 \| 5 ]
compression	Adjusts the image quality and file size. Values: [ medium \| high \| low ]
color	Selects color or grayscale image. Values: [ normal \| none ]
axislogo	Shows/hides the Axis logotype. Values: [ off \| on ]
clock	Shows/hides the timestamp. Values: [ off \| on ]
rotation	Rotates the image. Values: [ normal \| upsidedown \| 90deg \| 270deg ]
mirror	Mirrors the image horizontally. Values: [ off \| on ]
cropping	Crops a ‘hugesize’ type image. Parameters: top, left, width, height Values: No. of pixels (in multiples of 8.)
move	Moves the Pan/Tilt device about 5 degrees in the specified direction. * Values: [ up \| down \| left \| right \| home ]
pan	Turns the Pan/Tilt device degrees relative to the home position. * Values: [ -180 ... 180 ]
tilt	Tilts the Pan/Tilt device degrees relative to the home position. * Values: [ -180 ... 180 ]
rpan	Turns the Pan/Tilt device degrees relative to the current position. * Values: [ -180 ... 180 ]
rtilt	Tilts the Pan/Tilt device degrees relative to the current position. * Values: [ -180 ... 180 ]
zoom	Adjusts the camera zoom to the specified angle. * Values: [ 1 ... 999 ]
presetposno	Enters the preset position directly in your URL. Values: [ 1 ... 10 ]
presetposname	Enters the preset position directly in your URL. Values: [ {name of the preset position} ]

dataout	Writes the specified data string to the Pan/Tilt serial port. Hexadecimal coded bytes. Maximum 128 bytes. Values: {0, 1, 2, 3, 4, 5, 6, 7, 8, 9, A, B, C, D, E, F, a, b, c, d, e, f}
read	Reads the specified number of bytes from the Pan/Tilt port. The returned value will be hexadecimal coded and placed between #'s, e.g. #3A#. Values: {1 ... 128}
wait	Waits the specified number of seconds before reading from the Pan/Tilt port. Used together with the "read" parameter. Values: {1 ... 9}
flush	Empties the input buffer for the Pan/Tilt port. Always performed first when combined with other parameters. Values: {yes, no}