画像の色データの解析方法

エンタープライズ グレードの画像の色検出および分析機能に関する包括的な API リファレンスです。

ImageColorData プロパティ

プロパティ	戻り値の型	説明
ImageBase64	string	元の画像データの Base64 エンコード文字列表現により、異なるシステムやプラットフォーム間で画像コンテンツを効率的に保存および送信できます。
Pixels	PixelImageData[]	画像全体のピクセル色情報を完全に配列化したもので、個々のピクセル データに包括的にアクセスできるため、詳細な色分析が可能になります。
幅	int	画像の水平方向の寸法です。ピクセル単位で測定され、座標計算と境界の検証のために画像の幅を定義します。
高さ	int	画像の垂直方向の寸法です。ピクセル単位で測定され、座標計算と境界の検証のために画像の高さを定義します。
OffsetPoint	Point?	ターゲットを絞ったピクセル分析用のオプションの座標点です。画像内の特定の関心領域にフォーカスして色を抽出できます。
CenterColor	PixelImageData?	画像の幾何学的な中心に位置するピクセルの色データで、主な焦点や中心的なテーマの分析に役立ちます。
OffsetPointColor	PixelImageData?	ユーザー定義のオフセット座標のピクセルの色データ。OffsetPoint が指定されている場合、カスタムの位置で正確なカラー サンプリングができるようにします。
DominantColor	色	すべての画像ピクセル全体で最も頻繁に発生する色。統計的頻度分析とユークリッド距離による比較によって計算され、主要な配色テーマを特定します。
DominantUICoreColor	NUICoreColor	画像内で最も頻繁に使用される UI コア カラーの分類です。ユークリッド距離を使用して各ピクセルとターゲット UI コア カラー間の距離を計算し、次に最も頻繁に一致する色を選択することで決定されます。
DominantKnownColor	KnownColor	画像内で最も一般的な標準システム カラーです。クロスプラットフォームで一貫して識別されるよう、ユークリッド距離計算を使用して、事前定義された色定数にマッピングされます。

ImageColorData メソッドと拡張機能

メソッド	戻り値の型	説明
GetPixelImageData(x, y)	PixelImageData?	指定した座標にあるピクセルの色情報を取得します。無効な座標または空の画像データの場合は null を返します。境界の検証を自動的に実行します。
GetDominantColor()	色	すべての画像ピクセルを分析し、最も頻繁に発生する色を返します。統計的頻度分析とユークリッド距離計算を組み合わせて、色の優位性を決定します。空の画像に対しては Color.Empty を返します。
GetDominantUICoreColor()	NUICoreColor	各ピクセルとターゲット UI コア カラー間のユークリッド距離計算を使用したピクセル分類と、一致の頻度カウントにより、画像内で最も広く使用されている UI コア カラーを識別します。空の画像に対しては NUICoreColor.None を返します。
GetUICoreColors()	IEnumerable<UICoreColorFrequency>	画像内で検出されたすべての UI コア カラーを、ユークリッド距離によるマッチングを使用して頻度順に網羅的にリスト化し、詳細な色分布分析を可能にします。
GetUICoreColors(colorFilter)	IEnumerable<UICoreColorFrequency>	指定した条件に基づいてフィルター処理された UI コア カラーを頻度順に並べ替えて返します。ユークリッド距離ベースの統計的精度を維持しつつ、カスタムのフィルター ロジックを適用します。
GetDominantKnownColor()	KnownColor	ユークリッド距離計算を使用した体系的なカラー マッチングにより、画像内で最も一般的な既知の標準色を決定します。空の画像に対しては KnownColor.Transparent を返します。

PixelImageData プロパティ

