主要内容

このページの翻訳は最新ではありません。ここをクリックして,英語の最新版を参照してください。

光のプロパティ

ライトの外観と動作

プロパティはオブジェクトの外観と動作を制御します。プロパティの値を変更することで,ライトの一部の特性を変更できます。プロパティのクエリと設定にはドット表記を使用します。

h =光;c = h.Color;h.Style =“当地”;

色とスタイル

すべて展開する

ライトの色。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進数が続く文字ベクトルまたは字符串スカラーです。これらの値では大文字小文字は区別されません。したがって,カラーコード“# FF8800”“# ff8800”“# F80”,および“# f80”は等価です。

あるいは,名前を使用して一部の一般的な色を指定できます。次の表に,名前の付いた色オプション,等価のRGB 3成分,および16進数カラーコードを示します。

色名 省略名 RGB 3成分 16進数カラーコード 外観
“红色” “r” (1 0 0) “# FF0000”

“绿色” ‘g’ (0 1 0) “# 00 ff00”

“蓝” “b” (0 0 1) “# 0000 ff”

“青色” “c” (0 1 1) “# 00飞行符”

“红色” “米” (1 0 1) “#就”

“黄色” “y” (1 1 0) “# FFFF00”

“黑” “k” (0 0 0) # 000000的

“白色” ' w ' (1 1 1) “# FFFFFF”

MATLAB®の多くのタイプのプロットで使用されている既定の色のRGB 3成分および16進数カラーコードを次に示します。

RGB 3成分 16進数カラーコード 外観
[0 0.4470 - 0.7410) “# 0072 bd”

(0.8500 0.3250 0.0980) “# D95319”

(0.9290 0.6940 0.1250) “# EDB120”

(0.4940 0.1840 0.5560) “# 7 e2f8e”

(0.4660 0.6740 0.1880) “# 77 ac30”

(0.3010 0.7450 0.9330) “# 4 dbeee”

(0.6350 0.0780 0.1840) “# A2142F”

例:“绿色”

光源の種類。第1次の値のつとして指定します。

  • “无限”——ライトを無限遠に配置します。位置プロパティを使用して,ライトがどの方向から平行光線を発するかを指定します。

  • “本地”- - - - - -位置プロパティによって指定される位置にライトを配置します。ライトは点光源で,設定位置から全方向を照らします。

光源の位置。[x y z]の書式の3要素ベクトルとして指定します。座標軸の原点から(xyz)座標までのデータ単位のベクトル要素を定義します。ライトの実際の位置は,风格プロパティの値によって異なります。

例:(-40 4 140)

位置

すべて展開する

光源の位置。[x y z]の書式の3要素ベクトルとして指定します。座標軸の原点から(xyz)座標までのデータ単位のベクトル要素を定義します。ライトの実際の位置は,风格プロパティの値によって異なります。

例:(-40 4 140)

光源からの光の可視性。“上”または“关闭”として,もしくは数値または逻辑1真正的)または0)として指定します。“上”の値は真正的と等価であり,“关闭”と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型の开/关逻辑値として格納されます。

コールバック

すべて展開する

オブジェクト作成関数。次の値のいずれかとして指定します。

  • 関数ハンドル。

  • 最初の要素が関数ハンドルである细胞配列。细胞配列内のその後の要素はコールバック関数に渡される引数です。

  • 有効なMATLAB式を含む文字ベクトル(非推奨)。MATLABは,この式をベース ワークスペースで評価します。

コールバックを関数ハンドル,细胞配列,または文字ベクトルとして指定する方法の詳細については,コールバック定義を参照してください。

このプロパティは,MATLABがオブジェクトを作成するときに実行されるコールバック関数を指定します。MATLABはCreateFcnコールバックを実行する前に,すべてのプロパティ値を初期化します。CreateFcnプロパティを指定しない場合,MATLABは既定の作成関数を実行します。

既存のコンポーネントにCreateFcnプロパティを設定しても効果はありません。

このプロパティを関数ハンドルまたは细胞配列として指定した場合,コールバック関数の最初の引数を使用して,作成中のオブジェクトにアクセスできます。それ以外の場合は,関数gcboを使用してオブジェクトにアクセスします。

