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.3 KiB
Markdown
93 lines
3.3 KiB
Markdown
---
|
|
description: "Lihat metadata gambar terperinci, properti, dan statistik histogram per-channel."
|
|
i18n_source_hash: 8a0f7a0b0153
|
|
i18n_provenance: human
|
|
i18n_output_hash: d007549742c9
|
|
---
|
|
|
|
# Image Info {#image-info}
|
|
|
|
Alat analisis read-only yang mengembalikan metadata gambar komprehensif termasuk dimensi, format, ruang warna, keberadaan EXIF/ICC/XMP, dan statistik histogram per-channel. Tidak menghasilkan file output yang telah diproses.
|
|
|
|
## API Endpoint {#api-endpoint}
|
|
|
|
`POST /api/v1/tools/image/info`
|
|
|
|
Menerima multipart form data dengan file gambar. Tidak diperlukan field pengaturan.
|
|
|
|
## Parameters {#parameters}
|
|
|
|
Alat ini tidak memiliki parameter yang dapat dikonfigurasi. Cukup unggah file gambar.
|
|
|
|
| Field | Type | Required | Description |
|
|
|-------|------|----------|-------------|
|
|
| file | file | Yes | Gambar yang akan dianalisis |
|
|
|
|
## Example Request {#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"
|
|
```
|
|
|
|
## Example Response {#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 }
|
|
]
|
|
}
|
|
```
|
|
|
|
## Response Fields {#response-fields}
|
|
|
|
| Field | Type | Description |
|
|
|-------|------|-------------|
|
|
| filename | string | Nama file yang telah disanitasi |
|
|
| fileSize | number | Ukuran file dalam byte |
|
|
| width | number | Lebar gambar dalam piksel |
|
|
| height | number | Tinggi gambar dalam piksel |
|
|
| format | string | Format yang terdeteksi (jpeg, png, webp, dll.) |
|
|
| channels | number | Jumlah channel warna |
|
|
| hasAlpha | boolean | Apakah gambar memiliki channel alpha |
|
|
| colorSpace | string | Ruang warna (srgb, cmyk, dll.) |
|
|
| density | number or null | Resolusi DPI/PPI |
|
|
| isProgressive | boolean | Apakah JPEG menggunakan encoding progresif |
|
|
| orientation | number or null | Nilai orientasi EXIF (1-8) |
|
|
| hasProfile | boolean | Apakah ada profil ICC yang tersemat |
|
|
| hasExif | boolean | Apakah metadata EXIF ada |
|
|
| hasIcc | boolean | Apakah profil warna ICC ada |
|
|
| hasXmp | boolean | Apakah metadata XMP ada |
|
|
| bitDepth | string or null | Bit per sampel |
|
|
| pages | number | Jumlah halaman (untuk format multi-halaman seperti TIFF, GIF) |
|
|
| histogram | array | Statistik per-channel (min, max, mean, deviasi standar) |
|
|
|
|
## Notes {#notes}
|
|
|
|
- Ini adalah endpoint read-only. Ia tidak menghasilkan file output yang dapat diunduh atau sebuah `jobId`.
|
|
- Untuk gambar format RAW (DNG, CR2, NEF, ARW, dll.), ExifTool digunakan untuk mengekstrak dimensi sensor asli dan flag metadata yang tidak dapat dibaca Sharp secara langsung.
|
|
- File HEIC/HEIF di-decode ke PNG secara internal untuk mengekstrak statistik piksel, karena Sharp tidak dapat men-decode piksel HEVC.
|
|
- Histogram menyediakan min/max/mean/stdev per channel, bukan distribusi 256-bin penuh.
|
|
- Field `density` mencerminkan metadata DPI yang tersemat, bila ada.
|