このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

vision.AlphaBlender

イメージの結合、イメージのオーバーレイ、または選択したピクセルの強調表示

説明

AlphaBlender System object™ は 2 つのイメージを結合したり、1 つのイメージを別のイメージに重ね合わせたり、選択されたピクセルを強調表示したりします。

2 つのイメージを結合するか、1 つのイメージを別のイメージの上に重ね合わせるか、選択されたピクセルを強調表示するには、次の手順を実行します。

1. vision.AlphaBlender オブジェクトを作成し、そのプロパティを設定します。

2. 関数と同様に、引数を指定してオブジェクトを呼び出します。

System object の機能の詳細については、System object とはを参照してください。

作成

構文

alphablend = vision.AlphaBlender

alphablend = vision.AlphaBlender(Name,Value)

説明

alphablend = vision.AlphaBlender はアルファ ブレンダー System object alphablend を作成します。これは、2 つのイメージを結合したり、1 つのイメージを別のイメージの上に重ね合わせたり、選択されたピクセルを強調表示したりします。

alphablend = vision.AlphaBlender(Name,Value) は、名前と値のペアを 1 つ以上使用してプロパティを設定します。各プロパティ名を引用符で囲みます。たとえば、alphablend = vision.AlphaBlender('Operation','Blend') です。

プロパティ

特に指定がない限り、プロパティは "調整不可能" です。つまり、オブジェクトの呼び出し後に値を変更することはできません。オブジェクトは呼び出すとロックされ、ロックを解除するには関数 release を使用します。

プロパティが "調整可能" の場合、その値をいつでも変更できます。

プロパティ値の変更の詳細については、System object を使用した MATLAB でのシステム設計を参照してください。

Operation — 操作

'Blend' | 'Binary mask' | 'Highlight selected pixels'

操作。'Blend'、'Binary mask'、または 'Highlight selected pixels' として指定します。

操作	説明
'Blend'	1 つのイメージのピクセルを別のイメージと線形に結合します。
'Binary mask'	1 つのイメージのピクセル値を別のイメージのピクセル値で上書きします。
'Highlight selected pixels'	mask バイナリ イメージ入力を使用して、データ型でサポートされる最大値に設定されるピクセルを決定します。

OpacitySource — 不透明度係数のソース

Property (既定値) | 'Input port'

不透明度係数のソース。'Property' または 'Input port' として指定します。このプロパティは、Operation プロパティを Blend に設定した場合に適用されます。

Opacity — ピクセルのスケール値

0.75 (既定値) | スカラー | 行列

ピクセルのスケール値。スカラーまたは行列として指定します。オブジェクトは、イメージを結合する前に各ピクセルをスケールします。このプロパティは、OpacitySource プロパティを Property に設定した場合に適用されます。

調整可能: Yes

MaskSource — バイナリ マスク ソース

'Property' (既定値) | 'Input port'

バイナリ マスク ソース。'Property' または 'Input port' として指定します。このプロパティは、Operation プロパティを Binary mask に設定した場合に適用されます。

Mask — スカラーの上書き

1 (既定値) | 0 | binary scalar | バイナリ スカラーの行列

スカラーの上書き。すべてのピクセルに対して 0 または 1、あるいは 0 と 1 の行列として指定します。このプロパティは、MaskSource プロパティを Property に設定した場合に適用されます。

調整可能: Yes

LocationSource — 左上位置のソース

'Property' (既定値) | 'Input port'

2 番目の入力イメージの左上隅の位置のソース

2 番目の入力イメージの左上隅の位置のソース。Property または Input port として指定します。

Location — 位置

[1 1] | 2 要素ベクトル

最初の入力イメージの位置に相対的な 2 番目の入力イメージの左上隅の位置。形式 [x y] の 2 要素ベクトルとして指定します。このプロパティは、LocationSource プロパティを Property に設定した場合に適用されます。

Computer Vision Toolbox™ で使用される 2 つの主要座標であるピクセル座標と空間座標の詳細については、座標系を参照してください。

調整可能: Yes

固定小数点プロパティ

RoundingMethod — 丸め方法

'Floor' (既定値) | 'Convergent' | 'Floor' | ...

丸め方法。'Ceiling'、'Convergent'、'Floor'、'Nearest'、'Round'、'Simplest'、または 'Zero' として指定します。

OverflowAction — オーバーフロー アクション

'Wrap' (既定値) | 'Saturate'

固定小数点演算のオーバーフロー アクション。'Wrap' または 'Saturate' として指定します。

OpacityDataType — 不透明度の語長と小数部の長さ

'Same word length as input' (既定値) | 'Custom'

固定小数点演算の不透明度の語長と小数部の長さ。'Same word length as input' または 'Custom' として指定します。

CustomOpacityDataType — 不透明度の語長と小数部の長さ

numerictype([],16) (既定値) | スケーリングされていない numerictype オブジェクト

固定小数点演算の不透明度の語長と小数部の長さ。Signedness が Auto のスケーリングされていない numerictype (Fixed-Point Designer) オブジェクトとして指定します。このプロパティは、OpacityDataType プロパティを Custom に設定した場合に適用されます。

ProductDataType — 乗算の語長と小数部の長さ

'Custom' (既定値) | 'Same as first input'

乗算の語長と小数部の長さ。'Custom' または 'Same as first input' として指定します。

