insertShape

イメージまたはビデオへの形状の挿入

構文

RGB = insertShape(I,shape,position)

RGB = insertShape(___,Name,Value)

説明

RGB = insertShape(I,shape,position) は、shape が挿入されたトゥルーカラーイメージを返します。入力イメージ I は、トゥルーカラーイメージまたはグレースケールイメージになります。ピクセル値を上書きすることによって形状を描画します。

例

RGB = insertShape(___,Name,Value) は、1 つ以上の Name,Value 引数ペアによって指定された追加オプションを使用します。

例

すべて折りたたむ

イメージへの円と塗りつぶし形状の挿入

ライブスクリプトを開く

イメージを読み取ります。

I = imread('peppers.png');

境界線の幅が 5 の円を描画します。

RGB = insertShape(I,'circle',[150 280 35],'LineWidth',5);

塗りつぶされた三角形と塗りつぶされた六角形を描画します。

pos_triangle = [183 297 302 250 316 297];
pos_hexagon = [340 163 305 186 303 257 334 294 362 255 361 191];
RGB = insertShape(RGB,'FilledPolygon',{pos_triangle,pos_hexagon},...
    'Color', {'white','green'},'Opacity',0.7);

イメージを表示します。

imshow(RGB);

入力引数

すべて折りたたむ

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

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

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

`shape` — 形状のタイプ
`'Rectangle'` | `'FilledRectangle'` | `'Line'` | `'Polygon'` | `'FilledPolygon'` | `'Circle'` | `'FilledCircle'`

形状のタイプ。文字ベクトルとして指定します。ベクトルとして、'Rectangle'、'FilledRectangle'、'Line'、'Polygon'、'FilledPolygon'、'Circle' または 'FilledCircle' を使用できます。

データ型: char

`position` — 形状の位置
行列 | ベクトル | cell 配列

形状の位置。表に示す形状のタイプに従って指定します。

形状位置描画される形状

形状	位置	描画される形状
`'Rectangle'` `'FilledRectangle'`	M 行 4 列の行列。各行は四角形を $[\begin{matrix} x & y & w i d t h & h e i g h t \end{matrix}]$ として指定します。 $[\begin{matrix} x_{1} & y_{1} & w i d t h_{1} & h e i g h t_{1} \\ x_{2} & y_{2} & w i d t h_{2} & h e i g h t_{2} \\ ⋮ & ⋮ & ⋮ & ⋮ \\ x_{M} & y_{M} & w i d t h_{M} & h e i g h t_{M} \end{matrix}]$
`'Line'`	1 つ以上のつながっていないラインの場合は、M 行 4 列の行列。各 4 要素ベクトル [x₁, y₁, x₂,y₂] は、端点が [x₁ y₁] と [x₂ y₂] のラインを示します。 $[\begin{matrix} x_{11} & y_{11} & x_{12} & y_{12} \\ x_{21} & y_{21} & x_{22} & y_{22} \\ ⋮ & ⋮ & ⋮ & ⋮ \\ x_{M 1} & y_{M 1} & x_{M 2} & x_{M 2} \end{matrix}]$
1 つ以上のラインセグメントの場合は、M 行 2L 列の行列。各行は、L 個の頂点をもつポリラインを表すベクトルです。 $[\begin{matrix} x_{11} & y_{11} & x_{12} & y_{12} & \dots & x_{1 L} & y_{1 L} \\ x_{21} & y_{21} & x_{22} & y_{22} & \dots & x_{2 L} & y_{2 L} \\ ⋮ & ⋮ & ⋮ & ⋮ & ⋱ & ⋮ & ⋮ \\ x_{M 1} & y_{M 1} & x_{M 2} & y_{M 2} & \dots & x_{M L} & y_{M L} \end{matrix}]$ ポリラインは最初と最後の頂点がつながれていないため、常に (L-1) 個のセグメントを含みます。セグメント数の少ないラインの場合には、終わりの座標を繰り返して行列を埋めます。形状を M ベクトルの cell 配列として指定することもできます。 {[x₁₁,y₁₁,x₁₂,y₁₂,...,x₁_p,y₁_p], [x₂₁,y₂₁,x₂₂,y₂₂,.....,x₂_q,y₂_q], ... [x_M1,y_M1,x_M2,y_M2,.......,x_M_r,y_M_r]} p、q および r では頂点の数を指定します。
`'Polygon'` `'FilledPolygon'`	M 行 2L 列の行列。各行は L 個の頂点をもつ多角形を表します。行列の各行が 1 つの多角形に対応します。セグメント数の少ない多角形の場合には、終わりの座標を繰り返して行列を埋めます。 $[\begin{matrix} x_{11} & y_{11} & x_{12} & y_{12} & \dots & x_{1 L} & y_{1 L} \\ x_{21} & y_{21} & x_{22} & y_{22} & \dots & x_{2 L} & y_{2 L} \\ ⋮ & ⋮ & ⋮ & ⋮ & ⋱ & ⋮ & ⋮ \\ x_{M 1} & y_{M 1} & x_{M 2} & y_{M 2} & \dots & x_{M L} & y_{M L} \end{matrix}]$ 形状を次のように M ベクトルの cell 配列として指定することもできます。 {[x₁₁,y₁₁,x₁₂,y₁₂,...,x₁_p,y₁_p], [x₂₁,y₂₁,x₂₂,y₂₂,.....,x₂_q,y₂_q], ... [x_M1,y_M1,x_M2,y_M2,.......,x_M_r,y_M_r]} p、q および r では頂点の数を指定します。
`'Circle'` `'FilledCircle'`	M 行 3 列の行列。各行は円を $[\begin{matrix} x & y & r a d i u s \end{matrix}]$ として指定するベクトルです。 $[\begin{matrix} x & y \end{matrix}]$ 座標は円の中心を表します。 $[\begin{matrix} x_{1} & y_{1} & r a d i u s_{1} \\ x_{2} & y_{2} & r a d i u s_{2} \\ ⋮ & ⋮ & ⋮ \\ x_{M} & y_{M} & r a d i u s_{M} \end{matrix}]$

