Polygon のプロパティ
多角形の外観と動作
Polygon プロパティは、Polygon オブジェクトの外観と動作を制御します。プロパティの値を変更することによって、多角形の特定の要素を変更できます。
ps = polyshape([0 0 1 1],[1 0 0 1]); pg = plot(ps); pg.FaceAlpha = 0.5; lw = pg.LineWidth;
色とスタイル
塗りつぶし領域の色。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 進数カラー コードを取得します。
例: pg.FaceColor = [0.1 0.5 0.2];
例: pg.FaceColor = 'white';
例: pg.FaceColor = 'none';
FaceColor プロパティの設定方法を制御します。次のいずれかの値として指定します。
"auto"— MATLAB® がPolygonオブジェクトのSeriesIndexプロパティと座標軸のColorOrderプロパティを使用して、FaceColorプロパティ値を制御します。"manual"—Polygonオブジェクトを作成するときに、FaceColorプロパティ値を直接設定するか、関数の引数として間接的に設定します。
FaceColor プロパティの値を手動で変更すると、MATLAB は FaceColorMode プロパティの値を "manual" に変更します。
塗りつぶし領域の外側の境界の色。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 進数カラー コードを取得します。
例: pg.EdgeColor = [0.1 0.5 0.2];
例: pg.EdgeColor = 'white';
例: pg.EdgeColor = 'none';
塗りつぶし領域の内側の境界の色。RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。内側の境界の色を指定しない場合は、EdgeColor プロパティと同じ色が使用されます。既定の色は [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 進数カラー コードを取得します。
例: pg.HoleEdgeColor = [0.1 0.5 0.2];
例: pg.HoleEdgeColor = 'white';
例: pg.HoleEdgeColor = '#D9A2E9';
例: pg.HoleEdgeColor = 'none';
R2023b 以降
HoleEdgeColor プロパティの設定方法を制御します。次のいずれかの値として指定します。
"auto"—HoleEdgeColorプロパティはEdgeColorプロパティと一致します。EdgeColorプロパティが変更されると、HoleEdgeColorプロパティはその色に一致するように更新されます。"manual"—HoleEdgeColorプロパティの値を直接設定します。この値は変更されません。
HoleEdgeColor プロパティの値を手動で変更すると、MATLAB は HoleEdgeColorMode プロパティの値を "manual" に変更します。
塗りつぶし領域の透明度。範囲 [0,1] 内のスカラーとして指定します。値 1 は不透明、値 0 は完全な透明を表します。0 と 1 の間の値は半透明です。
例: pg.FaceAlpha = 0.5;
シリーズ インデックス。正の整数または "none" として指定します。このプロパティは、Polygon オブジェクトの面の色を、他のオブジェクトの色と一致するよう再割り当てするのに役立ちます。
既定では、SeriesIndex プロパティの値は、1 から始まる、作成順に対応する数値です。MATLAB は、この数値を使用して、プロット関数を呼び出すときに面の色を割り当てるインデックスを計算します。このインデックスは、座標軸の ColorOrder プロパティに格納されている配列の行を表します。同じ SeriesIndex 数値をもつ座標軸内のオブジェクトは同じ色をもちます。
SeriesIndex の値が "none" の場合は、インデックス方式に参加しない中間色に対応します。
手動の色割り当てにより SeriesIndex の動作をオーバーライドする方法
塗りつぶし色を手動で制御するには、Polygon オブジェクトの FaceColor プロパティを色名や RGB 3 成分などのカラー値に設定します。
オブジェクトの塗りつぶし色を手動で設定すると、MATLAB はそのオブジェクトの色の自動選択を無効にし、SeriesIndex プロパティの値に関係なく色を保持できるようにします。FaceColorMode プロパティは、色が手動で (ユーザーにより) 設定されているか、自動的に設定されているかを示します。値 "manual" は手動選択を示し、値 "auto" は自動選択を示します。
自動選択を再度有効にするには、SeriesIndex プロパティを正の整数に設定し、FaceColorMode プロパティを "auto" に設定します。
場合によっては、MATLAB は SeriesIndex 値を 0 に設定し、色の自動選択も無効にします。
塗りつぶし領域の外側の境界の透明度。範囲 [0,1] 内のスカラーとして指定します。値 1 は不透明、値 0 は完全な透明を表します。0 と 1 の間の値は半透明です。
例: pg.EdgeAlpha = 0.5;
塗りつぶし領域の内側の境界の透明度。範囲 [0,1] 内のスカラーとして指定します。値 1 は不透明、値 0 は完全な透明を表します。0 と 1 の間の値は半透明です。
例: pg.HoleEdgeAlpha = 0.5;
R2023b 以降
HoleEdgeAlpha プロパティの設定方法を制御します。次のいずれかの値として指定します。
"auto"—HoleEdgeAlphaプロパティはEdgeAlphaプロパティと一致します。EdgeAlphaプロパティが変更されると、HoleEdgeAlphaプロパティはアルファ値に一致するように更新されます。"manual"—HoleEdgeAlphaプロパティの値を直接設定します。この値は変更されません。
HoleEdgeAlpha プロパティの値を手動で変更すると、MATLAB は HoleEdgeAlphaMode プロパティの値を "manual" に変更します。
ライン スタイル。次の表にリストされたオプションのいずれかとして指定します。
| ライン スタイル | 説明 | 結果として得られる線 |
|---|---|---|
"-" | 実線 |
|
"--" | 破線 |
|
":" | 点線 |
|
"-." | 一点鎖線 |
|
"none" | ラインなし | ラインなし |
ライン幅。ポイント単位の正の値として指定します。
例: pg.LineWidth = 0.75;
ラインの角のスタイル。"round"、"miter"、"chamfer" のいずれかに指定します。次の表に、各値によって指定される外観を示します。
"round" | "miter" | "chamfer" |
|---|---|---|
|
|
|
垂直および水平のラインのシャープ化。'on' または 'off'、もしくは数値または logical 1 (true) または 0 (false) として指定します。'on' の値は true と等価であり、'off' の値は false と等価です。したがって、このプロパティの値を logical 値として使用できます。値は matlab.lang.OnOffSwitchState 型の on/off logical 値として格納されます。
| 値 | 説明 | 外観 |
|---|---|---|
'on' | 垂直および水平のラインをシャープ化して不均一な外観を取り除きます。 |
|
'off' | 垂直および水平のラインをシャープ化しません。均一でない太さや色でラインが表示される場合があります。 |
|
