mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
SnapOtterandGitHub
4963ab3bbd
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.
93 lines
3.5 KiB
Markdown
93 lines
3.5 KiB
Markdown
---
|
|
description: "Zeigt detaillierte Bildmetadaten, Eigenschaften und Histogrammstatistiken pro Kanal an."
|
|
i18n_source_hash: 8a0f7a0b0153
|
|
i18n_provenance: human
|
|
i18n_output_hash: bd976d2a6f65
|
|
---
|
|
|
|
# Bildinformationen {#image-info}
|
|
|
|
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 {#api-endpoint}
|
|
|
|
`POST /api/v1/tools/image/info`
|
|
|
|
Akzeptiert Multipart-Formulardaten mit einer Bilddatei. Es ist kein Einstellungsfeld erforderlich.
|
|
|
|
## Parameter {#parameters}
|
|
|
|
Dieses Werkzeug hat keine konfigurierbaren Parameter. Laden Sie einfach die Bilddatei hoch.
|
|
|
|
| Feld | Typ | Erforderlich | Beschreibung |
|
|
|-------|------|----------|-------------|
|
|
| file | file | Ja | Das zu analysierende Bild |
|
|
|
|
## Beispielanfrage {#example-request}
|
|
|
|
```bash
|
|
curl -X POST http://localhost:1349/api/v1/tools/image/info \
|
|
-H "Authorization: Bearer si_your-api-key" \
|
|
-F "file=@photo.jpg"
|
|
```
|
|
|
|
## Beispielantwort {#example-response}
|
|
|
|
```json
|
|
{
|
|
"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 {#response-fields}
|
|
|
|
| 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 {#notes}
|
|
|
|
- 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.
|