最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

Draw Shapes

イメージ上への四角形、ライン、多角形または円の描画

  • ライブラリ:
  • Computer Vision Toolbox / Text & Graphics

説明

Draw Shapes ブロックは、ピクセル値を上書きして、イメージ上に四角形、ライン、多角形または円を描画します。その結果、形状が出力イメージに埋め込まれます。このブロックは、Bresenham の線分描画アルゴリズムを使用してライン、多角形および四角形を描画し、Bresenham の円描画アルゴリズムを使用して円を描画します。出力信号のサイズとデータ型は、ImageRG および B 端子への入力と同じになります。

形状の塗りつぶしや境界線の色は、入力端子を通じて、または [ブロック パラメーター] ウィンドウに値を手動で入力して設定できます。色のパラメーターを使用して、四角形、ライン、多角形または円の外観を決定します。

端子

入力

すべて展開する

入力イメージ。強度値の M 行 N 列の行列、または M x N x P の色の値 (P は色平面の数) として指定します。

データ型: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | boolean | fixed point

赤色のビデオ ストリーム。スカラー、ベクトルまたは行列として指定します。この入力は RGB ビデオ ストリームの 1 つの平面を表します。RG および B 端子の次元数とデータ型は同じでなければなりません。

依存関係

この端子を有効にするには、[イメージ信号] パラメーターを [個別のカラー信号] に設定します。

データ型: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | boolean | fixed point

緑色のビデオ ストリーム。スカラー、ベクトルまたは行列として指定します。この入力は RGB ビデオ ストリームの 1 つの平面を表します。RG および B 端子の次元数とデータ型は同じでなければなりません。

依存関係

この端子を有効にするには、[イメージ信号] パラメーターを [個別のカラー信号] に設定します。

データ型: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | boolean | fixed point

青色のビデオ ストリーム。スカラー、ベクトルまたは行列として指定します。この入力は RGB ビデオ ストリームの 1 つの平面を表します。RG および B 端子の次元数とデータ型は同じでなければなりません。

依存関係

この端子を有効にするには、[イメージ信号] パラメーターを [個別のカラー信号] に設定します。

データ型: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | boolean | fixed point

