Files
SnapOtter/apps/docs/de/tools/image/info.md
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

3.5 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Zeigt detaillierte Bildmetadaten, Eigenschaften und Histogrammstatistiken pro Kanal an. 8a0f7a0b0153 human bd976d2a6f65

Bildinformationen

Schreibgeschütztes Analysewerkzeug, das umfassende Bildmetadaten zurückgibt, darunter Abmessungen, Format, Farbraum, das Vorhandensein von EXIF/ICC/XMP und Histogrammstatistiken pro Kanal. Erzeugt keine verarbeitete Ausgabedatei.

API-Endpunkt

POST /api/v1/tools/image/info

Akzeptiert Multipart-Formulardaten mit einer Bilddatei. Es ist kein Einstellungsfeld erforderlich.

Parameter

Dieses Werkzeug hat keine konfigurierbaren Parameter. Laden Sie einfach die Bilddatei hoch.

Feld Typ Erforderlich Beschreibung
file file Ja Das zu analysierende Bild

Beispielanfrage

curl -X POST http://localhost:1349/api/v1/tools/image/info \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg"

Beispielantwort

{
  "filename": "photo.jpg",
  "fileSize": 2450000,
  "width": 4032,
  "height": 3024,
  "format": "jpeg",
  "channels": 3,
  "hasAlpha": false,
  "colorSpace": "srgb",
  "density": 72,
  "isProgressive": false,
  "orientation": 1,
  "hasProfile": true,
  "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 }
  ]
}

Antwortfelder

Feld Typ Beschreibung
filename string Bereinigter Dateiname
fileSize number Dateigröße in Bytes
width number Bildbreite in Pixeln
height number Bildhöhe in Pixeln
format string Erkanntes Format (jpeg, png, webp usw.)
channels number Anzahl der Farbkanäle
hasAlpha boolean Ob das Bild einen Alphakanal hat
colorSpace string Farbraum (srgb, cmyk usw.)
density number oder null DPI/PPI-Auflösung
isProgressive boolean Ob JPEG progressive Codierung verwendet
orientation number oder null EXIF-Ausrichtungswert (1-8)
hasProfile boolean Ob ein ICC-Profil eingebettet ist
hasExif boolean Ob EXIF-Metadaten vorhanden sind
hasIcc boolean Ob ein ICC-Farbprofil vorhanden ist
hasXmp boolean Ob XMP-Metadaten vorhanden sind
bitDepth string oder null Bits pro Sample
pages number Anzahl der Seiten (bei mehrseitigen Formaten wie TIFF, GIF)
histogram array Statistiken pro Kanal (Minimum, Maximum, Mittelwert, Standardabweichung)

Hinweise

  • Dies ist ein schreibgeschützter Endpunkt. Er erzeugt keine herunterladbare Ausgabedatei und keine jobId.
  • Bei Bildern im RAW-Format (DNG, CR2, NEF, ARW usw.) wird ExifTool verwendet, um die tatsächlichen Sensorabmessungen und Metadaten-Flags zu extrahieren, die Sharp nicht direkt lesen kann.
  • HEIC/HEIF-Dateien werden intern zu PNG decodiert, um Pixelstatistiken zu extrahieren, da Sharp HEVC-Pixel nicht decodieren kann.
  • Das Histogramm liefert Minimum/Maximum/Mittelwert/Standardabweichung pro Kanal, nicht eine vollständige Verteilung mit 256 Bins.
  • Das Feld density gibt die eingebetteten DPI-Metadaten wieder, sofern vorhanden.