SNAPSHOT

 

Description

Get a still image in JPEG format from the encoder.

With MPEG4 encoder in platform A/T/K devices, it will send the MPEG4 NOP during the snapshot to maintain constant frame rate.

If the CHANNEL=n was not set with this URL to the multiple channel video encoder the target device is the CHANNEL 1. If the CHANNEL 1 module does not available, the error message will be returned.

Here is the URL handshake of the SNAPSHOT.
The format of this URL http://172.16.3.35/cgi-bin/encoder?USER=Admin&PWD=123456&SNAPSHOT is listed below.

Stage 1: Send this URL to the device for getting a still image

ASCII FORMAT

Hex Dump Format

Stage 2 : Device reply with a JPEG image

ASCII FORMAT

Hex Dump Format

Input Argument

None
or
ImageSize
or
ImageSize,Quality
where
None : no input argument with this URL. Firmware uses channel's video resolution as the snapshot image size with default JPEG quality settings to do the snapshot.
ImageSize : set the snapshot image size. The value of ImageSize is the same as input argument of VIDEO_RESOLUTION.
Quality : the quality of the JPEG and the range is 1~100. The higher value, the higher quality.

Note in PlatformA1 cameras:

  1. The snapshot image size is fixed to be the same as the channel's video resolution.

  2. The firmware will ignore the ImageSize value in this URL.
  3. When OSG is enabled in video stream 1 or video stream 2, the firmware always use video stream1 as the snspshot source.
  4. The CHANNEL command will be ignored then.

Attribute

Return of Message

JPEG image
or
ERROR: Description of error

Applicability

Status

Valid

See Also

VIDEO_RESOLUTION

Example

http://ip:port/cgi-bin/encoder?USER=Admin&PWD=123456&SNAPSHOT
or
http://ip:port/cgi-bin/cmd/encoder?SNAPSHOT
or
http://ip:port/cgi-bin/encoder?USER=Admin&PWD=123456&SNAPSHOT=N640x480,90
or
http://ip:port/cgi-bin/cmd/encoder?SNAPSHOT=N640x480,90
or
http://ip:port/cgi-bin/encoder?USER=Admin&PWD=123456&SNAPSHOT=N640x480
or
http://ip:port/cgi-bin/cmd/encoder?SNAPSHOT=N640x480

Back to

HOME, MPEG4 CGI, ENCODER CGI