Thema: CGI-Parameter von image.jpg

CGI-Parameter von image.jpg

Um Live-Bilder der Kamera direkt vom integrierten Web-Server abzuholen, stehen Ihnen zwei HTTP-Befehle zur Verfügung:

http://10.x.x.x/record/current.jpg

Holt ein Bild der Kamera mit den aktuellen Bildeinstellungen. Es können keine zusätzlichen Parameter übergeben werden.
http://10.x.x.x/cgi-bin/image.jpg

Diesen Verweis können Sie mit zusätzlichen Parametern aufrufen. Beispielsweise liefert der folgende Aufruf ein Bild des rechten Kameraobjektivs in der Größe 320x240 mit der Bildqualität 60%:

http://10.x.x.x/cgi-bin/image.jpg?camera=right&size=320x240&quality=60

Die gespeicherte Konfiguration wird nicht verändert.

Hinweis:	Diese Funktionalität steht bei Basic-Kameras nicht zur Verfügung.

Parameter für image.jpg

Parameter Beschreibung

help

Gibt eine Auflistung der möglichen Parameter und Werte zurück.
Aufruf: http://10.x.x.x/cgi-bin/image.jpg?help

current

Gibt das gleiche Bild wie /record/current.jpg zurück. Alle weiteren Parameter werden ignoriert.
Aufruf: http://10.x.x.x/cgi-bin/image.jpg?current

config

Gibt ein Bild mit den aktuell gespeicherten Bildeinstellungen zurück. Zusätzlich übergebene Parameter werden berücksichtigt.

Beispiel:
http://10.x.x.x/cgi-bin/image.jpg?config&quality=40

camera

Legt die Darstellungsart fest.

Mögliche Werte sind:

right	Ruft das Bild des rechten Objektivs ab.
left	Ruft das Bild des linken Objektivs ab.
both	Ruft ein Doppelbild des rechten und linken Objektivs ab. Hinweis: Nur möglich bei Dual-Kameras.
RiL	Erzeugt ein Bild in Bild: Rechtes im Linken Bild Ein kleines Bild (160x120) des rechten Objektivs wird in der rechten unteren Ecke des vom linken Objektiv erhaltenen Bilds dargestellt. Hinweis: Nur möglich bei Dual-Kameras.
LiR	Erzeugt ein Bild in Bild: Linkes im Rechten Bild Ein kleines Bild (160x120) des linken Objektivs wird in der rechten unteren Ecke des vom rechten Objektiv erhaltenen Bilds dargestellt. Hinweis: Nur möglich bei Dual-Kameras.

Beispiel:
http://10.x.x.x/cgi-bin/image.jpg?config&camera=right

size

Steuert die Bild-Auflösung.

Mögliche Werte sind:

640x480
320x240
160x120

Beispiel:
http://10.x.x.x/cgi-bin/image.jpg?config&size=320x240

quality

Steuert die Bildqualität.

Mögliche Werte: 0..100

Beispiel:
http://10.x.x.x/cgi-bin/image.jpg?config&quality=70

error

Rückgabewert des Scripts im Fehlerfall.

Mögliche Werte sind:

empty	Es werden keine Daten zurückgegeben.
picture	Das Fehlerbild No frame available wird zurückgegeben.
content	Gibt den HTTP-Header content-type zurück.

Beispiel:
http://10.x.x.x/cgi-bin/image.jpg?error=picture

automatic

Steuert den automatischen Kontrast im Bild.

Mögliche Werte sind:

off	Automatischer Kontrast ist ausgeschaltet.
auto	Automatischer Kontrast ist eingeschaltet.

Beispiel:
http://10.x.x.x/cgi-bin/image.jpg?config&automatic=auto

brightness

Steuert die Helligkeit im Bild.

Mögliche Werte sind: -10 .. 0 .. 10
Die werksseitig empfohlene Einstellung ist 0.

