1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
//! This file has been automatically generated by `objc2`'s `header-translator`.
//! DO NOT EDIT
use core::ffi::*;
use core::ptr::NonNull;
use objc2::__framework_prelude::*;
use objc2_foundation::*;
use crate::*;
extern_protocol!(
/// An object conforming to
/// `GCAxisInput`represents an input that produces
/// normalized values - between [-1, 1] - along an axis with a fixed origin.
/// The origin - a value of 0 - corresponds the neutral state of the input.
///
/// See also [Apple's documentation](https://developer.apple.com/documentation/gamecontroller/gcaxisinput?language=objc)
pub unsafe trait GCAxisInput: NSObjectProtocol {
#[cfg(all(feature = "GCPhysicalInputElement", feature = "block2"))]
/// Set this block to be notified when the value of the axis input changes.
///
///
/// Parameter `element`: the element that has been modified.
///
/// Parameter `input`: the input that has been modified.
///
/// Parameter `value`: the value the axis was set to at the time the valueChangedHandler fired.
///
/// # Safety
///
/// - The returned block's argument 1 must be a valid pointer.
/// - The returned block's argument 2 must be a valid pointer.
#[unsafe(method(valueDidChangeHandler))]
#[unsafe(method_family = none)]
unsafe fn valueDidChangeHandler(
&self,
) -> *mut block2::DynBlock<
dyn Fn(
NonNull<ProtocolObject<dyn GCPhysicalInputElement>>,
NonNull<ProtocolObject<dyn GCAxisInput>>,
c_float,
),
>;
#[cfg(all(feature = "GCPhysicalInputElement", feature = "block2"))]
/// Setter for [`valueDidChangeHandler`][Self::valueDidChangeHandler].
///
/// This is [copied][objc2_foundation::NSCopying::copy] when set.
#[unsafe(method(setValueDidChangeHandler:))]
#[unsafe(method_family = none)]
unsafe fn setValueDidChangeHandler(
&self,
value_did_change_handler: Option<
&block2::DynBlock<
dyn Fn(
NonNull<ProtocolObject<dyn GCPhysicalInputElement>>,
NonNull<ProtocolObject<dyn GCAxisInput>>,
c_float,
),
>,
>,
);
/// A normalized value for the axis input, between -1 and 1 (inclusive). The values
/// are deadzoned and saturated before they are returned so there is no value
/// outside the range. Deadzoning does not remove values from the range, the full
/// 0 to 1 magnitude of values are possible from the input.
///
/// As an axis is often used in a digital sense, you can rely on a value of 0
/// meaning the axis is inside the deadzone. Any value greater than or less than
/// zero is not in the deadzone.
#[unsafe(method(value))]
#[unsafe(method_family = none)]
unsafe fn value(&self) -> c_float;
/// Check if the axis can support more than just digital values.
///
/// Defaults to
/// `YES`for most axis inputs.
#[unsafe(method(isAnalog))]
#[unsafe(method_family = none)]
unsafe fn isAnalog(&self) -> bool;
/// Check if the axis input value "rolls over" when reaching either the extreme
/// high or low value. For example, some dials can be rotated past the position
/// that represents their maximum value causing the reported value to roll over.
///
/// Defaults to
/// `NO`for most axis elements.
#[unsafe(method(canWrap))]
#[unsafe(method_family = none)]
unsafe fn canWrap(&self) -> bool;
/// The timestamp of the last value.
///
/// This time interval is not relative to any specific point in time. You can
/// subtract a previous timestamp from the current timestamp to determine the time
/// (in seconds) between changes to the value.
#[unsafe(method(lastValueTimestamp))]
#[unsafe(method_family = none)]
unsafe fn lastValueTimestamp(&self) -> NSTimeInterval;
/// The interval (in seconds) between the timestamp of the last event and the
/// current time.
///
/// This should be treated as a lower bound of the event latency. It may not
/// include (wired or wireless) transmission latency, or latency accrued on
/// the device before the event was transmitted to the host.
#[unsafe(method(lastValueLatency))]
#[unsafe(method_family = none)]
unsafe fn lastValueLatency(&self) -> NSTimeInterval;
#[cfg(feature = "GCPhysicalInputSource")]
/// An object describing the physical action(s) the user performs to manipulate
/// this input.
#[unsafe(method(sources))]
#[unsafe(method_family = none)]
unsafe fn sources(&self) -> Retained<NSSet<ProtocolObject<dyn GCPhysicalInputSource>>>;
}
);