diff --git a/automated_updates_data.json b/automated_updates_data.json index 5341285457..cd5daf3a16 100644 --- a/automated_updates_data.json +++ b/automated_updates_data.json @@ -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" } ] } diff --git a/docs/gdevelop5/all-features/device-sensors/index.md b/docs/gdevelop5/all-features/device-sensors/index.md index c3fd6ed651..04ba76eee4 100644 --- a/docs/gdevelop5/all-features/device-sensors/index.md +++ b/docs/gdevelop5/all-features/device-sensors/index.md @@ -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** @@ -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) @@ -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 @@ -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 @@ -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) diff --git a/docs/gdevelop5/all-features/screenshot/index.md b/docs/gdevelop5/all-features/screenshot/index.md index bb4518a422..dec60b9f26 100644 --- a/docs/gdevelop5/all-features/screenshot/index.md +++ b/docs/gdevelop5/all-features/screenshot/index.md @@ -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 @@ -29,7 +31,7 @@ Relative paths are not supported. This path: -``` () + () + "my_screenshot.png" ``` +``` FileSystem::PicturesPath() + FileSystem::PathDelimiter() + "my_screenshot.png" ``` This will save the screenshot to the *Pictures* folder on Windows, Linux and MacOS.