android_native_app_glue.h

/*
 * Copyright (C) 2010 The Android Open Source Project
 *
 * лицензировано по лицензии Apache License, версия 2.0 ( "Лицензия");
 *этот файл можно использовать только в соответствии с лицензией.
 *Копию лицензии можно получить на веб-сайте
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 *Если только не требуется в соответствии с применимым законодательством или согласовано в письменном виде, программное обеспечение
 * распространяется в рамках лицензии на УСЛОВИЯХ "КАК ЕСТЬ",
 * БЕЗ ГАРАНТИЙ И УСЛОВИЙ ЛЮБОГО РОДА, явно выраженных и подразумеваемых.
 * См. лицензию для получения информации об определенных разрешениях по использованию языка и
 * ограничениях в рамках лицензии.
 *
 */
 
#ifndef _ANDROID_NATIVE_APP_GLUE_H
#define _ANDROID_NATIVE_APP_GLUE_H
 
#include <poll.h>
#include <pthread.h>
#include <sched.h>
 
#include <android/configuration.h>
#include <android/looper.h>
#include <android/native_activity.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
struct android_app;
 
struct android_poll_source {
    // Идентификатор данного источника. Может быть LOOPER_ID_MAIN или
    // LOOPER_ID_INPUT.
    int32_t id;
 
    // android_app, с которым связан данный идентификатор.
    struct android_app* app;
 
    // Функция, вызываемая для стандартной обработки данных из
    // этого источника.
    void (*process)(struct android_app* app, struct android_poll_source* source);
};
 
struct android_app {
    // Приложение может поместить указатель на свой собственный объект состояния
    // здесь, если хочет.
    void* userData;
 
    // Введите здесь код функции для обработки основных команд приложения (APP_CMD_*)
    void (*onAppCmd)(struct android_app* app, int32_t cmd);
 
    // Введите здесь код функции для обработки входных событий. В этот момент
    // событие уже было предварительно отправлено и будет завершено при
    // возврате. Верните 1, если событие обработано, 0 — для любой диспетчеризации
    // по умолчанию.
    int32_t (*onInputEvent)(struct android_app* app, AInputEvent* event);
 
    // Экземпляр объекта ANativeActivity, в котором выполняется это приложение.
    ANativeActivity* activity;
 
    // Текущая конфигурация, в которой выполняется это приложение.
    AConfiguration* config;
 
    // Это последнее сохраненное состояние экземпляра, предоставленное во время создания.
    // Значение равно NULL, если состояния не было. Можно использовать это по мере необходимости;
    // память останется доступной до вызова android_app_exec_cmd() для
    // APP_CMD_RESUME, после чего она будет освобождена, а savedState получит значение NULL.
    // Эти переменные необходимо изменять только при обработке APP_CMD_SAVE_STATE,
    // когда их значения будут инициализироваться в NULL и можно будет выполнить malloc для
    // состояния и поместить здесь информацию. В этом случае память будет
    // освобождена позднее.
    void* savedState;
    size_t savedStateSize;
 
    // ALooper, связанный с потоком приложения.
    ALooper* looper;
 
    // Если значение не равно NULL, то это входная очередь, из которой приложение будет
    // получать входные события пользователя.
    AInputQueue* inputQueue;
 
    // Если значение не равно NULL, то это поверхность окна, в котором приложение может рисовать.
    ANativeWindow* window;
 
    // Текущий прямоугольник содержимого окна. Это область, в которой
    // должно помещаться содержимое окна, чтобы его видел пользователь.
    ARect contentRect;
 
    // Текущее состояние действия приложения. Может быть APP_CMD_START,
    // APP_CMD_RESUME, APP_CMD_PAUSE или APP_CMD_STOP; см. ниже.
    int activityState;
 
    // Значение не равно нулю, когда NativeActivity приложения
    // разрушается и ожидает завершения потока приложения.
    int destroyRequested;
 
    // -------------------------------------------------
    // Ниже показан "частная" реализация кода прилипания.
 
    pthread_mutex_t mutex;
    pthread_cond_t cond;
 
    int msgread;
    int msgwrite;
 
    pthread_t thread;
 
    struct android_poll_source cmdPollSource;
    struct android_poll_source inputPollSource;
 
    int running;
    int stateSaved;
    int destroyed;
    int redrawNeeded;
    AInputQueue* pendingInputQueue;
    ANativeWindow* pendingWindow;
    ARect pendingContentRect;
};
 
enum {
    LOOPER_ID_MAIN = 1,
 
    LOOPER_ID_INPUT = 2,
 
    LOOPER_ID_USER = 3,
};
 
enum {
    APP_CMD_INPUT_CHANGED,
 
    APP_CMD_INIT_WINDOW,
 
    APP_CMD_TERM_WINDOW,
 
    APP_CMD_WINDOW_RESIZED,
 
    APP_CMD_WINDOW_REDRAW_NEEDED,
 
    APP_CMD_CONTENT_RECT_CHANGED,
 
    APP_CMD_GAINED_FOCUS,
 
    APP_CMD_LOST_FOCUS,
 
    APP_CMD_CONFIG_CHANGED,
 
    APP_CMD_LOW_MEMORY,
 
    APP_CMD_START,
 
    APP_CMD_RESUME,
 
    APP_CMD_SAVE_STATE,
 
    APP_CMD_PAUSE,
 
    APP_CMD_STOP,
 
    APP_CMD_DESTROY,
};
 
int8_t android_app_read_cmd(struct android_app* android_app);
 
void android_app_pre_exec_cmd(struct android_app* android_app, int8_t cmd);
 
void android_app_post_exec_cmd(struct android_app* android_app, int8_t cmd);
 
extern void android_main(struct android_app* app);
 
#ifdef __cplusplus
}
#endif
 
#endif /* _ANDROID_NATIVE_APP_GLUE_H */