insertShape

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

構文

RGB = insertShape(I,shape,position)

RGB = insertShape(___,Name=Value)

説明

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

RGB = insertShape(___,Name=Value) は、前の構文の入力引数の入力引数に加えて、名前と値の引数を 1 つ以上使用してオプションを指定します。たとえば、LineWidth=5 は、挿入する形状の線幅の値を 5 に設定します。

例

すべて折りたたむ

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

ライブスクリプトを開く

イメージをワークスペースに読み取ります。

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,"filled-polygon",{pos_triangle pos_hexagon}, ...
    ShapeColor=["white","green"],Opacity=0.7);

結果のイメージを表示します。

imshow(RGB)

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

入力引数

すべて折りたたむ

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

入力イメージ。M×N×3 のトゥルーカラーイメージまたは M 行 N 列のグレースケールイメージとして指定します。

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

`shape` — 形状のタイプ
`"rectangle"` | `"filled-rectangle"` | `"line"` | `"polygon"` | `"filled-polygon"` | `"circle"` | `"filled-circle"` | `"projected-cuboid"`

形状のタイプ。"rectangle"、"filled-rectangle"、"line"、"polygon"、"filled-polygon"、"circle"、"filled-circle"、または "projected-cuboid" として指定します。

データ型: char | string

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

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

形状	位置	例
`rectangle` `filled-rectangle`	1 つ以上の軸に揃えられた四角形または塗りつぶされた四角形の場合、M 行 4 列の数値行列として指定します。ここで、各行は $[\begin{matrix} x & y & w i d t h & h e i g h t \end{matrix}]$ 形式の四角形を指定します。 M は軸に平行な四角形の数です。 x と `y` は四角形の左上隅を指定します。 w は四角形の幅、つまり x 軸に沿った長さを指定します。 h は四角形の高さ、つまり y 軸に沿った長さを指定します。 $[\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}]$
`rectangle` `filled-rectangle`	1 つ以上の回転した四角形の場合、空間座標で M 行 5 列の数値行列として指定します。ここで、各行は [xctr yctr w h yaw] 形式の回転した四角形を指定します。 M は回転した四角形の数です。 xctr および yctr は四角形の中心を指定します。 w は四角形の幅、つまり、回転前の x 軸に沿った長さを指定します。 h は四角形の高さ、つまり、回転前の y 軸に沿った長さを指定します。 yaw は回転角度 (度単位) を指定します。回転は四角形の中心を軸として時計回りに正となります。
`circle` `filled-circle`	1 つ以上の円の場合、空間座標を M 行 3 列の数値行列として指定します。ここで、各行は [xctr yctr radius] 形式の円を指定します。 M は円の数です。 xctr と yctr は円の中心を指定します。 radius は円の半径を指定します。 $[\begin{matrix} x c t r_{1} & y c t r_{1} & r a d i u s_{1} \\ x c t r_{2} & y c t r_{2} & r a d i u s_{2} \\ ⋮ & ⋮ & ⋮ \\ x c t r_{M} & y c t r_{M} & r a d i u s_{M} \end{matrix}]$
`line`	1 つ以上のラインの場合、以下の形式のいずれかを使用して、端点が繋がっている 1 本のライン、同じ数の端点をもつ複数のライン、または異なる数の端点をもつ複数のラインを指定するための空間座標を指定します。端点が繋がっている 1 本のライン — P 行 2 列の行列として指定します。ここで、各行は [x y] の形式で端点を指定します。また、行の端点は次の行の端点と直接繋がっています。P はライン内の端点の数です。同じ数の端点をもつ複数のライン — M 行 2P 列の行列として指定します。各行は、[x1 y1 x2 y2 ... xp yp] の形式で 1 本のラインの連続する端点を指定します。各 [x y] のペアは、単一の端点の座標です。M は指定する行の数、P は 1 行あたりの端点の数です。異なる数の端点をもつ複数のライン — M 行 1 列の cell 配列として指定します。各セルには、1 本のラインの端点を P 行 2 列の行列または 1 行 2P 列のベクトルとして格納します。M は指定する行の数、P は各行の端点の数です。
`polygon` `filled-polygon`	1 つ以上の多角形の場合、空間座標で M 行 1 列の cell 配列として指定します。各セルには、[x y] 頂点位置からなる L 行 2 列の行列、または [x₁, y₁, x₂,y₂, … x_L,y_L ] の形式の連続する頂点位置からなる 1 行 2L 列のベクトルを格納します。 M は多角形の数です。各 [x y] ペアは頂点の位置または端点を記述します。 L は、多角形の頂点またはラインの端点の数です。それぞれの多角形またはラインには、異なる数の頂点または端点を含めることができます。
`projected-cuboid`	1 つ以上の投影された直方体の場合、空間座標で 8×2×M の配列または M 行 8 列の行列として指定します。ここで、M は投影された直方体の数です。 8×2×M の配列として指定する場合、各行には投影された直方体の頂点の位置 [x y] が含まれていなければなりません。頂点が繋がって 6 つの面をもつ直方体を形成します。入力頂点の順序は、図に示されている順序と一致しなければなりません。 M 行 8 列の行列として指定する場合、各行は投影された直方体の前面と背面の寸法を [x1 y1 w1 h1 x2 y2 w2 h2] の形式で指定します。ここで、[x1 y1] と [x2 y2] はそれぞれ前面と背面の左上の座標を指定し、[w1 h1] と [w2 h2] は対応する幅と高さを指定します。

