1 /*
2  * Copyright (C) 2012, Collabora Ltd.
3  * Copyright (C) 2012, Cisco Systems, Inc.
4  *   Author: Youness Alaoui <youness.alaoui@collabora.co.uk>
5  *
6  * Copyright (C) 2015, Collabora Ltd.
7  *   Author: Justin Kim <justin.kim@collabora.com>
8  *
9  * This library is free software; you can redistribute it and/or
10  * modify it under the terms of the GNU Lesser General Public
11  * License as published by the Free Software Foundation
12  * version 2.1 of the License.
13  *
14  * This library is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17  * Lesser General Public License for more details.
18  *
19  * You should have received a copy of the GNU Lesser General Public
20  * License along with this library; if not, write to the Free Software
21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301 USA
22  *
23  */
24 
25 #ifndef __GST_ANDROID_HARDWARE_CAMERA_H__
26 #define __GST_ANDROID_HARDWARE_CAMERA_H__
27 
28 #include <gst/gst.h>
29 #include <jni.h>
30 
31 #include "gst-android-graphics-imageformat.h"
32 #include "gstamcsurfacetexture.h"
33 
34 G_BEGIN_DECLS
35 
36 typedef struct _GstAHCamera GstAHCamera;
37 typedef struct _GstAHCCameraInfo GstAHCCameraInfo;
38 typedef struct _GstAHCSize GstAHCSize;
39 typedef struct _GstAHCParameters GstAHCParameters;
40 
41 /* android.hardware.Camera */
42 struct _GstAHCamera
43 {
44   /* < private > */
45   jobject object;               /* global reference */
46 };
47 
48 /* android.hardware.Camera.CameraInfo */
49 struct _GstAHCCameraInfo
50 {
51   gint facing;
52   gint orientation;
53 };
54 extern gint CameraInfo_CAMERA_FACING_BACK;
55 extern gint CameraInfo_CAMERA_FACING_FRONT;
56 
57 /* android.hardware.Camera.Size */
58 struct _GstAHCSize
59 {
60   gint width;
61   gint height;
62 };
63 
64 /* android.hardware.Camera.Parameters */
65 struct _GstAHCParameters
66 {
67   /* < private > */
68   jobject object;               /* global reference */
69 };
70 extern const gchar *Parameters_WHITE_BALANCE_AUTO;
71 extern const gchar *Parameters_WHITE_BALANCE_INCANDESCENT;
72 extern const gchar *Parameters_WHITE_BALANCE_FLUORESCENT;
73 extern const gchar *Parameters_WHITE_BALANCE_WARM_FLUORESCENT;
74 extern const gchar *Parameters_WHITE_BALANCE_DAYLIGHT;
75 extern const gchar *Parameters_WHITE_BALANCE_CLOUDY_DAYLIGHT;
76 extern const gchar *Parameters_WHITE_BALANCE_TWILIGHT;
77 extern const gchar *Parameters_WHITE_BALANCE_SHADE;
78 extern const gchar *Parameters_EFFECT_NONE;
79 extern const gchar *Parameters_EFFECT_MONO;
80 extern const gchar *Parameters_EFFECT_NEGATIVE;
81 extern const gchar *Parameters_EFFECT_SOLARIZE;
82 extern const gchar *Parameters_EFFECT_SEPIA;
83 extern const gchar *Parameters_EFFECT_POSTERIZE;
84 extern const gchar *Parameters_EFFECT_WHITEBOARD;
85 extern const gchar *Parameters_EFFECT_BLACKBOARD;
86 extern const gchar *Parameters_EFFECT_AQUA;
87 extern const gchar *Parameters_ANTIBANDING_AUTO;
88 extern const gchar *Parameters_ANTIBANDING_50HZ;
89 extern const gchar *Parameters_ANTIBANDING_60HZ;
90 extern const gchar *Parameters_ANTIBANDING_OFF;
91 extern const gchar *Parameters_FLASH_MODE_OFF;
92 extern const gchar *Parameters_FLASH_MODE_AUTO;
93 extern const gchar *Parameters_FLASH_MODE_ON;
94 extern const gchar *Parameters_FLASH_MODE_RED_EYE;
95 extern const gchar *Parameters_FLASH_MODE_TORCH;
96 extern const gchar *Parameters_SCENE_MODE_AUTO;
97 extern const gchar *Parameters_SCENE_MODE_ACTION;
98 extern const gchar *Parameters_SCENE_MODE_PORTRAIT;
99 extern const gchar *Parameters_SCENE_MODE_LANDSCAPE;
100 extern const gchar *Parameters_SCENE_MODE_NIGHT;
101 extern const gchar *Parameters_SCENE_MODE_NIGHT_PORTRAIT;
102 extern const gchar *Parameters_SCENE_MODE_THEATRE;
103 extern const gchar *Parameters_SCENE_MODE_BEACH;
104 extern const gchar *Parameters_SCENE_MODE_SNOW;
105 extern const gchar *Parameters_SCENE_MODE_SUNSET;
106 extern const gchar *Parameters_SCENE_MODE_STEADYPHOTO;
107 extern const gchar *Parameters_SCENE_MODE_FIREWORKS;
108 extern const gchar *Parameters_SCENE_MODE_SPORTS;
109 extern const gchar *Parameters_SCENE_MODE_PARTY;
110 extern const gchar *Parameters_SCENE_MODE_CANDLELIGHT;
111 extern const gchar *Parameters_SCENE_MODE_BARCODE;
112 extern const gchar *Parameters_FOCUS_MODE_AUTO;
113 extern const gchar *Parameters_FOCUS_MODE_INFINITY;
114 extern const gchar *Parameters_FOCUS_MODE_MACRO;
115 extern const gchar *Parameters_FOCUS_MODE_FIXED;
116 extern const gchar *Parameters_FOCUS_MODE_EDOF;
117 extern const gchar *Parameters_FOCUS_MODE_CONTINUOUS_VIDEO;
118 extern const gchar *Parameters_FOCUS_MODE_CONTINUOUS_PICTURE;
119 
120 /* android.hardware.Camera.ErrorCallback */
121 typedef void (*GstAHCErrorCallback) (gint error, gpointer user_data);
122 
123 /* android.hardware.Camera.PreviewCallback */
124 typedef void (*GstAHCPreviewCallback) (jbyteArray data, gpointer user_data);
125 
126 /* android.hardware.Camera.AutoFocusCallback */
127 typedef void (*GstAHCAutoFocusCallback) (gboolean success, gpointer user_data);
128 
129 gboolean gst_android_hardware_camera_init (void);
130 void gst_android_hardware_camera_deinit (void);
131 
132 /* android.hardware.Camera */
133 void gst_ah_camera_add_callback_buffer (GstAHCamera * self, jbyteArray buffer);
134 gboolean gst_ah_camera_auto_focus (GstAHCamera * self,
135     GstAHCAutoFocusCallback cb, gpointer user_data);
136 gboolean gst_ah_camera_cancel_auto_focus (GstAHCamera * self);
137 gboolean gst_ah_camera_get_camera_info (gint camera_id,
138     GstAHCCameraInfo * camera_info);
139 gint gst_ah_camera_get_number_of_cameras (void);
140 GstAHCParameters *gst_ah_camera_get_parameters (GstAHCamera * self);
141 gboolean gst_ah_camera_lock (GstAHCamera * self);
142 GstAHCamera *gst_ah_camera_open (gint camera_id);
143 gboolean gst_ah_camera_reconnect (GstAHCamera * self);
144 void gst_ah_camera_release (GstAHCamera * self);
145 void gst_ah_camera_free (GstAHCamera * self);
146 gboolean gst_ah_camera_set_parameters (GstAHCamera * self,
147     GstAHCParameters * params);
148 gboolean gst_ah_camera_set_error_callback (GstAHCamera * self,
149     GstAHCErrorCallback cb, gpointer user_data);
150 gboolean gst_ah_camera_set_preview_callback_with_buffer (GstAHCamera * self,
151     GstAHCPreviewCallback cb, gpointer user_data);
152 void gst_ah_camera_set_preview_texture (GstAHCamera * self,
153     GstAmcSurfaceTexture * surfaceTexture);
154 gboolean gst_ah_camera_start_preview (GstAHCamera * self);
155 gboolean gst_ah_camera_start_smooth_zoom (GstAHCamera * self, gint value);
156 gboolean gst_ah_camera_stop_preview (GstAHCamera * self);
157 gboolean gst_ah_camera_stop_smooth_zoom (GstAHCamera * self);
158 gboolean gst_ah_camera_unlock (GstAHCamera * self);
159 
160 /* android.hardware.Camera.Size */
161 GstAHCSize *gst_ahc_size_new (gint width, gint height);
162 void gst_ahc_size_free (GstAHCSize * self);
163 
164 /* android.hardware.Camera.Parameters */
165 gchar *gst_ahc_parameters_flatten (GstAHCParameters * self);
166 const gchar *gst_ahc_parameters_get_antibanding (GstAHCParameters * self);
167 const gchar *gst_ahc_parameters_get_color_effect (GstAHCParameters * self);
168 gint gst_ahc_parameters_get_exposure_compensation (GstAHCParameters * self);
169 gfloat gst_ahc_parameters_get_exposure_compensation_step (GstAHCParameters
170     * self);
171 const gchar *gst_ahc_parameters_get_flash_mode (GstAHCParameters * self);
172 gfloat gst_ahc_parameters_get_focal_length (GstAHCParameters * self);
173 const gchar *gst_ahc_parameters_get_focus_mode (GstAHCParameters * self);
174 gfloat gst_ahc_parameters_get_horizontal_view_angle (GstAHCParameters * self);
175 gint gst_ahc_parameters_get_max_exposure_compensation (GstAHCParameters * self);
176 gint gst_ahc_parameters_get_max_zoom (GstAHCParameters * self);
177 gint gst_ahc_parameters_get_min_exposure_compensation (GstAHCParameters * self);
178 gint gst_ahc_parameters_get_preview_format (GstAHCParameters * self);
179 gboolean gst_ahc_parameters_get_preview_fps_range (GstAHCParameters * self,
180     gint * min, gint * max);
181 GstAHCSize *gst_ahc_parameters_get_preview_size (GstAHCParameters * self);
182 const gchar *gst_ahc_parameters_get_scene_mode (GstAHCParameters * self);
183 /* GList <const gchar *> */
184 GList *gst_ahc_parameters_get_supported_antibanding (GstAHCParameters * self);
185 void gst_ahc_parameters_supported_antibanding_free (GList * list);
186 /* GList <const gchar *> */
187 GList *gst_ahc_parameters_get_supported_color_effects (GstAHCParameters * self);
188 void gst_ahc_parameters_supported_color_effects_free (GList * list);
189 /* GList <const gchar *> */
190 GList *gst_ahc_parameters_get_supported_flash_modes (GstAHCParameters * self);
191 void gst_ahc_parameters_supported_flash_modes_free (GList * list);
192 /* GList <const gchar *> */
193 GList *gst_ahc_parameters_get_supported_focus_modes (GstAHCParameters * self);
194 void gst_ahc_parameters_supported_focus_modes_free (GList * list);
195 /* GList <int> */
196 GList *gst_ahc_parameters_get_supported_preview_formats (GstAHCParameters
197     * self);
198 void gst_ahc_parameters_supported_preview_formats_free (GList * list);
199 /* GList <int [2]> */
200 GList *gst_ahc_parameters_get_supported_preview_fps_range (GstAHCParameters
201     * self);
202 void gst_ahc_parameters_supported_preview_fps_range_free (GList * list);
203 /* GList <GstAHCSize *> */
204 GList *gst_ahc_parameters_get_supported_preview_sizes (GstAHCParameters * self);
205 void gst_ahc_parameters_supported_preview_sizes_free (GList * list);
206 /* GList <const gchar *> */
207 GList *gst_ahc_parameters_get_supported_scene_modes (GstAHCParameters * self);
208 void gst_ahc_parameters_supported_scene_modes_free (GList * list);
209 /* GList <const gchar *> */
210 GList *gst_ahc_parameters_get_supported_white_balance (GstAHCParameters * self);
211 void gst_ahc_parameters_supported_white_balance_free (GList * list);
212 gfloat gst_ahc_parameters_get_vertical_view_angle (GstAHCParameters * self);
213 gboolean gst_ahc_parameters_get_video_stabilization (GstAHCParameters * self);
214 const gchar *gst_ahc_parameters_get_white_balance (GstAHCParameters * self);
215 gint gst_ahc_parameters_get_zoom (GstAHCParameters * self);
216 /* GList <int> */
217 GList *gst_ahc_parameters_get_zoom_ratios (GstAHCParameters * self);
218 void gst_ahc_parameters_zoom_ratios_free (GList * list);
219 gboolean gst_ahc_parameters_is_smooth_zoom_supported (GstAHCParameters * self);
220 gboolean gst_ahc_parameters_is_video_stabilization_supported (
221     GstAHCParameters * self);
222 gboolean gst_ahc_parameters_is_zoom_supported (GstAHCParameters * self);
223 gboolean gst_ahc_parameters_set_antibanding (GstAHCParameters * self,
224     const gchar * antibanding);
225 gboolean gst_ahc_parameters_set_color_effect (GstAHCParameters * self,
226     const gchar * value);
227 gboolean gst_ahc_parameters_set_exposure_compensation (GstAHCParameters * self,
228     gint value);
229 gboolean gst_ahc_parameters_set_flash_mode (GstAHCParameters * self,
230     const gchar * value);
231 gboolean gst_ahc_parameters_set_focus_mode (GstAHCParameters * self,
232     const gchar * value);
233 gboolean gst_ahc_parameters_set_preview_format (GstAHCParameters * self,
234     gint format);
235 gboolean gst_ahc_parameters_set_preview_fps_range (GstAHCParameters * self,
236     gint min, gint max);
237 gboolean gst_ahc_parameters_set_preview_size (GstAHCParameters * self,
238     gint width, gint height);
239 gboolean gst_ahc_parameters_set_scene_mode (GstAHCParameters * self,
240     const gchar * value);
241 gboolean gst_ahc_parameters_set_white_balance (GstAHCParameters * self,
242     const gchar * value);
243 gboolean gst_ahc_parameters_set_video_stabilization (GstAHCParameters * self,
244     gboolean toggle);
245 gboolean gst_ahc_parameters_set_zoom (GstAHCParameters * self, gint value);
246 gboolean gst_ahc_parameters_unflatten (GstAHCParameters * self,
247     const gchar * flattened);
248 void gst_ahc_parameters_free (GstAHCParameters * self);
249 
250 G_END_DECLS
251 
252 #endif /* __GST_ANDROID_HARDWARE_CAMERA_H__ */
253