## GstPhotography

GstPhotography — Interface for digital image capture elements

## Stability Level

Unstable, unless otherwise indicated

## Functions

void | (*GstPhotographyCapturePrepared) ()
gboolean | gst_photography_get_ev_compensation ()
gboolean | gst_photography_get_iso_speed ()
gboolean | gst_photography_get_aperture ()
gboolean | gst_photography_get_exposure ()
gboolean | gst_photography_get_white_balance_mode ()
gboolean | gst_photography_get_color_tone_mode ()
gboolean | gst_photography_get_scene_mode ()
gboolean | gst_photography_get_flash_mode ()
gboolean | gst_photography_get_flicker_mode ()
gboolean | gst_photography_get_focus_mode ()
gboolean | gst_photography_get_noise_reduction ()
gboolean | gst_photography_get_zoom ()
gboolean | gst_photography_set_ev_compensation ()
gboolean | gst_photography_set_iso_speed ()
gboolean | gst_photography_set_aperture ()
gboolean | gst_photography_set_exposure ()
gboolean | gst_photography_set_white_balance_mode ()
gboolean | gst_photography_set_color_tone_mode ()
gboolean | gst_photography_set_scene_mode ()
gboolean | gst_photography_set_flash_mode ()
gboolean | gst_photography_set_flicker_mode ()
gboolean | gst_photography_set_focus_mode ()
gboolean | gst_photography_set_noise_reduction ()
gboolean | gst_photography_set_zoom ()
GstPhotographyCaps | gst_photography_get_capabilities ()
gboolean | gst_photography_prepare_for_capture ()
void | gst_photography_set_autofocus ()
gboolean | gst_photography_set_config ()
gboolean | gst_photography_get_config ()

## Types and Values

| GstPhotography
enum | GstPhotographyNoiseReduction
enum | GstPhotographyWhiteBalanceMode
enum | GstPhotographyColorToneMode
enum | GstPhotographySceneMode
enum | GstPhotographyFlashMode
enum | GstPhotographyFlickerReductionMode
enum | GstPhotographyFocusMode
enum | GstPhotographyFocusStatus
enum | GstPhotographyCaps
enum | GstPhotographyShakeRisk
#define | GST_PHOTOGRAPHY_AUTOFOCUS_DONE
#define | GST_PHOTOGRAPHY_SHAKE_RISK
#define | GST_PHOTOGRAPHY_PROP_WB_MODE
#define | GST_PHOTOGRAPHY_PROP_SCENE_MODE
#define | GST_PHOTOGRAPHY_PROP_FLASH_MODE
#define | GST_PHOTOGRAPHY_PROP_NOISE_REDUCTION
#define | GST_PHOTOGRAPHY_PROP_FOCUS_STATUS
#define | GST_PHOTOGRAPHY_PROP_CAPABILITIES
#define | GST_PHOTOGRAPHY_PROP_SHAKE_RISK
#define | GST_PHOTOGRAPHY_PROP_EV_COMP
#define | GST_PHOTOGRAPHY_PROP_ISO_SPEED
#define | GST_PHOTOGRAPHY_PROP_APERTURE
#define | GST_PHOTOGRAPHY_PROP_IMAGE_CAPTURE_SUPPORTED_CAPS
#define | GST_PHOTOGRAPHY_PROP_IMAGE_PREVIEW_SUPPORTED_CAPS
#define | GST_PHOTOGRAPHY_PROP_FLICKER_MODE
#define | GST_PHOTOGRAPHY_PROP_FOCUS_MODE
#define | GST_PHOTOGRAPHY_PROP_ZOOM

## Includes

    #include <gst/codecparsers/gstmpeg4parser.h>

## Description

The interface allows access to some common digital image capture parameters.

The GstPhotography interface is unstable API and may change in future. One can define GST_USE_UNSTABLE_API to acknowledge and avoid this warning.

## Functions

### GstPhotographyCapturePrepared ()

    void
    (*GstPhotographyCapturePrepared) (gpointer data,
                                      const GstCaps *configured_caps);

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.

#### Parameters

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. |

### gst_photography_get_ev_compensation ()

    gboolean
    gst_photography_get_ev_compensation (GstPhotography *photo,
                                         gfloat *ev_comp);

Get the ev compensation value for the GstElement

#### Parameters

photo | GstPhotography interface of a GstElement |
ev_comp | ev compensation value to get |

#### Returns

`TRUE` if getting the value succeeded, `FALSE` otherwise

