STEPPED_ZOOM

 

Description

Send the stepped zoom command to the zoom capable camera.

The zoom control might not be easy to handle because the network latency of camera and the response of the mechanical parts in zoom lens. The stepped zoom command allows user to move the zoom lens step by step with programmable step size. That gives convenient way to control the zoom lens to view the specific details of the object in the scene.

The camera stops zooming after it moved one step zoom size by this command. It does not need to send the ZOOM=STOP command to stop zooming in camera then.

Input Argument

Direction[,StepSize]
where
Direction: the direction of the zoom command. It could be TELE or WIDE
StepSize: the zoom step size from 1 to 255. This argument is an optional argument. If it is set by this URL, the camera will use it as the new step size to move the zoom lens immediately. And this new step size will be recorded in the device configuration and be used later on. If it is not in this URL, the camera will use the previous step size to move the zoom lens.

Note :

In fisheye camera, the unit of step size is 100. The following formula is used to map this step size to ISP zoom step size.
ISP step size = (StepSize <= 10) ? 100 : (StepSize/10)*100
The camera will move to the zoom position 0 or max. zoom position depends on the Direction in this URL command if the zoom position reaches the minimum or maximum zooming range. No error message will be returned in this case.

Attribute

Return of Message

OK: STEPPED_ZOOM='echo the input arguments'
or
ERROR: STEPPED_ZOOM is write-only
or
ERROR: invalid parameters
or
ERROR: STEPPED_ZOOM not found

Applicability

Status

Valid

See Also

ZOOM, ZOOM_POSITION, ZOOM_CAP_GET

Example

http://ip:port/cgi-bin/encoder?USER=Admin&PWD=123456&STEPPED_ZOOM=TELE,5
or
http://ip:port/cgi-bin/cmd/encoder?STEPPED_ZOOM=TELE,5

Back to

HOME, ENCODER CGI