Skip to content

[Auto] [Improve] Fixed device sensor rotation units, typo, gravity note, and screenshot expression syntax #535

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.

Sign up for GitHub

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

Open
github-actions wants to merge 1 commit into
base: main
Choose a base branch
from
Open

[Auto] [Improve] Fixed device sensor rotation units, typo, gravity note, and screenshot expression syntax #535

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
4 changes: 4 additions & 0 deletions automated_updates_data.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -80,6 +80,10 @@
{
"date": "2026-03-15",
"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)"
},
{
"date": "2026-03-22",
"summary": "Fixed device-sensors docs: corrected motion rotation units from m/s² to deg/s, fixed 'gamma/beta' typo, added gravity note for acceleration; fixed screenshot expression syntax and added desktop-only warning"
}
]
}
20 changes: 12 additions & 8 deletions docs/gdevelop5/all-features/device-sensors/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@ This action deactivates the orientation sensor so that it stops delivering alpha

**Is Absolute**

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).
Returns `1` if the orientation data is relative to the Earth's coordinate frame (absolute, like a true compass heading), or `0` if the device uses an arbitrary reference frame. Not all devices support absolute orientation.

**Alpha Value**

Expand All @@ -91,6 +91,10 @@ In contrast to the orientation sensor which returns absolute values, the motion

### Axes explained

!!! note

The acceleration values include the force of gravity. For example, when the device is lying flat and still, the Z-axis reads approximately **9.8 m/s²** (Earth's gravitational acceleration). Keep this in mind when interpreting the values.

#### Acceleration X

![](/gdevelop5/all-features/motion_acceleration_x.png)
Expand Down Expand Up @@ -125,7 +129,7 @@ This value shows the acceleration around the x-axis. If you hold your device in

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

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.
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.

### Conditions

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

**Motion Alpha**

This condition lets you compare the value of alpha to a number or variable. (m/s²)
This condition lets you compare the rotation rate around the z-axis to a number or variable. (deg/s)

**Motion Beta**

This condition lets you compare the value of beta to a number or variable. (m/s²)
This condition lets you compare the rotation rate around the x-axis to a number or variable. (deg/s)

**Motion Gamma**

This condition lets you compare the value of gamma to a number or variable. (m/s²)
This condition lets you compare the rotation rate around the y-axis to a number or variable. (deg/s)

### Actions

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

**Alpha Value**

The "alpha" rotation. (m/s²)
The rotation rate around the z-axis. (deg/s)

**Beta Value**

The "beta" rotation. (m/s²)
The rotation rate around the x-axis. (deg/s)

**Gamma Value**

The "gamma" rotation. (m/s²)
The rotation rate around the y-axis. (deg/s)

![](/gdevelop5/all-features/devicesensorsevents.png)
8 changes: 5 additions & 3 deletions docs/gdevelop5/all-features/screenshot/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,11 @@ title: Screenshot extension
---
# Screenshot extension

This extension lets you save a screenshot of the running game in a specified folder.
This extension lets you save a screenshot of the running game to a file.

Note: As of GDevelop 5.0.0-beta92 the screenshot action is no longer an extension. Just add an action and search for `screenshot` or go to `Other Actions`/`Screenshot`/`Take screenshot`.
!!! warning

Saving screenshots to the file system only works on **desktop** (Windows, macOS, Linux) builds. It is not available on web/browser or mobile exports. On those platforms, use a different approach if you need to capture game images.

### Actions

Expand All @@ -29,7 +31,7 @@ Relative paths are not supported.

This path:

``` <FileSystem::PicturesPath>() + <FileSystem::PathDelimiter>() + "my_screenshot.png" ```
``` FileSystem::PicturesPath() + FileSystem::PathDelimiter() + "my_screenshot.png" ```

This will save the screenshot to the *Pictures* folder on Windows, Linux and MacOS.

Expand Down