From c1da5af6a53525817e44966e5fefe67141cbeed5 Mon Sep 17 00:00:00 2001 From: 4ian <1280130+4ian@users.noreply.github.com> Date: Sun, 26 Jul 2026 10:39:06 +0000 Subject: [PATCH] [Auto] [Improve] Expanded Tiled Sprite offset scrolling docs and fixed grammar and runtime property notes --- automated_updates_data.json | 4 ++++ docs/gdevelop5/objects/tiled_sprite/index.md | 15 +++++++++++++-- 2 files changed, 17 insertions(+), 2 deletions(-) diff --git a/automated_updates_data.json b/automated_updates_data.json index 2fa8e494dbb..ec19b18ab26 100644 --- a/automated_updates_data.json +++ b/automated_updates_data.json @@ -104,6 +104,10 @@ { "date": "2026-07-07", "summary": "Improved keyboard docs: added 'Key just pressed' (held vs one-frame) and 'Any key released' conditions, control-remapping note, and a reference list of valid key names" + }, + { + "date": "2026-07-26", + "summary": "Improved Tiled Sprite object docs: fixed grammar and expanded the image offset section explaining seamless scrolling for backgrounds/parallax, plus runtime image, opacity and angle changes" } ] } diff --git a/docs/gdevelop5/objects/tiled_sprite/index.md b/docs/gdevelop5/objects/tiled_sprite/index.md index c96292dca01..65ae4971a59 100644 --- a/docs/gdevelop5/objects/tiled_sprite/index.md +++ b/docs/gdevelop5/objects/tiled_sprite/index.md @@ -3,7 +3,7 @@ title: Tiled Sprite --- # Tiled Sprite -A tiled sprite [object](/gdevelop5/objects) allows us to use repeating images in our games. increasing the width or height of the object will cause it repeat it's image, rather than stretching the image like a normal sprite object. +A tiled sprite [object](/gdevelop5/objects) allows us to use repeating images in our games. Increasing the width or height of the object will cause it to repeat its image, rather than stretching the image like a normal sprite object. A tiled sprite object can be used to create platforms in a platform game, health bars, status bars, repeating wall tiles, repeating backgrounds, etc. @@ -43,10 +43,21 @@ If the object is scaled to be larger in pixels than the image used, then the obj ![](tiled-sprite-100100.png) -You can use events to manipulate the scale and positioning of tiled sprite object, but there are actions unique to tiled sprites. Offsets, which allow a user to scroll through a tiled sprite image without changing it's position. This is often used for scrolling backgrounds, and similar effects. +You can use events to manipulate the scale and positioning of a tiled sprite object like any other object, but there are also actions unique to tiled sprites. + +#### Scroll the image with offsets + +The **Image X offset** and **Image Y offset** actions move the tiled image *inside* the object without moving the object itself. Because the image repeats seamlessly, changing an offset by a small amount every frame creates a continuous scrolling effect that never shows a seam or edge. ![](/gdevelop5/objects/ChangeOffsetActions.png) +This is often used for scrolling backgrounds, conveyor belts, flowing water, and parallax layers. For a background that scrolls endlessly to the left, add a small value to the X offset each frame (for example, multiplied by `TimeDelta()` so the speed stays consistent regardless of the frame rate). + +#### Other properties changed at runtime + +- The **image** of a tiled sprite can be replaced during the game with the *Change the image* action, for example to swap a background or a status bar texture. +- The **opacity** and **angle** can also be changed with events, just like a regular sprite. + ## Examples !!! tip