rectangle
直角または角丸のコーナーをもつ四角形の作成
構文
説明
rectangle('Position', は 2 次元座標の四角形を作成します。pos)pos を、[x y w h] という形式の 4 要素ベクトルとして、データ単位で指定します。x 要素と y 要素で位置が決まり、w 要素と h 要素でサイズが決まります。関数は座標軸から既存の内容を消去せずに、現在の座標軸にプロットを作成します。
rectangle(___, は、名前と値のペア引数を 1 つ以上使用して、四角形のプロパティを指定します。たとえば、Name,Value)'FaceColor','red' は赤の塗りつぶしを指定します。四角形のプロパティは、前述の構文に示した任意の入力引数の組み合わせを使用して指定できます。
rectangle( は、現在の座標軸内 (ax,___)gca) ではなく、ax で指定された座標軸内に四角形を作成します。オプションの ax は、前述の構文のすべての入力引数の組み合わせより前に指定できます。
r = rectangle(___)r は四角形の作成後にそのプロパティを変更する場合に使用します。プロパティの一覧については、Rectangle のプロパティ を参照してください。前述の構文のいずれかで出力引数を返すことができます。
例
左下隅が点 (1,2) にある四角形を描画します。四角形の幅を 5 単位、高さを 6 単位に指定します。さらに、座標軸の範囲も変更します。
rectangle('Position',[1 2 5 6])
axis([0 10 0 10])
左下隅が (0,0)、右上隅が (2,4) にある四角形を描画します。曲率をスカラー値 0.2 として指定して、角丸の四角形を作成します。x 軸と y 軸の両方向に同じ長さのデータ単位を指定するには、axis equal を使用します。
figure rectangle('Position',[0 0 2 4],'Curvature',0.2) axis equal
曲率をスカラー値 1 に指定して、短い方の辺が完全に丸い 2 番目の四角形を追加します。
rectangle('Position',[3 0 2 4],'Curvature',1)
3 番目の四角形を追加して、水平の辺と垂直の辺に異なる曲率を指定します。水平方向の曲率を 0.5 に指定して、水平の 2 辺の 50 パーセントを曲線にします。垂直方向の曲率を 1 に指定して、垂直の 2 辺を完全な曲線にします。
rectangle('Position',[6 0 2 4],'Curvature',[0.5,1])
円を描画するには Curvature プロパティを [1 1] に設定します。(2,4) と (4,6) の 2 点の間にある四角形の領域を埋める円を描画します。Position プロパティを設定して、円が収まる最小の四角形を定義します。
pos = [2 4 2 2]; rectangle('Position',pos,'Curvature',[1 1]) axis equal
同じ位置を使用して赤い四角形を描画し、この四角形の領域が円で埋まることを確認します。
rectangle('Position',pos,'EdgeColor','r')
四角形を描画して、塗りつぶしの色および外枠の色と幅を指定します。
rectangle('Position',[1,2,5,10],'FaceColor',[0 .5 .5],'EdgeColor','b',... 'LineWidth',3)
現在の座標軸に四角形を追加して、rectangle オブジェクト r を返します。
r = rectangle('Position',[0 0 1 1]')
r =
Rectangle with properties:
FaceColor: 'none'
EdgeColor: [0.1294 0.1294 0.1294]
LineWidth: 0.5000
LineStyle: '-'
Curvature: [0 0]
Position: [0 0 1 1]
Show all properties
四角形を作成した後で変更を加えるには、r を使用します。塗りつぶしの色、外枠の色および外枠の幅を変更します。
r.FaceColor = [0 .5 .5];
r.EdgeColor = 'b';
r.LineWidth = 3;
入力引数
名前と値の引数
オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。
例: rectangle('Position',[0 0 1 1],'EdgeColor','k','FaceColor',[0 .5 .5])
塗りつぶし色。RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。
カスタム色を使用する場合は、RGB 3 成分または 16 進数カラー コードを指定します。
RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は
[0,1]の範囲でなければなりません。たとえば[0.4 0.6 0.7]のようになります。16 進数カラー コードは、ハッシュ記号 (
#) で始まり、3 桁または 6 桁の0からFまでの範囲の 16 進数が続く string スカラーまたは文字ベクトルです。この値は大文字と小文字を区別しません。したがって、カラー コード"#FF8800"、"#ff8800"、"#F80"、および"#f80"は等価です。
あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。
| 色名 | 省略名 | RGB 3 成分 | 16 進数カラー コード | 外観 |
|---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" |
|
"green" | "g" | [0 1 0] | "#00FF00" |
|
"blue" | "b" | [0 0 1] | "#0000FF" |
|
"cyan" | "c" | [0 1 1] | "#00FFFF" |
|
"magenta" | "m" | [1 0 1] | "#FF00FF" |
|
"yellow" | "y" | [1 1 0] | "#FFFF00" |
|
"black" | "k" | [0 0 0] | "#000000" |
|
"white" | "w" | [1 1 1] | "#FFFFFF" |
|
"none" | 該当なし | 該当なし | 該当なし | 色なし |
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。 |
|
|
|
orderedcolors 関数と rgb2hex 関数を使用すると、これらのパレットの RGB 3 成分および 16 進数カラー コードを取得できます。たとえば、"gem" パレットの RGB 3 成分を取得し、16 進数カラー コードに変換します。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。
R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラー コードを取得します。
例: "blue"
例: [0 0 1]
例: "#0000FF"
外枠の色。RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。既定の RGB 3 成分の値 [0 0 0] は、黒に相当します。
カスタム色を使用する場合は、RGB 3 成分または 16 進数カラー コードを指定します。
RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は
[0,1]の範囲でなければなりません。たとえば[0.4 0.6 0.7]のようになります。16 進数カラー コードは、ハッシュ記号 (
#) で始まり、3 桁または 6 桁の0からFまでの範囲の 16 進数が続く string スカラーまたは文字ベクトルです。この値は大文字と小文字を区別しません。したがって、カラー コード"#FF8800"、"#ff8800"、"#F80"、および"#f80"は等価です。
あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。
| 色名 | 省略名 | RGB 3 成分 | 16 進数カラー コード | 外観 |
|---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" |
|
"green" | "g" | [0 1 0] | "#00FF00" |
|
"blue" | "b" | [0 0 1] | "#0000FF" |
|
"cyan" | "c" | [0 1 1] | "#00FFFF" |
|
"magenta" | "m" | [1 0 1] | "#FF00FF" |
|
"yellow" | "y" | [1 1 0] | "#FFFF00" |
|
"black" | "k" | [0 0 0] | "#000000" |
|
"white" | "w" | [1 1 1] | "#FFFFFF" |
|
"none" | 該当なし | 該当なし | 該当なし | 色なし |
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。 |
|
|
|
orderedcolors 関数と rgb2hex 関数を使用すると、これらのパレットの RGB 3 成分および 16 進数カラー コードを取得できます。たとえば、"gem" パレットの RGB 3 成分を取得し、16 進数カラー コードに変換します。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。
R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラー コードを取得します。
例: 'blue'
例: [0 0 1]
例: '#0000FF'
ライン幅。ポイント単位の正の値として指定します。
例: 0.75
ライン スタイル。次の表にリストされたオプションのいずれかとして指定します。
| ライン スタイル | 説明 | 結果として得られる線 |
|---|---|---|
"-" | 実線 |
|
"--" | 破線 |
|
":" | 点線 |
|
"-." | 一点鎖線 |
|
"none" | ラインなし | ラインなし |
バージョン履歴
R2006a より前に導入
