Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add get and set functions for joypad motion sensors #4

Merged
merged 1 commit into from
Jan 14, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions core/os/input.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -86,10 +86,18 @@ void Input::_bind_methods() {
ClassDB::bind_method(D_METHOD("get_accelerometer"), &Input::get_accelerometer);
ClassDB::bind_method(D_METHOD("get_magnetometer"), &Input::get_magnetometer);
ClassDB::bind_method(D_METHOD("get_gyroscope"), &Input::get_gyroscope);
ClassDB::bind_method(D_METHOD("get_joy_gravity", "device"), &Input::get_joy_gravity);
ClassDB::bind_method(D_METHOD("get_joy_accelerometer", "device"), &Input::get_joy_accelerometer);
ClassDB::bind_method(D_METHOD("get_joy_magnetometer", "device"), &Input::get_joy_magnetometer);
ClassDB::bind_method(D_METHOD("get_joy_gyroscope", "device"), &Input::get_joy_gyroscope);
ClassDB::bind_method(D_METHOD("set_gravity", "value"), &Input::set_gravity);
ClassDB::bind_method(D_METHOD("set_accelerometer", "value"), &Input::set_accelerometer);
ClassDB::bind_method(D_METHOD("set_magnetometer", "value"), &Input::set_magnetometer);
ClassDB::bind_method(D_METHOD("set_gyroscope", "value"), &Input::set_gyroscope);
ClassDB::bind_method(D_METHOD("set_joy_gravity", "device", "value"), &Input::set_joy_gravity);
ClassDB::bind_method(D_METHOD("set_joy_accelerometer", "device", "value"), &Input::set_joy_accelerometer);
ClassDB::bind_method(D_METHOD("set_joy_magnetometer", "device", "value"), &Input::set_joy_magnetometer);
ClassDB::bind_method(D_METHOD("set_joy_gyroscope", "device", "value"), &Input::set_joy_gyroscope);
//ClassDB::bind_method(D_METHOD("get_mouse_position"),&Input::get_mouse_position); - this is not the function you want
ClassDB::bind_method(D_METHOD("get_last_mouse_speed"), &Input::get_last_mouse_speed);
ClassDB::bind_method(D_METHOD("get_mouse_button_mask"), &Input::get_mouse_button_mask);
Expand Down
8 changes: 8 additions & 0 deletions core/os/input.h
Original file line number Diff line number Diff line change
Expand Up @@ -117,10 +117,18 @@ class Input : public Object {
virtual Vector3 get_accelerometer() const = 0;
virtual Vector3 get_magnetometer() const = 0;
virtual Vector3 get_gyroscope() const = 0;
virtual Vector3 get_joy_gravity(int p_device) const = 0;
virtual Vector3 get_joy_accelerometer(int p_device) const = 0;
virtual Vector3 get_joy_magnetometer(int p_device) const = 0;
virtual Vector3 get_joy_gyroscope(int p_device) const = 0;
virtual void set_gravity(const Vector3 &p_gravity) = 0;
virtual void set_accelerometer(const Vector3 &p_accel) = 0;
virtual void set_magnetometer(const Vector3 &p_magnetometer) = 0;
virtual void set_gyroscope(const Vector3 &p_gyroscope) = 0;
virtual void set_joy_gravity(int p_device, const Vector3 &p_gravity) = 0;
virtual void set_joy_accelerometer(int p_device, const Vector3 &p_accel) = 0;
virtual void set_joy_magnetometer(int p_device, const Vector3 &p_magnetometer) = 0;
virtual void set_joy_gyroscope(int p_device, const Vector3 &p_gyroscope) = 0;

virtual void action_press(const StringName &p_action, float p_strength = 1.f) = 0;
virtual void action_release(const StringName &p_action) = 0;
Expand Down
70 changes: 68 additions & 2 deletions doc/classes/Input.xml
Original file line number Diff line number Diff line change
Expand Up @@ -105,6 +105,13 @@
[b]Note:[/b] This method only works on Android and iOS. On other platforms, it always returns [constant Vector3.ZERO].
</description>
</method>
<method name="get_joy_accelerometer" qualifiers="const">
<return type="Vector3" />
<argument index="0" name="device" type="int" />
<description>
Returns the acceleration of the controller's accelerometer sensor, if the controller has one. Otherwise, the method returns [constant Vector3.ZERO].
</description>
</method>
<method name="get_joy_axis" qualifiers="const">
<return type="float" />
<argument index="0" name="device" type="int" />
Expand Down Expand Up @@ -141,13 +148,34 @@
Receives a gamepad button from [enum JoystickList] and returns its equivalent name as a string.
</description>
</method>
<method name="get_joy_gravity" qualifiers="const">
<return type="Vector3" />
<argument index="0" name="device" type="int" />
<description>
Returns the gravity of the controller's accelerometer sensor, if the controller has one. Otherwise, the method returns [constant Vector3.ZERO].
</description>
</method>
<method name="get_joy_guid" qualifiers="const">
<return type="String" />
<argument index="0" name="device" type="int" />
<description>
Returns a SDL2-compatible device GUID on platforms that use gamepad remapping, e.g. [code]030000004c050000c405000000010000[/code]. Returns [code]"Default Gamepad"[/code] otherwise. Godot uses the [url=https://github.com/gabomdq/SDL_GameControllerDB]SDL2 game controller database[/url] to determine gamepad names and mappings based on this GUID.
</description>
</method>
<method name="get_joy_gyroscope" qualifiers="const">
<return type="Vector3" />
<argument index="0" name="device" type="int" />
<description>
Returns the rotation rate in rad/s around a controller's X, Y, and Z axes of the gyroscope sensor, if the controller has one. Otherwise, the method returns [constant Vector3.ZERO].
</description>
</method>
<method name="get_joy_magnetometer" qualifiers="const">
<return type="Vector3" />
<argument index="0" name="device" type="int" />
<description>
Returns the magnetic field strength in micro-Tesla for all axes of the controller's magnetometer sensor, if the controller has one. Otherwise, the method returns [constant Vector3.ZERO].
</description>
</method>
<method name="get_joy_name">
<return type="String" />
<argument index="0" name="device" type="int" />
Expand Down Expand Up @@ -346,15 +374,53 @@
<return type="void" />
<argument index="0" name="value" type="Vector3" />
<description>
Sets the value of the rotation rate of the gyroscope sensor. Can be used for debugging on devices without a hardware sensor, for example in an editor on a PC.
Sets the value of the rotation rate of the device's gyroscope sensor.
Can be used for debugging on devices without a hardware sensor, for example in an editor on a PC.
[b]Note:[/b] This value can be immediately overwritten by the hardware sensor value on Android and iOS.
</description>
</method>
<method name="set_joy_accelerometer">
<return type="void" />
<argument index="0" name="device" type="int" />
<argument index="1" name="value" type="Vector3" />
<description>
Sets the acceleration value of the controller's accelerometer sensor.
Can be used for debugging on devices without a hardware sensor, for example in an editor on a PC.
</description>
</method>
<method name="set_joy_gravity">
<return type="void" />
<argument index="0" name="device" type="int" />
<argument index="1" name="value" type="Vector3" />
<description>
Sets the gravity value of the controller's accelerometer sensor.
Can be used for debugging on devices without a hardware sensor, for example in an editor on a PC.
</description>
</method>
<method name="set_joy_gyroscope">
<return type="void" />
<argument index="0" name="device" type="int" />
<argument index="1" name="value" type="Vector3" />
<description>
Sets the value of the rotation rate of the controller's gyroscope sensor.
Can be used for debugging on devices without a hardware sensor, for example in an editor on a PC.
</description>
</method>
<method name="set_joy_magnetometer">
<return type="void" />
<argument index="0" name="device" type="int" />
<argument index="1" name="value" type="Vector3" />
<description>
Sets the value of the magnetic field of the controller's magnetometer sensor.
Can be used for debugging on devices without a hardware sensor, for example in an editor on a PC.
</description>
</method>
<method name="set_magnetometer">
<return type="void" />
<argument index="0" name="value" type="Vector3" />
<description>
Sets the value of the magnetic field of the magnetometer sensor. Can be used for debugging on devices without a hardware sensor, for example in an editor on a PC.
Sets the value of the magnetic field of the device's magnetometer sensor.
Can be used for debugging on devices without a hardware sensor, for example in an editor on a PC.
[b]Note:[/b] This value can be immediately overwritten by the hardware sensor value on Android and iOS.
</description>
</method>
Expand Down
44 changes: 44 additions & 0 deletions main/input_default.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -205,6 +205,26 @@ float InputDefault::get_joy_axis(int p_device, int p_axis) const {
}
}

Vector3 InputDefault::get_joy_gravity(int p_device) const {
_THREAD_SAFE_METHOD_
return gravity;
}

Vector3 InputDefault::get_joy_accelerometer(int p_device) const {
_THREAD_SAFE_METHOD_
return accelerometer;
}

Vector3 InputDefault::get_joy_magnetometer(int p_device) const {
_THREAD_SAFE_METHOD_
return magnetometer;
}

Vector3 InputDefault::get_joy_gyroscope(int p_device) const {
_THREAD_SAFE_METHOD_
return gyroscope;
}

String InputDefault::get_joy_name(int p_idx) {
_THREAD_SAFE_METHOD_
return joy_names[p_idx].name;
Expand Down Expand Up @@ -499,6 +519,30 @@ void InputDefault::set_joy_axis(int p_device, int p_axis, float p_value) {
_joy_axis[c] = p_value;
}

void InputDefault::set_joy_gravity(int p_device, const Vector3 &p_gravity) {
_THREAD_SAFE_METHOD_

gravity = p_gravity;
}

void InputDefault::set_joy_accelerometer(int p_device, const Vector3 &p_accel) {
_THREAD_SAFE_METHOD_

accelerometer = p_accel;
}

void InputDefault::set_joy_magnetometer(int p_device, const Vector3 &p_magnetometer) {
_THREAD_SAFE_METHOD_

magnetometer = p_magnetometer;
}

void InputDefault::set_joy_gyroscope(int p_device, const Vector3 &p_gyroscope) {
_THREAD_SAFE_METHOD_

gyroscope = p_gyroscope;
}

void InputDefault::start_joy_vibration(int p_device, float p_weak_magnitude, float p_strong_magnitude, float p_duration) {
_THREAD_SAFE_METHOD_
if (p_weak_magnitude < 0.f || p_weak_magnitude > 1.f || p_strong_magnitude < 0.f || p_strong_magnitude > 1.f) {
Expand Down
8 changes: 8 additions & 0 deletions main/input_default.h
Original file line number Diff line number Diff line change
Expand Up @@ -226,6 +226,10 @@ class InputDefault : public Input {
virtual float get_action_raw_strength(const StringName &p_action, bool p_exact = false) const;

virtual float get_joy_axis(int p_device, int p_axis) const;
virtual Vector3 get_joy_gravity(int p_device) const;
virtual Vector3 get_joy_accelerometer(int p_device) const;
virtual Vector3 get_joy_magnetometer(int p_device) const;
virtual Vector3 get_joy_gyroscope(int p_device) const;
String get_joy_name(int p_idx);
virtual Array get_connected_joypads();
virtual Vector2 get_joy_vibration_strength(int p_device);
Expand All @@ -252,6 +256,10 @@ class InputDefault : public Input {
virtual void set_magnetometer(const Vector3 &p_magnetometer);
virtual void set_gyroscope(const Vector3 &p_gyroscope);
void set_joy_axis(int p_device, int p_axis, float p_value);
virtual void set_joy_gravity(int p_device, const Vector3 &p_gravity);
virtual void set_joy_accelerometer(int p_device, const Vector3 &p_accel);
virtual void set_joy_magnetometer(int p_device, const Vector3 &p_magnetometer);
virtual void set_joy_gyroscope(int p_device, const Vector3 &p_gyroscope);

virtual void start_joy_vibration(int p_device, float p_weak_magnitude, float p_strong_magnitude, float p_duration = 0);
virtual void stop_joy_vibration(int p_device);
Expand Down
Loading