3dphotoshoot
view src/android/native_glue.h @ 1:7eb73ce46dd0
fucking jni man ... wtf
| author | John Tsiombikas <nuclear@member.fsf.org> |
|---|---|
| date | Thu, 14 May 2015 23:46:56 +0300 |
| parents | src/android/android_native_app_glue.h@a4bf2687e406 |
| children | cf5964db7ff3 |
line source
1 /*
2 * Copyright (C) 2010 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 *
16 */
18 #ifndef _ANDROID_NATIVE_APP_GLUE_H
19 #define _ANDROID_NATIVE_APP_GLUE_H
21 #include <poll.h>
22 #include <pthread.h>
23 #include <sched.h>
25 #include <android/configuration.h>
26 #include <android/looper.h>
27 #include <android/native_activity.h>
29 #ifdef __cplusplus
30 extern "C" {
31 #endif
33 /**
34 * The native activity interface provided by <android/native_activity.h>
35 * is based on a set of application-provided callbacks that will be called
36 * by the Activity's main thread when certain events occur.
37 *
38 * This means that each one of this callbacks _should_ _not_ block, or they
39 * risk having the system force-close the application. This programming
40 * model is direct, lightweight, but constraining.
41 *
42 * The 'android_native_app_glue' static library is used to provide a different
43 * execution model where the application can implement its own main event
44 * loop in a different thread instead. Here's how it works:
45 *
46 * 1/ The application must provide a function named "android_main()" that
47 * will be called when the activity is created, in a new thread that is
48 * distinct from the activity's main thread.
49 *
50 * 2/ android_main() receives a pointer to a valid "android_app" structure
51 * that contains references to other important objects, e.g. the
52 * ANativeActivity obejct instance the application is running in.
53 *
54 * 3/ the "android_app" object holds an ALooper instance that already
55 * listens to two important things:
56 *
57 * - activity lifecycle events (e.g. "pause", "resume"). See APP_CMD_XXX
58 * declarations below.
59 *
60 * - input events coming from the AInputQueue attached to the activity.
61 *
62 * Each of these correspond to an ALooper identifier returned by
63 * ALooper_pollOnce with values of LOOPER_ID_MAIN and LOOPER_ID_INPUT,
64 * respectively.
65 *
66 * Your application can use the same ALooper to listen to additional
67 * file-descriptors. They can either be callback based, or with return
68 * identifiers starting with LOOPER_ID_USER.
69 *
70 * 4/ Whenever you receive a LOOPER_ID_MAIN or LOOPER_ID_INPUT event,
71 * the returned data will point to an android_poll_source structure. You
72 * can call the process() function on it, and fill in android_app->onAppCmd
73 * and android_app->onInputEvent to be called for your own processing
74 * of the event.
75 *
76 * Alternatively, you can call the low-level functions to read and process
77 * the data directly... look at the process_cmd() and process_input()
78 * implementations in the glue to see how to do this.
79 *
80 * See the sample named "native-activity" that comes with the NDK with a
81 * full usage example. Also look at the JavaDoc of NativeActivity.
82 */
84 struct android_app;
86 /**
87 * Data associated with an ALooper fd that will be returned as the "outData"
88 * when that source has data ready.
89 */
90 struct android_poll_source {
91 // The identifier of this source. May be LOOPER_ID_MAIN or
92 // LOOPER_ID_INPUT.
93 int32_t id;
95 // The android_app this ident is associated with.
96 struct android_app* app;
98 // Function to call to perform the standard processing of data from
99 // this source.
100 void (*process)(struct android_app* app, struct android_poll_source* source);
101 };
103 /**
104 * This is the interface for the standard glue code of a threaded
105 * application. In this model, the application's code is running
106 * in its own thread separate from the main thread of the process.
107 * It is not required that this thread be associated with the Java
108 * VM, although it will need to be in order to make JNI calls any
109 * Java objects.
110 */
111 struct android_app {
112 // The application can place a pointer to its own state object
113 // here if it likes.
114 void* userData;
116 // Fill this in with the function to process main app commands (APP_CMD_*)
117 void (*onAppCmd)(struct android_app* app, int32_t cmd);
119 // Fill this in with the function to process input events. At this point
120 // the event has already been pre-dispatched, and it will be finished upon
121 // return. Return 1 if you have handled the event, 0 for any default
122 // dispatching.
123 int32_t (*onInputEvent)(struct android_app* app, AInputEvent* event);
125 // The ANativeActivity object instance that this app is running in.
126 ANativeActivity* activity;
128 // The current configuration the app is running in.
129 AConfiguration* config;
131 // This is the last instance's saved state, as provided at creation time.
132 // It is NULL if there was no state. You can use this as you need; the
133 // memory will remain around until you call android_app_exec_cmd() for
134 // APP_CMD_RESUME, at which point it will be freed and savedState set to NULL.
135 // These variables should only be changed when processing a APP_CMD_SAVE_STATE,
136 // at which point they will be initialized to NULL and you can malloc your
137 // state and place the information here. In that case the memory will be
138 // freed for you later.
139 void* savedState;
140 size_t savedStateSize;
142 // The ALooper associated with the app's thread.
143 ALooper* looper;
145 // When non-NULL, this is the input queue from which the app will
146 // receive user input events.
147 AInputQueue* inputQueue;
149 // When non-NULL, this is the window surface that the app can draw in.
150 ANativeWindow* window;
152 // Current content rectangle of the window; this is the area where the
153 // window's content should be placed to be seen by the user.
154 ARect contentRect;
156 // Current state of the app's activity. May be either APP_CMD_START,
157 // APP_CMD_RESUME, APP_CMD_PAUSE, or APP_CMD_STOP; see below.
158 int activityState;
160 // This is non-zero when the application's NativeActivity is being
161 // destroyed and waiting for the app thread to complete.
162 int destroyRequested;
164 // -------------------------------------------------
165 // Below are "private" implementation of the glue code.
167 pthread_mutex_t mutex;
168 pthread_cond_t cond;
170 int msgread;
171 int msgwrite;
173 pthread_t thread;
175 struct android_poll_source cmdPollSource;
176 struct android_poll_source inputPollSource;
178 int running;
179 int stateSaved;
180 int destroyed;
181 int redrawNeeded;
182 AInputQueue* pendingInputQueue;
183 ANativeWindow* pendingWindow;
184 ARect pendingContentRect;
186 // MainActivity class
187 jclass activity_class;
188 };
190 enum {
191 /**
192 * Looper data ID of commands coming from the app's main thread, which
193 * is returned as an identifier from ALooper_pollOnce(). The data for this
194 * identifier is a pointer to an android_poll_source structure.
195 * These can be retrieved and processed with android_app_read_cmd()
196 * and android_app_exec_cmd().
197 */
198 LOOPER_ID_MAIN = 1,
200 /**
201 * Looper data ID of events coming from the AInputQueue of the
202 * application's window, which is returned as an identifier from
203 * ALooper_pollOnce(). The data for this identifier is a pointer to an
204 * android_poll_source structure. These can be read via the inputQueue
205 * object of android_app.
206 */
207 LOOPER_ID_INPUT = 2,
209 /**
210 * Start of user-defined ALooper identifiers.
211 */
212 LOOPER_ID_USER = 3,
213 };
215 enum {
216 /**
217 * Command from main thread: the AInputQueue has changed. Upon processing
218 * this command, android_app->inputQueue will be updated to the new queue
219 * (or NULL).
220 */
221 APP_CMD_INPUT_CHANGED,
223 /**
224 * Command from main thread: a new ANativeWindow is ready for use. Upon
225 * receiving this command, android_app->window will contain the new window
226 * surface.
227 */
228 APP_CMD_INIT_WINDOW,
230 /**
231 * Command from main thread: the existing ANativeWindow needs to be
232 * terminated. Upon receiving this command, android_app->window still
233 * contains the existing window; after calling android_app_exec_cmd
234 * it will be set to NULL.
235 */
236 APP_CMD_TERM_WINDOW,
238 /**
239 * Command from main thread: the current ANativeWindow has been resized.
240 * Please redraw with its new size.
241 */
242 APP_CMD_WINDOW_RESIZED,
244 /**
245 * Command from main thread: the system needs that the current ANativeWindow
246 * be redrawn. You should redraw the window before handing this to
247 * android_app_exec_cmd() in order to avoid transient drawing glitches.
248 */
249 APP_CMD_WINDOW_REDRAW_NEEDED,
251 /**
252 * Command from main thread: the content area of the window has changed,
253 * such as from the soft input window being shown or hidden. You can
254 * find the new content rect in android_app::contentRect.
255 */
256 APP_CMD_CONTENT_RECT_CHANGED,
258 /**
259 * Command from main thread: the app's activity window has gained
260 * input focus.
261 */
262 APP_CMD_GAINED_FOCUS,
264 /**
265 * Command from main thread: the app's activity window has lost
266 * input focus.
267 */
268 APP_CMD_LOST_FOCUS,
270 /**
271 * Command from main thread: the current device configuration has changed.
272 */
273 APP_CMD_CONFIG_CHANGED,
275 /**
276 * Command from main thread: the system is running low on memory.
277 * Try to reduce your memory use.
278 */
279 APP_CMD_LOW_MEMORY,
281 /**
282 * Command from main thread: the app's activity has been started.
283 */
284 APP_CMD_START,
286 /**
287 * Command from main thread: the app's activity has been resumed.
288 */
289 APP_CMD_RESUME,
291 /**
292 * Command from main thread: the app should generate a new saved state
293 * for itself, to restore from later if needed. If you have saved state,
294 * allocate it with malloc and place it in android_app.savedState with
295 * the size in android_app.savedStateSize. The will be freed for you
296 * later.
297 */
298 APP_CMD_SAVE_STATE,
300 /**
301 * Command from main thread: the app's activity has been paused.
302 */
303 APP_CMD_PAUSE,
305 /**
306 * Command from main thread: the app's activity has been stopped.
307 */
308 APP_CMD_STOP,
310 /**
311 * Command from main thread: the app's activity is being destroyed,
312 * and waiting for the app thread to clean up and exit before proceeding.
313 */
314 APP_CMD_DESTROY,
315 };
317 /**
318 * Call when ALooper_pollAll() returns LOOPER_ID_MAIN, reading the next
319 * app command message.
320 */
321 int8_t android_app_read_cmd(struct android_app* android_app);
323 /**
324 * Call with the command returned by android_app_read_cmd() to do the
325 * initial pre-processing of the given command. You can perform your own
326 * actions for the command after calling this function.
327 */
328 void android_app_pre_exec_cmd(struct android_app* android_app, int8_t cmd);
330 /**
331 * Call with the command returned by android_app_read_cmd() to do the
332 * final post-processing of the given command. You must have done your own
333 * actions for the command before calling this function.
334 */
335 void android_app_post_exec_cmd(struct android_app* android_app, int8_t cmd);
337 /**
338 * Dummy function you can call to ensure glue code isn't stripped.
339 */
340 void app_dummy();
342 /**
343 * This is the function that application code must implement, representing
344 * the main entry to the app.
345 */
346 extern void android_main(struct android_app* app);
348 #ifdef __cplusplus
349 }
350 #endif
352 #endif /* _ANDROID_NATIVE_APP_GLUE_H */