IRIS_NUMBER

 

Description

Get or Set the camera manual IRIS F-Number.

This command is only available when the IRIS of camera lens is configurable by F-Number. The IRIS F-Number with this URL is the manual IRIS F-number.
When the IRIS mode is AUTO, set the IRIS F-Number by this URL might not affect the camera exposure. User should follow camera exposure control mechanism to manage the camera IRIS.
When read, the camera IRIS F-number is returned. The return value is not the current IRIS F-Number if the IRIS mode is AUTO.

Before set the manual IRIS F-Number, user should get the IRIS capability to have the valid range of F-Number. If the F-Number is out of range, the firmware pick up smaller but the closest F-Number to set the manual IRIS F-Number.
For example, the F-Number capability in a camera is F18, F20, F24, F34, F40. When the IRIS_NUMBER=F30 was sent the camera, the firmware pick up F24 to set the manual IRIS and return
OK: IRIS_NUMBER='F24'

The error message, ERROR: IRIS_NUMBER not found" will be returned if the camera does not support this URL.

Input Argument

FNum
where
FNum: Manual IRIS F-Number.
The mapping of this argument and aperture size in lens is listed below.

FNum Aperture size in lens
F220 F22.0
F190 F19.0
F160 F16.0
F140 F14.0
F110 F11.0
F96 F9.6
F80 F8.0
F68 F6.8
F56 F5.6
F48 F4.8
F40 F4.0
F34 F3.4
F28 F2.8
F24 F2.4
F20 F2.0
F18 F1.8
F16 F1.6
F14 F1.4
F10 F1.0

Attribute

Return of Message

IRIS_NUMBER='F20'
OK: IRIS_NUMBER='F20'
or
ERROR: IRIS_NUMBER='F20' (possible reason is the first character is not 'F')

Applicability

Status

Valid

See Also

VIDEO_EXPOSURE_MODE, IRIS_CAP

Example

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

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

Back to

HOME, ENCODER CGI