diff --git a/automated_updates_data.json b/automated_updates_data.json index 88dd158d37..4333acd973 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-09-05", + "summary": "Improved Tiled Sprite object docs: fixed intro grammar, documented X/Y image offset scrolling with wrap-around and offset expressions, and the runtime Set image action; fixed Text Entry reference link" } ] } diff --git a/docs/gdevelop5/objects/text_entry/index.md b/docs/gdevelop5/objects/text_entry/index.md index aa831db4e8..3232d5996d 100644 --- a/docs/gdevelop5/objects/text_entry/index.md +++ b/docs/gdevelop5/objects/text_entry/index.md @@ -51,4 +51,4 @@ Using events, it is possible to enable or disable the "Text entry" object. Event ## Reference -All actions, conditions and expressions are listed in [the shape painter reference page](/gdevelop5/all-features/text-entry-object/reference/). \ No newline at end of file +All actions, conditions and expressions are listed in [the text entry object reference page](/gdevelop5/all-features/text-entry-object/reference/). \ No newline at end of file diff --git a/docs/gdevelop5/objects/tiled_sprite/index.md b/docs/gdevelop5/objects/tiled_sprite/index.md index acfefb428c..f60fac3c9d 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,20 @@ 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 shift the repeating image inside the object without moving the object itself. Increasing an offset a little on every frame makes the image scroll continuously, which is often used for scrolling backgrounds, conveyor belts, waterfalls, and similar effects. + +Because the image repeats seamlessly, the offset simply wraps around once it goes past the image size, so it can be increased indefinitely without any visible jump. Matching expressions (`Object.XOffset()` and `Object.YOffset()`) return the current offset values. ![](/gdevelop5/objects/ChangeOffsetActions.png) +#### Change the image with events + +The **Image** action ("Set image ... on ...") replaces the displayed image at runtime with another image resource of the project. This is handy to reuse a single tiled sprite object for different repeating textures instead of creating one object per texture. + ## Examples !!! tip