### gst_photography_get_iso_speed ()

    gboolean
    gst_photography_get_iso_speed (GstPhotography *photo,
                                   guint *iso_speed);

Get the ISO value (light sensivity) for the GstElement

#### Parameters

photo | GstPhotography interface of a GstElement |
iso_speed | ISO speed value to get |

#### Returns

`TRUE` if getting the value succeeded, `FALSE` otherwise

### gst_photography_get_aperture ()

    gboolean
    gst_photography_get_aperture (GstPhotography *photo,
                                  guint *aperture);

Get the aperture value for the GstElement

#### Parameters

photo | GstPhotography interface of a GstElement |
aperture | aperture value to get |

#### Returns

`TRUE` if getting the value succeeded, `FALSE` otherwise

### gst_photography_get_exposure ()

    gboolean
    gst_photography_get_exposure (GstPhotography *photo,
                                  guint32 *exposure);

Get the fixed exposure time (in us) for the GstElement

#### Parameters

photo | GstPhotography interface of a GstElement |
exposure | exposure time to get |

#### Returns

`TRUE` if getting the value succeeded, `FALSE` otherwise

### gst_photography_get_white_balance_mode ()

    gboolean
    gst_photography_get_white_balance_mode
                                   (GstPhotography *photo,
                                    GstPhotographyWhiteBalanceMode *wb_mode);

Get the white balance mode for the GstElement

#### Parameters

photo | GstPhotography interface of a GstElement |
wb_mode | GstPhotographyWhiteBalanceMode to get |

#### Returns

`TRUE` if getting the value succeeded, `FALSE` otherwise

### gst_photography_get_color_tone_mode ()

    gboolean
    gst_photography_get_color_tone_mode (GstPhotography *photo,
                                         GstPhotographyColorToneMode *tone_mode);

Get the color tone mode for the GstElement

#### Parameters

photo | GstPhotography interface of a GstElement |
tone_mode | GstPhotographyColorToneMode to get |

#### Returns

`TRUE` if getting the value succeeded, `FALSE` otherwise

### gst_photography_get_scene_mode ()

    gboolean
    gst_photography_get_scene_mode (GstPhotography *photo,
                                    GstPhotographySceneMode *scene_mode);

Get the scene mode for the GstElement

#### Parameters

photo | GstPhotography interface of a GstElement |
scene_mode | GstPhotographySceneMode to get |

#### Returns

`TRUE` if getting the value succeeded, `FALSE` otherwise

### gst_photography_get_flash_mode ()

    gboolean
    gst_photography_get_flash_mode (GstPhotography *photo,
                                    GstPhotographyFlashMode *flash_mode);

Get the flash mode for the GstElement

#### Parameters

photo | GstPhotography interface of a GstElement |
flash_mode | GstPhotographyFlashMode to get |

#### Returns

`TRUE` if getting the value succeeded, `FALSE` otherwise

### gst_photography_get_flicker_mode ()

    gboolean
    gst_photography_get_flicker_mode (GstPhotography *photo,
                                      GstPhotographyFlickerReductionMode *mode);

Get the flicker mode value for the GstElement

#### Parameters

photo | GstPhotography interface of a GstElement |
flicker_mode | flicker mode value to get |

#### Returns

`TRUE` if getting the value succeeded, `FALSE` otherwise

### gst_photography_get_focus_mode ()

    gboolean
    gst_photography_get_focus_mode (GstPhotography *photo,
                                    GstPhotographyFocusMode *mode);

Get the focus mode value for the GstElement

#### Parameters

photo | GstPhotography interface of a GstElement |
focus_mode | focus_mode value to get |

#### Returns

`TRUE` if getting the value succeeded, `FALSE` otherwise

### gst_photography_get_noise_reduction ()

    gboolean
    gst_photography_get_noise_reduction (GstPhotography *photo,
                                         GstPhotographyNoiseReduction *noise_reduction);

Get the noise reduction mode for the GstElement

#### Parameters

photo | GstPhotography interface of a GstElement |
noise_reduction | GstPhotographyNoiseReductionMode to get |

#### Returns

`TRUE` if getting the value succeeded, `FALSE` otherwise

### gst_photography_get_zoom ()

    gboolean
    gst_photography_get_zoom (GstPhotography *photo,
                              gfloat *zoom);

Get the zoom value for the GstElement

#### Parameters

photo | GstPhotography interface of a GstElement |
zoom | zoom value to get |

#### Returns

`TRUE` if getting the value succeeded, `FALSE` otherwise

