diff --git a/automated_updates_data.json b/automated_updates_data.json index 1c314c31bf..d48033c279 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-20", + "summary": "Improved window docs (added screen/window size expressions and Advanced Window features), screenshot doc (added desktop-only warning, removed outdated beta note), and device-sensors doc (fixed wrong rotation units m/s² → deg/s², fixed gamma description typo)" } ] } diff --git a/docs/gdevelop5/all-features/device-sensors/index.md b/docs/gdevelop5/all-features/device-sensors/index.md index c3fd6ed651..6fa951d1e5 100644 --- a/docs/gdevelop5/all-features/device-sensors/index.md +++ b/docs/gdevelop5/all-features/device-sensors/index.md @@ -125,7 +125,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 +147,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 value of alpha 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 value of beta 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 value of gamma to a number or variable. (deg/s²) ### Actions @@ -183,14 +183,14 @@ The "z" acceleration. (m/s²) **Alpha Value** -The "alpha" rotation. (m/s²) +The "alpha" rotation. (deg/s²) **Beta Value** -The "beta" rotation. (m/s²) +The "beta" rotation. (deg/s²) **Gamma Value** -The "gamma" rotation. (m/s²) +The "gamma" rotation. (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..2caed17fce 100644 --- a/docs/gdevelop5/all-features/screenshot/index.md +++ b/docs/gdevelop5/all-features/screenshot/index.md @@ -3,35 +3,27 @@ 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 as a PNG 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 -### Actions + The screenshot action only works in **desktop builds** (Windows, macOS, Linux). It is not available on web (browser) or mobile (Android/iOS) builds, because those platforms do not provide direct file system write access. -#### Take screenshot +## Taking a screenshot -Use this action to save a screenshot of everything which is currently drawn on the game window into a *png* file. - -##### Parameters: - -**Save path**: The file path where the screenshot should be saved. - -The save path needs to be an absolute path on the file system (Like "C:\MyFolder\MyScreenshot.png" on Windows)' +Use the **"Take screenshot"** action to capture everything currently drawn on the game canvas and save it to a PNG file. Provide an absolute file path as the save path (for example `C:\Users\Me\Pictures\shot.png` on Windows). Relative paths are not supported. -!!! note - - In order to create a game that runs on all supported platforms you should use the special folders from the file system extension in combination with the path separator. These determine the path to common folders like *Pictures*, *Documents* or *Desktop* automatically. You can read more about it in [this article](/gdevelop5/all-features/filesystem). - -## Example +!!! tip -This path: + Use the expressions from the [File system](/gdevelop5/all-features/filesystem) extension to build a portable path that works across operating systems. For example: -``` () + () + "my_screenshot.png" ``` + ``` + FileSystem::PicturesPath() + FileSystem::PathDelimiter() + "my_screenshot.png" + ``` -This will save the screenshot to the *Pictures* folder on Windows, Linux and MacOS. + This saves the screenshot to the *Pictures* folder on Windows, Linux and macOS. ## Reference diff --git a/docs/gdevelop5/all-features/window/index.md b/docs/gdevelop5/all-features/window/index.md index c3ef482243..850420f14e 100644 --- a/docs/gdevelop5/all-features/window/index.md +++ b/docs/gdevelop5/all-features/window/index.md @@ -39,6 +39,28 @@ By default, the game name is used for the executable name (on Windows, macOS and With the action to change the title, the title bar on Windows, macOS and Linux will be changed. Nothing will be visible on Android and iOS. For HTML5 games, the web page title will be changed. +## Getting window and screen dimensions + +Several expressions let you read the current size of the game area: + +- `SceneWindowWidth()` / `SceneWindowHeight()` — the size (in pixels) of the game canvas currently displayed. +- `ScreenWidth()` / `ScreenHeight()` — the size of the browser page or the desktop window that contains the game. On a web build this returns the browser viewport size; on a desktop build it returns the application window size. + +These are useful to position UI elements that must stay anchored to the edges of the screen, or to adapt the game to different screen sizes at runtime. + +## Advanced Window features (desktop only) + +The **Advanced Window** extension provides additional control over the application window on **Windows, macOS and Linux** desktop builds. It has no effect on web or mobile builds. + +Some useful things you can do with it: + +- **Resize and position the window** — move the window to specific screen coordinates or read its current position with the `WindowX()` / `WindowY()` expressions. +- **Control window state** — maximize, minimize, or restore the window; enable or disable the ability for the player to resize, move, minimize or close the window. +- **Window appearance** — set the window opacity (0 to 1), toggle the window shadow, or enable content protection to prevent the OS from including the window in screenshots and screen recordings. +- **Always on top** — keep the window floating above all other windows, for example for a mini game HUD or an overlay tool. +- **Kiosk mode** — lock the game in fullscreen and prevent the player from exiting, which is useful for public installations or kiosk terminals. +- **Flash / alert** — make the window flash in the taskbar to notify the player. + ## Reference All actions, conditions and expressions are listed in [the window reference page](/gdevelop5/all-features/window/reference/). \ No newline at end of file