'Rectangle'
'FilledRectangle'

M 行 4 列の行列。各行は四角形を

[\begin{matrix} x & y & w i d t h & h e i g h t \end{matrix}]

として指定します。

$[\begin{matrix} x_{1} & y_{1} & w i d t h_{1} & h e i g h t_{1} \\ x_{2} & y_{2} & w i d t h_{2} & h e i g h t_{2} \\ ⋮ & ⋮ & ⋮ & ⋮ \\ x_{M} & y_{M} & w i d t h_{M} & h e i g h t_{M} \end{matrix}]$

'Line'

1 つ以上のつながっていないラインの場合は、M 行 4 列の行列。各 4 要素ベクトル [x₁, y₁, x₂,y₂] は、端点が [x₁ y₁] と [x₂ y₂] のラインを示します。

$[\begin{matrix} x_{11} & y_{11} & x_{12} & y_{12} \\ x_{21} & y_{21} & x_{22} & y_{22} \\ ⋮ & ⋮ & ⋮ & ⋮ \\ x_{M 1} & y_{M 1} & x_{M 2} & x_{M 2} \end{matrix}]$

1 つ以上のラインセグメントの場合は、M 行 2L 列の行列。各行は、L 個の頂点をもつポリラインを表すベクトルです。

$[\begin{matrix} x_{11} & y_{11} & x_{12} & y_{12} & \dots & x_{1 L} & y_{1 L} \\ x_{21} & y_{21} & x_{22} & y_{22} & \dots & x_{2 L} & y_{2 L} \\ ⋮ & ⋮ & ⋮ & ⋮ & ⋱ & ⋮ & ⋮ \\ x_{M 1} & y_{M 1} & x_{M 2} & y_{M 2} & \dots & x_{M L} & y_{M L} \end{matrix}]$

ポリラインは最初と最後の頂点がつながれていないため、常に (L-1) 個のセグメントを含みます。セグメント数の少ないラインの場合には、終わりの座標を繰り返して行列を埋めます。

形状を M ベクトルの cell 配列として指定することもできます。

{[x₁₁,y₁₁,x₁₂,y₁₂,...,x₁_p,y₁_p], [x₂₁,y₂₁,x₂₂,y₂₂,.....,x₂_q,y₂_q], ... [x_M1,y_M1,x_M2,y_M2,.......,x_M_r,y_M_r]}

p、q および r では頂点の数を指定します。

'Polygon'
'FilledPolygon'

M 行 2L 列の行列。各行は L 個の頂点をもつ多角形を表します。行列の各行が 1 つの多角形に対応します。セグメント数の少ない多角形の場合には、終わりの座標を繰り返して行列を埋めます。

形状を次のように M ベクトルの cell 配列として指定することもできます。

{[x₁₁,y₁₁,x₁₂,y₁₂,...,x₁_p,y₁_p], [x₂₁,y₂₁,x₂₂,y₂₂,.....,x₂_q,y₂_q], ... [x_M1,y_M1,x_M2,y_M2,.......,x_M_r,y_M_r]}

p、q および r では頂点の数を指定します。

'Circle'
'FilledCircle'

M 行 3 列の行列。各行は円を

[\begin{matrix} x & y & r a d i u s \end{matrix}]

として指定するベクトルです。

[\begin{matrix} x & y \end{matrix}]

座標は円の中心を表します。

$[\begin{matrix} x_{1} & y_{1} & r a d i u s_{1} \\ x_{2} & y_{2} & r a d i u s_{2} \\ ⋮ & ⋮ & ⋮ \\ x_{M} & y_{M} & r a d i u s_{M} \end{matrix}]$

名前と値のペアの引数

オプションの引数 Name,Value のコンマ区切りペアを指定します。Name は引数名で、Value は対応する値です。Name は引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を、任意の順番で指定できます。

例: 'Color','yellow' は、形状の色に黄色を指定します。

`LineWidth` — 形状の境界線の幅
`1` (既定値) | 正のスカラー整数

形状の境界線の幅。正のスカラー整数としてピクセル単位で指定します。このプロパティは、'Rectangle'、'Line'、'Polygon' または 'Circle' の形状に対してのみ適用されます。

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

