mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-11-03 16:09:39 +00:00
645 lines
27 KiB
C
645 lines
27 KiB
C
/* GStreamer
|
|
*
|
|
* Copyright (C) 2008 Nokia Corporation <multimedia@maemo.org>
|
|
*
|
|
* photography.h: photography interface for digital imaging
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Library General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Library General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Library General Public
|
|
* License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
|
|
* Boston, MA 02110-1301, USA.
|
|
*/
|
|
|
|
#ifndef __GST_PHOTOGRAPHY_H__
|
|
#define __GST_PHOTOGRAPHY_H__
|
|
|
|
#ifndef GST_USE_UNSTABLE_API
|
|
#warning "The GstPhotography interface is unstable API and may change in future."
|
|
#warning "You can define GST_USE_UNSTABLE_API to avoid this warning."
|
|
#endif
|
|
|
|
#include <gst/gst.h>
|
|
#include <gst/interfaces/photography-prelude.h>
|
|
#include <gst/interfaces/photography-enumtypes.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define GST_TYPE_PHOTOGRAPHY \
|
|
(gst_photography_get_type ())
|
|
#define GST_PHOTOGRAPHY(obj) \
|
|
(G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_PHOTOGRAPHY, GstPhotography))
|
|
#define GST_IS_PHOTOGRAPHY(obj) \
|
|
(G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_PHOTOGRAPHY))
|
|
#define GST_PHOTOGRAPHY_GET_INTERFACE(inst) \
|
|
(G_TYPE_INSTANCE_GET_INTERFACE ((inst), GST_TYPE_PHOTOGRAPHY, GstPhotographyInterface))
|
|
|
|
|
|
/**
|
|
* GST_PHOTOGRAPHY_AUTOFOCUS_DONE:
|
|
*
|
|
* Name of custom GstMessage that will be posted to #GstBus when autofocusing
|
|
* is complete.
|
|
* This message contains following fields:
|
|
*
|
|
* * `status` (#GstPhotographyFocusStatus): Tells if focusing succeeded or failed.
|
|
*
|
|
* * `focus-window-rows` (#G_TYPE_INT): Tells number of focus matrix rows.
|
|
*
|
|
* * `focus-window-columns` (#G_TYPE_INT): Tells number of focus matrix columns.
|
|
*
|
|
* * `focus-window-mask` (#G_TYPE_INT): Bitmask containing rows x columns bits
|
|
* which mark the focus points in the focus matrix. Lowest bit (LSB) always
|
|
* represents the top-left corner of the focus matrix. This field is only valid
|
|
* when focusing status is SUCCESS.
|
|
*/
|
|
#define GST_PHOTOGRAPHY_AUTOFOCUS_DONE "autofocus-done"
|
|
|
|
/**
|
|
* GST_PHOTOGRAPHY_SHAKE_RISK:
|
|
*
|
|
* Name of custom GstMessage that is posted to #GstBus during autofocusing
|
|
* process. It is posted if there is change in the risk of captured image
|
|
* becoming "shaken" due to camera movement and too long exposure time.
|
|
*
|
|
* This message contains following fields:
|
|
*
|
|
* * `status` (#GstPhotographyShakeRisk): Tells risk level of capturing shaken image.
|
|
*/
|
|
#define GST_PHOTOGRAPHY_SHAKE_RISK "shake-risk"
|
|
|
|
/* Maximum white point values used in #GstPhotographySettings */
|
|
#define MAX_WHITE_POINT_VALUES 4
|
|
|
|
/* Interface property names */
|
|
#define GST_PHOTOGRAPHY_PROP_WB_MODE "white-balance-mode"
|
|
#define GST_PHOTOGRAPHY_PROP_COLOR_TONE "color-tone-mode"
|
|
#define GST_PHOTOGRAPHY_PROP_SCENE_MODE "scene-mode"
|
|
#define GST_PHOTOGRAPHY_PROP_FLASH_MODE "flash-mode"
|
|
#define GST_PHOTOGRAPHY_PROP_NOISE_REDUCTION "noise-reduction"
|
|
#define GST_PHOTOGRAPHY_PROP_FOCUS_STATUS "focus-status"
|
|
#define GST_PHOTOGRAPHY_PROP_CAPABILITIES "capabilities"
|
|
#define GST_PHOTOGRAPHY_PROP_SHAKE_RISK "shake-risk"
|
|
#define GST_PHOTOGRAPHY_PROP_EV_COMP "ev-compensation"
|
|
#define GST_PHOTOGRAPHY_PROP_ISO_SPEED "iso-speed"
|
|
#define GST_PHOTOGRAPHY_PROP_APERTURE "aperture"
|
|
#define GST_PHOTOGRAPHY_PROP_EXPOSURE_TIME "exposure-time"
|
|
#define GST_PHOTOGRAPHY_PROP_IMAGE_CAPTURE_SUPPORTED_CAPS \
|
|
"image-capture-supported-caps"
|
|
#define GST_PHOTOGRAPHY_PROP_IMAGE_PREVIEW_SUPPORTED_CAPS \
|
|
"image-preview-supported-caps"
|
|
#define GST_PHOTOGRAPHY_PROP_FLICKER_MODE "flicker-mode"
|
|
#define GST_PHOTOGRAPHY_PROP_FOCUS_MODE "focus-mode"
|
|
#define GST_PHOTOGRAPHY_PROP_ZOOM "zoom"
|
|
#define GST_PHOTOGRAPHY_PROP_COLOR_TEMPERATURE "color-temperature"
|
|
#define GST_PHOTOGRAPHY_PROP_WHITE_POINT "white-point"
|
|
#define GST_PHOTOGRAPHY_PROP_ANALOG_GAIN "analog-gain"
|
|
#define GST_PHOTOGRAPHY_PROP_EXPOSURE_MODE "exposure-mode"
|
|
#define GST_PHOTOGRAPHY_PROP_LENS_FOCUS "lens-focus"
|
|
#define GST_PHOTOGRAPHY_PROP_MIN_EXPOSURE_TIME "min-exposure-time"
|
|
#define GST_PHOTOGRAPHY_PROP_MAX_EXPOSURE_TIME "max-exposure-time"
|
|
|
|
/**
|
|
* GstPhotography:
|
|
*
|
|
* Opaque #GstPhotography data structure.
|
|
*/
|
|
typedef struct _GstPhotography GstPhotography;
|
|
|
|
/**
|
|
* GstPhotographyNoiseReduction:
|
|
* @GST_PHOTOGRAPHY_NOISE_REDUCTION_BAYER: Adaptive noise reduction on Bayer
|
|
* format
|
|
* @GST_PHOTOGRAPHY_NOISE_REDUCTION_YCC: reduces the noise on Y and 2-chroma
|
|
* images.
|
|
* @GST_PHOTOGRAPHY_NOISE_REDUCTION_TEMPORAL: Multi-frame adaptive NR,
|
|
* provided for the video mode
|
|
* @GST_PHOTOGRAPHY_NOISE_REDUCTION_FIXED: Fixed Pattern Noise refers to noise
|
|
* that does not change between frames. The noise is removed from the sensor
|
|
* image, by subtracting a previously-captured black image in memory.
|
|
* @GST_PHOTOGRAPHY_NOISE_REDUCTION_EXTRA: Extra Noise Reduction. In the case
|
|
* of high-ISO capturing, some noise remains after YCC NR. XNR reduces this
|
|
* remaining noise.
|
|
*
|
|
* Noise Reduction features of a photography capture or filter element.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GST_PHOTOGRAPHY_NOISE_REDUCTION_BAYER = (1 << 0),
|
|
GST_PHOTOGRAPHY_NOISE_REDUCTION_YCC = (1 << 1),
|
|
GST_PHOTOGRAPHY_NOISE_REDUCTION_TEMPORAL = (1 << 2),
|
|
GST_PHOTOGRAPHY_NOISE_REDUCTION_FIXED = (1 << 3),
|
|
GST_PHOTOGRAPHY_NOISE_REDUCTION_EXTRA = (1 << 4)
|
|
} GstPhotographyNoiseReduction;
|
|
|
|
/**
|
|
* GstPhotographyWhiteBalanceMode:
|
|
* @GST_PHOTOGRAPHY_WB_MODE_AUTO: Choose white balance mode automatically
|
|
* @GST_PHOTOGRAPHY_WB_MODE_DAYLIGHT: Mode for daylight conditions
|
|
* @GST_PHOTOGRAPHY_WB_MODE_CLOUDY: Mode for cloudy conditions
|
|
* @GST_PHOTOGRAPHY_WB_MODE_SUNSET: Mode for sunset conditions
|
|
* @GST_PHOTOGRAPHY_WB_MODE_TUNGSTEN: Mode for tungsten lighting
|
|
* @GST_PHOTOGRAPHY_WB_MODE_FLUORESCENT: Mode for fluorescent lighting
|
|
* @GST_PHOTOGRAPHY_WB_MODE_MANUAL: Disable automatic white balance adjustment
|
|
* and keep current values.
|
|
* @GST_PHOTOGRAPHY_WB_MODE_WARM_FLUORESCENT: Mode for warm fluorescent lighting (Since: 1.2)
|
|
* @GST_PHOTOGRAPHY_WB_MODE_SHADE: Mode for shade lighting (Since: 1.2)
|
|
*
|
|
* Modes for white balance control.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GST_PHOTOGRAPHY_WB_MODE_AUTO = 0,
|
|
GST_PHOTOGRAPHY_WB_MODE_DAYLIGHT,
|
|
GST_PHOTOGRAPHY_WB_MODE_CLOUDY,
|
|
GST_PHOTOGRAPHY_WB_MODE_SUNSET,
|
|
GST_PHOTOGRAPHY_WB_MODE_TUNGSTEN,
|
|
GST_PHOTOGRAPHY_WB_MODE_FLUORESCENT,
|
|
GST_PHOTOGRAPHY_WB_MODE_MANUAL,
|
|
GST_PHOTOGRAPHY_WB_MODE_WARM_FLUORESCENT,
|
|
GST_PHOTOGRAPHY_WB_MODE_SHADE
|
|
} GstPhotographyWhiteBalanceMode;
|
|
|
|
/**
|
|
* GstPhotographyColorToneMode:
|
|
* @GST_PHOTOGRAPHY_COLOR_TONE_MODE_NORMAL: No effects
|
|
* @GST_PHOTOGRAPHY_COLOR_TONE_MODE_SEPIA: Sepia
|
|
* @GST_PHOTOGRAPHY_COLOR_TONE_MODE_NEGATIVE: Negative
|
|
* @GST_PHOTOGRAPHY_COLOR_TONE_MODE_GRAYSCALE: Grayscale
|
|
* @GST_PHOTOGRAPHY_COLOR_TONE_MODE_NATURAL: Natural
|
|
* @GST_PHOTOGRAPHY_COLOR_TONE_MODE_VIVID: Vivid
|
|
* @GST_PHOTOGRAPHY_COLOR_TONE_MODE_COLORSWAP: Colorswap
|
|
* @GST_PHOTOGRAPHY_COLOR_TONE_MODE_SOLARIZE: Solarize
|
|
* @GST_PHOTOGRAPHY_COLOR_TONE_MODE_OUT_OF_FOCUS: Out of focus
|
|
* @GST_PHOTOGRAPHY_COLOR_TONE_MODE_SKY_BLUE: Sky blue
|
|
* @GST_PHOTOGRAPHY_COLOR_TONE_MODE_GRASS_GREEN: Grass green
|
|
* @GST_PHOTOGRAPHY_COLOR_TONE_MODE_SKIN_WHITEN: Skin whiten
|
|
* @GST_PHOTOGRAPHY_COLOR_TONE_MODE_POSTERIZE: Posterize (Since: 1.2)
|
|
* @GST_PHOTOGRAPHY_COLOR_TONE_MODE_WHITEBOARD: Whiteboard (Since: 1.2)
|
|
* @GST_PHOTOGRAPHY_COLOR_TONE_MODE_BLACKBOARD: Blackboard (Since: 1.2)
|
|
* @GST_PHOTOGRAPHY_COLOR_TONE_MODE_AQUA: Aqua (Since: 1.2)
|
|
*
|
|
* Modes for special color effects.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GST_PHOTOGRAPHY_COLOR_TONE_MODE_NORMAL = 0,
|
|
GST_PHOTOGRAPHY_COLOR_TONE_MODE_SEPIA,
|
|
GST_PHOTOGRAPHY_COLOR_TONE_MODE_NEGATIVE,
|
|
GST_PHOTOGRAPHY_COLOR_TONE_MODE_GRAYSCALE,
|
|
GST_PHOTOGRAPHY_COLOR_TONE_MODE_NATURAL,
|
|
GST_PHOTOGRAPHY_COLOR_TONE_MODE_VIVID,
|
|
GST_PHOTOGRAPHY_COLOR_TONE_MODE_COLORSWAP,
|
|
GST_PHOTOGRAPHY_COLOR_TONE_MODE_SOLARIZE,
|
|
GST_PHOTOGRAPHY_COLOR_TONE_MODE_OUT_OF_FOCUS,
|
|
GST_PHOTOGRAPHY_COLOR_TONE_MODE_SKY_BLUE,
|
|
GST_PHOTOGRAPHY_COLOR_TONE_MODE_GRASS_GREEN,
|
|
GST_PHOTOGRAPHY_COLOR_TONE_MODE_SKIN_WHITEN,
|
|
GST_PHOTOGRAPHY_COLOR_TONE_MODE_POSTERIZE,
|
|
GST_PHOTOGRAPHY_COLOR_TONE_MODE_WHITEBOARD,
|
|
GST_PHOTOGRAPHY_COLOR_TONE_MODE_BLACKBOARD,
|
|
GST_PHOTOGRAPHY_COLOR_TONE_MODE_AQUA
|
|
} GstPhotographyColorToneMode;
|
|
|
|
/**
|
|
* GstPhotographySceneMode:
|
|
* @GST_PHOTOGRAPHY_SCENE_MODE_MANUAL: Set individual options manually
|
|
* @GST_PHOTOGRAPHY_SCENE_MODE_CLOSEUP: Mode for close objects
|
|
* @GST_PHOTOGRAPHY_SCENE_MODE_PORTRAIT: Mode for portraits
|
|
* @GST_PHOTOGRAPHY_SCENE_MODE_LANDSCAPE: Mode for landscapes
|
|
* @GST_PHOTOGRAPHY_SCENE_MODE_SPORT: Mode for scene with fast motion
|
|
* @GST_PHOTOGRAPHY_SCENE_MODE_NIGHT: Mode for night conditions
|
|
* @GST_PHOTOGRAPHY_SCENE_MODE_AUTO: Choose scene mode automatically
|
|
* @GST_PHOTOGRAPHY_SCENE_MODE_ACTION: Take photos of fast moving
|
|
* objects (Since: 1.2)
|
|
* @GST_PHOTOGRAPHY_SCENE_MODE_NIGHT_PORTRAIT: Take people pictures
|
|
* at night (Since: 1.2)
|
|
* @GST_PHOTOGRAPHY_SCENE_MODE_THEATRE: Take photos in a theater (Since: 1.2)
|
|
* @GST_PHOTOGRAPHY_SCENE_MODE_BEACH: Take pictures on the beach (Since: 1.2)
|
|
* @GST_PHOTOGRAPHY_SCENE_MODE_SNOW: Take pictures on the snow (Since: 1.2)
|
|
* @GST_PHOTOGRAPHY_SCENE_MODE_SUNSET: Take sunset photos (Since: 1.2)
|
|
* @GST_PHOTOGRAPHY_SCENE_MODE_STEADY_PHOTO: Avoid blurry pictures
|
|
* (for example, due to hand shake) (Since: 1.2)
|
|
* @GST_PHOTOGRAPHY_SCENE_MODE_FIREWORKS: For shooting firework
|
|
* displays (Since: 1.2)
|
|
* @GST_PHOTOGRAPHY_SCENE_MODE_PARTY: Take indoor low-light shot (Since: 1.2)
|
|
* @GST_PHOTOGRAPHY_SCENE_MODE_CANDLELIGHT: Capture the naturally warm color
|
|
* of scenes lit by candles (Since: 1.2)
|
|
* @GST_PHOTOGRAPHY_SCENE_MODE_BARCODE: Applications are looking for
|
|
* a barcode (Since: 1.2)
|
|
*
|
|
* Each mode contains preset #GstPhotography options in order to produce
|
|
* good capturing result in certain scene.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GST_PHOTOGRAPHY_SCENE_MODE_MANUAL = 0,
|
|
GST_PHOTOGRAPHY_SCENE_MODE_CLOSEUP,
|
|
GST_PHOTOGRAPHY_SCENE_MODE_PORTRAIT,
|
|
GST_PHOTOGRAPHY_SCENE_MODE_LANDSCAPE,
|
|
GST_PHOTOGRAPHY_SCENE_MODE_SPORT,
|
|
GST_PHOTOGRAPHY_SCENE_MODE_NIGHT,
|
|
GST_PHOTOGRAPHY_SCENE_MODE_AUTO,
|
|
GST_PHOTOGRAPHY_SCENE_MODE_ACTION,
|
|
GST_PHOTOGRAPHY_SCENE_MODE_NIGHT_PORTRAIT,
|
|
GST_PHOTOGRAPHY_SCENE_MODE_THEATRE,
|
|
GST_PHOTOGRAPHY_SCENE_MODE_BEACH,
|
|
GST_PHOTOGRAPHY_SCENE_MODE_SNOW,
|
|
GST_PHOTOGRAPHY_SCENE_MODE_SUNSET,
|
|
GST_PHOTOGRAPHY_SCENE_MODE_STEADY_PHOTO,
|
|
GST_PHOTOGRAPHY_SCENE_MODE_FIREWORKS,
|
|
GST_PHOTOGRAPHY_SCENE_MODE_PARTY,
|
|
GST_PHOTOGRAPHY_SCENE_MODE_CANDLELIGHT,
|
|
GST_PHOTOGRAPHY_SCENE_MODE_BARCODE
|
|
} GstPhotographySceneMode;
|
|
|
|
/**
|
|
* GstPhotographyFlashMode:
|
|
* @GST_PHOTOGRAPHY_FLASH_MODE_AUTO: Fire flash automatically according to
|
|
* lighting conditions.
|
|
* @GST_PHOTOGRAPHY_FLASH_MODE_OFF: Never fire flash
|
|
* @GST_PHOTOGRAPHY_FLASH_MODE_ON: Always fire flash
|
|
* @GST_PHOTOGRAPHY_FLASH_MODE_FILL_IN: Fill in flash
|
|
* @GST_PHOTOGRAPHY_FLASH_MODE_RED_EYE: Flash mode for reducing chance of
|
|
* capturing red eyes
|
|
*
|
|
* Modes for flash control.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GST_PHOTOGRAPHY_FLASH_MODE_AUTO = 0,
|
|
GST_PHOTOGRAPHY_FLASH_MODE_OFF,
|
|
GST_PHOTOGRAPHY_FLASH_MODE_ON,
|
|
GST_PHOTOGRAPHY_FLASH_MODE_FILL_IN,
|
|
GST_PHOTOGRAPHY_FLASH_MODE_RED_EYE
|
|
} GstPhotographyFlashMode;
|
|
|
|
/**
|
|
* GstPhotographyFocusStatus:
|
|
* @GST_PHOTOGRAPHY_FOCUS_STATUS_NONE: No status available
|
|
* @GST_PHOTOGRAPHY_FOCUS_STATUS_RUNNING: Focusing is ongoing
|
|
* @GST_PHOTOGRAPHY_FOCUS_STATUS_FAIL: Focusing failed
|
|
* @GST_PHOTOGRAPHY_FOCUS_STATUS_SUCCESS: Focusing succeeded
|
|
*
|
|
* Status of the focusing operation, used in #GST_PHOTOGRAPHY_AUTOFOCUS_DONE
|
|
* message.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GST_PHOTOGRAPHY_FOCUS_STATUS_NONE = 0,
|
|
GST_PHOTOGRAPHY_FOCUS_STATUS_RUNNING,
|
|
GST_PHOTOGRAPHY_FOCUS_STATUS_FAIL,
|
|
GST_PHOTOGRAPHY_FOCUS_STATUS_SUCCESS
|
|
} GstPhotographyFocusStatus;
|
|
|
|
/**
|
|
* GstPhotographyCaps:
|
|
*
|
|
* Bitmask that indicates which #GstPhotography interface features an instance
|
|
* supports.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GST_PHOTOGRAPHY_CAPS_NONE = (0 << 0),
|
|
GST_PHOTOGRAPHY_CAPS_EV_COMP = (1 << 0),
|
|
GST_PHOTOGRAPHY_CAPS_ISO_SPEED = (1 << 1),
|
|
GST_PHOTOGRAPHY_CAPS_WB_MODE = (1 << 2),
|
|
GST_PHOTOGRAPHY_CAPS_TONE = (1 << 3),
|
|
GST_PHOTOGRAPHY_CAPS_SCENE = (1 << 4),
|
|
GST_PHOTOGRAPHY_CAPS_FLASH = (1 << 5),
|
|
GST_PHOTOGRAPHY_CAPS_ZOOM = (1 << 6),
|
|
GST_PHOTOGRAPHY_CAPS_FOCUS = (1 << 7),
|
|
GST_PHOTOGRAPHY_CAPS_APERTURE = (1 << 8),
|
|
GST_PHOTOGRAPHY_CAPS_EXPOSURE = (1 << 9),
|
|
GST_PHOTOGRAPHY_CAPS_SHAKE = (1 << 10),
|
|
GST_PHOTOGRAPHY_CAPS_WHITE_BALANCE = (1 << 11),
|
|
GST_PHOTOGRAPHY_CAPS_NOISE_REDUCTION = (1 << 12),
|
|
GST_PHOTOGRAPHY_CAPS_FLICKER_REDUCTION = (1 << 13),
|
|
GST_PHOTOGRAPHY_CAPS_ALL = (~0)
|
|
} GstPhotographyCaps;
|
|
|
|
/**
|
|
* GstPhotographyShakeRisk:
|
|
* @GST_PHOTOGRAPHY_SHAKE_RISK_LOW: Low risk
|
|
* @GST_PHOTOGRAPHY_SHAKE_RISK_MEDIUM: Medium risk
|
|
* @GST_PHOTOGRAPHY_SHAKE_RISK_HIGH: High risk
|
|
*
|
|
* Risk level of captured image becoming "shaken" due to camera movement and
|
|
* too long exposure time. Used in #GST_PHOTOGRAPHY_SHAKE_RISK #GstMessage.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GST_PHOTOGRAPHY_SHAKE_RISK_LOW = 0,
|
|
GST_PHOTOGRAPHY_SHAKE_RISK_MEDIUM,
|
|
GST_PHOTOGRAPHY_SHAKE_RISK_HIGH,
|
|
} GstPhotographyShakeRisk;
|
|
|
|
/**
|
|
* GstPhotographyFlickerReductionMode:
|
|
* @GST_PHOTOGRAPHY_FLICKER_REDUCTION_OFF: Disable flicker reduction
|
|
* @GST_PHOTOGRAPHY_FLICKER_REDUCTION_50HZ: 50Hz flicker reduction
|
|
* @GST_PHOTOGRAPHY_FLICKER_REDUCTION_60HZ: 60Hz flicker reduction
|
|
* @GST_PHOTOGRAPHY_FLICKER_REDUCTION_AUTO: Choose mode automatically
|
|
*
|
|
* Reduce flicker in video caused by light source fluctuation.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GST_PHOTOGRAPHY_FLICKER_REDUCTION_OFF = 0,
|
|
GST_PHOTOGRAPHY_FLICKER_REDUCTION_50HZ,
|
|
GST_PHOTOGRAPHY_FLICKER_REDUCTION_60HZ,
|
|
GST_PHOTOGRAPHY_FLICKER_REDUCTION_AUTO,
|
|
} GstPhotographyFlickerReductionMode;
|
|
|
|
/**
|
|
* GstPhotographyFocusMode:
|
|
* @GST_PHOTOGRAPHY_FOCUS_MODE_AUTO: Choose focus mode automatically
|
|
* @GST_PHOTOGRAPHY_FOCUS_MODE_MACRO: Mode for focusing objects close to lens
|
|
* @GST_PHOTOGRAPHY_FOCUS_MODE_PORTRAIT: Mode for portraits
|
|
* @GST_PHOTOGRAPHY_FOCUS_MODE_INFINITY: Mode for landscapes and far away objects
|
|
* @GST_PHOTOGRAPHY_FOCUS_MODE_HYPERFOCAL: Mode for maximum depth of field, keeping
|
|
* focus acceptable both in infinify and as close objects as possible
|
|
* @GST_PHOTOGRAPHY_FOCUS_MODE_EXTENDED: Extended focus mode
|
|
* @GST_PHOTOGRAPHY_FOCUS_MODE_CONTINUOUS_NORMAL: Continuous autofocus mode
|
|
* @GST_PHOTOGRAPHY_FOCUS_MODE_CONTINUOUS_EXTENDED: Extended continuous
|
|
* autofocus mode
|
|
* @GST_PHOTOGRAPHY_FOCUS_MODE_MANUAL: Disable automatic focusing
|
|
* and keep current value. #GstPhotography:lens-focus property can
|
|
* be used to change focus manually.
|
|
*
|
|
* Choose mode for focusing algorithm.
|
|
*/
|
|
typedef enum {
|
|
GST_PHOTOGRAPHY_FOCUS_MODE_AUTO = 0,
|
|
GST_PHOTOGRAPHY_FOCUS_MODE_MACRO,
|
|
GST_PHOTOGRAPHY_FOCUS_MODE_PORTRAIT,
|
|
GST_PHOTOGRAPHY_FOCUS_MODE_INFINITY,
|
|
GST_PHOTOGRAPHY_FOCUS_MODE_HYPERFOCAL,
|
|
GST_PHOTOGRAPHY_FOCUS_MODE_EXTENDED,
|
|
GST_PHOTOGRAPHY_FOCUS_MODE_CONTINUOUS_NORMAL,
|
|
GST_PHOTOGRAPHY_FOCUS_MODE_CONTINUOUS_EXTENDED,
|
|
GST_PHOTOGRAPHY_FOCUS_MODE_MANUAL
|
|
} GstPhotographyFocusMode;
|
|
|
|
/**
|
|
* GstPhotographyExposureMode:
|
|
* @GST_PHOTOGRAPHY_EXPOSURE_MODE_AUTO: Adjust exposure automatically
|
|
* @GST_PHOTOGRAPHY_EXPOSURE_MODE_MANUAL: Disable automatic exposure adjustment
|
|
* and keep current values.
|
|
*
|
|
*/
|
|
typedef enum {
|
|
GST_PHOTOGRAPHY_EXPOSURE_MODE_AUTO = 0,
|
|
GST_PHOTOGRAPHY_EXPOSURE_MODE_MANUAL
|
|
} GstPhotographyExposureMode;
|
|
|
|
/**
|
|
* GstPhotographySettings:
|
|
*
|
|
* Structure containing all #GstPhotography settings, used to set all
|
|
* settings in one call with @gst_photography_set_config().
|
|
*/
|
|
typedef struct
|
|
{
|
|
GstPhotographyWhiteBalanceMode wb_mode;
|
|
GstPhotographyColorToneMode tone_mode;
|
|
GstPhotographySceneMode scene_mode;
|
|
GstPhotographyFlashMode flash_mode;
|
|
guint32 exposure_time;
|
|
guint aperture;
|
|
gfloat ev_compensation;
|
|
guint iso_speed;
|
|
gfloat zoom;
|
|
GstPhotographyFlickerReductionMode flicker_mode;
|
|
GstPhotographyFocusMode focus_mode;
|
|
GstPhotographyNoiseReduction noise_reduction;
|
|
GstPhotographyExposureMode exposure_mode;
|
|
guint color_temperature;
|
|
guint white_point[MAX_WHITE_POINT_VALUES];
|
|
gfloat analog_gain;
|
|
gfloat lens_focus;
|
|
guint min_exposure_time;
|
|
guint max_exposure_time;
|
|
/* FIXME: add padding? */
|
|
} GstPhotographySettings;
|
|
|
|
/**
|
|
* GstPhotographyCapturePrepared:
|
|
* @data: user data that has been given, when registering the callback
|
|
* @configured_caps: #GstCaps defining the configured capture format.
|
|
* Ownership of these caps stays in the element.
|
|
*
|
|
* This callback will be called when the element has finished preparations
|
|
* and is ready for image capture. The next buffer that element produces
|
|
* will be of @configured_caps format, so this callback allows the application
|
|
* to e.g. reconfigure capsfilters in pipeline if any.
|
|
*/
|
|
typedef void (*GstPhotographyCapturePrepared) (gpointer data, const GstCaps *configured_caps);
|
|
|
|
/**
|
|
* GstPhotographyInterface:
|
|
* @parent: parent interface type.
|
|
* @get_ev_compensation: vmethod to get ev exposure compensation value
|
|
* @get_iso_speed: vmethod to get iso speed (light sensitivity) value
|
|
* @get_aperture: vmethod to get aperture value
|
|
* @get_exposure: vmethod to get exposure time value
|
|
* @get_white_balance_mode: vmethod to get white balance mode value
|
|
* @get_color_tone_mode: vmethod to get color tone mode value
|
|
* @get_scene_mode: vmethod to get scene mode value
|
|
* @get_flash_mode: vmethod to get flash mode value
|
|
* @get_noise_reduction: vmethod to get noise reduction mode value
|
|
* @get_zoom: vmethod to get zoom factor value
|
|
* @set_ev_compensation: vmethod to set ev exposure compensation value
|
|
* @set_iso_speed: vmethod to set iso speed (light sensitivity) value
|
|
* @set_aperture: vmethod to set aperture value
|
|
* @set_exposure: vmethod to set exposure time value
|
|
* @set_white_balance_mode: vmethod to set white balance mode value
|
|
* @set_color_tone_mode: vmethod to set color tone mode value
|
|
* @set_scene_mode: vmethod to set scene mode value
|
|
* @set_flash_mode: vmethod to set flash mode value
|
|
* @set_noise_reduction: vmethod to set noise reduction mode value
|
|
* @set_zoom: vmethod to set zoom factor value
|
|
* @get_capabilities: vmethod to get supported capabilities of the interface
|
|
* @prepare_for_capture: vmethod to tell the element to prepare for capturing
|
|
* @set_autofocus: vmethod to set autofocus on/off
|
|
* @set_config: vmethod to set all configuration parameters at once
|
|
* @get_config: vmethod to get all configuration parameters at once
|
|
* @get_image_capture_supported_caps: vmethod to get caps describing supported image capture formats
|
|
*
|
|
* #GstPhotographyInterface interface.
|
|
*/
|
|
typedef struct _GstPhotographyInterface
|
|
{
|
|
GTypeInterface parent;
|
|
|
|
/* virtual functions */
|
|
gboolean (*get_ev_compensation) (GstPhotography * photo, gfloat * ev_comp);
|
|
gboolean (*get_iso_speed) (GstPhotography * photo, guint * iso_speed);
|
|
gboolean (*get_aperture) (GstPhotography * photo, guint * aperture);
|
|
gboolean (*get_exposure) (GstPhotography * photo, guint32 * exposure);
|
|
gboolean (*get_white_balance_mode) (GstPhotography * photo, GstPhotographyWhiteBalanceMode * wb_mode);
|
|
gboolean (*get_color_tone_mode) (GstPhotography * photo, GstPhotographyColorToneMode * tone_mode);
|
|
gboolean (*get_scene_mode) (GstPhotography * photo, GstPhotographySceneMode * scene_mode);
|
|
gboolean (*get_flash_mode) (GstPhotography * photo, GstPhotographyFlashMode * flash_mode);
|
|
gboolean (*get_zoom) (GstPhotography * photo, gfloat * zoom);
|
|
gboolean (*get_flicker_mode) (GstPhotography * photo, GstPhotographyFlickerReductionMode * flicker_mode);
|
|
gboolean (*get_focus_mode) (GstPhotography * photo, GstPhotographyFocusMode * focus_mode);
|
|
|
|
gboolean (*set_ev_compensation) (GstPhotography * photo, gfloat ev_comp);
|
|
gboolean (*set_iso_speed) (GstPhotography * photo, guint iso_speed);
|
|
gboolean (*set_aperture) (GstPhotography * photo, guint aperture);
|
|
gboolean (*set_exposure) (GstPhotography * photo, guint32 exposure);
|
|
gboolean (*set_white_balance_mode) (GstPhotography * photo, GstPhotographyWhiteBalanceMode wb_mode);
|
|
gboolean (*set_color_tone_mode) (GstPhotography * photo, GstPhotographyColorToneMode tone_mode);
|
|
gboolean (*set_scene_mode) (GstPhotography * photo, GstPhotographySceneMode scene_mode);
|
|
gboolean (*set_flash_mode) (GstPhotography * photo, GstPhotographyFlashMode flash_mode);
|
|
gboolean (*set_zoom) (GstPhotography * photo, gfloat zoom);
|
|
gboolean (*set_flicker_mode) (GstPhotography * photo, GstPhotographyFlickerReductionMode flicker_mode);
|
|
gboolean (*set_focus_mode) (GstPhotography * photo, GstPhotographyFocusMode focus_mode);
|
|
|
|
GstPhotographyCaps (*get_capabilities) (GstPhotography * photo);
|
|
|
|
gboolean (*prepare_for_capture) (GstPhotography * photo, GstPhotographyCapturePrepared func, GstCaps *capture_caps, gpointer user_data);
|
|
|
|
void (*set_autofocus) (GstPhotography * photo, gboolean on);
|
|
|
|
gboolean (*set_config) (GstPhotography * photo, GstPhotographySettings * config);
|
|
gboolean (*get_config) (GstPhotography * photo, GstPhotographySettings * config);
|
|
|
|
gboolean (*get_noise_reduction) (GstPhotography * photo, GstPhotographyNoiseReduction * noise_reduction);
|
|
gboolean (*set_noise_reduction) (GstPhotography * photo, GstPhotographyNoiseReduction noise_reduction);
|
|
|
|
/* FIXME: remove padding, not needed for interfaces */
|
|
/*< private > */
|
|
gpointer _gst_reserved[GST_PADDING];
|
|
} GstPhotographyInterface;
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
GType gst_photography_get_type (void);
|
|
|
|
/* virtual class function wrappers */
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_get_ev_compensation (GstPhotography * photo,
|
|
gfloat * ev_comp);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_get_iso_speed (GstPhotography * photo,
|
|
guint * iso_speed);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_get_aperture (GstPhotography * photo,
|
|
guint * aperture);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_get_exposure (GstPhotography * photo,
|
|
guint32 * exposure);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_get_white_balance_mode (GstPhotography * photo,
|
|
GstPhotographyWhiteBalanceMode * wb_mode);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_get_color_tone_mode (GstPhotography * photo,
|
|
GstPhotographyColorToneMode * tone_mode);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_get_scene_mode (GstPhotography * photo,
|
|
GstPhotographySceneMode * scene_mode);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_get_flash_mode (GstPhotography * photo,
|
|
GstPhotographyFlashMode * flash_mode);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_get_noise_reduction (GstPhotography * photo,
|
|
GstPhotographyNoiseReduction * noise_reduction);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_get_zoom (GstPhotography * photo, gfloat * zoom);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_get_flicker_mode (GstPhotography * photo,
|
|
GstPhotographyFlickerReductionMode * mode);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_get_focus_mode (GstPhotography * photo,
|
|
GstPhotographyFocusMode * mode);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_set_ev_compensation (GstPhotography * photo,
|
|
gfloat ev_comp);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_set_iso_speed (GstPhotography * photo,
|
|
guint iso_speed);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_set_aperture (GstPhotography * photo, guint aperture);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_set_exposure (GstPhotography * photo, guint exposure);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_set_white_balance_mode (GstPhotography * photo,
|
|
GstPhotographyWhiteBalanceMode wb_mode);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_set_color_tone_mode (GstPhotography * photo,
|
|
GstPhotographyColorToneMode tone_mode);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_set_scene_mode (GstPhotography * photo,
|
|
GstPhotographySceneMode scene_mode);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_set_flash_mode (GstPhotography * photo,
|
|
GstPhotographyFlashMode flash_mode);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_set_noise_reduction (GstPhotography * photo,
|
|
GstPhotographyNoiseReduction noise_reduction);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_set_zoom (GstPhotography * photo, gfloat zoom);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_set_flicker_mode (GstPhotography * photo,
|
|
GstPhotographyFlickerReductionMode mode);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_set_focus_mode (GstPhotography * photo,
|
|
GstPhotographyFocusMode mode);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
GstPhotographyCaps gst_photography_get_capabilities (GstPhotography * photo);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_prepare_for_capture (GstPhotography * photo,
|
|
GstPhotographyCapturePrepared func,
|
|
GstCaps *capture_caps,
|
|
gpointer user_data);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_set_config (GstPhotography * photo,
|
|
GstPhotographySettings * config);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
gboolean gst_photography_get_config (GstPhotography * photo,
|
|
GstPhotographySettings * config);
|
|
|
|
GST_PHOTOGRAPHY_API
|
|
void gst_photography_set_autofocus (GstPhotography * photo, gboolean on);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GST_PHOTOGRAPHY_H__ */
|