画像範囲 色解析ツール (Image Color Analyzer)

画像ファイルを開き、指定した矩形（四角形）の範囲に含まれるピクセルの色情報を統計的に解析するツールです。

---

✨ 主な機能

• インタラクティブな範囲選択: 画像をマウスでドラッグして、解析したい範囲を直感的に指定できます。
• ズーム機能: Ctrl + マウスホイール またはツールバーのボタンで、画像の拡大・縮小が可能です。
• 詳細な色分析: ターミナル（コンソール）に、選択範囲の以下の情報を出力します。
  • 平均色 (Mean): 全ピクセルのRGB値の平均。
  • 中央値 (Median): 全ピクセルを並べたときの中央のRGB値。
  • 最も明るい色: 範囲内で最も輝度が高いピクセルの色。
  • 最も暗い色: 範囲内で最も輝度が低いピクセルの色。
• HEICサポート: pillow-heif により、iPhoneなどで撮影されたHEIC形式の画像も直接開けます。

---

⚙️ 動作要件

• Python 3.8 以上
• PySide6
• NumPy
• Pillow
• pillow-heif

---

🚀 使い方

1. リポジトリのクローン

   git clone [リポジトリのURL]
   cd image-color-analyzer

2. 依存ライブラリのインストール

   # Ryeを使用している場合
   rye sync
   # pipを直接使用する場合
   # pip install PySide6 numpy pillow pillow-heif

3. アプリケーションの実行

   • ターミナルで以下のコマンドを実行します。
   • 方法A (ファイルダイアログから選択):

     python -m src.image_color_analizer

     （ファイル選択ダイアログが開きます）
   • 方法B (ファイルパスを直接指定):

     python -m src.image_color_analizer path/to/your/image.jpg

4. 色の解析

   • 画像ウィンドウが開いたら、解析したい範囲をマウスでドラッグして矩形選択します。
   • マウスボタンを離すと、即座にターミナルに解析結果が出力され、画像ウィンドウは自動で閉じます。

---

📜 ライセンス

このプロジェクトは MIT License のもとで公開されています。ライセンスの全文については、LICENSE ファイルをご覧ください。

また、このプロジェクトはサードパーティ製のライブラリを利用しています。これらのライブラリのライセンス情報については、NOTICE.md ファイルに記載しています。

作成者

Samurai-Human-Go

• 【PySide6開発奮闘記】QLabelからQGraphicsViewへ！画像解析ツールのリファクタリング全記録