Protocol: Exposure - jdeananderson/Lumens-IP-Camera-Control GitHub Wiki
Camera exposure controls how light reaches the camera sensor. There are 5 exposure modes, that use various parameters.
Exposure is controlled by one of 5 modes as seen in the table below. Each mode is controlled by parameters as seen in two tables below.
| Function | Command | Variable | Values | Comments |
|---|---|---|---|---|
| Exposure mode | http://[camera ip]/vb.htm?exposuremodeindex=[mode]&_=[UTS] | [camera ip] | Camera’s current ip | |
| [UTS] | Current Unix time stamp | |||
| [mode] | 0 | Full Auto | ||
| 1 | Shutter Priority | |||
| 2 | Iris Priority | |||
| 3 | Manual | |||
| 4 | White Board | |||
| 5 | Smooth Auto |
- Ini.htm: exposuremodename=Full Auto;Shutter Pri;Iris Pri;Manual;White Board;Smooth Auto
| Exposure mode | Parameters used | Mode Description |
|---|---|---|
| Full Auto | Exposure compensation and Wide dynamic range | Automatic exposure, but user can customize image using exposure compensation and WDR. |
| Shutter Priority | Exposure compensation, Wide dynamic range and Shutter speed | User sets a shutter speed and remaining parameters are chosen for optimal exposure. User can customize image using exposure compensation and WDR. |
| Iris Priority | Exposure compensation, Iris Priority, and Wide dynamic range | User sets iris opening and remaining parameters are chosen for optimal exposure User can customize image using exposure compensation and WDR. |
| Manual | Gain, Iris, Wide dynamic range and Shutter Speed | User has complete manual control of exposure. |
| White Board | None | Settings optimized for an instructor in front of a white board. |
| Smooth Auto | None |
Allows user control to brighten and darken an image while using one of the various automatic exposure control modes.
| Function | Command | Variable | Values | Comments |
|---|---|---|---|---|
| Exposure Compensation | http://[camera ip]/vb.htm?exposurelevelname=[level]&_=[UTS] | [camera ip] | Camera’s current ip | |
| [UTS] | Current Unix time stamp | |||
| [level] | -6 | Lowest compensation level (darkest) | ||
| .. | Levels range from -6 to 5 | |||
| 5 | Highest compensation level (brightest) |
Combines multiple frames of video to try and compensate for areas of overexposure and areas of underexposure in the picture.
| Function | Command | Variable | Values | Comments |
|---|---|---|---|---|
| Wide dynamic range (WDR) | http://[camera ip]/vb.htm?wdridx=[setting]&_=[UTS] | [camera ip] | Camera’s current ip | |
| [UTS] | Current Unix time stamp | |||
| [setting] | 0 | WDR off | ||
| ... | Values range from 0 through 5 | |||
| 5 | Maximum compensation for high contrast lighting conditions. |
Manually set shutter speed, all other exposure settings are automatic. User can also set exposure compensation and WDR
| Function | Command | Variable | Values | Comments |
|---|---|---|---|---|
| Shutter Priority Speed | http://[camera ip]/vb.htm?shutterpriidx=[speed]&_=[UTS] | [camera ip] | Camera’s current ip | |
| [UTS] | Current Unix time stamp | |||
| [speed] | 0 | Fastest shutter speed of 1/10000 | ||
| ... | Shutter speeds range from 0 to 21. Numbers 0-21 map to speeds returned by shutterpriname in ini.htm. (See note below) | |||
| 21 | Slowest shutter speed of 1/1 |
- Ini.htm: shutterpriname=1/10000;1/5000;1/3000;1/2500;1/2000;1/1500;1/1000;1/725;1/500;1/350;1/250;1/180;1/120;1/100;1/90;1/60;1/30;1/15;1/8;1/4;1/2;1/1
Manually set Iris, all other exposure settings are automatic. User can also set exposure compensation, and WDR.
| Function | Command | Variable | Values | Comments |
|---|---|---|---|---|
| Iris Priority | http://[camera ip]/vb.htm?irispriidx=[fstop]&_=[UTS] | [camera ip] | Camera’s current ip | |
| [UTS] | Current Unix time stamp | |||
| [fstop] | 0 | Smallest iris opening of F18 | ||
| ... | Iris priority numbers range from 0 to 14. Numbers match to iris values returned by irispriname in ini.htm | |||
| 14 | Largest iris opening of F1.6 |
- Ini.htm: irispriname=F18;F16;F13;F11;F9;F7.8;F6.3;F5.4;F4.5;F3.8;F3.2;F2.7;F2.2;F2;F1.6
Manually set exposure. Must set gain, iris, WDR, shutter speed, and ptz assist mode of the camera.
| Function | Command | Variable | Values | Comments |
|---|---|---|---|---|
| Gain | http://[camera ip]/vb.htm?exposuremodeindex=3&wdridx=[setting]&gainmanualidx=[gain]& shuttermanualidx=[manual_speed]&irismanualidx=[manual_fstop]&_=[UTS] |
[camera ip] | Camera’s current ip | |
| [UTS] | Current Unix time stamp | |||
| exposuremodeindex=3 | As seen in table above, exposuremode=3 is “Manual Mode” | |||
| wdrix=[setting] | See WDR table above | |||
| [gain] | 0 | Lowest gain of 0dB | ||
| ... | Gain settings range fro 0dB to 20dB. Names for the 10 gain values are set by gainmanualname as returned by ini.htm. See note. More gain typically means more noise in the picture. | |||
| 10 | Highest gain of 20dB. | |||
| [manual_speed] | 0 | Fastest shutter speed of 1/10000 | ||
| ... | Shutter speeds range from 0 to 21. Numbers 0-21 map to speeds returned by shutterpriname in ini.htm. (See note below) | |||
| 21 | Slowest shutter speed of 1/1 | |||
| [manual_fstop] | 0 | Smallest iris opening of F18 | ||
| ... | Iris numbers range from 0 to 14. Numbers match to iris values returned by irismanualname in ini.htm (See note below) | |||
| 14 | Largest iris opening of F1.6 |
- Ini.htm: gainmanualname=0 dB;2 dB;4 dB;6 dB;8 dB;10 dB;12 dB;14 dB;16 dB;18 dB;20 dB
- Ini.htm: irismanualname=F18;F16;F13;F11;F9;F7.8;F6.3;F5.4;F4.5;F3.8;F3.2;F2.7;F2.2;F2;F1.6