CustomProductDataType — 乗算の語長と小数部の長さ

numerictype([],32,10) (既定値) | スケーリングされた numerictype オブジェクト

乗算の語長と小数部の長さ。'Signedness' が 'Auto' のスケーリングされた numerictype (Fixed-Point Designer) オブジェクトとして指定します。このプロパティは、'ProductDataType' プロパティを 'Custom' に設定した場合に適用されます。

AccumulatorDataType — アキュムレータの語長と小数部の長さ

'Same as product' (既定値) | 'Custom'

アキュムレータの語長と小数部の長さ。'Same as product'、'Same as first input'、または 'Custom' として指定します。

CustomAccumulatorDataType — アキュムレータの語長と小数部の長さ

numerictype([],32,10) (既定値) | スケーリングされた numerictype オブジェクト

アキュムレータの語長と小数部の長さ。'Signedness' が 'Auto' のスケーリングされた numerictype (Fixed-Point Designer) オブジェクトとして指定します。

OutputDataType — 出力の語長と小数部の長さ

'Same as product' (既定値) | 'Custom'

出力語長と小数部の長さ。'Same as first input' または 'Custom' として指定します。

CustomOutputDataType — 出力の語長と小数部の長さ

numerictype([],32,10) (既定値) | スケーリングされた numerictype オブジェクト

出力語長と小数部の長さ。'Signedness' が 'Auto' のスケーリングされた numerictype (Fixed-Point Designer) オブジェクトとして指定します。

使用法

構文

ab = alphablend(I1,I2)

ab = alphablend(I1,I2,opacity)

ab = alphablend(I1,I2,mask)

ab = alphablend(I1,mask)

ab = alphablend(I1,I2,___,location)

説明

ab = alphablend(I1,I2) は、イメージ I1 と I2 をブレンドするアルファ ブレンダー オブジェクトを返します。

ab = alphablend(I1,I2,opacity) は、opacity 入力を使用して I1 と I2 のピクセル値を結合します。opacity 入力を使用するには、Operation プロパティを 'Blend' に設定し、OpacitySource プロパティを 'Input port' に設定しなければなりません。

ab = alphablend(I1,I2,mask) は、mask 入力を使用して、I1 を I2 の上にオーバーレイします。オーバーレイを使用する mask 入力を使用するには、Operation プロパティを 'Binary mask' に設定し、MaskSource プロパティを 'Input port' に設定しなければなりません。

ab = alphablend(I1,mask) は、mask 入力を使用して、データ型でサポートされる最大値に設定される I1 内のピクセルを確認します。オーバーレイを使用する mask 入力を使用するには、Operation プロパティを 'Highlight selected pixels' に設定し、MaskSource プロパティを 'Input port' に設定しなければなりません。

ab = alphablend(I1,I2,___,location) は、I2 の左上隅の location も設定します。location 入力を使用するためには、LocationSource プロパティも 'Input port' に設定しなければなりません。

入力引数

I1 — 入力イメージ

M x N x 3 のトゥルーカラー | M 行 N 列の 2 次元グレースケール イメージ

入力イメージ。トゥルーカラーまたは 2 次元グレースケールとして指定します。

データ型: single | double | int16 | uint8 | uint16

I2 — 入力イメージ

M x N x 3 のトゥルーカラー | M 行 N 列の 2 次元グレースケール イメージ

入力イメージ。トゥルーカラーまたは 2 次元グレースケールとして指定します。

データ型: single | double | int16 | uint8 | uint16

opacity — スケール

スカラー | 行列

ピクセルのスケール値。スカラーまたは行列として指定します。オブジェクトは、イメージを結合する前に各ピクセルをスケールします。

mask — スカラーの上書き

binary scalar | バイナリ スカラーの行列

スカラーの上書き。すべてのピクセルに対して 0 または 1、あるいは 0 と 1 の行列として指定します。

location — 位置

2 要素ベクトル

最初の入力イメージの位置に相対的な 2 番目の入力イメージの左上隅の位置。形式 [x y] の 2 要素ベクトルとして指定します。

調整可能: Yes

出力引数

alphablend — ブレンドされた出力イメージ

M x N x 3 のトゥルーカラー | M 行 N 列の 2 次元グレースケール イメージ

出力のブレンドされたイメージ。結合されたイメージ、オーバーレイされたイメージ、または選択されたピクセルが強調表示されたイメージとして返されます。

オブジェクト関数

オブジェクト関数を使用するには、System object を最初の入力引数として指定します。たとえば、obj という名前の System object のシステム リソースを解放するには、次の構文を使用します。

release(obj)

すべての System object に共通

step	System object のアルゴリズムの実行
release	リソースを解放し、System object のプロパティ値と入力特性の変更を可能にします。
reset	System object の内部状態のリセット

例

2 つのイメージのブレンド

2 つのイメージを表示します。

I1 = im2single(imread('blobs.png'));
I2 = im2single(imread('circles.png'));
subplot(1,2,1);
imshow(I1);
subplot(1,2,2);
imshow(I2);

2 つのイメージをブレンドし、結果を表示します。

blender = vision.AlphaBlender;
J = blender(I1,I2);
figure;
imshow(J);

拡張機能

C/C++ コード生成

MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意および制限:

• MATLAB コード生成における System object (MATLAB Coder)を参照してください。

バージョン履歴

R2012a で導入

参考

insertText