collage fixes
Some checks failed
Build & Push Docker (latest) / verify (push) Successful in 9m27s
Build & Push Docker (latest) / build (push) Has been cancelled

This commit is contained in:
Aiden Wilson
2026-05-29 23:45:52 +10:00
parent 4b488913e4
commit 30cd5c7b13
7 changed files with 372 additions and 55 deletions

View File

@@ -94,8 +94,9 @@ The template also accepts a raw URL string or standard CasparCG XML
## Collage
Use `/collage` to render multiple social posts as a vertically scrolling strip.
Posts are repeated in the track so the motion keeps filling gaps.
Use `/collage` to render multiple social posts as independently scrolling
columns. The browser keeps only a small window of live posts per column, removes
cards after they scroll off the top, and fills new random cards at the bottom.
Repeated `url` parameters:
@@ -114,12 +115,15 @@ Useful collage parameters:
- `spacing`: pixels between a post and anything else, including screen edges and other posts, default `48`.
- `fade`: optional pixels used to fade posts in/out at the top and bottom edges, default `0`.
- `columns`: number of post columns, default `3`.
- `repeatDistance`: minimum pixel distance before the same post can be reused near another live copy, default `900`.
- `hydrateDelay`: milliseconds between hydrating newly inserted provider embeds, default `180`.
- `duration`: seconds per scroll loop, default `360`.
- `repeat`: number of times to repeat the post list in each half of the loop, default `4`.
- `repeat`: virtual scroll buffer multiplier, default `2`.
- `shuffle`: `1` to randomize post order on each page load, default `1`.
Collage card width is calculated from `width`, `spacing`, and `columns`,
then capped at `500px`, so all columns fit within the configured screen width.
Collage card width is calculated from `width`, `spacing`, and `columns` so the
columns fill the configured screen width with only the chosen spacing at the
edges.
## API