OSVR-Core
ButtonInterfaceC.h
Go to the documentation of this file.
1 
13 /*
14 // Copyright 2014 Sensics, Inc.
15 //
16 // Licensed under the Apache License, Version 2.0 (the "License");
17 // you may not use this file except in compliance with the License.
18 // You may obtain a copy of the License at
19 //
20 // http://www.apache.org/licenses/LICENSE-2.0
21 //
22 // Unless required by applicable law or agreed to in writing, software
23 // distributed under the License is distributed on an "AS IS" BASIS,
24 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
25 // See the License for the specific language governing permissions and
26 // limitations under the License.
27 */
28 
29 #ifndef INCLUDED_ButtonInterfaceC_h_GUID_64F54A8F_976B_4A87_7BEA_D5CE628B3E6C
30 #define INCLUDED_ButtonInterfaceC_h_GUID_64F54A8F_976B_4A87_7BEA_D5CE628B3E6C
31 
32 /* Internal Includes */
36 
37 /* Library/third-party includes */
38 /* none */
39 
40 /* Standard includes */
41 /* none */
42 
43 OSVR_EXTERN_C_BEGIN
44 
55 
66 OSVR_PLUGINKIT_EXPORT
67 OSVR_ReturnCode
69  OSVR_OUT_PTR OSVR_ButtonDeviceInterface *iface,
70  OSVR_IN OSVR_ChannelCount numChan)
71  OSVR_FUNC_NONNULL((1, 2));
72 
75 OSVR_PLUGINKIT_EXPORT
77  OSVR_IN_PTR OSVR_ButtonDeviceInterface
78  iface,
81  OSVR_FUNC_NONNULL((1, 2));
82 
85 OSVR_PLUGINKIT_EXPORT
88  OSVR_IN_PTR OSVR_ButtonDeviceInterface iface, OSVR_IN OSVR_ButtonState val,
89  OSVR_IN OSVR_ChannelCount chan, OSVR_IN_PTR OSVR_TimeValue const *timestamp)
90  OSVR_FUNC_NONNULL((1, 2, 5));
91 
94 OSVR_PLUGINKIT_EXPORT
96  OSVR_IN_PTR OSVR_ButtonDeviceInterface
97  iface,
100  OSVR_FUNC_NONNULL((1, 2, 3));
101 
104 OSVR_PLUGINKIT_EXPORT
107  OSVR_IN_PTR OSVR_ButtonDeviceInterface iface,
109  OSVR_IN_PTR OSVR_TimeValue const *timestamp)
110  OSVR_FUNC_NONNULL((1, 2, 3, 5));
111  /* end of group */
113 
114 OSVR_EXTERN_C_END
115 
116 #endif
#define OSVR_OUT_PTR
Indicates a required pointer (non-null) function parameter that serves only as output.
Definition: AnnotationMacrosC.h:151
uint32_t OSVR_ChannelCount
The integer type specifying a number of channels/sensors or a channel/sensor index.
Definition: ChannelCountC.h:51
#define OSVR_IN_PTR
Indicates a required pointer (non-null) function parameter that serves only as input.
Definition: AnnotationMacrosC.h:108
OSVR_PLUGINKIT_EXPORT OSVR_ReturnCode OSVR_PLUGINKIT_EXPORT OSVR_ReturnCode OSVR_PLUGINKIT_EXPORT OSVR_ReturnCode OSVR_PLUGINKIT_EXPORT OSVR_ReturnCode osvrDeviceButtonSetValues(OSVR_INOUT_PTR OSVR_DeviceToken dev, OSVR_IN_PTR OSVR_ButtonDeviceInterface iface, OSVR_IN_PTR OSVR_ButtonState val[], OSVR_IN OSVR_ChannelCount chans) OSVR_FUNC_NONNULL((1
Report the value of multiple channels.
A DeviceToken connects the generic device interaction code in PluginKit's C API with the workings of ...
Definition: DeviceToken.h:56
struct OSVR_ButtonDeviceInterfaceObject * OSVR_ButtonDeviceInterface
Opaque type used in conjunction with a device token to send data on a button interface.
Definition: ButtonInterfaceC.h:54
OSVR_PLUGINKIT_EXPORT OSVR_ReturnCode OSVR_PLUGINKIT_EXPORT OSVR_ReturnCode OSVR_PLUGINKIT_EXPORT OSVR_ReturnCode osvrDeviceButtonSetValueTimestamped(OSVR_IN_PTR OSVR_DeviceToken dev, OSVR_IN_PTR OSVR_ButtonDeviceInterface iface, OSVR_IN OSVR_ButtonState val, OSVR_IN OSVR_ChannelCount chan, OSVR_IN_PTR OSVR_TimeValue const *timestamp) OSVR_FUNC_NONNULL((1
Report the value of a single channel with the supplied timestamp.
#define OSVR_FUNC_NONNULL(X)
Indicates the parameter(s) that must be non-null.
Definition: AnnotationMacrosC.h:202
Structure used internally to construct the desired type of device.
Definition: DeviceInitObject.h:59
#define OSVR_INOUT_PTR
Indicates a required pointer (non-null) function parameter that is both read and written to...
Definition: AnnotationMacrosC.h:178
OSVR_PLUGINKIT_EXPORT OSVR_ReturnCode OSVR_PLUGINKIT_EXPORT OSVR_ReturnCode osvrDeviceButtonSetValue(OSVR_IN_PTR OSVR_DeviceToken dev, OSVR_IN_PTR OSVR_ButtonDeviceInterface iface, OSVR_IN OSVR_ButtonState val, OSVR_IN OSVR_ChannelCount chan) OSVR_FUNC_NONNULL((1
Report the value of a single channel.
Definition: ButtonInterfaceC.cpp:41
uint8_t OSVR_ButtonState
Type of button state.
Definition: ClientReportTypesC.h:120
OSVR_PLUGINKIT_EXPORT OSVR_ReturnCode OSVR_PLUGINKIT_EXPORT OSVR_ReturnCode OSVR_PLUGINKIT_EXPORT OSVR_ReturnCode OSVR_PLUGINKIT_EXPORT OSVR_ReturnCode OSVR_PLUGINKIT_EXPORT OSVR_ReturnCode osvrDeviceButtonSetValuesTimestamped(OSVR_IN_PTR OSVR_DeviceToken dev, OSVR_IN_PTR OSVR_ButtonDeviceInterface iface, OSVR_IN_PTR OSVR_ButtonState val[], OSVR_IN OSVR_ChannelCount chans, OSVR_IN_PTR OSVR_TimeValue const *timestamp) OSVR_FUNC_NONNULL((1
Report the value of multiple channels with the supplied timestamp.
OSVR_PLUGINKIT_EXPORT OSVR_ReturnCode osvrDeviceButtonConfigure(OSVR_IN_PTR OSVR_DeviceInitOptions opts, OSVR_OUT_PTR OSVR_ButtonDeviceInterface *iface, OSVR_IN OSVR_ChannelCount numChan) OSVR_FUNC_NONNULL((1
Specify that your device will implement the Button interface.
#define OSVR_IN
Indicates a required function parameter that serves only as input.
Definition: AnnotationMacrosC.h:100
Standardized, portable parallel to struct timeval for representing both absolute times and time inter...
Definition: TimeValueC.h:81
Definition: ProjectionMatrix.h:77