mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
63 lines
2.7 KiB
Markdown
63 lines
2.7 KiB
Markdown
|
---
|
||
|
|
description: "Genereer een kleine low-quality afbeeldingsplaceholder met base64 data-URI."
|
||
|
|
i18n_source_hash: f8a27c8021f5
|
||
|
|
i18n_provenance: human
|
||
|
|
i18n_output_hash: b04cea872353
|
||
|
|
---
|
||
|
|
|
||
|
|
# LQIP-placeholder {#lqip-placeholder}
|
||
|
|
|
||
|
|
Genereer een kleine low-quality afbeeldingsplaceholder (LQIP) vanuit een bronafbeelding. Retourneert een klein placeholderbestand samen met een base64 data-URI, een kant-en-klare HTML `<img>`-tag en een CSS `background-image`-snippet voor directe inbedding.
|
||
|
|
|
||
|
|
## API Endpoint {#api-endpoint}
|
||
|
|
|
||
|
|
`POST /api/v1/tools/image/lqip-placeholder`
|
||
|
|
|
||
|
|
Accepteert multipart-formuliergegevens met een afbeeldingsbestand en een JSON-veld `settings`.
|
||
|
|
|
||
|
|
## Parameters {#parameters}
|
||
|
|
|
||
|
|
| Parameter | Type | Vereist | Standaard | Beschrijving |
|
||
|
|
|-----------|------|----------|---------|-------------|
|
||
|
|
| width | integer | Nee | `16` | Doelbreedte in pixels (4-64) |
|
||
|
|
| blur | number | Nee | `2` | Vervagingsradius voor de vervagingsstrategie (0-20) |
|
||
|
|
| strategy | string | Nee | `"blur"` | Placeholderstrategie: `blur`, `pixelate` of `solid` |
|
||
|
|
| format | string | Nee | `"webp"` | Uitvoerformaat: `webp`, `png` of `jpeg` |
|
||
|
|
| quality | integer | Nee | `50` | Uitvoerkwaliteit (1-100) |
|
||
|
|
|
||
|
|
## Voorbeeldverzoek {#example-request}
|
||
|
|
|
||
|
|
```bash
|
||
|
|
curl -X POST http://localhost:1349/api/v1/tools/image/lqip-placeholder \
|
||
|
|
-H "Authorization: Bearer si_your-api-key" \
|
||
|
|
-F "file=@photo.jpg" \
|
||
|
|
-F 'settings={"width": 20, "strategy": "blur", "format": "webp"}'
|
||
|
|
```
|
||
|
|
|
||
|
|
## Voorbeeldantwoord {#example-response}
|
||
|
|
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||
|
|
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.webp",
|
||
|
|
"originalSize": 2450000,
|
||
|
|
"processedSize": 280,
|
||
|
|
"dataUri": "data:image/webp;base64,UklGR...",
|
||
|
|
"width": 20,
|
||
|
|
"height": 13,
|
||
|
|
"bytes": 280,
|
||
|
|
"strategy": "blur",
|
||
|
|
"html": "<img src=\"data:image/webp;base64,UklGR...\" />",
|
||
|
|
"css": "background-image:url('data:image/webp;base64,UklGR...');background-size:cover;background-position:center;"
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## Opmerkingen {#notes}
|
||
|
|
|
||
|
|
- Het veld `dataUri` bevat de volledige data-URI, klaar voor gebruik in `src`-attributen of CSS zonder aanvullende verzoeken.
|
||
|
|
- De velden `html` en `css` bieden kopieer-en-plak-snippets voor veelvoorkomende gebruiksscenario's.
|
||
|
|
- De strategie `blur` produceert een zachte, vervaagde thumbnail. De strategie `pixelate` maakt een blokkerig mozaïek. De strategie `solid` retourneert één enkele gemiddelde kleur.
|
||
|
|
- Typische placeholdergroottes zijn 200-500 bytes, waardoor ze geschikt zijn om rechtstreeks in HTML in te voegen.
|
||
|
|
- De hoogte wordt automatisch berekend om de beeldverhouding van de bronafbeelding te behouden.
|
||
|
|
- HEIC-, RAW-, PSD- en SVG-invoer wordt automatisch gedecodeerd vóór de verwerking.
|