形状座標。点の形式は、[形状] パラメーターで指定した形状のタイプによって異なります。

  • 四角形 — M 個の四角形の M 行 4 列の行列。各四角形の形式は [x y width height] でなければなりません。

    形状Pts 端子への入力描画される形状
    1 つの四角形
    [x y width height] 形式の 4 要素の行ベクトル 。ここで、
    • xy は四角形の左上隅を示す 1 ベースの座標です。

    • widthheight は四角形の幅と高さ (ピクセル単位) です。widthheight の値は 0 より大きくなければなりません。

    M 個の四角形

    次の形式の M 行 4 列の行列

    [x1y1width1height1x2y2width2height2xMyMwidthMheightM]

    行列の各行は異なる 1 つの四角形に対応し、1 つの四角形を表すベクトルと同じ形式です。

  • ライン — M 個のポリラインの M 行 2L 列の行列。各ポリラインの形式は、[x1,y1,x2,y2,…,xL,yL] でなければなりません。

    形状Pts 端子への入力描画される形状
    1 本のライン[x1 y1 x2 y2] 形式の 4 要素の行ベクトル。ここで、
    • x1y1 はラインの始まりを示す座標です。

    • x2y2 はラインの終わりを示す座標です。

    M 本のライン

    次の形式の M 行 4 列の行列

    [x11y11x12y12x21y21x22y22xM1yM1xM2yM2]

    行列の各行は異なる 1 本のラインに対応し、1 本のラインを表すベクトルと同じ形式です。

    (L-1) 個のセグメントからなる 1 つのポリラインサイズ 2L のベクトル。ここで L は頂点の数を示し、[x1, y1, x2, y2, ..., xL, yL] の形式を取ります。ここで、
    • x1 と y1 は、最初のライン セグメントの始まりの座標です。

    • x2 と y2 は、最初のライン セグメントの終わりと 2 番目のライン セグメントの始まりを示す座標です。

    • xL と yL は、(L-1) 番目のライン セグメントの終わりを示す座標です。

    ポリラインは最初と最後の頂点がつながれていないため、常に (L-1) 個のセグメントを含みます。行の数が 2 未満の場合や 2 の倍数でない場合、ブロックはエラー メッセージを生成します。

    (L-1) 個のセグメントからなる M 個のポリライン

    次の形式の M 行 2L 列の行列

    [x11y11x12y12x1Ly1Lx21y21x22y22x2Ly2LxM1yM1xM2yM2xMLyML]

    行列の各行は異なる 1 つのポリラインに対応し、1 つのポリラインを表すベクトルと同じ形式です。1 つのポリラインに含めるセグメントの数を (L–1) より小さい値に指定する場合、最後の頂点の座標を繰り返して行列を埋めなければなりません。

    行の数が 2 未満の場合や 2 の倍数でない場合、ブロックはエラー メッセージを生成します。

  • 多角形 — M 個の多角形の M 行 2L 列の行列。各多角形の形式は、[x1,y1,x2,y2,…,xL,yL] でなければなりません。点は、多角形を形成する順序どおりに指定します。

    形状Pts 端子への入力描画される形状
    L 個のライン セグメントからなる 1 つの多角形サイズ 2L の行ベクトル。ここで L は頂点の数を示し、[x1 y1 x2 y2 ... xL yL] の形式を取ります。ここで、
    • x1 と y1 は、最初のライン セグメントの始まりの座標です。

    • x2 と y2 は、最初のライン セグメントの終わりと 2 番目のライン セグメントの始まりを示す座標です。

    • xL と yL は、(L-1) 番目のライン セグメントの終わりと L 番目のライン セグメントの始まりを示す座標です。

    ブロックは [x1 y1][xL yL] に接続して多角形を完成させます。行の数が負の値の場合、または 2 の倍数にならない場合には、ブロックはエラーを生成します。

    あるラインのライン セグメントの最大数が L である M 個の多角形

    次の形式の M 行 2L 列の行列

    [x11y11x12y12x1Ly1Lx21y21x22y22x2Ly2LxM1yM1xM2yM2xMLyML]

    行列の各行は異なる 1 つの多角形に対応し、1 つの多角形を表すベクトルと同じ形式です。一部の多角形が他より短い場合には、終わりの座標を繰り返して多角形行列を埋めます。

    行の数が 2 未満の場合や 2 の倍数でない場合、ブロックはエラー メッセージを生成します。

  • — M 個の円の M 行 3 列の行列。各円の形式は [x y radius] でなければなりません。

    形状Pts 端子への入力描画される形状
    1 つの円
    [x y radius] 形式の 3 要素の行ベクトル。ここで、
    • xy は円の中心を示す座標です。

    • radius は円の直径で、0 より大きくなければなりません。

    M 個の円

    次の形式の "M 行 3 列" の行列

    [x1y1radius1x2y2radius2xMyMradiusM]

    行列の各行は異なる 1 つの円に対応し、1 つの円を表すベクトルと同じ形式です。

依存関係

  • 倍精度浮動小数点は、Image 端子、または RG および B 端子への入力が浮動小数点の場合にのみサポートされます。

  • 単精度浮動小数点は、Image 端子、または RG および B 端子への入力が浮動小数点の場合にのみサポートされます。

データ型: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32

関心領域。4 要素ベクトル [x y width height] として指定します。この領域は、形状を描画する四角形の領域を定義します。最初の 2 つの要素は領域の左上隅の 1 ベースの座標を表します。次の 2 要素は領域の幅と高さを表します。

依存関係

この端子を有効にするには、[形状の描画領域] パラメーターを [関心領域を端子により指定] に設定します。

データ型: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | boolean | fixed point