オブジェクト削除関数。次の値のいずれかとして指定します。

  • 関数ハンドル。

  • 最初の要素が関数ハンドルである细胞配列。细胞配列内のその後の要素はコールバック関数に渡される引数です。

  • 有効なMATLAB式を含む文字ベクトル(非推奨)。MATLABは,この式をベース ワークスペースで評価します。

コールバックを関数ハンドル,细胞配列,または文字ベクトルとして指定する方法の詳細については,コールバック定義を参照してください。

このプロパティは,MATLABがオブジェクトを削除するときに実行されるコールバック関数を指定します。MATLABは,オブジェクトのプロパティを破棄する前にDeleteFcnコールバックを実行します。DeleteFcnプロパティを指定しない場合,MATLABは既定の削除関数を実行します。

このプロパティを関数ハンドルまたは细胞配列として指定した場合,コールバック関数の最初の引数を使用して,削除されるオブジェクトにアクセスできます。それ以外の場合は,関数gcboを使用してオブジェクトにアクセスします。

コールバック実行制御

すべて展開する

このプロパティは読み取り専用です。

削除状態。matlab.lang.OnOffSwitchState型の开/关逻辑値として返されます。

MATLABは,DeleteFcnコールバックが実行を開始すると,BeingDeletedプロパティを“上”に設定します。コンポーネントオブジェクトが存在しなくなるまでBeingDeletedプロパティは“上”に設定されたままです。

クエリや変更の前にオブジェクトが削除されようとしていないか確認するためにBeingDeletedプロパティの値をチェックします。

親/子

すべて展開する

親。集团または变换オブジェクトとして指定します。

このオブジェクトには子がありません。このプロパティは設定できません。

親の孩子们プロパティ内でのオブジェクトハンドルの可視性。次の値のいずれかとして指定します。

  • “上”——オブジェクトハンドルは常に表示されます。

  • “关闭”——オブジェクトハンドルは常に非表示です。このオプションは,他の関数による意図しない変更を防止するために役立ちます。HandleVisibility“关闭”に設定すると,その関数の実行中にハンドルが一時的に非表示になります。

  • “回调”——オブジェクトハンドルはコールバック内から,あるいはコールバックにより呼び出される関数から参照できます。しかし,コマンドラインから呼び出される関数からは参照できません。このオプションを使用すると,コマンドラインからのオブジェクトへのアクセスがブロックされますが,コールバック関数からのアクセスは許可されます。

オブジェクトが親の孩子们プロパティ内にリストされない場合,オブジェクト階層の検索またはハンドルプロパティのクエリによってオブジェクトハンドルを取得する関数は,そのオブジェクトハンドルを返しません。こうした関数の例としては,関数得到findobjgcagcfgconewplotclf,および关闭などが挙げられます。

非表示のオブジェクトハンドルは有効なままです。ルートのShowHiddenHandlesプロパティを“上”に設定すると,HandleVisibilityプロパティの設定にかかわらず,すべてのオブジェクトハンドルがリストされます。

識別子

すべて展開する

このプロパティは読み取り専用です。

グラフィックスオブジェクトのタイプ。“光”として返されます。プロット階層内にある特定のタイプのすべてのオブジェクトを検出するためにこのプロパティを使用できます。たとえばfindobjを使用してタイプを検索します。

オブジェクト識別子。文字ベクトルまたは字符串スカラーとして指定します。オブジェクトの識別子として機能する一意の标签値を指定できます。コードの他の部分からオブジェクトにアクセスする必要がある場合,関数findobjを使用して标签値に基づいてオブジェクトを検索できます。

ユーザーデータ。任意のMATLAB配列として指定します。たとえば、スカラー、ベクトル、行列、cell 配列、文字配列、table、または構造体を指定できます。このプロパティを使用して、任意のデータをオブジェクトに保存します。

程序设计师を使用している場合は,用户数据プロパティを使用する代わりに,アプリでパブリックプロパティまたはプライベートプロパティを作成してデータを共有します。詳細については,程序设计师アプリ内でのデータの共有を参照してください。

未使用のプロパティ

すべて展開する

オブジェクトはこのプロパティを使用しません。

オブジェクトはこのプロパティを使用しません。

オブジェクトはこのプロパティを使用しません。

オブジェクトはこのプロパティを使用しません。

オブジェクトはこのプロパティを使用しません。

光オブジェクトはこのプロパティを使用しません。

オブジェクトはこのプロパティを使用しません。

オブジェクトはこのプロパティを使用しません。

R2006aより前に導入