surfl
カラーマップ ベースのライティングによる表面のプロット
構文
説明
surfl( は、表面を作成し、Z)Z の要素の列インデックスと行インデックスを x 座標および y 座標として使用します。
surfl(___,'light') は、MATLAB® の light オブジェクトによるハイライト部をもつ表面を作成します。これは、既定のカラーマップベースのライティング手法とは異なる結果を生成します。'light' オブジェクトを最後の入力引数として指定します。
surfl(___, は、1 つ以上の名前と値の引数を使用して表面プロットのプロパティを設定します。たとえば、表面の色と透明度を設定できます。プロパティの一覧については、Surface のプロパティ を参照してください。 (R2024b 以降)Name=Value)
surfl( は、現在の座標軸ではなく、ax,___)ax で指定される座標軸にプロットします。座標軸を最初の入力引数として指定します。
s = surfl(___) は chart surface オブジェクトを返します。'light' オプションを使用して光源が light オブジェクトとして指定されている場合、s は、chart surface オブジェクトと light オブジェクトを含むグラフィックス配列として返されます。surface オブジェクトおよび light オブジェクトを作成した後で変更を加えるには、s を使用します。プロパティの一覧については、Surface のプロパティ および Light のプロパティ を参照してください。
例
同じサイズの 3 つの行列を作成します。次に、カラーマップベースのライティングを使用して、これらを表面としてプロットします。表面では、高さに Z、色に Z と光源の両方が使用されます。
[X,Y] = meshgrid(1:0.5:10,1:20); Z = sin(X) + cos(Y); surfl(X,Y,Z)
同じサイズの 3 つの行列を作成します。次に、それらを MATLAB® の light オブジェクトによるハイライト部をもつ表面としてプロットします。表面では、高さに Z、色に Z と light オブジェクトの両方が使用されます。関数は、surface オブジェクトと light オブジェクトを含む配列を返します。それを変数 sl に代入します。
[X,Y] = meshgrid(1:0.5:10,1:20);
Z = sin(X) + cos(Y);
sl = surfl(X,Y,Z,'light');
surface オブジェクトと light オブジェクトの作成後にそれらのプロパティにアクセスして変更するには、sl にインデックスを付けます。表面プロットは sl(1) として、light オブジェクトは sl(2) としてアクセスできます。たとえば、light オブジェクトの Color プロパティを設定することで光の色を変更します。
sl(2).Color = 'r';
同じサイズの 3 つの行列を作成し、表面としてプロットします。光源の方向を、方位角 45 度、仰角 20 度に指定します。周囲光の寄与を増加し、乱反射と正反射の寄与を減少することで表面の反射率を増加します。surface オブジェクトを変数 sl に代入します。
[X,Y] = meshgrid(1:0.5:10,1:20); Z = sin(X) + cos(Y); s = [-45 20]; k = [.65 .4 .3 10];
光源と反射率のベクトルを使用して、データをプロットします。
sl = surfl(X,Y,Z,s,k);
surface オブジェクトの作成後にそのプロパティにアクセスし、変更を加えるには、sl を使用します。たとえば、EdgeColor プロパティを設定することでエッジを非表示にします。
sl.EdgeColor = 'none';
入力引数
名前と値の引数
オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
例: surfl(peaks,FaceAlpha=0.5) は、50% の透明度で表面をプロットします。
メモ
ここには一部のプロパティのみを示します。完全な一覧については、Surface のプロパティ を参照してください。
面の色。次の表のいずれかの値として指定します。
| 値 | 説明 |
|---|---|
'flat' |
|
'interp' |
|
| RGB 3 成分、16 進数カラー コード、色名 | 指定した色をすべての面で使用します。このオプションは
|
'texturemap' | CData のカラー データを表面に適合するように変換します。 |
'none' | 面を描画しません。 |
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" |
|
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
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 進数カラー コードを取得します。
エッジのラインの色。次のいずれかの値として指定します。既定の色は [0 0 0] で、これは黒色のエッジに対応します。
| 値 | 説明 |
|---|---|
'none' | エッジを描画しません。 |
'flat' |
|
'interp' |
|
| 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" |
|
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
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 進数カラー コードを取得します。
ヒント
行列
X,Y,Zの点の順序は、パラメトリックな表面の内側と外側を定義します。反対側の表面が光源を反射するようにするには、surfl(X',Y',Z')を使用します。