名前と値の引数

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

例: insertShape(I,"circle",position,Color="yellow") は、形状の色を黄色に設定します。

R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。

例: insertShape(I,"circle",position,"Color","yellow") は、形状の色を黄色に設定します。

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

形状の境界線の幅。正の整数としてピクセル単位で指定します。この引数は、"Rectangle"、"Line"、"Polygon"、および "Circle" の形状にのみ適用されます。

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

`ShapeColor` — 形状の色
`"green"` (既定値) | 色の省略名 | 色の名前 | 色名のベクトル | RGB 3 成分の 3 列の行列

形状の色。色の省略名、色の名前、色名のベクトル、RGB 3 成分の 3 列の行列として指定します。

サポートされている色の表には範囲 [0, 1] で RGB 強度を掲載していますが、RGB 3 成分の指定は選択するデータ型の範囲で行わなければなりません。たとえば、この引数を uint8 の値の行列として指定する場合、各強度値を [0, 255] の範囲に変換しなければなりません。掲載されている強度値を uint8 データ型に変換するには、コード uint8(255*intensity) を使用します。ここで、intensity は、表に掲載されている RGB 3 成分の値です。

形状ごとに異なる色を指定したり、すべての形状に 1 つの色を指定したりできます。すべてのマーカーに 1 つの色を指定するには、ShapeColor を色の名前または [R G B] ベクトルとして指定します。

仕様	形式	例
すべての形状 (またはマーカー) に 1 つの色を指定	色の省略名または色の名前	`"r"` `"red"`
すべての形状 (またはマーカー) に 1 つの色を指定	RGB 3 成分	`[1 0 0]`
各形状 (またはマーカー) の色を指定	色名のベクトル	`["red","yellow","blue"]`
各形状 (またはマーカー) の色を指定	RGB 3 成分の 3 列の行列	[1 0 0 0 1 1 1 0 1 1 1 1]

次の表に、サポートされている形状の色を示します。

色の名前	省略名	RGB 3 成分
`"red"`	`"r"`	`[1 0 0]`
`"green"`	`"g"`	`[0 1 0]`
`"blue"`	`"b"`	`[0 0 1]`
`"cyan"`	`"c"`	`[0 1 1]`
`"magenta"`	`"m"`	`[1 0 1]`
`"yellow"`	`"y"`	`[1 1 0]`
`"black"`	`"k"`	`[0 0 0]`
`"white"`	`"w"`	`[1 1 1]`

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

塗りつぶし形状の不透明度。[0 1] の範囲のスカラーとして指定します。引数 Opacity は、"filled-rectangle"、"filled-polygon"、および "filled-circle" の形状にのみ適用されます。

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

形状のエッジの平滑化。logical の 1 (true) または 0 (false) として指定します。true 値は、アンチエイリアシングフィルターを有効にして形状のエッジを平滑化します。この値は四角形以外の形状に対してのみ適用されます。アンチエイリアシングを有効にすると、形状の描画にかかる時間が長くなります。

データ型: logical

出力引数

すべて折りたたむ

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

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

拡張機能

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

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

名前と値の引数 Color および SmoothEdges は、コンパイル時の定数でなければなりません。
コード生成には C++ コンパイラが必要です。サポートされているコンパイラの一覧については、Supported and Compatible Compilers を参照してください。

バージョン履歴

R2014a で導入

すべて展開する

R2023b: [0,1] の範囲での RGB カラー指定

R2023b 以降、マーカーの色の RGB 値を [0,1] の範囲で指定できるようになりました。

R2023b: 境界ボックス用の回転した四角形のサポート

[xctr yctr width height yaw] の形式を使用して、回転した四角形の境界ボックスを指定できます。

R2023b: 境界ボックスの四角形の方向の表示

名前と値の引数 ShowOrientation を指定して、回転した四角形の境界ボックスの方向と角度を表示できるようになりました。

R2022b: 投影された直方体の可視化

投影された直方体を可視化するためのサポートが追加されました。

参考

関数

showShape | insertObjectAnnotation | insertObjectMask | insertMarker | insertText | cuboid2img

insertShape

構文

説明

例

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

入力引数

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

shape — 形状のタイプ "rectangle" | "filled-rectangle" | "line" | "polygon" | "filled-polygon" | "circle" | "filled-circle" | "projected-cuboid"

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

名前と値の引数

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

ShapeColor — 形状の色 "green" (既定値) | 色の省略名 | 色の名前 | 色名のベクトル | RGB 3 成分の 3 列の行列

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

SmoothEdges — 形状のエッジの平滑化 true または 1 (既定値) | false または 0

出力引数

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

拡張機能

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

バージョン履歴

R2023b: [0,1] の範囲での RGB カラー指定

R2023b: 境界ボックス用の回転した四角形のサポート

R2023b: 境界ボックスの四角形の方向の表示

R2022b: 投影された直方体の可視化

参考

関数

トピック

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

`shape` — 形状のタイプ
`"rectangle"` | `"filled-rectangle"` | `"line"` | `"polygon"` | `"filled-polygon"` | `"circle"` | `"filled-circle"` | `"projected-cuboid"`

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

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

`ShapeColor` — 形状の色
`"green"` (既定値) | 色の省略名 | 色の名前 | 色名のベクトル | RGB 3 成分の 3 列の行列

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

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

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

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