To retrieve images of the camera directly from the integrated web server, you can use one of the following HTTP commands:
http://192.168.178.67/record/current.jpg
Retrieves a camera image according to the current image settings. You cannot specify any additional parameters.
http://192.168.178.67/cgi-bin/image.jpg
Retrieves a camera image using additional image parameters. For example, the following command will display an image from the right camera lens, size 320x240 mm with an image quality of 60%:
http://192.168.178.67/cgi-bin/image.jpg?camera=right&size=320x240&quality=60
The saved configuration is not changed.
Appending ?help to the end of the command will display the corresponding help page:
http://192.168.178.67/cgi-bin/image.jpg?help
See Parameters for image.jpg for additional information.
http://192.168.178.67/cgi-bin/faststream.jpg
Retrieves the live stream from the camera using additional image parameters. For example, the following command will show the live stream as MxPEG from the camera in a generated HTML page:
http://192.168.178.67/cgi-bin/faststream.jpg?stream=MxPEG&html
Appending ?help to the end of the command will display the corresponding help page:
http://192.168.178.67/cgi-bin/faststream.jpg?help
See Parameters for faststream.jpg for additional information.
http://192.168.178.67/control/event.jpg
Provides access the camera's events and allows adding additional parameters. The following request, for example, delivers the last event image of the camera:
http://192.168.178.67/control/event.jpg?event=head
Appending ?help to the end of the command will display the corresponding help page: http://192.168.178.67/control/event.jpg?help
See Parameters for event.jpg for additional information.
Notes:
| Parameter=Default | Values | Explanation |
|---|---|---|
| help | Help This overview. |
|
| current | Current Live Image Output image from /record/current.jpg All other parameters are ignored. |
|
| config | Current Configuration Output image with parameters from current configuration file Other parameters will overwrite them. |
|
| fip=10.0.0.0 | Escaped string | Factory IP Will only deliver an image if the camera has this factory IP address. |
| error=picture | picture empty content current |
Error Handling Sets the error handling options in case no image is available: picture: returns the "No frame available!" image empty: returns nothing content: returns only the content type current: returns the current.jpg image |
| imgprof= | Escaped string | Image Profile Load parameters from this image profile. At first, the current configuration is read and will be overritten by image profile settings. |
| Image Parameter | ||
| camera=live | right left both pip RiL LiR live |
Camera Selection Camera lens used for JPEG conversion. Note: A Day&Night camera always shows the appropriate image sensor depending on the current illumination. |
| size=640x480 | 1280x960 640x480 320x240 160x120 640x240 |
Image Size Resolution of converted JPEG. |
| automatic=auto | off auto day night inactiv autoonly |
Automatic Image Improvement Set the image improvement mode: off/inactive: contrast will not be improved auto/day/autoonly: normal auto contrast night: auto contrast with more clipping |
| brightness=0 | -10..10 | Brightness |
| backlight=4 | -10..10 | Backlight Correction Increases brightness of darker points in the image. |
| color=0 | -10..10 | Color Saturation -10 will output B&W image. |
| blue=0 | -20..20 | Color Balance for Blue Adjust blue balance. |
| red=0 | -20..20 | Color Balance for Red Adjust red balance. |
| sharpen=4 | -2..20 | Sharpen Negative values wil blur the image. |
| quality=80 | 1..100 | JPEG Quality |
| textdisplay=enable | disable enable datetime |
Text Display Enable or disable text display: datetime displays date & time only. |
| textbgopacity=0 | 0..100 | Text Background Opacity Opacity of the background color in percent. |
| textbgcolor=0x000000 | Escaped string | Text Background Color Enter hex color: 0xRRGGBB Default black=0x000000 |
| stitchmode=left_top | off left surround left_top |
Cover Borders Covers the borders of dual images (RiL, LiR, Both) with bars. |
| date=0 | 0..7 | Insert Date & Time 0 = off 1 = Date, time zone, time 2 = Time 3 = Time, milliseconds 4 = Date 5 = Long date 6 = Date, time & milliseconds 7 = Time zone |
| print= | Escaped string | Customized Message The message text follow CGI syntax rules: '%0A' for return, '+' for space and so on. |
| mirror=no | no vertical horizontal both |
Mirror |
| rotate=0 | 0..360 | Rotate Currently only 0° and 180° available. |
| darknoisesuppress=medium | off medium high |
Noise Suppress Specify the noise suppress mode. |
| showlogo= | MXLOGO-320 MXLOGO-640 MXLOGO-1280 MXLOGO-VGA2 |
Image Link Logo Logo profile for image. Repeat parameter to display more logos at once. |
Except for the help and current parameters, you can combine any number of parameters in any order.
| Parameter=Default | Values | Explanation |
|---|---|---|
| help | Help This overview. |
|
| stream=full | full MxPEG mxg |
Stream Type Image data in stream: full: full JPEG images MxPEG: MOBOTIX optimized JPEG mxg: MxPEG Clipfile; not server push |
| needlength | Need Content-Length Send HTTP content-length for every frame in server push stream. Note: This option is not useful for browsers. |
|
| jpheaderupdate=0 | 0..1000 | Frames between tables refreshs Table refresh count. 0: off, 1: every frame, 2: every second frame, ... |
| jpheaderrefresh=10 | 0..60 | Seconds between table refreshs Table refresh time. 0: off, 1: every second, 2: every second second, ... |
| fps=1 | Escaped string | Frames per Second Frame rate of streamed images: e.g. '3.0' streaming with 3 frames per second. Set to 0 for maximum rate. |
| framecount=0 | 0.. | Frame Counter Amount of images delivered before stream stops (0=infinite). |
| fip=10.0.0.0 | Escaped string | Factory IP Will only deliver an image if the camera has this factory IP address. |
| error=picture | picture empty content current |
Error Handling Sets the error handling options in case no image is available: picture: returns the "No frame available!" image empty: returns nothing content: returns only the content type current: returns the current.jpg image |
| html | HTML Page With Stream Output HTML page including stream. |
| Parameter=Default | Values | Explanation |
|---|---|---|
| help | Help This overview. |
|
| sequence=head | Escaped string | Sequence Number Accepted values are 0..999999: Number of Sequence head: last sequence tail: oldest sequence in buffer |
| offset=0 | -999999..999999 | Sequence Offset Set an offset to the sequence number. |
| eno=0 | -1..99999 | Event Offset Set an offset to the event number. Accepted values are -1: last event found in sequence 0 = E00000.jpg 1 = E00001.jpg 2 = E00002.jpg ... |
| story=0 | -99999..99999 | Story Offset View an image or clip file out of the story: -3 = A00001.jpg -2 = A00002.jpg -1 = A00003.jpg 0 = E00000.jpg 1 = P00001.jpg, M00001.jpg or C00001.jpg 2 = P00002.jpg or M00002.jpg 3 = P00003.jpg or M00003.jpg ... |
| direct=0 | -99999..99999 | Direct Story Offset Directly load the story image or clip file without retrieving a story size: -1 = A00001.jpg -2 = A00002.jpg -3 = A00003.jpg 0 = E00000.jpg Same procedure as Story Offset on post alarm files. |
| source=auto | auto intern extern |
Image Storage Source Select the image storage: auto: perfer external, but use intern on fail intern: use the internal event buffer extern: use the external storage |
| fip=10.0.0.0 | Escaped string | Factory IP Will only deliver an image if the camera has this factory IP address. |
| error=picture | picture empty content current |
Error Handling Sets the error handling options in case no image is available: picture: returns the "No frame available!" image empty: returns nothing content: returns only the content type current: returns the current.jpg image |
| output=jpeg | jpeg m1img evtinfo evtinfo_d mxg |
Output Format Output format of event JPEG: m1img: print JPEG comment M1IMG evtinfo: print event information: e.g. recoding mode, story count and event number evtinfo_d: print normal and detailed event information: e.g. story size, frame number and time stamp mxg: entire event story in one clip file. |
| event= | Escaped string | Event Number This Parameter is obsolete! Use the sequence argument instead. Accepted values are 0..999999: Number of Event head: last event tail: oldest event in buffer |
