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.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 メタデータを反映します。
|