Add collage background overlay render mode toggle#1545
Conversation
|
The current approach of placing images on top of the collage background works fine for simple layouts, but it becomes limiting for more advanced collage designs. Decorative elements such as frames, shadows, stickers, polaroid effects, gold borders, or overlapping graphics cannot properly interact with the images because the photos are always rendered above everything else. The idea behind this change is to treat the collage background more like a real overlay or frame. The images should be rendered first, and then the designed collage background should be placed on top of them. The background itself contains transparent cutouts or “holes” where the images remain visible. This makes it possible to create much more professional and visually polished collage designs:
The feature should remain optional so both the current simple rendering behavior and the new overlay/frame-based rendering mode are supported. |

Prerequisites checklist
What is the purpose of this pull request? (put an "x" next to an item)
What changes did you make? (Give an overview)
background_render_modewith two modes:behind_images(current/default behavior)overlay_frame(new mode)src/Collage.php:behind_images: background first, then imagesoverlay_frame: images first, then background as overlay framesrc/Configuration/Section/CollageConfiguration.phpwith defaultbehind_images.src/Dto/CollageConfig.phpsrc/Factory/CollageConfigFactory.phplib/configsetup.inc.php:checkbox) instead of selectoverlay_frame, OFF =>behind_imagesresources/lang/en.jsonresources/lang/de.jsonincluding manual description in “If enabled / Wenn aktiviert …” style.
Tests:
php -lon changed PHP filesresources/lang/en.jsonandresources/lang/de.jsonbehind_imagesandoverlay_frame) completed successfullytrue->overlay_framefalse->behind_imagesIs there anything you'd like reviewers to focus on?
AI used to create this Pull Request?
I used AI selectively in the code, for minor suggestions, alternatives or for understanding.
The idea, concept and logic behind the changes are my own.