light
light オブジェクトの作成
説明
light( は、1 つ以上の名前と値の引数を使用して、ライトのプロパティを指定します。たとえば、Name,Value)light("Color","green") を使用して、ライトの色を緑に指定できます。プロパティの一覧については、Light のプロパティ を参照してください。
lt = light(___) は Light オブジェクトを返します。ライトの作成後にそのプロパティを変更するには、lt を使用します。プロパティの一覧については、Light のプロパティ を参照してください。
例
球面を作成し、Light オブジェクトを使用してライトを照射します。
sphere
axis equal
light
球面を作成し、ローカル光源を使用して "x" 軸および "y" 軸の負の隅からその球面に向けて真っ直ぐにライトを照射します。
sphere axis equal light("Style","local","Position",[-10 -10 0]);
関数 tiledlayout および関数 nexttile を使用して、プロットをタイル表示できます。関数 tiledlayout を呼び出して、1 行 2 列のタイル表示チャート レイアウトを作成します。関数 nexttile を呼び出して、axes オブジェクト ax1 および ax2 を作成します。各 axes オブジェクトを sphere および light の最初の引数として指定することで、球面と対応するライトを各プロットに作成します。
左の座標軸で、球面を作成し、Color プロパティを指定して赤のライトを照射します。右の座標軸で、球面を作成し、緑のライトを照射します。
colormap([1 1 1]) tiledlayout(1,2) % Left sphere ax1 = nexttile; sphere(ax1) axis equal lt1 = light(ax1); lt1.Color = "r"; % Right sphere ax2 = nexttile; sphere(ax2) axis equal lt2 = light(ax2); lt2.Color = "g";
入力引数
名前と値の引数
オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
例: light(Position=[-1 0 0],Style="local")
R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。
例: light("Position",[-1 0 0],"Style","local")
ライトの色。RGB 3 成分、16 進数カラー コード、色の名前、または省略名として指定されます。既定の RGB 3 成分 [1 1 1] は白に対応します。
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 進数カラー コードを取得します。
例: 'green'
光源の種類。次の値の 1 つとして指定します。
"infinite"— ライトを無限遠に配置します。Positionプロパティを使用して、 ライトがどの方向から平行光線を発するかを指定します。"local"—Positionプロパティによって指定される位置にライトを配置します。ライトは点光源で、設定位置から全方向を照らします。
光源の位置。[x y z] の書式の3 要素ベクトルとして指定します。座標軸の原点から (x, y, z) 座標までのデータ単位のベクトル要素を定義します。ライトの実際の位置は、Style プロパティの値によって異なります。
例: [-40 -4 140]
バージョン履歴
R2006a より前に導入