形状の色。P 要素ベクトルまたは M 個の形状と P 個の色平面の M 行 P 列の行列として指定します。形状ごとに色 (RGB) を指定したり、すべての形状に 1 つの色を指定したりできます。

依存関係

この端子を有効にするには、[境界線の色のソース] パラメーターを [入力端子] に設定します。

データ型: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | boolean | fixed point

出力

すべて展開する

出力イメージ。スカラー、ベクトルまたは行列として返されます。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | boolean | fixed point | 列挙型 | バス

パラメーター

すべて展開する

[メイン] タブ

[形状の塗りつぶし] を選択して、強度値または色を指定します。

メモ

コード生成時に [形状の塗りつぶし] チェック ボックスをオンにしている場合、ブロック入力の語長が 16 ビットを上回ることはありません。

塗りつぶし色のソースの値を [ダイアログにより指定] または [入力端子] のいずれかに指定します。

依存関係

このパラメーターを有効にするには、[形状の塗りつぶし] を選択します。

形状の塗りつぶしの色を指定します。

依存関係

このパラメーターを有効にするには、[形状の塗りつぶし] パラメーターを選択します。

境界線の色のソースの値を [ダイアログにより指定] または [入力端子] のいずれかに指定します。

依存関係

このパラメーターを有効にするには、[形状の塗りつぶし] パラメーターを選択します。

形状の境界線の外観を指定します。[黒][白] または [ユーザー指定の値] を指定できます。次の表で、ブロック入力と描画する形状の数に基づいて、どのように色の値を入力するかを説明します。

ブロック入力1 つの形状または複数の形状を同じ色で描画する場合の色の値複数の形状をそれぞれ独自の色で描画する場合の色の値
強度イメージスカラー強度値R 要素ベクトル (R は形状の数)
カラー イメージP 要素ベクトル (P は色平面の数)R 行 P 列の行列 (P は色平面の数、R は形状の数)

[カラー値] パラメーターの各値について、入力イメージのデータ型で示される最小値と最大値の間の数値を入力します。この範囲外の値を入力すると、ブロックによってエラー メッセージが表示されます。

依存関係

このパラメーターを有効にするには、[形状の塗りつぶし] パラメーターをオフにします。

形状の境界線または塗りつぶしの強度または色の値を指定します。

調整可能: Yes

依存関係

このパラメーターを有効にするには、[境界線の色] パラメーターまたは [塗りつぶし色] パラメーターを [ユーザー指定の値] に設定します。

形状内部のシェーディングの不透明度を指定します。0 は透明、1 は不透明です。

1 つの形状または複数の形状を同じ色で描画する場合の不透明度係数の値複数の形状をそれぞれ独自の色で描画する場合の不透明度係数の値
スカラー強度値R 要素ベクトル (R は形状の数)

依存関係

このパラメーターを有効にするには、[形状の塗りつぶし] パラメーターをオフにします。

ライン、多角形または円に対して平滑化アルゴリズムを実行します。

依存関係

  • このパラメーターを有効にするには、[形状] パラメーターを [ライン][多角形] または [円] のいずれかに設定します。

カラー ビデオ信号の入出力方法を指定します。カラー ビデオ信号を次のいずれかとして選択します。

  • 1 つの多次元信号 — ブロックは M x N x P のカラー ビデオ信号を受け入れます。P は、1 つの端子での色平面の数です。

  • 個別のカラー信号[R][G] および [B] の各入力端子が有効になります。それぞれの端子が RGB ビデオ ストリームの 1 つの M x N 平面を受け入れます。

[データ型] タブ

固定小数点ブロック パラメーターの詳細については、ブロックの固定小数点属性の指定を参照してください。

ブロックの特性

データ型

boolean | double | fixed point | 整数 | single

多次元信号

あり

可変サイズの信号

あり

拡張機能

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

固定小数点の変換
Fixed-Point Designer™ を使用して固定小数点システムの設計とシミュレーションを行います。

R2006a より前に導入