Http commands, Iviewhd userʼs manual – NetMedia iViewHD-2M User Manual
Page 37
HTTP Commands
iViewHD accepts HTTP commands that may be used with NVR software to control the operation of
the camera. These commands are case sensitive and must be issued in the proper case or else they
will not be understood. The general form of the HTTP commands is
http://
IP-Address
/image.cgi?CAPTURE=
YES/NO
&STREAM=
0/1
&COMMAND=
commands
Where
• IP-Address is the IP-Address of the camera. If you have Bonjour installed on your NVR or the
computer issuing the commands, you can use the cameraʼs Bonjour name here.
• YES/NO is either the word YES or NO and is used to indicate if an image is to be CAPTURED
after the commands that follow are processed. Usually you set this to YES to begin capturing
video or still pictures. You would set this to NO if you just want to change some camera parame-
ter without receiving an image. This is useful if you are changing parameters while another com-
puter is capturing images.
• 0/1 is either the number 0 or 1 and indicates if images are to be streamed or not. A 0 means that
only a single JPEG image is to be returned, while a 1 means that multiple JPEG (MJPEG) im-
ages are to be returned/streamed.
• commands is a list of commands separated by commas described below. The COMMAND= pa-
rameter should always be present even if there are no commands included afterwards.
Some example HTTP commands are
http://iViewHD-Camera-2M-470040/image.cgi?CAPTURE=YES&STREAM=1&COMMAND=
Returns a stream of MJPEG images using the camera parameters that are currently set in the cam-
era at IP address iViewHD-Camera-2M-470040.
http://192.168.1.140/image.cgi?CAPTURE=YES&STREAM=1&COMMAND=
Same as previous example, but camera images come from IP address 192.168.1.140.
http://192.168.1.140/image.cgi?CAPTURE=YES&STREAM=0&COMMAND=
A single JPEG image is returned from IP address 192.168.1.140 using the cameras current parame-
ters.
As a convention we will be omitting the
http://IP-Address/ portion in some of the examples below
Commands that can follow the COMMAND= option are also case sensitive and are separated by
commas. The commands are
• COMP: 0..45 Compression level (Default 11)
• 0 is lowest compression (best image quality) - large file size
• 45 is highest compression (worst image quality) - small file size
• EFFECT: 0..8 Special effect (Default 0)
• 0 - Normal
• 1 - Negative
• 2 - Gray
• 3 - Bluish
• 4 - Greenish
• 5 - Reddish
• 6 - Sepia
iViewHD Userʼs Manual
© 2009 NetMedia, Inc. 37