mirror of
https://github.com/torvalds/linux.git
synced 2024-11-17 09:31:50 +00:00
[media] V4L: Add camera scene mode control
Add control for the scene mode feature available in image sensor with more advanced ISP firmware. The V4L2_CID_SCENE_MODE menu control allows to select a set of parameters or a specific image processing and capture control algorithm optimized for common image capture conditions. Signed-off-by: HeungJun Kim <riverful.kim@samsung.com> Signed-off-by: Sylwester Nawrocki <s.nawrocki@samsung.com> Signed-off-by: Kyungmin Park <kyungmin.park@samsung.com> Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>
This commit is contained in:
Sylwester Nawrocki
Mauro Carvalho Chehab
parent
cf072139c7
commit
0bf6b7dc5f
@ -3184,6 +3184,123 @@ sensitivity adjustments.</entry>
|
||||
</row>
|
||||
<row><entry></entry></row>
|
||||
|
||||
<row id="v4l2-scene-mode">
|
||||
<entry spanname="id"><constant>V4L2_CID_SCENE_MODE</constant> </entry>
|
||||
<entry>enum v4l2_scene_mode</entry>
|
||||
</row><row><entry spanname="descr">This control allows to select
|
||||
scene programs as the camera automatic modes optimized for common shooting
|
||||
scenes. Within these modes the camera determines best exposure, aperture,
|
||||
focusing, light metering, white balance and equivalent sensitivity. The
|
||||
controls of those parameters are influenced by the scene mode control.
|
||||
An exact behavior in each mode is subject to the camera specification.
|
||||
|
||||
<para>When the scene mode feature is not used, this control should be set to
|
||||
<constant>V4L2_SCENE_MODE_NONE</constant> to make sure the other possibly
|
||||
related controls are accessible. The following scene programs are defined:
|
||||
</para>
|
||||
</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entrytbl spanname="descr" cols="2">
|
||||
<tbody valign="top">
|
||||
<row>
|
||||
<entry><constant>V4L2_SCENE_MODE_NONE</constant> </entry>
|
||||
<entry>The scene mode feature is disabled.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry><constant>V4L2_SCENE_MODE_BACKLIGHT</constant> </entry>
|
||||
<entry>Backlight. Compensates for dark shadows when light is
|
||||
coming from behind a subject, also by automatically turning
|
||||
on the flash.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry><constant>V4L2_SCENE_MODE_BEACH_SNOW</constant> </entry>
|
||||
<entry>Beach and snow. This mode compensates for all-white or
|
||||
bright scenes, which tend to look gray and low contrast, when camera's automatic
|
||||
exposure is based on an average scene brightness. To compensate, this mode
|
||||
automatically slightly overexposes the frames. The white balance may also be
|
||||
adjusted to compensate for the fact that reflected snow looks bluish rather
|
||||
than white.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry><constant>V4L2_SCENE_MODE_CANDLELIGHT</constant> </entry>
|
||||
<entry>Candle light. The camera generally raises the ISO
|
||||
sensitivity and lowers the shutter speed. This mode compensates for relatively
|
||||
close subject in the scene. The flash is disabled in order to preserve the
|
||||
ambiance of the light.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry><constant>V4L2_SCENE_MODE_DAWN_DUSK</constant> </entry>
|
||||
<entry>Dawn and dusk. Preserves the colors seen in low
|
||||
natural light before dusk and after down. The camera may turn off the flash,
|
||||
and automatically focus at infinity. It will usually boost saturation and
|
||||
lower the shutter speed.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry><constant>V4L2_SCENE_MODE_FALL_COLORS</constant> </entry>
|
||||
<entry>Fall colors. Increases saturation and adjusts white
|
||||
balance for color enhancement. Pictures of autumn leaves get saturated reds
|
||||
and yellows.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry><constant>V4L2_SCENE_MODE_FIREWORKS</constant> </entry>
|
||||
<entry>Fireworks. Long exposure times are used to capture
|
||||
the expanding burst of light from a firework. The camera may invoke image
|
||||
stabilization.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry><constant>V4L2_SCENE_MODE_LANDSCAPE</constant> </entry>
|
||||
<entry>Landscape. The camera may choose a small aperture to
|
||||
provide deep depth of field and long exposure duration to help capture detail
|
||||
in dim light conditions. The focus is fixed at infinity. Suitable for distant
|
||||
and wide scenery.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry><constant>V4L2_SCENE_MODE_NIGHT</constant> </entry>
|
||||
<entry>Night, also known as Night Landscape. Designed for low
|
||||
light conditions, it preserves detail in the dark areas without blowing out bright
|
||||
objects. The camera generally sets itself to a medium-to-high ISO sensitivity,
|
||||
with a relatively long exposure time, and turns flash off. As such, there will be
|
||||
increased image noise and the possibility of blurred image.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry><constant>V4L2_SCENE_MODE_PARTY_INDOOR</constant> </entry>
|
||||
<entry>Party and indoor. Designed to capture indoor scenes
|
||||
that are lit by indoor background lighting as well as the flash. The camera
|
||||
usually increases ISO sensitivity, and adjusts exposure for the low light
|
||||
conditions.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry><constant>V4L2_SCENE_MODE_PORTRAIT</constant> </entry>
|
||||
<entry>Portrait. The camera adjusts the aperture so that the
|
||||
depth of field is reduced, which helps to isolate the subject against a smooth
|
||||
background. Most cameras recognize the presence of faces in the scene and focus
|
||||
on them. The color hue is adjusted to enhance skin tones. The intensity of the
|
||||
flash is often reduced.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry><constant>V4L2_SCENE_MODE_SPORTS</constant> </entry>
|
||||
<entry>Sports. Significantly increases ISO and uses a fast
|
||||
shutter speed to freeze motion of rapidly-moving subjects. Increased image
|
||||
noise may be seen in this mode.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry><constant>V4L2_SCENE_MODE_SUNSET</constant> </entry>
|
||||
<entry>Sunset. Preserves deep hues seen in sunsets and
|
||||
sunrises. It bumps up the saturation.</entry>
|
||||
</row>
|
||||
<row>
|
||||
<entry><constant>V4L2_SCENE_MODE_TEXT</constant> </entry>
|
||||
<entry>Text. It applies extra contrast and sharpness, it is
|
||||
typically a black-and-white mode optimized for readability. Automatic focus
|
||||
may be switched to close-up mode and this setting may also involve some
|
||||
lens-distortion correction.</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</entrytbl>
|
||||
</row>
|
||||
<row><entry></entry></row>
|
||||
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
|
||||
@ -273,6 +273,23 @@ const char * const *v4l2_ctrl_get_menu(u32 id)
|
||||
"Auto",
|
||||
NULL
|
||||
};
|
||||
static const char * const scene_mode[] = {
|
||||
"None",
|
||||
"Backlight",
|
||||
"Beach/Snow",
|
||||
"Candle Light",
|
||||
"Dusk/Dawn",
|
||||
"Fall Colors",
|
||||
"Fireworks",
|
||||
"Landscape",
|
||||
"Night",
|
||||
"Party/Indoor",
|
||||
"Portrait",
|
||||
"Sports",
|
||||
"Sunset",
|
||||
"Text",
|
||||
NULL
|
||||
};
|
||||
static const char * const tune_preemphasis[] = {
|
||||
"No Preemphasis",
|
||||
"50 Microseconds",
|
||||
@ -448,6 +465,8 @@ const char * const *v4l2_ctrl_get_menu(u32 id)
|
||||
return auto_n_preset_white_balance;
|
||||
case V4L2_CID_ISO_SENSITIVITY_AUTO:
|
||||
return camera_iso_sensitivity_auto;
|
||||
case V4L2_CID_SCENE_MODE:
|
||||
return scene_mode;
|
||||
case V4L2_CID_TUNE_PREEMPHASIS:
|
||||
return tune_preemphasis;
|
||||
case V4L2_CID_FLASH_LED_MODE:
|
||||
@ -641,6 +660,7 @@ const char *v4l2_ctrl_get_name(u32 id)
|
||||
case V4L2_CID_ISO_SENSITIVITY: return "ISO Sensitivity";
|
||||
case V4L2_CID_ISO_SENSITIVITY_AUTO: return "ISO Sensitivity, Auto";
|
||||
case V4L2_CID_EXPOSURE_METERING: return "Exposure, Metering Mode";
|
||||
case V4L2_CID_SCENE_MODE: return "Scene Mode";
|
||||
|
||||
/* FM Radio Modulator control */
|
||||
/* Keep the order of the 'case's the same as in videodev2.h! */
|
||||
@ -793,6 +813,7 @@ void v4l2_ctrl_fill(u32 id, const char **name, enum v4l2_ctrl_type *type,
|
||||
case V4L2_CID_JPEG_CHROMA_SUBSAMPLING:
|
||||
case V4L2_CID_ISO_SENSITIVITY_AUTO:
|
||||
case V4L2_CID_EXPOSURE_METERING:
|
||||
case V4L2_CID_SCENE_MODE:
|
||||
*type = V4L2_CTRL_TYPE_MENU;
|
||||
break;
|
||||
case V4L2_CID_LINK_FREQ:
|
||||
|
||||
@ -1740,6 +1740,24 @@ enum v4l2_exposure_metering {
|
||||
V4L2_EXPOSURE_METERING_SPOT = 2,
|
||||
};
|
||||
|
||||
#define V4L2_CID_SCENE_MODE (V4L2_CID_CAMERA_CLASS_BASE+26)
|
||||
enum v4l2_scene_mode {
|
||||
V4L2_SCENE_MODE_NONE = 0,
|
||||
V4L2_SCENE_MODE_BACKLIGHT = 1,
|
||||
V4L2_SCENE_MODE_BEACH_SNOW = 2,
|
||||
V4L2_SCENE_MODE_CANDLE_LIGHT = 3,
|
||||
V4L2_SCENE_MODE_DAWN_DUSK = 4,
|
||||
V4L2_SCENE_MODE_FALL_COLORS = 5,
|
||||
V4L2_SCENE_MODE_FIREWORKS = 6,
|
||||
V4L2_SCENE_MODE_LANDSCAPE = 7,
|
||||
V4L2_SCENE_MODE_NIGHT = 8,
|
||||
V4L2_SCENE_MODE_PARTY_INDOOR = 9,
|
||||
V4L2_SCENE_MODE_PORTRAIT = 10,
|
||||
V4L2_SCENE_MODE_SPORTS = 11,
|
||||
V4L2_SCENE_MODE_SUNSET = 12,
|
||||
V4L2_SCENE_MODE_TEXT = 13,
|
||||
};
|
||||
|
||||
/* FM Modulator class control IDs */
|
||||
#define V4L2_CID_FM_TX_CLASS_BASE (V4L2_CTRL_CLASS_FM_TX | 0x900)
|
||||
#define V4L2_CID_FM_TX_CLASS (V4L2_CTRL_CLASS_FM_TX | 1)
|
||||
|
||||
Loading…
Reference in New Issue
Block a user