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
4.9 KiB
Markdown
93 lines
4.9 KiB
Markdown
---
|
|
description: "Просмотр подробных метаданных изображения, свойств и постатейной статистики гистограммы по каналам."
|
|
i18n_source_hash: 8a0f7a0b0153
|
|
i18n_provenance: human
|
|
i18n_output_hash: ddfe45cbea0c
|
|
---
|
|
|
|
# Информация об изображении {#image-info}
|
|
|
|
Инструмент анализа только для чтения, возвращающий полные метаданные изображения, включая размеры, формат, цветовое пространство, наличие EXIF/ICC/XMP и постатейную статистику гистограммы по каналам. Не создаёт обработанный выходной файл.
|
|
|
|
## Конечная точка API {#api-endpoint}
|
|
|
|
`POST /api/v1/tools/image/info`
|
|
|
|
Принимает данные формы multipart с файлом изображения. Поле настроек не требуется.
|
|
|
|
## Параметры {#parameters}
|
|
|
|
У этого инструмента нет настраиваемых параметров. Просто загрузите файл изображения.
|
|
|
|
| Поле | Тип | Обязательный | Описание |
|
|
|-------|------|----------|-------------|
|
|
| file | file | Да | Изображение для анализа |
|
|
|
|
## Пример запроса {#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}
|
|
|
|
```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}
|
|
|
|
| Поле | Тип | Описание |
|
|
|-------|------|-------------|
|
|
| filename | string | Очищенное имя файла |
|
|
| fileSize | number | Размер файла в байтах |
|
|
| width | number | Ширина изображения в пикселях |
|
|
| height | number | Высота изображения в пикселях |
|
|
| format | string | Обнаруженный формат (jpeg, png, webp и т. д.) |
|
|
| channels | number | Количество цветовых каналов |
|
|
| hasAlpha | boolean | Есть ли у изображения альфа-канал |
|
|
| colorSpace | string | Цветовое пространство (srgb, cmyk и т. д.) |
|
|
| density | number или null | Разрешение DPI/PPI |
|
|
| isProgressive | boolean | Использует ли JPEG прогрессивное кодирование |
|
|
| orientation | number или null | Значение ориентации EXIF (1-8) |
|
|
| hasProfile | boolean | Встроен ли ICC-профиль |
|
|
| hasExif | boolean | Присутствуют ли метаданные EXIF |
|
|
| hasIcc | boolean | Присутствует ли цветовой профиль ICC |
|
|
| hasXmp | boolean | Присутствуют ли метаданные XMP |
|
|
| bitDepth | string или null | Бит на выборку |
|
|
| pages | number | Количество страниц (для многостраничных форматов вроде TIFF, GIF) |
|
|
| histogram | array | Постатейная статистика (мин, макс, среднее, стандартное отклонение) |
|
|
|
|
## Примечания {#notes}
|
|
|
|
- Это конечная точка только для чтения. Она не создаёт загружаемый выходной файл или `jobId`.
|
|
- Для изображений в формате RAW (DNG, CR2, NEF, ARW и т. д.) для извлечения истинных размеров сенсора и флагов метаданных, которые Sharp не может прочитать напрямую, используется ExifTool.
|
|
- Файлы HEIC/HEIF декодируются в PNG внутренне для извлечения статистики пикселей, поскольку Sharp не может декодировать пиксели HEVC.
|
|
- Гистограмма предоставляет мин/макс/среднее/стандартное отклонение по каналу, а не полное распределение из 256 корзин.
|
|
- Поле `density` отражает встроенные метаданные DPI, если они присутствуют.
|