Afbeeldingscompositie

Leg een overlay-afbeelding over een basisafbeelding met configureerbare positie, dekking en overvloeimodus. Nuttig voor het samenstellen van logo's, graphics of het combineren van meerdere afbeeldingen.

API-eindpunt

POST /api/v1/tools/image/compose

Accepteert multipart-formuliergegevens met twee afbeeldingsbestanden en een JSON-veld settings.

Parameters

Parameter	Type	Vereist	Standaard	Beschrijving
x	number	Nee	0	Horizontale offset van de overlay vanaf de linkerbovenhoek in pixels (min. 0)
y	number	Nee	0	Verticale offset van de overlay vanaf de linkerbovenhoek in pixels (min. 0)
opacity	number	Nee	100	Dekkingspercentage van de overlay (0 tot 100)
blendMode	string	Nee	"over"	Overvloeimodus voor compositie

Overvloeimodi

Waarde	Beschrijving
over	Normale overlay (standaard)
multiply	Donkerder maken door pixelwaarden te vermenigvuldigen
screen	Lichter maken door te inverteren, te vermenigvuldigen en opnieuw te inverteren
overlay	Combineert multiply en screen op basis van de helderheid van de basis
darken	Houd de donkerste pixel van elke laag
lighten	Houd de lichtste pixel van elke laag
hard-light	Sterke contrastoverlay
soft-light	Subtiele contrastoverlay
difference	Absoluut verschil tussen lagen
exclusion	Vergelijkbaar met difference maar met lager contrast

Bestandsvelden

Veldnaam	Vereist	Beschrijving
file	Ja	De basis-/achtergrondafbeelding
overlay	Ja	De overlay-/voorgrondafbeelding

Voorbeeldverzoek

curl -X POST http://localhost:1349/api/v1/tools/image/compose \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F 'settings={"x": 100, "y": 50, "opacity": 80, "blendMode": "over"}'

Met de overvloeimodus multiply:

curl -X POST http://localhost:1349/api/v1/tools/image/compose \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F 'settings={"x": 0, "y": 0, "opacity": 50, "blendMode": "multiply"}'

Voorbeeldantwoord

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/background.jpg",
  "originalSize": 3200000,
  "processedSize": 3450000
}

Opmerkingen

• Beide afbeeldingen worden gevalideerd en gedecodeerd (HEIC, RAW, PSD, SVG worden ondersteund) vóór de compositie.
• De overlay wordt geplaatst op de exacte pixelcoördinaten die zijn opgegeven met x en y. De overlay wordt niet passend gemaakt.
• Als de dekking lager is dan 100, wordt vóór het overvloeien een alfamasker op de overlay toegepast.
• De overlay kan buiten de grenzen van de basisafbeelding uitsteken (het gedeelte daarbuiten wordt afgeknipt).
• De EXIF-oriëntatie wordt automatisch toegepast op beide afbeeldingen vóór de verwerking.
• De uitvoerafmetingen komen overeen met de afmetingen van de basisafbeelding.