A free and open source instant messaging and VoIP chat app built for friends, groups, and communities.
docs: document sign-in backdrops and original-size branding
Hampus74f5d583dd03
diff --git a/fluxer_docs/src/content/docs/media-proxy/routes.mdx b/fluxer_docs/src/content/docs/media-proxy/routes.mdxindex bd4d0fc7c..05873ce6f 100644--- a/fluxer_docs/src/content/docs/media-proxy/routes.mdx+++ b/fluxer_docs/src/content/docs/media-proxy/routes.mdx@@ -26,7 +26,7 @@ Every media read route can produce these statuses in addition to the ones in its| 413 | Payload too large | The stored object exceeds the 500 MiB media bound and the route neither streams it unchanged nor spools it || 502 | Bad gateway | The object store could not be read |-The 500 MiB media bound applies where a route holds an object in memory. A read that streams the stored object unchanged, such as an attachment read without a transformation parameter, has no size bound. An attachment read that asks for a frame of a video above the bound copies the video to the [spool directory](/operator/configuration/#media-proxy-settings) first, one video at a time, and returns 413 when the video exceeds the spool ceiling. Any other transformation of an object above the bound returns 413.+The 500 MiB media bound applies where a route holds an object in memory. A read that streams the stored object unchanged, such as an attachment read without a transformation parameter, has no size bound. An attachment read that asks for a frame of a video above the bound copies the video to the spool directory first, one video at a time, and returns 413 when the video exceeds the spool ceiling. Any other transformation of an object above the bound returns 413.## Get attachment@@ -240,7 +240,7 @@ Fluxer matches an asset path by its shape alone. A path with the wrong number ofUse the hash returned by the API. Do not calculate one from the image yourself.-An owner segment of the literal `.` or `..` parses as an asset path but produces an unsafe storage key and returns 400. So does a hash of the literal `a_` on an avatar, icon, branding, banner, splash, embed splash, or guild member asset path.+An owner segment of the literal `.` or `..` parses as an asset path but produces an unsafe storage key and returns 400. So does a hash of the literal `a_` on an avatar, icon, branding, sign-in backdrop, banner, splash, embed splash, or guild member asset path.### Query parameters@@ -252,7 +252,7 @@ An owner segment of the literal `.` or `..` parses as an asset path but produces| animated?<sup>3</sup> | boolean | Whether animated output is requested || download? | boolean | Whether attachment disposition is requested |-<sup>1</sup> An absent or unparsable value selects 128 before clamping. No value is rejected+<sup>1</sup> An absent or unparsable value selects 128 before clamping, except that an absent value on a branding or sign-in backdrop path keeps the original size. No value is rejected<sup>2</sup> Accepts case-insensitive `auto`, `png`, `jpg`, `jpeg`, `webp`, `gif`, `apng`, and `avif`, where `auto` keeps path-based selection and `avif` selects WebP. Any other value falls back to path-based selection, and a sticker path always selects WebP and ignores the field@@ -318,7 +318,7 @@ The [image asset response](#image-asset-response) applies.<RouteHeader method="GET" path="/branding/{entity_id}/{hash}.{ext}" unauthenticated />-Returns the instance branding image written by [Create branding asset](/admin-api/instance/#create-branding-asset), under the icon size class.+Returns the instance branding image written by [Create branding asset](/admin-api/instance/#create-branding-asset), under the branding size class.### Path parameters@@ -332,6 +332,24 @@ Returns the instance branding image written by [Create branding asset](/admin-apThe [image asset response](#image-asset-response) applies.+## Get instance sign-in backdrop++<RouteHeader method="GET" path="/branding-backdrops/{entity_id}/{hash}.{ext}" unauthenticated />++Returns the sign-in backdrop written by [Create branding asset](/admin-api/instance/#create-branding-asset) with the `sign_in_backdrop` kind, under the branding size class.++### Path parameters++| Field | Type | Description |+| --- | --- | --- |+| entity_id | string | The instance branding entity key supplied by the backdrop URL |+| hash | string | The backdrop hash, under the [image asset contract](#image-asset-contract) |+| ext | string | The path extension, which selects the output format |++### Response++The [image asset response](#image-asset-response) applies.+## Get owner banner<RouteHeader method="GET" path="/banners/{owner_id}/{hash}.{ext}" unauthenticated />diff --git a/fluxer_docs/src/content/docs/media-proxy/transformations.md b/fluxer_docs/src/content/docs/media-proxy/transformations.mdindex 1707e6a58..c438a58ca 100644--- a/fluxer_docs/src/content/docs/media-proxy/transformations.md+++ b/fluxer_docs/src/content/docs/media-proxy/transformations.md@@ -69,14 +69,15 @@ An asset request snaps `size` to the ladder and then clamps the result into the| Asset class | Routes | Range || --- | --- | --- |-| Icon | avatars, icons, branding, guild member avatars | 128 through 1024 |+| Icon | avatars, icons, guild member avatars | 128 through 1024 || Banner<sup>1</sup> | banners, splashes, embed splashes, guild member banners | 480 through 2400 || Emoji | emojis | 32 through 512 || Sticker | stickers | 128 through 512 |+| Branding | branding, sign-in backdrops | 16 through 4096 |<sup>1</sup> The banner maximum of 2400 is not a ladder rung and is reachable only by clamping, so 3072 and every larger request collapse onto it-An absent `size` resolves to 128 before clamping, so an avatar defaults to 128 and a banner defaults to 480. Emoji and sticker assets also default to 128. Every ladder value below a class minimum collapses onto that minimum, and every value above a class maximum collapses onto that maximum.+An absent `size` resolves to 128 before clamping, so an avatar defaults to 128 and a banner defaults to 480. Emoji and sticker assets also default to 128. A branding asset with no `size` is served at its original size. Every ladder value below a class minimum collapses onto that minimum, and every value above a class maximum collapses onto that maximum.## Attachment and external formats