Geogram  Version 1.9.1-rc
A programming library of geometric algorithms
android_utils.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2000-2022 Inria
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions are met:
7  *
8  * * Redistributions of source code must retain the above copyright notice,
9  * this list of conditions and the following disclaimer.
10  * * Redistributions in binary form must reproduce the above copyright notice,
11  * this list of conditions and the following disclaimer in the documentation
12  * and/or other materials provided with the distribution.
13  * * Neither the name of the ALICE Project-Team nor the names of its
14  * contributors may be used to endorse or promote products derived from this
15  * software without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
18  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
21  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
22  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
23  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
24  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
25  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
26  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
27  * POSSIBILITY OF SUCH DAMAGE.
28  *
29  * Contact: Bruno Levy
30  *
31  * https://www.inria.fr/fr/bruno-levy
32  *
33  * Inria,
34  * Domaine de Voluceau,
35  * 78150 Le Chesnay - Rocquencourt
36  * FRANCE
37  *
38  */
39 
40 #ifndef GEOGRAM_BASIC_ANDROID_UTILS
41 #define GEOGRAM_BASIC_ANDROID_UTILS
42 
43 #include <geogram/basic/common.h>
44 #include <geogram/basic/numeric.h>
45 #include <geogram/basic/argused.h>
46 #include <android/log.h>
47 #include <string>
48 
54 struct android_app;
55 struct AInputEvent;
56 
57 namespace GEO {
58  namespace AndroidUtils {
59 
64  void GEOGRAM_API show_soft_keyboard(android_app* app);
65 
70  void GEOGRAM_API hide_soft_keyboard(android_app* app);
71 
79  android_app* app,
80  Numeric::int32 deviceId,
81  Numeric::int32 keyCode,
82  Numeric::int32 metaState
83  );
84 
94  bool GEOGRAM_API has_permission(android_app* app, const char* perm);
95 
106  void GEOGRAM_API request_permissions(
107  android_app* app, int nb_perms, const char** perms
108  );
109 
116  std::string GEOGRAM_API temp_folder(android_app* app);
117 
125  inline void debug_log(const char* str) {
126  geo_argused(str);
127 #ifdef GEO_DEBUG
128  __android_log_print(
129  ANDROID_LOG_VERBOSE, "GEOGRAM", "DBG: %s", str
130  );
131 #endif
132  }
133 
141  inline void debug_log(const std::string& str) {
142  debug_log(str.c_str());
143  }
144 
152  void GEOGRAM_API debug_show_event(AInputEvent* event);
153 
154  }
155 }
156 #endif
Numeric::int32 keycode_to_unicode(android_app *app, Numeric::int32 deviceId, Numeric::int32 keyCode, Numeric::int32 metaState)
Converts a keycode to a Unicode character.
void debug_show_event(AInputEvent *event)
Displays an android event in the android log in Debug mode, ignored in release mode.
std::string temp_folder(android_app *app)
Gets the path for temporary file.
void show_soft_keyboard(android_app *app)
Shows the software keyboard on the phone.
bool has_permission(android_app *app, const char *perm)
Tests whether a permission is granted.
void debug_log(const char *str)
Displays a message in the android log in Debug mode, ignored in Release mode.
void request_permissions(android_app *app, int nb_perms, const char **perms)
Request permissions.
void hide_soft_keyboard(android_app *app)
Hides the software keyboard on the phone.
A function to suppress unused parameters compilation warnings.
Common include file, providing basic definitions. Should be included before anything else by all head...
int32_t int32
Definition: numeric.h:129
Global Vorpaline namespace.
Definition: basic.h:55
void geo_argused(const T &)
Suppresses compiler warnings about unused parameters.
Definition: argused.h:60
Types and functions for numbers manipulation.