mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-12-29 11:40:38 +00:00
4d70e1d8ee
Current to b69f807ce59189457662c2144a8e7e12dc776988 No integration of stereoscopic support as yet
220 lines
9.9 KiB
C
220 lines
9.9 KiB
C
/*
|
|
* Copyright (c) 2013-2015 Jan Schmidt <jan@centricular.com>
|
|
Portions:
|
|
Copyright (c) 2013, Broadcom Europe Ltd
|
|
Copyright (c) 2013, James Hughes
|
|
All rights reserved.
|
|
|
|
Redistribution and use in source and binary forms, with or without
|
|
modification, are permitted provided that the following conditions are met:
|
|
* Redistributions of source code must retain the above copyright
|
|
notice, this list of conditions and the following disclaimer.
|
|
* Redistributions in binary form must reproduce the above copyright
|
|
notice, this list of conditions and the following disclaimer in the
|
|
documentation and/or other materials provided with the distribution.
|
|
* Neither the name of the copyright holder nor the
|
|
names of its contributors may be used to endorse or promote products
|
|
derived from this software without specific prior written permission.
|
|
|
|
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
|
|
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY
|
|
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
|
|
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
|
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
#ifndef RASPICAMCONTROL_H_
|
|
#define RASPICAMCONTROL_H_
|
|
|
|
/* Various parameters
|
|
*
|
|
* Exposure Mode
|
|
* MMAL_PARAM_EXPOSUREMODE_OFF,
|
|
MMAL_PARAM_EXPOSUREMODE_AUTO,
|
|
MMAL_PARAM_EXPOSUREMODE_NIGHT,
|
|
MMAL_PARAM_EXPOSUREMODE_NIGHTPREVIEW,
|
|
MMAL_PARAM_EXPOSUREMODE_BACKLIGHT,
|
|
MMAL_PARAM_EXPOSUREMODE_SPOTLIGHT,
|
|
MMAL_PARAM_EXPOSUREMODE_SPORTS,
|
|
MMAL_PARAM_EXPOSUREMODE_SNOW,
|
|
MMAL_PARAM_EXPOSUREMODE_BEACH,
|
|
MMAL_PARAM_EXPOSUREMODE_VERYLONG,
|
|
MMAL_PARAM_EXPOSUREMODE_FIXEDFPS,
|
|
MMAL_PARAM_EXPOSUREMODE_ANTISHAKE,
|
|
MMAL_PARAM_EXPOSUREMODE_FIREWORKS,
|
|
*
|
|
* AWB Mode
|
|
* MMAL_PARAM_AWBMODE_OFF,
|
|
MMAL_PARAM_AWBMODE_AUTO,
|
|
MMAL_PARAM_AWBMODE_SUNLIGHT,
|
|
MMAL_PARAM_AWBMODE_CLOUDY,
|
|
MMAL_PARAM_AWBMODE_SHADE,
|
|
MMAL_PARAM_AWBMODE_TUNGSTEN,
|
|
MMAL_PARAM_AWBMODE_FLUORESCENT,
|
|
MMAL_PARAM_AWBMODE_INCANDESCENT,
|
|
MMAL_PARAM_AWBMODE_FLASH,
|
|
MMAL_PARAM_AWBMODE_HORIZON,
|
|
*
|
|
* Image FX
|
|
MMAL_PARAM_IMAGEFX_NONE,
|
|
MMAL_PARAM_IMAGEFX_NEGATIVE,
|
|
MMAL_PARAM_IMAGEFX_SOLARIZE,
|
|
MMAL_PARAM_IMAGEFX_POSTERIZE,
|
|
MMAL_PARAM_IMAGEFX_WHITEBOARD,
|
|
MMAL_PARAM_IMAGEFX_BLACKBOARD,
|
|
MMAL_PARAM_IMAGEFX_SKETCH,
|
|
MMAL_PARAM_IMAGEFX_DENOISE,
|
|
MMAL_PARAM_IMAGEFX_EMBOSS,
|
|
MMAL_PARAM_IMAGEFX_OILPAINT,
|
|
MMAL_PARAM_IMAGEFX_HATCH,
|
|
MMAL_PARAM_IMAGEFX_GPEN,
|
|
MMAL_PARAM_IMAGEFX_PASTEL,
|
|
MMAL_PARAM_IMAGEFX_WATERCOLOUR,
|
|
MMAL_PARAM_IMAGEFX_FILM,
|
|
MMAL_PARAM_IMAGEFX_BLUR,
|
|
MMAL_PARAM_IMAGEFX_SATURATION,
|
|
MMAL_PARAM_IMAGEFX_COLOURSWAP,
|
|
MMAL_PARAM_IMAGEFX_WASHEDOUT,
|
|
MMAL_PARAM_IMAGEFX_POSTERISE,
|
|
MMAL_PARAM_IMAGEFX_COLOURPOINT,
|
|
MMAL_PARAM_IMAGEFX_COLOURBALANCE,
|
|
MMAL_PARAM_IMAGEFX_CARTOON,
|
|
|
|
*/
|
|
|
|
/// Annotate bitmask options
|
|
/// Supplied by user on command line
|
|
#define ANNOTATE_USER_TEXT 1
|
|
/// Supplied by app using this module
|
|
#define ANNOTATE_APP_TEXT 2
|
|
/// Insert current date
|
|
#define ANNOTATE_DATE_TEXT 4
|
|
// Insert current time
|
|
#define ANNOTATE_TIME_TEXT 8
|
|
|
|
#define ANNOTATE_SHUTTER_SETTINGS 16
|
|
#define ANNOTATE_CAF_SETTINGS 32
|
|
#define ANNOTATE_GAIN_SETTINGS 64
|
|
#define ANNOTATE_LENS_SETTINGS 128
|
|
#define ANNOTATE_MOTION_SETTINGS 256
|
|
#define ANNOTATE_FRAME_NUMBER 512
|
|
#define ANNOTATE_BLACK_BACKGROUND 1024
|
|
|
|
|
|
// There isn't actually a MMAL structure for the following, so make one
|
|
typedef struct
|
|
{
|
|
int enable; /// Turn colourFX on or off
|
|
int u,v; /// U and V to use
|
|
} MMAL_PARAM_COLOURFX_T;
|
|
|
|
typedef struct
|
|
{
|
|
int enable;
|
|
int width,height;
|
|
int quality;
|
|
} MMAL_PARAM_THUMBNAIL_CONFIG_T;
|
|
|
|
typedef struct
|
|
{
|
|
double x;
|
|
double y;
|
|
double w;
|
|
double h;
|
|
} PARAM_FLOAT_RECT_T;
|
|
|
|
/// struct contain camera settings
|
|
typedef struct
|
|
{
|
|
int sharpness; /// -100 to 100
|
|
int contrast; /// -100 to 100
|
|
int brightness; /// 0 to 100
|
|
int saturation; /// -100 to 100
|
|
int ISO; /// TODO : what range?
|
|
int videoStabilisation; /// 0 or 1 (false or true)
|
|
int exposureCompensation; /// -10 to +10 ?
|
|
MMAL_PARAM_EXPOSUREMODE_T exposureMode;
|
|
MMAL_PARAM_EXPOSUREMETERINGMODE_T exposureMeterMode;
|
|
MMAL_PARAM_AWBMODE_T awbMode;
|
|
MMAL_PARAM_IMAGEFX_T imageEffect;
|
|
MMAL_PARAMETER_IMAGEFX_PARAMETERS_T imageEffectsParameters;
|
|
MMAL_PARAM_COLOURFX_T colourEffects;
|
|
int rotation; /// 0-359
|
|
int hflip; /// 0 or 1
|
|
int vflip; /// 0 or 1
|
|
PARAM_FLOAT_RECT_T roi; /// region of interest to use on the sensor. Normalised [0,1] values in the rect
|
|
int shutter_speed; /// 0 = auto, otherwise the shutter speed in ms
|
|
float awb_gains_r; /// AWB red gain
|
|
float awb_gains_b; /// AWB blue gain
|
|
MMAL_PARAMETER_DRC_STRENGTH_T drc_level; // Strength of Dynamic Range compression to apply
|
|
MMAL_BOOL_T stats_pass; /// Stills capture statistics pass on/off
|
|
int enable_annotate; /// Flag to enable the annotate, 0 = disabled, otherwise a bitmask of what needs to be displayed
|
|
char annotate_string[MMAL_CAMERA_ANNOTATE_MAX_TEXT_LEN_V2]; /// String to use for annotate - overrides certain bitmask settings
|
|
int annotate_text_size; // Text size for annotation
|
|
int annotate_text_colour; // Text colour for annotation
|
|
int annotate_bg_colour; // Background colour for annotation
|
|
MMAL_PARAMETER_STEREOSCOPIC_MODE_T stereo_mode;
|
|
} RASPICAM_CAMERA_PARAMETERS;
|
|
|
|
|
|
void raspicamcontrol_check_configuration(int min_gpu_mem);
|
|
|
|
int raspicamcontrol_parse_cmdline(RASPICAM_CAMERA_PARAMETERS *params, const char *arg1, const char *arg2);
|
|
void raspicamcontrol_display_help();
|
|
int raspicamcontrol_cycle_test(MMAL_COMPONENT_T *camera);
|
|
|
|
int raspicamcontrol_set_all_parameters(MMAL_COMPONENT_T *camera, const RASPICAM_CAMERA_PARAMETERS *params);
|
|
int raspicamcontrol_get_all_parameters(MMAL_COMPONENT_T *camera, RASPICAM_CAMERA_PARAMETERS *params);
|
|
void raspicamcontrol_dump_parameters(const RASPICAM_CAMERA_PARAMETERS *params);
|
|
|
|
void raspicamcontrol_set_defaults(RASPICAM_CAMERA_PARAMETERS *params);
|
|
|
|
void raspicamcontrol_check_configuration(int min_gpu_mem);
|
|
void raspicamcontrol_get_camera(int *supported, int *detected);
|
|
|
|
// Individual setting functions
|
|
int raspicamcontrol_set_saturation(MMAL_COMPONENT_T *camera, int saturation);
|
|
int raspicamcontrol_set_sharpness(MMAL_COMPONENT_T *camera, int sharpness);
|
|
int raspicamcontrol_set_contrast(MMAL_COMPONENT_T *camera, int contrast);
|
|
int raspicamcontrol_set_brightness(MMAL_COMPONENT_T *camera, int brightness);
|
|
int raspicamcontrol_set_ISO(MMAL_COMPONENT_T *camera, int ISO);
|
|
int raspicamcontrol_set_metering_mode(MMAL_COMPONENT_T *camera, MMAL_PARAM_EXPOSUREMETERINGMODE_T mode);
|
|
int raspicamcontrol_set_video_stabilisation(MMAL_COMPONENT_T *camera, int vstabilisation);
|
|
int raspicamcontrol_set_exposure_compensation(MMAL_COMPONENT_T *camera, int exp_comp);
|
|
int raspicamcontrol_set_exposure_mode(MMAL_COMPONENT_T *camera, MMAL_PARAM_EXPOSUREMODE_T mode);
|
|
int raspicamcontrol_set_awb_mode(MMAL_COMPONENT_T *camera, MMAL_PARAM_AWBMODE_T awb_mode);
|
|
int raspicamcontrol_set_awb_gains(MMAL_COMPONENT_T *camera, float r_gain, float b_gain);
|
|
int raspicamcontrol_set_imageFX(MMAL_COMPONENT_T *camera, MMAL_PARAM_IMAGEFX_T imageFX);
|
|
int raspicamcontrol_set_colourFX(MMAL_COMPONENT_T *camera, const MMAL_PARAM_COLOURFX_T *colourFX);
|
|
int raspicamcontrol_set_rotation(MMAL_COMPONENT_T *camera, int rotation);
|
|
int raspicamcontrol_set_flips(MMAL_COMPONENT_T *camera, int hflip, int vflip);
|
|
int raspicamcontrol_set_ROI(MMAL_COMPONENT_T *camera, PARAM_FLOAT_RECT_T rect);
|
|
int raspicamcontrol_set_shutter_speed(MMAL_COMPONENT_T *camera, int speed_ms);
|
|
int raspicamcontrol_set_DRC(MMAL_COMPONENT_T *camera, MMAL_PARAMETER_DRC_STRENGTH_T strength);
|
|
int raspicamcontrol_set_stats_pass(MMAL_COMPONENT_T *camera, int stats_pass);
|
|
int raspicamcontrol_set_annotate(MMAL_COMPONENT_T *camera, const int bitmask, const char *string,
|
|
const int text_size, const int text_colour, const int bg_colour);
|
|
int raspicamcontrol_set_stereo_mode(MMAL_PORT_T *port, MMAL_PARAMETER_STEREOSCOPIC_MODE_T *stereo_mode);
|
|
|
|
//Individual getting functions
|
|
int raspicamcontrol_get_saturation(MMAL_COMPONENT_T *camera);
|
|
int raspicamcontrol_get_sharpness(MMAL_COMPONENT_T *camera);
|
|
int raspicamcontrol_get_contrast(MMAL_COMPONENT_T *camera);
|
|
int raspicamcontrol_get_brightness(MMAL_COMPONENT_T *camera);
|
|
int raspicamcontrol_get_ISO(MMAL_COMPONENT_T *camera);
|
|
MMAL_PARAM_EXPOSUREMETERINGMODE_T raspicamcontrol_get_metering_mode(MMAL_COMPONENT_T *camera);
|
|
int raspicamcontrol_get_video_stabilisation(MMAL_COMPONENT_T *camera);
|
|
int raspicamcontrol_get_exposure_compensation(MMAL_COMPONENT_T *camera);
|
|
MMAL_PARAM_THUMBNAIL_CONFIG_T raspicamcontrol_get_thumbnail_parameters(MMAL_COMPONENT_T *camera);
|
|
MMAL_PARAM_EXPOSUREMODE_T raspicamcontrol_get_exposure_mode(MMAL_COMPONENT_T *camera);
|
|
MMAL_PARAM_AWBMODE_T raspicamcontrol_get_awb_mode(MMAL_COMPONENT_T *camera);
|
|
MMAL_PARAM_IMAGEFX_T raspicamcontrol_get_imageFX(MMAL_COMPONENT_T *camera);
|
|
MMAL_PARAM_COLOURFX_T raspicamcontrol_get_colourFX(MMAL_COMPONENT_T *camera);
|
|
|
|
|
|
#endif /* RASPICAMCONTROL_H_ */
|