mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
93 lines
4.0 KiB
Markdown
93 lines
4.0 KiB
Markdown
|
---
|
|||
|
|
description: "詳細な画像メタデータ、プロパティ、チャンネルごとのヒストグラム統計を表示します。"
|
|||
|
|
i18n_source_hash: 8a0f7a0b0153
|
|||
|
|
i18n_provenance: human
|
|||
|
|
i18n_output_hash: c158254ef2ca
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 画像情報 {#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 ファイルは、Sharp が HEVC ピクセルをデコードできないため、ピクセル統計を抽出するために内部で PNG にデコードされます。
|
|||
|
|
- ヒストグラムは、完全な 256 ビン分布ではなく、チャンネルごとの最小値/最大値/平均値/標準偏差を提供します。
|
|||
|
|
- `density` フィールドは、存在する場合、埋め込まれた DPI メタデータを反映します。
|