### gst_photography_set_ev_compensation ()

    gboolean
    gst_photography_set_ev_compensation (GstPhotography *photo,
                                         gfloat ev_comp);

Set the ev compensation value for the GstElement

#### Parameters

photo | GstPhotography interface of a GstElement |
ev_comp | ev compensation value to set |

#### Returns

`TRUE` if setting the value succeeded, `FALSE` otherwise

### gst_photography_set_iso_speed ()

    gboolean
    gst_photography_set_iso_speed (GstPhotography *photo,
                                   guint iso_speed);

Set the ISO value (light sensivity) for the GstElement

#### Parameters

photo | GstPhotography interface of a GstElement |
iso_speed | ISO speed value to set |

#### Returns

`TRUE` if setting the value succeeded, `FALSE` otherwise

### gst_photography_set_aperture ()

    gboolean
    gst_photography_set_aperture (GstPhotography *photo,
                                  guint aperture);

Set the aperture value for the GstElement

#### Parameters

photo | GstPhotography interface of a GstElement |
aperture | aperture value to set |

#### Returns

`TRUE` if setting the value succeeded, `FALSE` otherwise

### gst_photography_set_exposure ()

    gboolean
    gst_photography_set_exposure (GstPhotography *photo,
                                  guint exposure);

Set the fixed exposure time (in us) for the GstElement

#### Parameters

photo | GstPhotography interface of a GstElement |
exposure | exposure time to set |

#### Returns

`TRUE` if setting the value succeeded, `FALSE` otherwise

### gst_photography_set_white_balance_mode ()

    gboolean
    gst_photography_set_white_balance_mode
                                   (GstPhotography *photo,
                                    GstPhotographyWhiteBalanceMode wb_mode);

Set the white balance mode for the GstElement

#### Parameters

photo | GstPhotography interface of a GstElement |
wb_mode | GstPhotographyWhiteBalanceMode to set |

#### Returns

`TRUE` if setting the value succeeded, `FALSE` otherwise

### gst_photography_set_color_tone_mode ()

    gboolean
    gst_photography_set_color_tone_mode (GstPhotography *photo,
                                         GstPhotographyColorToneMode tone_mode);

Set the color tone mode for the GstElement

#### Parameters

photo | GstPhotography interface of a GstElement |
tone_mode | GstPhotographyColorToneMode to set |

#### Returns

`TRUE` if setting the value succeeded, `FALSE` otherwise

### gst_photography_set_scene_mode ()

    gboolean
    gst_photography_set_scene_mode (GstPhotography *photo,
                                    GstPhotographySceneMode scene_mode);

Set the scene mode for the GstElement

#### Parameters

photo | GstPhotography interface of a GstElement |
scene_mode | GstPhotographySceneMode to set |

#### Returns

`TRUE` if setting the value succeeded, `FALSE` otherwise

### gst_photography_set_flash_mode ()

    gboolean
    gst_photography_set_flash_mode (GstPhotography *photo,
                                    GstPhotographyFlashMode flash_mode);

Set the flash mode for the GstElement

#### Parameters

photo | GstPhotography interface of a GstElement |
flash_mode | GstPhotographyFlashMode to set |

#### Returns

`TRUE` if setting the value succeeded, `FALSE` otherwise

### gst_photography_set_flicker_mode ()

    gboolean
    gst_photography_set_flicker_mode (GstPhotography *photo,
                                      GstPhotographyFlickerReductionMode mode);

Set the flicker mode value for the GstElement.

#### Parameters

photo | GstPhotography interface of a GstElement |
flicker_mode | flicker mode value to set |

#### Returns

`TRUE` if setting the value succeeded, `FALSE` otherwise

### gst_photography_set_focus_mode ()

    gboolean
    gst_photography_set_focus_mode (GstPhotography *photo,
                                    GstPhotographyFocusMode mode);

Set the focus mode value for the GstElement.

#### Parameters

photo | GstPhotography interface of a GstElement |
focus_mode | focus mode value to set |

#### Returns

`TRUE` if setting the value succeeded, `FALSE` otherwise

### gst_photography_set_noise_reduction ()

    gboolean
    gst_photography_set_noise_reduction (GstPhotography *photo,
                                         GstPhotographyNoiseReduction noise_reduction);

Set the noise reduction mode for the GstElement

#### Parameters

photo | GstPhotography interface of a GstElement |
noise_reduction | GstPhotographyNoiseReductionMode to set |

#### Returns

`TRUE` if setting the value succeeded, `FALSE` otherwise

