getPixelValue

数値配列としてのピクセル値の取得

ページ内をすべて折りたたむ

構文

pixval = getPixelValue(imgmodel,r,c)

説明

pixval = getPixelValue(imgmodel,r,c) は、イメージ モデル imgmodel にある (行, 列) 座標が (r, c) の 1 つ以上のピクセルの数値を返します。

例

例

すべて折りたたむ

ライブ スクリプトを開く

imagemodel オブジェクトから得られたピクセル値は、さまざまな対話型のイメージ処理ツールでの表示に適した複数の形式で返すことができます。

カラー イメージに関連付けられたイメージ モデルを作成します。

h = imshow('flamingos.jpg');

Figure contains an axes object. The hidden axes object contains an object of type image.

im = imagemodel(h)
 
im =
 
IMAGEMODEL object accessing an image with these properties:

       ClassType: 'uint8'
    DisplayRange: []
     ImageHeight: 972
       ImageType: 'truecolor'
      ImageWidth: 1296
    MinIntensity: []
    MaxIntensity: []

行座標と列座標を指定してピクセルを選択します。このピクセルの (行, 列) 座標は (100, 200) です。

r = 100;
c = 200;

関数 getPixelValue を使用してピクセルの数値を取得します。

pxValue = getPixelValue(im,r,c)
pxValue = 1×3 uint8 row vector

   104    95    54

関数 getDefaultPixelInfoString を使用して既定のピクセル情報文字列を取得します。この文字列はイメージのタイプによって異なりますが、ピクセル値を使用しません。ピクセル情報文字列はピクセル情報ツールで使用するのに適しています。

defaultPxInfoStr = getDefaultPixelInfoString(im)
defaultPxInfoStr = 
'[R G B]'

関数 getPixelInfoString を使用して、指定したピクセルのピクセル情報文字列を同じ文字列形式で取得します。

pxInfoStr = getPixelInfoString(im,r,c)
pxInfoStr = 
'[104 95 54]'

関数 getDefaultPixelRegionString を使用して既定のピクセル領域文字列を取得します。この文字列はイメージのタイプによって異なりますが、ピクセル値を使用しません。ピクセル領域文字列はピクセル領域ツールで使用するのに適しています。

defaultPxRegStr = getDefaultPixelRegionString(im)
defaultPxRegStr = 
    'R:000
     G:000
     B:000'

指定したピクセルのピクセル領域文字列を同じ文字列形式で取得するための 2 つの手順があります。まず、関数 getPixelRegionFormatFcn を使用して、数値ピクセル値の形式を整える関数 formatFcn を取得します。次に、formatFcn の入力引数としてピクセルの行座標と列座標を指定して、形式を整えた文字列を取得します。

formatFcn = getPixelRegionFormatFcn(im);
pxRegStr = formatFcn(r,c)
pxRegStr = 1×1 cell array
    {'R:104↵G: 95↵B: 54'}

入力引数

すべて折りたたむ

イメージ モデル。スカラー imagemodel オブジェクトとして指定します。

ピクセルの行座標。正の整数または正の整数のベクトルとして指定します。

ピクセルの列座標。正の整数または正の整数のベクトルとして指定します。

出力引数

すべて折りたたむ

ピクセル値。次のいずれかとして返されます。

入力タイプ返される形式
p 個のグレースケール ピクセルp 要素の数値の行ベクトル
p 個の RGB ピクセル長さ p*3 の数値行ベクトル。最初の p 要素は各ピクセルの赤の値です。次の p 要素は各ピクセルの緑の値です。最後の p 要素は各ピクセルの青の値です。
p 個のバイナリ ピクセルp 要素の logical 行ベクトル
p 個のインデックス付きピクセルp 行 3 列の数値配列。各行がピクセルを指定します。列は、そのピクセル値を構成する赤、緑、青の成分を指定します。

バージョン履歴

R2006a より前に導入

参考

| | |