Rectangle のプロパティ
四角形の外観と動作
四角形プロパティは、rectangle オブジェクトの外観と動作を制御するプロパティです。プロパティの値を変更することによって、四角形の特定の要素を変更できます。プロパティのクエリと設定にはドット表記を使用します。
h = rectangle; w = h.LineWidth; h.LineWidth = 3;
色とスタイル
塗りつぶし色。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 進数カラー コード、色名、または省略名として指定します。既定値 [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'
EdgeColor プロパティの設定方法を制御します。次のいずれかの値として指定します。
"auto"—RectangleオブジェクトのSeriesIndexプロパティと座標軸のColorOrderプロパティを使用することにより、MATLAB® がEdgeColorプロパティ値を制御します。"manual"—Rectangleオブジェクトを作成するときに、EdgeColorプロパティ値を直接設定するか、関数の引数として間接的に設定します。
EdgeColor プロパティの値を手動で変更すると、MATLAB は EdgeColorMode プロパティの値を "manual" に変更します。
R2024a 以降
塗りつぶし色の透明度。範囲 [0, 1] のスカラーとして指定します。値 1 は完全に不透明で、値 0 は完全に透明です。0 と 1 の間の値は一部透明です。
ライン スタイル。次の表にリストされたオプションのいずれかとして指定します。
| ライン スタイル | 説明 | 結果として得られる線 |
|---|---|---|
"-" | 実線 |
|
"--" | 破線 |
|
":" | 点線 |
|
"-." | 一点鎖線 |
|
"none" | ラインなし | ラインなし |
ライン幅。ポイント単位の正の値として指定します。
例: 0.75
R2023b 以降
シリーズ インデックス。正の整数または "none" として指定します。このプロパティは、Rectangle オブジェクトの外枠の色を、他のオブジェクトの色と一致するよう再割り当てするのに役立ちます。
SeriesIndex の値が数値の場合、MATLAB はその数値を使用して、関数 rectangle を呼び出すときに外枠の色を割り当てるインデックスを計算します。このインデックスは、座標軸の ColorOrder プロパティに格納されている配列の行を表します。同じ SeriesIndex 数値をもつ座標軸内のオブジェクトは同じ色をもちます。
SeriesIndex の値が "none" の場合は、インデックス方式に参加しない中間色に対応します。
手動の色割り当てにより SeriesIndex の動作をオーバーライドする方法
外枠の色を手動で制御するには、Rectangle オブジェクトの EdgeColor プロパティを色名や RGB 3 成分などのカラー値に設定します。
四角形の外枠の色を手動で設定すると、MATLAB はそのオブジェクトの色の自動選択を使用せず、SeriesIndex プロパティの値に関係なく色を保持できるようにします。EdgeColorMode プロパティは、色が手動で (ユーザーにより) 設定されているか、自動的に設定されているかを示します。値 "manual" は手動選択を示し、値 "auto" は自動選択を示します。
自動選択を有効にするには、SeriesIndex プロパティを正の整数に設定し、EdgeColorMode プロパティを "auto" に設定します。
場合によっては、MATLAB は SeriesIndex プロパティを 0 に設定し、色の自動選択も無効にします。
水平方向と垂直方向の曲率の量。[x y] の形式の 2 要素ベクトルまたはスカラー値として指定します。このプロパティは四角形の形状を楕円に近づける場合に使用します。水平方向の曲率は、上底と下底に沿って曲がる幅の割合です。垂直方向の曲率は、左辺と右辺に沿って曲がる高さの割合です。
水平方向と垂直方向で異なる曲率を使用するには、
[x y]の形式の 2 要素ベクトルを指定します。x要素が水平方向の曲率、y要素が垂直方向の曲率です。xとyの値は 0 (曲率なし) から 1 (最大曲率) までの範囲で指定します。たとえば、値を[0 0]にすると角が直角の四角形が生成され、値を[1 1]にすると楕円が生成されます。水平方向と垂直方向で同じ曲率を使用するには、
[0,1]の範囲のスカラー値を指定します。曲率の長さは短い方の寸法で決まります。
例: [0.5 0.6]
例: 0.75
垂直および水平のラインのシャープ化。'on' または 'off'、もしくは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off' の値は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。
| 値 | 説明 | 外観 |
|---|---|---|
'on' | 垂直および水平のラインをシャープ化して不均一な外観を取り除きます。 |
|
'off' | 垂直および水平のラインをシャープ化しません。均一でない太さや色でラインが表示される場合があります。 |
|
