FOCUS

 

Description

Perform the focus function. The available focus commands depend on the camera types. The input argument section gives the dependency of the focus commands and the camera types.

If the CHANNEL=n was not set with this URL to the multiple channel video encoders, the error message will be returned.

Input Argument

None

Cmd,Position

The Cmd is the focus command.
The Position is the focus position and used only when the Cmd is DIRECT.
The following table lists the available focus commands by this URL.

Cmd Position Description
STOP
None
stop the focus action
FAR
None
move the focus to the far end. If there is no STOP command to the camera, the focus will be move to the farthest position.
NEAR
None
move the focus to the near end. If there is no STOP command to the camera, the focus will be move to the nearest position.
AUTO
None
set the focus mode to auto mode. The camera will adjust the focus all the time.
MANUAL
None
set the focus mode to manual mode. The focus position will be fixed at the specific position set by users.
ZOOM_AF
None
set the focus mode to the ZOOM+AF mode. In this mode, the camera will not adjust the focus unless the zoom position was changed.
New function for PlatformK camera
REFOCUS
None
trigger the camera to do the auto focus again when the focus mode is ZOOM_AF. This command will NOT affect the focus mode.
New function for PlatformK camera
SWITCH
None
switch the focus mode between AUTO and MANUAL. The focus mode will be changed to other mode as this command is entered.
DIRECT
focus position
Move the focus to the specific position. This command is valid only when the focus mode is MANUAL.

Attribute

Return of Message

FOCUS='AUTO'

The possible of focus mode in the return message is AUTO, MANUAL or ZOOM_AF.

FOCUS='echo the input arguments'
or
ERROR: invalid parameters
or
ERROR: internal error.

Applicability

Status

Valid

See Also

ADDR, PTZ_VENDOR, ZOOM, ZOOM_POSITION, FOCUS_POSITION

Example

http://ip:port/cgi-bin/encoder?USER=Admin&PWD=123456&FOCUS
or
http://ip:port/cgi-bin/cmd/encoder?FOCUS

http://ip:port/cgi-bin/encoder?USER=Admin&PWD=123456&FOCUS=FAR
or
http://ip:port/cgi-bin/cmd/encoder?FOCUS=FAR

Back to

HOME, ENCODER CGI