形状とラインの描画

描画する形状のタイプを指定する場合、そのイメージ上の位置も指定しなければなりません。次の表に、さまざまな形状に対するポイントの入力形式を示します。

四角形

形状 PTS 入力描画される形状

1 つの四角形

形状	PTS 入力	描画される形状
1 つの四角形	4 要素の行ベクトル `[x y width height]`。ここで、 `x` と `y` は四角形の左上隅を示す 1 ベースの座標です。 `width` と `height` は四角形の幅と高さ (ピクセル単位) です。`width` と `height` の値は 0 より大きくなければなりません。
M 個の四角形	M 行 4 列の行列 $[\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}]$ 行列のそれぞれの行は異なる 1 つの四角形に対応し、1 つの四角形を表すベクトルと同じ形式です。

4 要素の行ベクトル
[x y width height]。ここで、

x と y は四角形の左上隅を示す 1 ベースの座標です。
width と height は四角形の幅と高さ (ピクセル単位) です。width と height の値は 0 より大きくなければなりません。

M 個の四角形

M 行 4 列の行列

$[\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}]$

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

ラインとポリライン

1 つ以上のラインまたはポリラインを描画できます。ポリラインには一連の接続されたラインセグメントが含まれます。

形状	PTS 入力	描画される形状
1 本のライン	4 要素の行ベクトル `[x₁ y₁ x₂ y₂]`。ここで、 `x₁` と `y₁` はラインの始まりを示す座標です。 `x₂` と `y₂` はラインの終わりを示す座標です。
M 本のライン	M 行 4 列の行列 $[\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} & y_{M 2} \end{matrix}]$ 行列のそれぞれの行は異なる 1 本のラインに対応し、1 本のラインを表すベクトルと同じ形式です。
(L-1) 個のセグメントからなる 1 つのポリライン	サイズ 2L のベクトル。ここで L は頂点の数を示し、`[x₁, y₁, x₂, y₂, ..., x_L, y_L]` の形式を取ります。ここで、 x₁ と y₁ は、最初のラインセグメントの始まりの座標です。 x₂ と y₂ は、最初のラインセグメントの終わりと 2 番目のラインセグメントの始まりを示す座標です。 x_L と y_L は、(L-1) 番目のラインセグメントの終わりを示す座標です。ポリラインは最初と最後の頂点がつながれていないため、常に (L-1) 個のセグメントを含みます。行の数が 2 未満の場合や 2 の倍数でない場合、ブロックはエラーメッセージを生成します。
(L-1) 個のセグメントからなる M 個のポリライン	2L 行 N 列の行列 $[\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}]$ 行列のそれぞれの行は異なる 1 つのポリラインに対応し、1 つのポリラインを表すベクトルと同じ形式です。1 つのポリラインに含めるセグメントの数を (L–1) より小さい値に指定する場合、最後の頂点の座標を繰り返して行列を埋めなければなりません。行の数が 2 未満の場合や 2 の倍数でない場合、ブロックはエラーメッセージを生成します。

多角形

1 つ以上の多角形を描画できます。

形状 PTS 入力描画される形状

L 個のラインセグメントからなる 1 つの多角形

形状	PTS 入力	描画される形状
L 個のラインセグメントからなる 1 つの多角形	サイズ 2L の行ベクトル。ここで L は頂点の数を示し、`[x₁ y₁ x₂ y₂ ... x_L y_L]` の形式を取ります。ここで、 x₁ と y₁ は、最初のラインセグメントの始まりの座標です。 x₂ と y₂ は、最初のラインセグメントの終わりと 2 番目のラインセグメントの始まりを示す座標です。 x_L と y_L は、(L-1) 番目のラインセグメントの終わりと L 番目のラインセグメントの始まりを示す座標です。ブロックは `[x₁ y₁]` を `[x_L y_L]` に接続して多角形を完成させます。行の数が負の値の場合、または 2 の倍数にならない場合には、ブロックはエラーを生成します。
あるラインのラインセグメントの最大数が L である M 個の多角形	M 行 2L 列の行列 $[\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}]$ 行列のそれぞれの行は異なる 1 つの多角形に対応し、1 つの多角形を表すベクトルと同じ形式です。一部の多角形が他より短い場合には、終わりの座標を繰り返して多角形行列を埋めます。行の数が 2 未満の場合や 2 の倍数でない場合、ブロックはエラーメッセージを生成します。

サイズ 2L の行ベクトル。ここで L は頂点の数を示し、[x₁ y₁ x₂ y₂ ... x_L y_L] の形式を取ります。ここで、

x₁ と y₁ は、最初のラインセグメントの始まりの座標です。
x₂ と y₂ は、最初のラインセグメントの終わりと 2 番目のラインセグメントの始まりを示す座標です。
x_L と y_L は、(L-1) 番目のラインセグメントの終わりと L 番目のラインセグメントの始まりを示す座標です。

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

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

M 行 2L 列の行列

$[\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}]$

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

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

円

1 つ以上の円を描画できます。

形状 PTS 入力描画される形状

1 つの円

形状	PTS 入力	描画される形状
1 つの円	3 要素の行ベクトル `[x y radius]`。ここで、 `x` と `y` は円の中心を示す座標です。 `radius` は円の直径で、0 より大きくなければなりません。
M 個の円	"M 行 3 列" の行列 $[\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}]$ ここで、行列のそれぞれの行は異なる 1 つの円に対応し、1 つの円を表すベクトルと同じ形式です。

3 要素の行ベクトル
[x y radius]。ここで、

x と y は円の中心を示す座標です。
radius は円の直径で、0 より大きくなければなりません。

M 個の円

"M 行 3 列" の行列

$[\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}]$

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

参考

insertObjectAnnotation | insertShape | insertMarker | insertText