Ubuntu Platform API  2.1.0
A library helping with tight integration into the Ubuntu platform
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
orientation.h
Go to the documentation of this file.
1 /*
2  * Copyright © 2014 Canonical Ltd.
3  *
4  * This program is free software: you can redistribute it and/or modify
5  * it under the terms of the GNU Lesser General Public License version 3 as
6  * published by the Free Software Foundation.
7  *
8  * This program is distributed in the hope that it will be useful,
9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11  * GNU Lesser General Public License for more details.
12  *
13  * You should have received a copy of the GNU Lesser General Public License
14  * along with this program. If not, see <http://www.gnu.org/licenses/>.
15  *
16  * Authored by: Ricardo Mendoza <ricardo.mendoza@canonical.com>
17  */
18 
19 #ifndef UBUNTU_APPLICATION_SENSORS_ORIENTATION_H_
20 #define UBUNTU_APPLICATION_SENSORS_ORIENTATION_H_
21 
22 #include <ubuntu/status.h>
23 #include <ubuntu/visibility.h>
24 
26 
27 #ifdef __cplusplus
28 extern "C" {
29 #endif
30 
35  typedef void UASensorsOrientation;
36 
42  void* context);
43 
49  UBUNTU_DLL_PUBLIC UASensorsOrientation*
51 
60  UASensorsOrientation* sensor);
61 
70  UASensorsOrientation* sensor);
71 
78  UBUNTU_DLL_PUBLIC uint32_t
80  UASensorsOrientation* sensor);
81 
90  UASensorsOrientation* sensor,
91  float* value);
92 
101  UASensorsOrientation* sensor,
102  float* value);
103 
112  UASensorsOrientation* sensor,
113  float* value);
114 
122  UBUNTU_DLL_PUBLIC void
124  UASensorsOrientation* sensor,
126  void *ctx);
127 
137  UASensorsOrientation* sensor,
138  uint32_t rate);
139 
140 #ifdef __cplusplus
141 }
142 #endif
143 
144 #endif /* UBUNTU_APPLICATION_SENSORS_ORIENTATION_H_ */
UBUNTU_DLL_PUBLIC UStatus ua_sensors_orientation_set_event_rate(UASensorsOrientation *sensor, uint32_t rate)
Set the sensor event delivery rate in nanoseconds..
void UASensorsOrientation
Opaque type that models the orientation.
Definition: orientation.h:35
void(* on_orientation_event_cb)(UASOrientationEvent *event, void *context)
Callback type used by applications to subscribe to orientation events.
Definition: orientation.h:41
UbuntuStatus
Indicates the status of an operation.
Definition: status.h:26
UBUNTU_DLL_PUBLIC UASensorsOrientation * ua_sensors_orientation_new()
Create a new object for accessing the orientation sensor.
UBUNTU_DLL_PUBLIC UStatus ua_sensors_orientation_get_resolution(UASensorsOrientation *sensor, float *value)
Queries the numeric resolution supported by the sensor.
UBUNTU_DLL_PUBLIC UStatus ua_sensors_orientation_get_max_value(UASensorsOrientation *sensor, float *value)
Queries the maximum value that can be reported by the sensor.
void UASOrientationEvent
Opaque type describing an orientation reading.
Definition: orientation.h:34
UBUNTU_DLL_PUBLIC UStatus ua_sensors_orientation_get_min_value(UASensorsOrientation *sensor, float *value)
Queries the minimum value that can be reported by the sensor.
UBUNTU_DLL_PUBLIC void ua_sensors_orientation_set_reading_cb(UASensorsOrientation *sensor, on_orientation_event_cb cb, void *ctx)
Set the callback to be invoked whenever a new sensor reading is available.
#define UBUNTU_DLL_PUBLIC
Definition: visibility.h:26
UBUNTU_DLL_PUBLIC UStatus ua_sensors_orientation_enable(UASensorsOrientation *sensor)
Enables the supplied orientation sensor.
UBUNTU_DLL_PUBLIC uint32_t ua_sensors_orientation_get_min_delay(UASensorsOrientation *sensor)
Queries the minimum delay between two readings for the supplied sensor.
UBUNTU_DLL_PUBLIC UStatus ua_sensors_orientation_disable(UASensorsOrientation *sensor)
Disables the supplied orientation sensor.