mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
SnapOtterandGitHub
f858c4cea0
Renames 18 ambiguous or hard-to-search tool names so image tools self-qualify like the other modalities ("Compress" becomes "Compress Image"), and cleans up a few awkward names. Propagated across search (constants.ts), display (en.ts + 20 locales), the OpenAPI base spec + 20 locale specs, and the docs tool-page headings in 21 languages. Removes the duplicate "Normalize Audio" summary shared by the video and audio endpoints. Tool ids and routes are unchanged, so no API paths or bookmarks break.
93 lines
4.4 KiB
Markdown
93 lines
4.4 KiB
Markdown
---
|
|
description: "Kombinera flera bilder till rutnätscollage med 25+ mallar, justerbara mellanrum och hörn samt panorering och zoom per cell."
|
|
i18n_source_hash: cd50a782239d
|
|
i18n_provenance: human
|
|
i18n_output_hash: 8f2a14aa47e4
|
|
---
|
|
|
|
# Collage & Rutnät {#collage-grid}
|
|
|
|
Kombinera flera bilder till snygga rutnätscollage med 25+ mallar. Stöder layouter för 2-9 bilder med anpassningsbart mellanrum, hörnradie, bakgrundsfärg och kontroller för panorering/zoom per cell.
|
|
|
|
## API-slutpunkt {#api-endpoint}
|
|
|
|
`POST /api/v1/tools/image/collage`
|
|
|
|
## Parametrar {#parameters}
|
|
|
|
| Parameter | Typ | Obligatorisk | Standard | Beskrivning |
|
|
|-----------|------|----------|---------|-------------|
|
|
| templateId | string | Ja | - | Mallens layout-ID (t.ex. `2-h-equal`, `3-left-large`, `4-grid`, `9-grid`) |
|
|
| cells | array | Nej | - | Array med inställningar per cell med `imageIndex`, `panX`, `panY`, `zoom`, `objectFit` |
|
|
| cells[].imageIndex | integer | Ja | - | Index för bilden som ska placeras i denna cell (0-baserat) |
|
|
| cells[].panX | number | Nej | 0 | Horisontell panoreringsförskjutning (-100 till 100) |
|
|
| cells[].panY | number | Nej | 0 | Vertikal panoreringsförskjutning (-100 till 100) |
|
|
| cells[].zoom | number | Nej | 1 | Zoomnivå (1 till 10) |
|
|
| cells[].objectFit | string | Nej | `"cover"` | Hur bilden fyller cellen: `cover` eller `contain` |
|
|
| gap | number | Nej | 8 | Mellanrum mellan celler i pixlar (0 till 500) |
|
|
| cornerRadius | number | Nej | 0 | Hörnradie för varje cell i pixlar (0 till 500) |
|
|
| backgroundColor | string | Nej | `"#FFFFFF"` | Bakgrundsfärg som hex eller `"transparent"` |
|
|
| aspectRatio | string | Nej | `"free"` | Ritytans bildförhållande: `free`, `1:1`, `4:3`, `3:2`, `16:9`, `9:16`, `4:5` |
|
|
| outputFormat | string | Nej | `"png"` | Utdataformat: `png`, `jpeg`, `webp`, `avif`, `jxl` |
|
|
| quality | number | Nej | 90 | Utdatakvalitet (1 till 100) |
|
|
|
|
## Tillgängliga mallar {#available-templates}
|
|
|
|
| Mall-ID | Bilder | Layout |
|
|
|-------------|--------|--------|
|
|
| `2-h-equal` | 2 | Två lika kolumner |
|
|
| `2-v-equal` | 2 | Två lika rader |
|
|
| `2-h-left-large` | 2 | Vänster 2/3, höger 1/3 |
|
|
| `2-h-right-large` | 2 | Vänster 1/3, höger 2/3 |
|
|
| `3-left-large` | 3 | Stor till vänster, två staplade till höger |
|
|
| `3-right-large` | 3 | Två staplade till vänster, stor till höger |
|
|
| `3-top-large` | 3 | Stor upptill, två kolumner nedtill |
|
|
| `3-h-equal` | 3 | Tre lika kolumner |
|
|
| `3-v-equal` | 3 | Tre lika rader |
|
|
| `4-grid` | 4 | 2x2-rutnät |
|
|
| `4-left-large` | 4 | Stor till vänster, tre staplade till höger |
|
|
| `4-top-large` | 4 | Stor upptill, tre kolumner nedtill |
|
|
| `4-bottom-large` | 4 | Tre kolumner upptill, stor nedtill |
|
|
| `5-top2-bottom3` | 5 | Två upptill, tre nedtill |
|
|
| `5-top3-bottom2` | 5 | Tre upptill, två nedtill |
|
|
| `5-left-large` | 5 | Stor till vänster, fyra staplade till höger |
|
|
| `5-center-large` | 5 | Stor i mitten, fyra i hörnen |
|
|
| `6-grid-2x3` | 6 | 2 kolumner x 3 rader |
|
|
| `6-grid-3x2` | 6 | 3 kolumner x 2 rader |
|
|
| `6-top-large` | 6 | Stor upptill, fem kolumner nedtill |
|
|
| `7-mosaic` | 7 | Mosaiklayout |
|
|
| `8-mosaic` | 8 | Mosaiklayout |
|
|
| `9-grid` | 9 | 3x3-rutnät |
|
|
|
|
## Exempelbegäran {#example-request}
|
|
|
|
```bash
|
|
curl -X POST http://localhost:1349/api/v1/tools/image/collage \
|
|
-F "file=@photo1.jpg" \
|
|
-F "file=@photo2.jpg" \
|
|
-F "file=@photo3.jpg" \
|
|
-F "file=@photo4.jpg" \
|
|
-F 'settings={"templateId":"4-grid","gap":12,"cornerRadius":8,"backgroundColor":"#F5F5F5","outputFormat":"png","quality":90}'
|
|
```
|
|
|
|
## Exempelsvar {#example-response}
|
|
|
|
```json
|
|
{
|
|
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
|
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/collage.png",
|
|
"originalSize": 2456789,
|
|
"processedSize": 1823456
|
|
}
|
|
```
|
|
|
|
## Anteckningar {#notes}
|
|
|
|
- Ladda upp flera bildfiler i multipart-begäran. Bilderna tilldelas mallcellerna i uppladdningsordning.
|
|
- Om fler bilder laddas upp än vad mallen stöder ignoreras de extra bilderna.
|
|
- Stöder indataformaten HEIC, RAW, PSD och SVG (avkodas automatiskt).
|
|
- Ritytans basstorlek är 2400px på den längsta sidan, skalad efter valt bildförhållande.
|
|
- När `aspectRatio` är `"free"` blir ritytan som standard 4:3 (2400x1800).
|
|
- Värden för `panX`/`panY` per cell förskjuter beskärningsfönstret inom cellen. Värdet 100 flyttar helt till en kant, -100 till den andra.
|
|
- Bakgrundsfärgen `"transparent"` bevaras endast med utdataformaten `png`, `webp` eller `avif`.
|