Beispiel:
http://10.x.x.x/cgi-bin/image.jpg?config&brightness=0

backlight

Steuert die Gegenlichtkorrektur im Bild.

Mögliche Werte sind: -10 .. 0 .. 10
Die werksseitig empfohlene Einstellung ist 4.

Beispiel:
http://10.x.x.x/cgi-bin/image.jpg?config&backlight=4

color

Steuert die Farbsättigung im Bild.

Mögliche Werte sind: -10 .. 0 .. 10
Die werksseitig empfohlene Einstellung ist 5, -10 gibt ein Schwarzweiß-Bild zurück.

Beispiel:
http://10.x.x.x/cgi-bin/image.jpg?config&color=5

blue

Steuert den Blauanteil im Bild.

Mögliche Werte sind: -10 .. 0 .. 10
Die werksseitig empfohlene Einstellung ist 0.

Beispiel:
http://10.x.x.x/cgi-bin/image.jpg?config&blue=0

red

Steuert den Rotanteil im Bild.

Mögliche Werte sind: -10 .. 0 .. 10
Die werksseitig empfohlene Einstellung ist 0.

Beispiel:
http://10.x.x.x/cgi-bin/image.jpg?config&red=0

sharpen

Steuert die Bildschärfe.

Mögliche Werte sind: -2 .. 10
Die werksseitig empfohlene Einstellung ist 4.

Beispiel:
http://10.x.x.x/cgi-bin/image.jpg?config&sharpen=4

textdisplay

Steuert die Texteinblendung im Bild.

Mögliche Werte sind:

disable Die Texteinblendung ist deaktiviert.

enable

Die Texteinblendung ist aktiviert, in Verbindung mit dem Parameter print (siehe unten) können Sie einen Text in das Bild einblenden.

Beispiel:
http://10.x.x.x/cgi-bin/image.jpg?config &textdisplay=enable &print=Beispieltext

datetime

Blendet ausschließlich Datum und Uhrzeit, entsprechend des in Darstellungs- und Texteinstellung ausgewählten Zeitformats, in das Bild ein.

Beispiel:
http://10.x.x.x/cgi-bin/image.jpg?config &textdisplay=datetime

Blendet einen benutzerdefinierten Text oder eine Nachricht in das Bild ein.

Als Wert wird ein HTTP-konformer Text erwartet. Beispielsweise werden Leerzeichen durch die Zeichenfolge %20 dargestellt, %0A steht für einen Zeilenumbruch.

Beispiel:
http://10.x.x.x/cgi-bin/image.jpg?config &textdisplay=enable &print=Dies%20ist%20ein%0ABeispieltext

date

Blendet Datum und Uhrzeit in einem bestimmten Format ein. Das in Darstellungs- und Texteinstellung eingestellte Format wird ignoriert.

Mögliche Werte sind:

0	deaktiviert
1	Datum Zeitzone Zeit
2	Zeit
3	Zeit plus Millisekunden
4	Datum
5	Langes Datum
6	Datum Zeit plus Millisekunden
7	Zeitzone

Beispiel:
http://10.x.x.x/cgi-bin/image.jpg?config&date=1

textbgtrans

Steuert die Transparenz des Texthintergrunds.

Mögliche Werte sind: 0..100

Beispiel:
http://10.x.x.x/cgi-bin/image.jpg?config &textbgtrans=50

textbgcolor

Steuert die Hintergrundfarbe für die Texteinblendung.

Der Wert muss in Hexadezimal-Format übergeben werden.

0x000000 → schwarz
0xffffff → weiß
0xff0000 → rot
0x00ff00 → grün
0x0000ff → blau

Beispiel:
http://10.x.x.x/cgi-bin/image.jpg?config &textdisplay=enable &textbgtrans=50&textbgcolor=0x00000f

Mit Ausnahme der Parameter help und current können Sie beliebig viele Parameter in beliebiger Reihenfolge miteinander kombinieren.