`Color` — 形状の色
`'yellow'` (既定値) | 文字ベクトル | 文字ベクトルの cell 配列 | [R G B] ベクトル | M 行 3 列の行列

形状の色。'Color' と、文字ベクトル、文字ベクトルの cell 配列、または行列で構成されるコンマ区切りのペアとして指定します。形状ごとに異なる色を指定したり、すべての形状に 1 つの色を指定したりできます。

形状ごとに色を指定するには、Color を色を表す文字ベクトルの cell 配列、または M 個の RGB (赤、緑、青) の色値の M 行 3 列の行列に設定します。

すべての形状に 1 つの色を指定するには、Color を色を表す文字ベクトルまたは [R G B] ベクトルに設定します。[R G B] ベクトルには、赤、緑、青の値が含まれます。

サポートされる色は、'blue'、'green'、'red'、'cyan'、'magenta'、'black'、'black' および 'white' です。

`Opacity` — 塗りつぶし形状の不透明度
0.6 (既定値) | [`0` `1`] の範囲

塗りつぶし形状の不透明度。'Opacity' と [0, 1] の範囲のスカラー値で構成されるコンマ区切りのペアとして指定します。Opacity プロパティは、FilledRectangle、FilledPolygon および FilledCircle の形状に対して適用されます。

`SmoothEdges` — 形状のエッジの平滑化
`true` (既定値) | `false`

形状のエッジの平滑化。'SmoothEdges' と logical 値 true または false で構成されるコンマ区切りのペアとして指定します。true 値は、アンチエイリアシングフィルターを有効にして形状のエッジを平滑化します。この値は長方形以外の形状に対してのみ適用されます。アンチエイリアシングを有効にすると、形状の描画にかかる時間が長くなります。

データ型: logical

出力引数

すべて折りたたむ

`RGB` — 出力イメージ
M x N x 3 のトゥルーカラー

出力イメージ。トゥルーカラーイメージとして返されます。

拡張機能

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

'Color' および 'SmoothEdges' はコンパイル時の定数でなければなりません。

参考

showShape | insertObjectAnnotation | insertObjectMask | insertMarker | insertText

トピック

R2014a で導入

insertShape

構文

説明

例

イメージへの円と塗りつぶし形状の挿入

入力引数

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

`shape` — 形状のタイプ
`'Rectangle'` | `'FilledRectangle'` | `'Line'` | `'Polygon'` | `'FilledPolygon'` | `'Circle'` | `'FilledCircle'`

`position` — 形状の位置
行列 | ベクトル | cell 配列

名前と値のペアの引数

`LineWidth` — 形状の境界線の幅
`1` (既定値) | 正のスカラー整数

`Color` — 形状の色
`'yellow'` (既定値) | 文字ベクトル | 文字ベクトルの cell 配列 | [R G B] ベクトル | M 行 3 列の行列

`Opacity` — 塗りつぶし形状の不透明度
0.6 (既定値) | [`0` `1`] の範囲

`SmoothEdges` — 形状のエッジの平滑化
`true` (既定値) | `false`

出力引数

`RGB` — 出力イメージ
M x N x 3 のトゥルーカラー

拡張機能

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

参考

トピック

Computer Vision Toolbox ドキュメンテーション

サポート

MATLABで始めるディープラーニング

insertShape

構文

説明

例

イメージへの円と塗りつぶし形状の挿入

入力引数

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

shape — 形状のタイプ 'Rectangle' | 'FilledRectangle' | 'Line' | 'Polygon' | 'FilledPolygon' | 'Circle' | 'FilledCircle'

position — 形状の位置 行列 | ベクトル | cell 配列

名前と値のペアの引数

LineWidth — 形状の境界線の幅 1 (既定値) | 正のスカラー整数

Color — 形状の色 'yellow' (既定値) | 文字ベクトル | 文字ベクトルの cell 配列 | [R G B] ベクトル | M 行 3 列の行列

Opacity — 塗りつぶし形状の不透明度 0.6 (既定値) | [0 1] の範囲

SmoothEdges — 形状のエッジの平滑化 true (既定値) | false

出力引数

RGB — 出力イメージ M x N x 3 のトゥルーカラー

拡張機能

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

参考

トピック

Computer Vision Toolbox ドキュメンテーション

サポート

MATLABで始めるディープラーニング

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

`shape` — 形状のタイプ
`'Rectangle'` | `'FilledRectangle'` | `'Line'` | `'Polygon'` | `'FilledPolygon'` | `'Circle'` | `'FilledCircle'`

`position` — 形状の位置
行列 | ベクトル | cell 配列

`LineWidth` — 形状の境界線の幅
`1` (既定値) | 正のスカラー整数

`Color` — 形状の色
`'yellow'` (既定値) | 文字ベクトル | 文字ベクトルの cell 配列 | [R G B] ベクトル | M 行 3 列の行列

`Opacity` — 塗りつぶし形状の不透明度
0.6 (既定値) | [`0` `1`] の範囲

`SmoothEdges` — 形状のエッジの平滑化
`true` (既定値) | `false`

`RGB` — 出力イメージ
M x N x 3 のトゥルーカラー

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