mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

T

SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages

All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.

2026-07-11 13:52:47 +08:00

5.8 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Vergroot/verklein, optimaliseer, wijzig de snelheid, keer om, roteer en extraheer frames uit geanimeerde GIF's in één enkel hulpmiddel.	5e525e80db92	human	d26467ae5a9b

GIF-tools

Vergroot/verklein, optimaliseer, wijzig de snelheid, keer om, extraheer frames en roteer geanimeerde GIF's. Biedt meerdere bewerkingsmodi in één enkel hulpmiddel.

API Endpoint

POST /api/v1/tools/image/gif-tools

Parameters

Algemene parameters

Parameter	Type	Vereist	Standaard	Beschrijving
mode	string	Nee	`"resize"`	Bewerkingsmodus: `resize`, `optimize`, `speed`, `reverse`, `extract`, `rotate`
loop	number	Nee	0	Aantal herhalingen voor de uitvoer-GIF (0 = oneindig, 1-100 = eindig aantal herhalingen)

Parameters voor vergroten/verkleinen-modus

Parameter	Type	Vereist	Standaard	Beschrijving
width	integer	Nee	-	Doelbreedte in pixels (1 tot 16384)
height	integer	Nee	-	Doelhoogte in pixels (1 tot 16384)
percentage	number	Nee	-	Schaal op percentage (1 tot 500). Overschrijft width/height indien ingesteld.

Parameters voor optimaliseren-modus

Parameter	Type	Vereist	Standaard	Beschrijving
colors	number	Nee	256	Maximaal aantal kleuren in het palet (2 tot 256)
dither	number	Nee	1.0	Ditheringsterkte (0 tot 1, waarbij 0 dithering uitschakelt)
effort	number	Nee	7	Optimalisatie-inspanningsniveau (1 tot 10, hoger = langzamer maar kleiner)

Parameters voor snelheidsmodus

Parameter	Type	Vereist	Standaard	Beschrijving
speedFactor	number	Nee	1.0	Snelheidsvermenigvuldiger (0.1 tot 10). Waarden > 1 versnellen, < 1 vertragen.

Parameters voor extractiemodus

Parameter	Type	Vereist	Standaard	Beschrijving
extractMode	string	Nee	`"single"`	Extractiemodus: `single`, `range`, `all`
frameNumber	number	Nee	0	Frame-index om te extraheren in `single`-modus (0-gebaseerd)
frameStart	number	Nee	0	Startframe-index voor `range`-modus (0-gebaseerd)
frameEnd	number	Nee	-	Eindframe-index voor `range`-modus (0-gebaseerd, inclusief)
extractFormat	string	Nee	`"png"`	Formaat voor geëxtraheerde frames: `png`, `webp`

Parameters voor rotatiemodus

Parameter	Type	Vereist	Standaard	Beschrijving
angle	number	Nee	-	Rotatiehoek: `90`, `180` of `270` graden
flipH	boolean	Nee	`false`	Horizontaal spiegelen
flipV	boolean	Nee	`false`	Verticaal spiegelen

Voorbeeldverzoeken

Vergroten/verkleinen

curl -X POST http://localhost:1349/api/v1/tools/image/gif-tools \
  -F "file=@animation.gif" \
  -F 'settings={"mode":"resize","percentage":50}'

Optimaliseren

curl -X POST http://localhost:1349/api/v1/tools/image/gif-tools \
  -F "file=@large.gif" \
  -F 'settings={"mode":"optimize","colors":128,"effort":9}'

Versnellen

curl -X POST http://localhost:1349/api/v1/tools/image/gif-tools \
  -F "file=@animation.gif" \
  -F 'settings={"mode":"speed","speedFactor":2.0}'

Eén frame extraheren

curl -X POST http://localhost:1349/api/v1/tools/image/gif-tools \
  -F "file=@animation.gif" \
  -F 'settings={"mode":"extract","extractMode":"single","frameNumber":5,"extractFormat":"png"}'

Voorbeeldantwoord

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/animation.gif",
  "originalSize": 2345678,
  "processedSize": 1234567
}

Info-subroute

POST /api/v1/tools/image/gif-tools/info

Retourneert metadata over een geanimeerde GIF zonder deze te verwerken.

Info-verzoek

curl -X POST http://localhost:1349/api/v1/tools/image/gif-tools/info \
  -F "file=@animation.gif"

Info-antwoord

{
  "width": 480,
  "height": 320,
  "pages": 24,
  "delay": [100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100, 100],
  "loop": 0,
  "fileSize": 2345678,
  "duration": 2400
}

Opmerkingen

Gebruikt de standaard createToolRoute-factory voor het hoofdverwerkingsendpoint.
Het info-endpoint vereist alleen een bestandsupload (geen instellingen nodig).
In resize-modus heeft percentage voorrang op width/height als het is opgegeven. Het vergroten/verkleinen gebruikt fit: inside om de beeldverhouding te behouden.
In speed-modus worden framevertragingen gedeeld door de snelheidsfactor. De minimale vertraging per frame is 20ms (beperking van de GIF-specificatie).
In reverse-modus is de parameter speedFactor ook beschikbaar om de snelheid gelijktijdig aan te passen tijdens het omkeren.
In extract-modus met range of all is de uitvoer een ZIP-bestand met de individuele frames.
In rotate-modus wordt elk frame afzonderlijk verwerkt en opnieuw samengevoegd tot een animatie.
De parameter loop bepaalt hoe vaak de uitvoer-GIF wordt herhaald. Gebruik 0 voor oneindig herhalen.
Het veld duration in het info-antwoord is de totale animatieduur in milliseconden.

5.8 KiB Raw Blame History