Image-engine

Het @snapotter/image-engine pakket verwerkt alle niet-AI-afbeeldingsbewerkingen. Het omhult Sharp en draait volledig in-process zonder externe afhankelijkheden.

Bewerkingen

resize

Schaal een afbeelding naar specifieke afmetingen of op percentage.

Parameter	Type	Beschrijving
width	number	Doelbreedte in pixels
height	number	Doelhoogte in pixels
fit	string	cover, contain, fill, inside of outside
withoutEnlargement	boolean	Indien true, worden kleinere afbeeldingen niet opgeschaald
percentage	number	Schaal op percentage in plaats van absolute afmetingen

Je kunt width, height of beide instellen. Als je er slechts één instelt, wordt de andere berekend om de beeldverhouding te behouden.

crop

Snijd een rechthoekig gebied uit de afbeelding.

Parameter	Type	Beschrijving
left	number	X-offset vanaf de linkerrand
top	number	Y-offset vanaf de bovenrand
width	number	Breedte van het bijsnijdgebied
height	number	Hoogte van het bijsnijdgebied
unit	string	px (standaard) of percent

rotate

Draai de afbeelding over een opgegeven hoek.

Parameter	Type	Beschrijving
angle	number	Rotatiehoek in graden (0-360)
background	string	Vulkleur voor blootgesteld gebied (standaard: #000000). Alleen van toepassing op hoeken die niet 90 graden zijn.

flip

Spiegel de afbeelding horizontaal, verticaal of beide. Ten minste één moet true zijn.

Parameter	Type	Beschrijving
horizontal	boolean	Spiegel van links naar rechts
vertical	boolean	Spiegel van boven naar beneden

convert

Wijzig het afbeeldingsformaat.

Parameter	Type	Beschrijving
format	string	Doelformaat: jpg, png, webp, avif, tiff, gif, jxl, heic, heif, bmp, ico, jp2, qoi
quality	number	Compressiekwaliteit (1-100, van toepassing op lossy-formaten)

De eerste zeven formaten (jpg tot en met jxl) worden in-process door Sharp gecodeerd. De overige formaten gebruiken externe encoders op de API-laag: heic/heif via heif-enc, bmp/ico via ImageMagick, jp2 via opj_compress en qoi via een inline TypeScript-codec.

compress

Verklein de bestandsgrootte met behoud van hetzelfde formaat.

Parameter	Type	Beschrijving
quality	number	Doelkwaliteit (1-100)
targetSizeBytes	number	Optionele doelbestandsgrootte in bytes
format	string	Optionele format-override

strip-metadata

Verwijder EXIF-, IPTC-, XMP- en ICC-metadata uit de afbeelding. Zonder parameters (of stripAll: true) wordt alles verwijderd. Geef individuele vlaggen mee voor selectieve verwijdering.

Parameter	Type	Beschrijving
stripAll	boolean	Alle metadata verwijderen (standaard wanneer geen vlaggen zijn ingesteld)
stripExif	boolean	EXIF-gegevens verwijderen (inclusief GPS als stripGps niet apart is ingesteld)
stripGps	boolean	GPS-locatiegegevens verwijderen
stripIcc	boolean	ICC-kleurprofiel verwijderen
stripXmp	boolean	XMP-metadata verwijderen

Kleuraanpassingen

Deze bewerkingen wijzigen de kleureigenschappen van een afbeelding. Elke neemt één numerieke waarde.

Bewerking	Parameter	Bereik	Beschrijving
brightness	value	-100 tot 100	Helderheid aanpassen
contrast	value	-100 tot 100	Contrast aanpassen
saturation	value	-100 tot 100	Kleurverzadiging aanpassen

Kleurfilters

Deze passen een vaste kleurtransformatie toe. Ze nemen geen parameters.

Bewerking	Beschrijving
grayscale	Omzetten naar grijstinten
sepia	Een sepiatint toepassen
invert	Alle kleuren omkeren

Kleurkanalen

Pas individuele RGB-kleurkanalen aan. Waarden zijn vermenigvuldigers waarbij 100 = geen wijziging.

Parameter	Type	Beschrijving
red	number	Vermenigvuldiger rood kanaal (0 tot 200, 100 = ongewijzigd)
green	number	Vermenigvuldiger groen kanaal (0 tot 200, 100 = ongewijzigd)
blue	number	Vermenigvuldiger blauw kanaal (0 tot 200, 100 = ongewijzigd)

sharpen

Eenvoudige verscherping, aangestuurd door één waarde.

Parameter	Type	Beschrijving
value	number	Verscherpingsintensiteit (0 tot 100). Toegewezen aan een Gaussische sigma van 0,5-10.

sharpen-advanced

Geavanceerde verscherping met drie selecteerbare methoden en een optionele ruisverminderende voorbewerking.

Parameter	Type	Beschrijving
method	string	adaptive, unsharp-mask of high-pass
sigma	number	Straal van Gaussische vervaging, 0,5-10 (adaptief)
m1	number	Verscherping van vlakke gebieden, 0-10 (adaptief)
m2	number	Verscherping van getextureerde gebieden, 0-20 (adaptief)
x1	number	Drempel vlak/gekarteld, 0-10 (adaptief)
y2	number	Max verheldering (halo-begrenzing), 0-50 (adaptief)
y3	number	Max verdonkering (halo-begrenzing), 0-50 (adaptief)
amount	number	Intensiteitspercentage, 0-500 (unsharp-mask)
radius	number	Straal van vervaging, 0,1-5,0 (unsharp-mask)
threshold	number	Minimale randhelderheid, 0-255 (unsharp-mask)
strength	number	Sterkte van menging, 0-100 (high-pass)
kernelSize	number	3 of 5 voor 3x3- / 5x5-kernel (high-pass)
denoise	string	Ruisverminderende voorbewerking: off, light, medium of strong

Parameters zijn methodespecifiek. Geef alleen de parameters mee die relevant zijn voor de gekozen methode.

color-blindness

Simuleer een kleurzienstoornis met een 3x3-kleurhercombinatiematrix.

Parameter	Type	Beschrijving
type	string	Een van: protanopia, deuteranopia, tritanopia, protanomaly, deuteranomaly, tritanomaly, achromatopsia, blueConeMonochromacy

edit-metadata

Schrijf of verwijder individuele EXIF-/IPTC-metadatavelden zonder het hele blok te verwijderen.

Parameter	Type	Beschrijving
artist	string	EXIF Artist-tag
copyright	string	EXIF Copyright-tag
imageDescription	string	EXIF ImageDescription-tag
software	string	EXIF Software-tag
dateTime	string	EXIF DateTime-tag
dateTimeOriginal	string	EXIF DateTimeOriginal-tag
clearGps	boolean	Alle GPS-tags verwijderen
fieldsToRemove	string[]	Lijst met te verwijderen EXIF-veldnamen

Alle parameters zijn optioneel. Velden die in fieldsToRemove worden opgesomd, worden uit het bestaande EXIF-blok verwijderd. Velden die via de benoemde parameters zijn ingesteld, worden geschreven (of overschreven). Binaire/onveilige sleutels zoals MakerNote worden stilzwijgend genegeerd.

Formaatdetectie

De engine detecteert invoerformaten automatisch op basis van bestandsheaders, niet alleen op basis van bestandsextensies. Dit betekent dat een .jpg-bestand dat eigenlijk een PNG is, correct wordt verwerkt. De detectie gebruikt een meerlaagse aanpak: eerst magic bytes, daarna de bestandsextensie als fallback.

SnapOtter ondersteunt 55+ invoerformaten en 13 uitvoerformaten, waaronder 23 camera-RAW-formaten van 20+ merken, professionele formaten (PSD, EPS, OpenEXR, HDR), moderne codecs (JPEG XL, AVIF, HEIC, QOI, JPEG 2000) en wetenschappelijke/gaming-formaten (FITS, DDS). Decodering wordt waar mogelijk native door Sharp afgehandeld, met automatische fallback naar ImageMagick, LibRaw en gespecialiseerde CLI-decoders.

Zie de pagina Ondersteunde formaten voor de volledige lijst.

Metadata-extractie

De info-tool geeft afbeeldingsmetadata terug. Zie Afbeeldingsinfo voor de volledige veldreferentie.

{
  "filename": "photo.jpg",
  "fileSize": 2450000,
  "width": 4032,
  "height": 3024,
  "format": "jpeg",
  "channels": 3,
  "hasAlpha": false,
  "colorSpace": "srgb",
  "density": 72,
  "isProgressive": false,
  "hasExif": true,
  "hasIcc": true,
  "hasXmp": false,
  "bitDepth": "8",
  "pages": 1,
  "histogram": [
    { "channel": "red", "min": 0, "max": 255, "mean": 128.45, "stdev": 52.31 },
    { "channel": "green", "min": 2, "max": 253, "mean": 115.22, "stdev": 48.76 },
    { "channel": "blue", "min": 0, "max": 250, "mean": 102.89, "stdev": 55.14 }
  ]
}