プロパティ	戻り値の型	説明
X	int	画像座標系内のピクセルの水平座標位置で、左端からゼロ始まりで数えられます。
Y	int	画像座標系内のピクセルの垂直座標位置で、上端からゼロ始まりで数えられます。
値 (Value)	int	整数として格納された 24 ビット RGB カラー値で、赤はビット 16 から 23、緑は 8 から 15、青のビットは 0 から 7 を占めます。
R	byte	赤色の成分の強度を示します。範囲は 0 (赤色なし) 〜 255 (赤色の最大彩度) です。
G	byte	緑色の成分の強度を示します。範囲は 0 (緑色なし) 〜 255 (緑色の最大彩度) です。
B	byte	青色の成分の強度を示します。範囲は 0 (青色なし) 〜 255 (青色の最大彩度) です。
RawColor	色	正確な System.Drawing.Color 表現。厳密な RGB 値を持ち、近似なしで完全な色の忠実度を維持します。
色	色	System.Drawing.Color に最も近い名前の付けられた色。ユークリッド距離計算を使用してピクセルの RGB 値を照合し、人間が判読できる色の識別を提供します。
CoreColor	NUICoreColor	RGB 色空間でのユークリッド距離計算によって決定された、ピクセルに最適な UI コア カラー分類。最適なユーザー インターフェイスの配色分析に使用されます。
KnownColor	KnownColor	ユークリッド距離による比較を使用した、System.Drawing.KnownColor 列挙体と最も近い色で、アプリケーション間で標準化された色の名前付けが可能になります。

PixelImageData 拡張メソッド

メソッド	戻り値の型	説明
GetColor()	色	ピクセル データを近似なしで正確な System.Drawing.Color 表現に変換し、元の色の精度と RGB 値を保持します。
GetClosestColor()	色	RGB 色空間でのユークリッド距離計算を使用して、System.Drawing.Color コレクションから最も近い名前付きの色を識別します。
GetUICoreColor()	NUICoreColor	RGB 色空間で最適化されたユークリッド距離アルゴリズムを使用して、ピクセル色を最適な UI コア カラー分類にマッピングし、インターフェイス分析を可能にします。
GetKnownColor()	KnownColor	RGB 色空間でのユークリッド距離による包括的な比較を通じて、ピクセルの色を最も近い System.Drawing.KnownColor 列挙値に一致させます。システム依存の色は除外されます。

UICoreColorFrequency プロパティ

プロパティ	戻り値の型	説明
色	NUICoreColor	画像内で検出および分析された特定の UI コア カラーで、事前定義されたインターフェイスの色分類の 1 つを表します。
Count	int	ユークリッド距離の計算により、画像内のピクセル数が特定の UI コア カラーと一致した頻度数を示し、色分布分析のための統計データを提供します。

UI 要素の色分析のサンプル

次の例は、さまざまなステートの一般的な UI 要素の主要な色の分析を示しています。

アイコンのステート分析

アイコンの種類	視覚的なサンプル	ステート	Dimension	主要な色	主要な UI コア カラー	ユースケース
エラー アイコン		エラー/失敗	32×32	#e74c3c	赤	検証エラー、失敗した操作、重要なアラート
ワーニング アイコン		警告/アラート	32×32	#f1c40f	黄	重要な通知、要注意、注意
成功アイコン		成功/完了	32×32	#27ae60	緑	完了したタスク、成功した検証、確認
確認済みアイコン		検証済み/信頼済み	32×32	#9b59b6	マゼンタ	認証済みアカウント、信頼できるソース、プレミアム ステータス
情報アイコン		Information	32×32	#3498db	青	情報メッセージ、ヘルプ テキスト、ガイダンス

色分析のインサイト

• セマンティック カラーの一貫性: エラー ステートは一貫して赤の UI コア カラーとして分析されます。成功は緑色、警告はオレンジ/黄色となります。
• コーポレート カラーと標準色: カスタムのコーポレート カラー (#27ae60 など) は、ユークリッド距離の計算により、標準の UI コア カラー (緑色) にマップされます。
• 視覚的な階層: さまざまな UI 要素で、一貫性のあるセマンティック カラー分類を維持しながら、色の強度とスタイルが使用されています。
• アクセシビリティのコンプライアンス: 色分析は、さまざまな UI ステートで十分なコントラスト比とセマンティックな意味を検証するのに役立ちます。
• オートメーションのテスト: 主要な色の検出により、UI のステート変更と視覚的なフィードバックの自動的な検証が可能になります。