From 1ebcd5ea776a976ff05e24b076f1bc332dd1735c Mon Sep 17 00:00:00 2001 From: 4ian <1280130+4ian@users.noreply.github.com> Date: Thu, 23 Jul 2026 10:51:50 +0000 Subject: [PATCH] [Auto] [Improve] Added parameter guidance to CRT, drop shadow, god rays, blur and other visual effect pages --- automated_updates_data.json | 4 ++++ docs/gdevelop5/all-features/effects/crt/index.md | 8 ++++++++ docs/gdevelop5/all-features/effects/drop-shadow/index.md | 8 ++++++++ docs/gdevelop5/all-features/effects/god-rays/index.md | 8 ++++++++ docs/gdevelop5/all-features/effects/kawase-blur/index.md | 6 ++++++ docs/gdevelop5/all-features/effects/outline/index.md | 5 +++++ docs/gdevelop5/all-features/effects/pixelate/index.md | 2 ++ docs/gdevelop5/all-features/effects/rgb-split/index.md | 6 ++++++ docs/gdevelop5/all-features/effects/tilt-shift/index.md | 5 +++++ 9 files changed, 52 insertions(+) diff --git a/automated_updates_data.json b/automated_updates_data.json index 2fa8e494dbb..59dd69ad452 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-23", + "summary": "Added 'Key settings' guidance to visual effect pages (CRT, drop shadow, god rays, Kawase blur, outline, pixelate, RGB split, tilt shift) explaining their tunable parameters in use-case terms" } ] } diff --git a/docs/gdevelop5/all-features/effects/crt/index.md b/docs/gdevelop5/all-features/effects/crt/index.md index de52bffba07..7894a4dc808 100644 --- a/docs/gdevelop5/all-features/effects/crt/index.md +++ b/docs/gdevelop5/all-features/effects/crt/index.md @@ -4,6 +4,14 @@ Applies a CRT effect, simulating an old cathode-ray tube television. ![](crt-effect.png) +## Key settings + +- **Curvature** bends the image outwards to imitate the bulge of a real CRT screen. Set it to a low value (or 0) for a flat, subtle retro look. +- The **Line width**, **Line contrast** and **Show vertical lines** settings control the scanlines drawn over the image. +- **Noise** and **Noise size** add moving static. Combine with the **Noise frequency** to control how often the static refreshes. +- **Vignetting** darkens the corners of the screen. Use it to draw attention to the center of the image. +- **Interlaced lines speed** animates the scanlines. Set it to 0 to keep them still. + ## Reference diff --git a/docs/gdevelop5/all-features/effects/drop-shadow/index.md b/docs/gdevelop5/all-features/effects/drop-shadow/index.md index f9ca072a4c2..10c4e004342 100644 --- a/docs/gdevelop5/all-features/effects/drop-shadow/index.md +++ b/docs/gdevelop5/all-features/effects/drop-shadow/index.md @@ -4,6 +4,14 @@ Add a drop shadow under your object's visible on the layer. ![](drop-shadow-effect.png) +## Key settings + +- **Distance** and **Rotation** position the shadow relative to the image: increase the distance to make objects appear higher above the ground, and change the rotation to match the direction of your light source. +- **Blur** softens the edges of the shadow, while **Alpha** controls how transparent it is. +- **Color** lets you tint the shadow (a dark blue often looks more natural than pure black). +- Enable **Shadow only** to display just the shadow, hiding the object itself. This is handy to render a separate silhouette. +- If a large or far-away shadow gets clipped at the edges of the object, increase the **Padding** to reserve more space for the effect. + ## Reference diff --git a/docs/gdevelop5/all-features/effects/god-rays/index.md b/docs/gdevelop5/all-features/effects/god-rays/index.md index 904f9fa64ac..236a0add3fc 100644 --- a/docs/gdevelop5/all-features/effects/god-rays/index.md +++ b/docs/gdevelop5/all-features/effects/god-rays/index.md @@ -4,6 +4,14 @@ Cast rays of light from the top of the screen. **This won't work well if shown o ![](godray-effect.gif) +## Key settings + +- **Angle** and **Center X**/**Center Y** control the direction the rays come from and their point of origin, so you can align them with the sun or a window in your scene. +- **Gain** and **Light** control how bright and how long the rays are. +- **Lacunarity** changes the amount of detail in the rays (higher values give more, finer beams). +- **Animation speed** makes the rays shimmer and move over time. Set it to 0 to freeze them. +- Enable **Parallel** for straight, parallel beams (like distant sunlight), or disable it for rays that radiate outwards from the center point. + ## Reference diff --git a/docs/gdevelop5/all-features/effects/kawase-blur/index.md b/docs/gdevelop5/all-features/effects/kawase-blur/index.md index 703917f8251..8f200a15db2 100644 --- a/docs/gdevelop5/all-features/effects/kawase-blur/index.md +++ b/docs/gdevelop5/all-features/effects/kawase-blur/index.md @@ -2,6 +2,12 @@ This is a faster version of the traditional "Blur" effect. It's recommended that you use this one rather than the "Gaussian" blur effect. +## Key settings + +- **Blur** sets the strength of the blur. +- **Quality** is the number of blur passes: higher values give a smoother result but cost more performance. +- **Pixelize X** and **Pixelize Y** stretch the blur along one axis. Keep them equal for a uniform blur, or set only one to create a directional (motion-like) blur. + ## Reference diff --git a/docs/gdevelop5/all-features/effects/outline/index.md b/docs/gdevelop5/all-features/effects/outline/index.md index aecd08ff547..4c6f6d73f09 100644 --- a/docs/gdevelop5/all-features/effects/outline/index.md +++ b/docs/gdevelop5/all-features/effects/outline/index.md @@ -4,6 +4,11 @@ Add an outline on all objects of the layer having the effect. **This won't work ![](outline-effect.png) +## Key settings + +- **Thickness** sets how wide the outline is, and **Color** sets its color. +- A thick outline can be cut off at the edges of the object. If this happens, increase the **Padding** to reserve extra space around the object for the effect. + ## Reference diff --git a/docs/gdevelop5/all-features/effects/pixelate/index.md b/docs/gdevelop5/all-features/effects/pixelate/index.md index a6a86e125a9..c57e3de32b5 100644 --- a/docs/gdevelop5/all-features/effects/pixelate/index.md +++ b/docs/gdevelop5/all-features/effects/pixelate/index.md @@ -4,6 +4,8 @@ Applies a pixelated effect, making display objects appear 'blocky'. ![](pixelate-effect.png) +The **Size** setting is the width and height, in pixels, of each "block". Larger values give a coarser, more heavily pixelated look. + !!! note For pixel-perfect or 8-bitgames, you can change the **Scale mode** options in your [game properties](/gdevelop5/interface/project-manager/properties) instead of using this effect. diff --git a/docs/gdevelop5/all-features/effects/rgb-split/index.md b/docs/gdevelop5/all-features/effects/rgb-split/index.md index 966ee01467e..7c900fcdeca 100644 --- a/docs/gdevelop5/all-features/effects/rgb-split/index.md +++ b/docs/gdevelop5/all-features/effects/rgb-split/index.md @@ -4,6 +4,12 @@ Separate each component's RGB(red, green, blue) colors and display them on the s ![](rgb-effect.png) +## Key settings + +Each color channel has its own **X offset** and **Y offset**, letting you shift the red, green and blue components independently. Larger offsets produce a stronger split. + +Animating these offsets with events is a common way to create a glitch, impact or teleport feedback: increase the offsets briefly when the player is hit, then return them to 0. + ## Reference diff --git a/docs/gdevelop5/all-features/effects/tilt-shift/index.md b/docs/gdevelop5/all-features/effects/tilt-shift/index.md index 1a7cbcf3aea..2567506aad6 100644 --- a/docs/gdevelop5/all-features/effects/tilt-shift/index.md +++ b/docs/gdevelop5/all-features/effects/tilt-shift/index.md @@ -4,6 +4,11 @@ Add blur to the top and bottom of the entire layer or object. Perfect to simulat ![](tilt-shift-effect.png) +## Key settings + +- **Blur** sets how strong the blur is at the top and bottom of the image. +- **Gradient blur** controls the size of the sharp band in the middle: a smaller value keeps a narrow strip in focus, while a larger value spreads the transition and keeps more of the image sharp. + ## Reference