### gst_photography_set_zoom ()

    gboolean
    gst_photography_set_zoom (GstPhotography *photo,
                              gfloat zoom);

Set the zoom value for the GstElement. E.g. 1.0 to get original image and 3.0 for 3x zoom and so on.

#### Parameters

photo | GstPhotography interface of a GstElement |
zoom | zoom value to set |

#### Returns

`TRUE` if setting the value succeeded, `FALSE` otherwise

### gst_photography_get_capabilities ()

    GstPhotographyCaps
    gst_photography_get_capabilities (GstPhotography *photo);

Get GstPhotographyCaps bitmask value that indicates what photography interface features the GstElement supports

#### Parameters

photo | GstPhotography interface of a GstElement |

#### Returns

GstPhotographyCaps value

### gst_photography_prepare_for_capture ()

    gboolean
    gst_photography_prepare_for_capture (GstPhotography *photo,
                                         GstPhotographyCapturePrepared func,
                                         GstCaps *capture_caps,
                                         gpointer user_data);

Start preparations for capture. Preparations can take indeterminate amount of time and `func` callback is called after preparations are done. Image capture will begin after callback returns.

#### Parameters

photo | GstPhotography interface of a GstElement |
func | callback that is called after capturing has been prepared |
capture_caps | GstCaps defining the desired format of the captured image |
user_data | user data that will be passed to the callback `func` |

#### Returns

`TRUE` if preparations were started (caps were OK), otherwise `FALSE`.

### gst_photography_set_autofocus ()

    void
    gst_photography_set_autofocus (GstPhotography *photo,
                                   gboolean on);

Start or stop autofocusing. `GST_PHOTOGRAPHY_AUTOFOCUS_DONE` message is posted to bus when autofocusing has finished.

#### Parameters

photo | GstPhotography interface of a GstElement |
on | `TRUE` to start autofocusing, `FALSE` to stop autofocusing |

### gst_photography_set_config ()

    gboolean
    gst_photography_set_config (GstPhotography *photo,
                                GstPhotographySettings *config);

Set all configuration settings at once.

#### Parameters

photo | GstPhotography interface of a GstElement |
config | GstPhotographySettings containg the configuration |

#### Returns

TRUE if configuration was set successfully, otherwise FALSE.

### gst_photography_get_config ()

    gboolean
    gst_photography_get_config (GstPhotography *photo,
                                GstPhotographySettings *config);

Get all configuration settings at once.

#### Parameters

photo | GstPhotography interface of a GstElement |
config | GstPhotographySettings containg the configuration |

#### Returns

TRUE if configuration was got successfully, otherwise FALSE.

## Types and Values

### GstPhotography

    typedef struct _GstPhotography GstPhotography;

Opaque GstPhotography data structure.

### enum GstPhotographyNoiseReduction

Noise Reduction features of a photography capture or filter element.

#### Members

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. |

### enum GstPhotographyWhiteBalanceMode

Modes for white balance control.

#### Members

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) |

### enum GstPhotographyColorToneMode

Modes for special color effects.

#### Members

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) |

### enum GstPhotographySceneMode

Each mode contains preset GstPhotography options in order to produce good capturing result in certain scene.

#### Members

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) |

### enum GstPhotographyFlashMode

Modes for flash control.

#### Members

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 |

### enum GstPhotographyFlickerReductionMode

Reduce flicker in video caused by light source fluctuation.

#### Members

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 |

### enum GstPhotographyFocusMode

Choose mode for focusing algorithm.

#### Members

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. “lens-focus” property can be used to change focus manually. |

### enum GstPhotographyFocusStatus

Status of the focusing operation, used in GST_PHOTOGRAPHY_AUTOFOCUS_DONE message.

#### Members

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 |

### enum GstPhotographyCaps

Bitmask that indicates which GstPhotography interface features an instance supports.

#### Members

GST_PHOTOGRAPHY_CAPS_NONE |  |
GST_PHOTOGRAPHY_CAPS_EV_COMP |  |
GST_PHOTOGRAPHY_CAPS_ISO_SPEED |  |
GST_PHOTOGRAPHY_CAPS_WB_MODE |  |
GST_PHOTOGRAPHY_CAPS_TONE |  |
GST_PHOTOGRAPHY_CAPS_SCENE |  |
GST_PHOTOGRAPHY_CAPS_FLASH |  |
GST_PHOTOGRAPHY_CAPS_ZOOM |  |
GST_PHOTOGRAPHY_CAPS_FOCUS |  |
GST_PHOTOGRAPHY_CAPS_APERTURE |  |
GST_PHOTOGRAPHY_CAPS_EXPOSURE |  |
GST_PHOTOGRAPHY_CAPS_SHAKE |  |
GST_PHOTOGRAPHY_CAPS_WHITE_BALANCE |  |
GST_PHOTOGRAPHY_CAPS_NOISE_REDUCTION |  |
GST_PHOTOGRAPHY_CAPS_FLICKER_REDUCTION |  |
GST_PHOTOGRAPHY_CAPS_ALL |  |

