Skip to content

Commit 7f71830

Browse files
[Auto] [Improve] Fix device sensor units, typo, and broken wiki link in advanced conditions (#539)
Co-authored-by: 4ian <1280130+4ian@users.noreply.github.com>
1 parent 97a30ec commit 7f71830

File tree

3 files changed

+20
-12
lines changed

3 files changed

+20
-12
lines changed

automated_updates_data.json

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -80,6 +80,10 @@
8080
{
8181
"date": "2026-03-15",
8282
"summary": "Improved string-instructions (added StrReplaceOne/StrReplaceAll), common-conversions (added LargeNumberToString, ToJSON/ObjectVarToJSON), timers (added TimeScale and Time() format selectors), and gamepad docs (added analog triggers, deadzone, StickForceX/Y, controller type detection)"
83+
},
84+
{
85+
"date": "2026-03-24",
86+
"summary": "Fixed device-sensors docs (typo in gamma rotation description, wrong units deg/s vs m/s² for rotation values, clarified Is Absolute expression, added gravity note to acceleration) and fixed broken wiki URL in advanced-conditions OR condition"
8387
}
8488
]
8589
}

docs/gdevelop5/all-features/advanced-conditions/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ If the "**OR**" condition is used in an event, the actions are performed when on
1919

2020
!!! warning
2121

22-
The OR condition has a special behavior regarding the [object filtering logic of GDevelop](http://wiki.compilgames.net/doku.php/gdevelop5/tutorials/basic-game-making-concepts#events_and_how_objects_are_selected_by_these_events). The objects listed under it are _unselected_ by GDevelop if their condition is not met, so actions specific to these objects may not work. In some cases, using "Pick all instances" on the action side will fix things. In other cases, replacing the OR will be necessary.
22+
The OR condition has a special behavior regarding the [object filtering logic of GDevelop](/gdevelop5/events/object-picking). The objects listed under it are _unselected_ by GDevelop if their condition is not met, so actions specific to these objects may not work. In some cases, using "Pick all instances" on the action side will fix things. In other cases, replacing the OR will be necessary.
2323

2424
## Not logical operation
2525
![](not-condition.png)

docs/gdevelop5/all-features/device-sensors/index.md

Lines changed: 15 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -67,24 +67,28 @@ This action deactivates the orientation sensor so that it stops delivering alpha
6767

6868
**Is Absolute**
6969

70-
This value indicates that the orientation data is in absolute values. In reference to the Earth's coordinates (value 1) or using an arbitrary frame, is determined by the device (value 0).
70+
Returns 1 if the orientation data is referenced to the Earth's coordinate frame (compass-based), or 0 if it uses an arbitrary frame determined by the device.
7171

7272
**Alpha Value**
7373

74-
The "alpha" rotation.
74+
The "alpha" rotation angle, in degrees (range: 0 to 360).
7575

7676
**Beta Value**
7777

78-
The "beta" rotation.
78+
The "beta" rotation angle, in degrees (range: -180 to 180).
7979

8080
**Gamma Value**
8181

82-
The "gamma" rotation.
82+
The "gamma" rotation angle, in degrees (range: -90 to 90).
8383

8484
## Motion sensor
8585

8686
In contrast to the orientation sensor which returns absolute values, the motion sensor delivers relative ones. This sensor only returns values while the device is moving. If you hold it still, no matter its orientation, the sensor will return 0. You can access the motion data along an axis via the "x", "y", "z" values and the rotation data around an axis via "alpha", "beta" and "gamma" which are explained in the next section.
8787

88+
!!! note
89+
90+
The acceleration values include the effect of gravity (approximately 9.81 m/s² on Earth), so a device lying flat on a table will still show a non-zero Z acceleration.
91+
8892
!!! note
8993

9094
The motion sensor rotation values (alpha, beta, gamma) are currently badly supported on mobile devices. It would currently be better to calculate the value from the orientation data
@@ -125,7 +129,7 @@ This value shows the acceleration around the x-axis. If you hold your device in
125129

126130
![](/gdevelop5/all-features/motion_gamma.png)
127131

128-
This value shows the acceleration around the y-axis. If you hold your device in portrait mode with a hand on each side, you can turn your device around the y-axis and the beta value will increase.
132+
This value shows the acceleration around the y-axis. If you hold your device in portrait mode with a hand on each side, you can turn your device around the y-axis and the gamma value will increase.
129133

130134
### Conditions
131135

@@ -147,15 +151,15 @@ This condition lets you compare the value of z-acceleration to a number or varia
147151

148152
**Motion Alpha**
149153

150-
This condition lets you compare the value of alpha to a number or variable. (m/s²)
154+
This condition lets you compare the value of alpha to a number or variable. (deg/s)
151155

152156
**Motion Beta**
153157

154-
This condition lets you compare the value of beta to a number or variable. (m/s²)
158+
This condition lets you compare the value of beta to a number or variable. (deg/s)
155159

156160
**Motion Gamma**
157161

158-
This condition lets you compare the value of gamma to a number or variable. (m/s²)
162+
This condition lets you compare the value of gamma to a number or variable. (deg/s)
159163

160164
### Actions
161165

@@ -183,14 +187,14 @@ The "z" acceleration. (m/s²)
183187

184188
**Alpha Value**
185189

186-
The "alpha" rotation. (m/s²)
190+
The "alpha" rotation rate. (deg/s)
187191

188192
**Beta Value**
189193

190-
The "beta" rotation. (m/s²)
194+
The "beta" rotation rate. (deg/s)
191195

192196
**Gamma Value**
193197

194-
The "gamma" rotation. (m/s²)
198+
The "gamma" rotation rate. (deg/s)
195199

196200
![](/gdevelop5/all-features/devicesensorsevents.png)

0 commit comments

Comments
 (0)