ZOOM

 

Description

This URL command is for zoom lens control.

Input Argument

STOP
or
Cmd,Speed
or
DIRECT,0xnnnn
or
DIRECT,mmmm

ZOOM=STOP will stop zooming. Important note that ZOOM=STOP should be sent to stop zooming before you sent new zooming command.

In ZOOM=Cmd,Speed command, Cmd could be
TELE for zooming in tele (out) direction.
WIDE for zooming in wide (in) direction.
Speed is in the range between 2 (slowest zooming speed) to 7 (fast zooming speed). If the camera have more levels of zoom speed, the linear scaling algorithm will be used.

ZOOM=DIRECT,0xnnnn sets the camera to the specific zoom position which it is hexadecimal value.
The range of 0xnnnn is form 0x0000 to 0xffff. The device might not have such wide range of the zoom position. However, the device will NOT validate the zoom position when it executes this command. It will reach zoom boundary if the zoom position is out of range. No error message will be returned in this case.
The zoom position in this commmand could be decimal value. The command is ZOOM=DIRECT,mmmm sets the zoom position with the absolute zoom position which it is a decimal value.
In PlaftormW speed dome, this command is not available.

In ACM-8511 PTZ camera, the zoom ratio and zoom position are mapped in the follow table. Note that the zoom positions in this table are approximate values.

Zoom Ratio Zoom Position (Hexadecimal Value)
1x 0x111
2x 0x223
3x 0x334
4x 0x446
5x 0x557
6x 0x669
7x 0x780
8x 0x892
9x 0x1003
10x 0x1115

Attribute

Return of Message

OK: echo the command
or
ERROR: invalid parameters

For example, the return message of ZOOM=TELE,5 is OK: ZOOM=TELE,5

Applicability

Status

Valid

See Also

ADDR, PTZ_VENDOR, ZOOM_POSITION, FOCUS, FOCUS_POSITION, XYZ_POS_GET

Example

http://ip:port/cgi-bin/encoder?USER=Admin&PWD=123456&ZOOM=TELE,0x5
or
http://ip:port/cgi-bin/cmd/encoder?ZOOM=TELE,0x5 or
http://ip:port/cgi-bin/cmd/encoder?ZOOM=DIRECT,0x50
or
http://ip:port/cgi-bin/cmd/encoder?ZOOM=DIRECT,80

Back to

HOME, ENCODER CGI