### enum GstPhotographyShakeRisk

Risk level of captured image becoming "shaken" due to camera movement and too long exposure time. Used in GST_PHOTOGRAPHY_SHAKE_RISK GstMessage.

#### Members

GST_PHOTOGRAPHY_SHAKE_RISK_LOW | Low risk |
GST_PHOTOGRAPHY_SHAKE_RISK_MEDIUM | Medium risk |
GST_PHOTOGRAPHY_SHAKE_RISK_HIGH | High risk |

### GST_PHOTOGRAPHY_AUTOFOCUS_DONE

    #define GST_PHOTOGRAPHY_AUTOFOCUS_DONE "autofocus-done"

Name of custom GstMessage that will be posted to GstBus when autofocusing is complete. This message contains following fields:

- GstPhotographyFocusStatus `"status"`: Tells if focusing succeeded or failed.

- G_TYPE_INT `"focus-window-rows"`: Tells number of focus matrix rows.

- G_TYPE_INT `"focus-window-columns"`: Tells number of focus matrix columns.

- G_TYPE_INT `"focus-window-mask"`: 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.

### GST_PHOTOGRAPHY_SHAKE_RISK

    #define GST_PHOTOGRAPHY_SHAKE_RISK "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:

- GstPhotographyShakeRisk `"status"`: Tells risk level of capturing shaken image.

### GST_PHOTOGRAPHY_PROP_WB_MODE

    #define GST_PHOTOGRAPHY_PROP_WB_MODE            "white-balance-mode"

### GST_PHOTOGRAPHY_PROP_SCENE_MODE

    #define GST_PHOTOGRAPHY_PROP_SCENE_MODE         "scene-mode"

### GST_PHOTOGRAPHY_PROP_FLASH_MODE

    #define GST_PHOTOGRAPHY_PROP_FLASH_MODE         "flash-mode"

### GST_PHOTOGRAPHY_PROP_NOISE_REDUCTION

    #define GST_PHOTOGRAPHY_PROP_NOISE_REDUCTION    "noise-reduction"

### GST_PHOTOGRAPHY_PROP_FOCUS_STATUS

    #define GST_PHOTOGRAPHY_PROP_FOCUS_STATUS       "focus-status"

### GST_PHOTOGRAPHY_PROP_CAPABILITIES

    #define GST_PHOTOGRAPHY_PROP_CAPABILITIES       "capabilities"

### GST_PHOTOGRAPHY_PROP_SHAKE_RISK

    #define GST_PHOTOGRAPHY_PROP_SHAKE_RISK         "shake-risk"

### GST_PHOTOGRAPHY_PROP_EV_COMP

    #define GST_PHOTOGRAPHY_PROP_EV_COMP            "ev-compensation"

### GST_PHOTOGRAPHY_PROP_ISO_SPEED

    #define GST_PHOTOGRAPHY_PROP_ISO_SPEED          "iso-speed"

### GST_PHOTOGRAPHY_PROP_APERTURE

    #define GST_PHOTOGRAPHY_PROP_APERTURE           "aperture"

### GST_PHOTOGRAPHY_PROP_IMAGE_CAPTURE_SUPPORTED_CAPS

    #define             GST_PHOTOGRAPHY_PROP_IMAGE_CAPTURE_SUPPORTED_CAPS

### GST_PHOTOGRAPHY_PROP_IMAGE_PREVIEW_SUPPORTED_CAPS

    #define             GST_PHOTOGRAPHY_PROP_IMAGE_PREVIEW_SUPPORTED_CAPS

### GST_PHOTOGRAPHY_PROP_FLICKER_MODE

    #define GST_PHOTOGRAPHY_PROP_FLICKER_MODE       "flicker-mode"

### GST_PHOTOGRAPHY_PROP_FOCUS_MODE

    #define GST_PHOTOGRAPHY_PROP_FOCUS_MODE         "focus-mode"

### GST_PHOTOGRAPHY_PROP_ZOOM

    #define GST_PHOTOGRAPHY_PROP_ZOOM               "zoom"