主要内容

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

表面のプロパティ

グラフの表面の外観と動作

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

h=surf(…);c=h.CData;h.CData映射='direct';

すべて展開する

面の色。次の表のいずれかの値として指定します。

説明
“平坦”

CDataプロパティの値に基づいて面ごとに異なる色を使用します。まず,CDataプロパティをZDataと同じサイズの行列として指定しなければなりません。各面の最初の頂点 (正の x方向と Y方向) のカラー値が、面全体の色を決定します。この値は脸阿尔法プロパティが“interp”に設定されている場合は使用できません。

“interp”

CDataプロパティの値に基づいて、面ごとに内挿によるカラーリングを使用します。まず、CDataプロパティをZDataと同じサイズの行列として指定しなければなりません。頂点のカラー値を内挿することにより、各面の端から端へと色が変化します。この値は脸阿尔法プロパティが“平坦”に設定されている場合は使用できません。

RGB 3成分,16進数カラーコード,色名

指定した色をすべての面で使用します。このオプションはCDataプロパティのカラー値を使用しません。

“texturemap” CDataのカラー データを表面に適合するように変換します。
“没有” 面を描画しません。

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) “#00FFFF”

“洋红” “我是 (1 0 1) “#FF00FF”

“黄色” “是的” [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) “#0072BD”

[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] “#4DBEEE”

[0.6350 0.0780 0.1840] “# A2142F”

面の透明度。次の値のいずれかとして指定します。

  • 範囲[0, 1]のスカラー——すべての面に一様な透明度を使用します。値1.は完全に不透明で、値0は完全に透明です。01.の間の値は半透明です。このオプションは字母数据プロパティの透明度値を使用しません。

  • “平坦”字母数据プロパティの値に基づいて面ごとに異なる透明度を使用します。面全体の透明度は、最初の頂点の透明度値によって決まります。まず字母数据プロパティをZDataプロパティと同じサイズの行列として指定しなければなりません。脸色プロパティも、“平坦”に設定しなければなりません。

  • “interp”字母数据プロパティの値に基づいて面ごとに内挿された透明度を使用します。頂点の値を内挿することにより、各面に異なる透明度が使用されます。まず字母数据プロパティをZDataプロパティと同じサイズの行列として指定しなければなりません。脸色プロパティも、“interp”に設定しなければなりません。

  • “texturemap”字母数据のデータを表面に適合するように変換します。

面に対する光オブジェクトの効果。次の値のいずれかとして指定します。

  • “平坦”——各面にライトを一様に適用します。この値は小平面で構成されたオブジェクトを表示する場合に使用します。

  • “古尔戈”——面のライトを変化させます。各頂点のライトを計算し,面上でライトを線形内挿します。この値は曲面を表示する場合に使用します。

  • “没有”-轻的オブジェクトのライトを面に適用しません。

光オブジェクトを座標軸に追加するには、関数を使用します。

メモ

“冯氏”は削除されました。代わりに“古尔戈”を使用してください。

頂点の法線がカメラと反対方向の場合の面のライティング方法。第1次の値のつとして指定します。

  • “reverselit”— 頂点法線がカメラに向かっているかのように面をライティングします。

  • “灯”——面をライティングしません。

  • “点燃”——頂点法線に従って面をライティングします。

このプロパティを使用すると、オブジェクトの内部と外部を見分けられます。例については、背面ライティングを参照してください。

エッジ

すべて展開する

表示するエッジ。“两个”“行”“列”のいずれかとして指定します。

エッジのラインの色。次のいずれかの値として指定します。既定の色は[0 0 0]で,これは黒色のエッジに対応します。

説明
“没有” エッジを描画しません。
“平坦”

CDataプロパティの値に基づいてエッジごとに異なる色を使用します。まず、CDataプロパティをZDataと同じサイズの行列として指定しなければなりません。各面の最初の頂点 (正の x方向と Y方向) のカラー値が、隣接するエッジの色を決定します。この値はEdgeAlphaプロパティが“interp”に設定されている場合は使用できません。

“interp”

CDataプロパティの値に基づいて、エッジごとに内挿によるカラーリングを使用します。まず、CDataプロパティをZDataと同じサイズの行列として指定しなければなりません。頂点でのカラー値を線形内挿することにより,各エッジの端から端に向かって色が変化します。この値はEdgeAlphaプロパティが“平坦”に設定されている場合は使用できません。

RGB 3成分,16進数カラーコード,色名

指定した色をすべてのエッジに使用します。このオプションはCDataプロパティのカラー値を使用しません。

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) “#00FFFF”

“洋红” “我是 (1 0 1) “#FF00FF”

“黄色” “是的” [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) “#0072BD”

[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] “#4DBEEE”

[0.6350 0.0780 0.1840] “# A2142F”

エッジの透明度。次の値のいずれかとして指定します。

  • 範囲[0, 1]のスカラー——すべてのエッジに一様な透明度を使用します。値1.は完全に不透明で、値0は完全に透明です。01.の間の値は半透明です。このオプションは字母数据プロパティの透明度値を使用しません。

  • “平坦”字母数据プロパティの値に基づいてエッジごとに異なる透明度を使用します。まず字母数据プロパティをZDataプロパティと同じサイズの行列として指定しなければなりません。エッジ全体の透明度は、最初の頂点の透明度値によって決まります。EdgeColorプロパティも、“平坦”に設定しなければなりません。

  • “interp”字母数据プロパティの値に基づいて,エッジごとに内挿した透明度を使用します。まず字母数据プロパティをZDataプロパティと同じサイズの行列として指定しなければなりません。頂点の値を内挿することにより,各エッジに一様でない透明度が使用されます。EdgeColorプロパティも、“interp”に設定しなければなりません。

ライン スタイル。次の表にリストされたオプションのいずれかとして指定します。

ラインスタイル 説明 結果として得られる線
'-' 実線

'--' 破線

':' 点線

'-.' 一点鎖線

“没有” ラインなし ラインなし

ライン幅。ポイント単位の正の値として指定します。1ポイントは1/72インチです。ラインがマーカーをもつ場合,ライン幅はマーカーエッジにも影響します。

ライン幅をピクセルの幅より細くすることはできません。システムでライン幅をピクセルの幅より細い値に設定すると,ラインは1ピクセル幅で表示されます。

垂直および水平のラインのシャープ化。“开”または“关”,もしくは数値または逻辑1.(真正的) または0()として指定します。“开”の値は 符合事实的と等価であり、“关”と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型の 开/关逻辑値として格納されます。

  • “开”— 垂直および水平のラインをシャープ化して不均一な外観を取り除きます。

  • “关”— 垂直または水平のラインをシャープ化しません。均一でない太さや色でラインが表示される場合があります。

関連付けられている图のGraphicsSmoothingプロパティが“开”に設定されていて渲染器プロパティがopengl的に設定されている場合,图のプロットには平滑化技法が適用されます。場合によってはこの平滑化技法が原因で,垂直および水平のラインが均一でない太さや色で表示されることがあります。この不均一な外観を取り除くためにAlignVertexCentersプロパティを使用します。

メモ

この機能をサポートするグラフィックスカードがなければなりません。この機能がサポートされているかどうかを確認するには,関数渲染器信息を呼び出します。サポートされている場合、渲染器信息info.Details.金宝appSupportsAlignVertexCenters1.の値を返します。

エッジに対する 光オブジェクトの効果。次の値のいずれかとして指定します。

  • “平坦”——各エッジにライトを一様に適用します。

  • “没有”——光オブジェクトのライトをエッジに適用しません。

  • “古尔戈”— 各頂点のライトを計算し、エッジ上でライトを線形内挿します。

メモ

“冯氏”は削除されました。代わりに“古尔戈”を使用してください。

マーカー

すべて展開する

マーカー記号。次の表に挙げる値のいずれかとして指定します。既定では、オブジェクトはマーカーを表示しません。マーカー記号を指定すると、各データ点または各頂点にマーカーが追加されます。

説明
“哦”
'+' プラス記号
'*' アスタリスク
'.'
“x” 十字
“_” 水平線
'|' 垂直線
“广场”または's' 正方形
“钻石”または“d” 菱形
“^” 上向き三角形
“v” 下向き三角形
'>' 右向き三角形
'<' 左向き三角形
“五角星”または“p” 星形五角形
“卦”または“h” 星形六角形
“没有” マーカーなし

マーカー サイズ。ポイント単位の正の値として指定します。1.ポイントは 1/72 インチです。

マーカーの輪郭の色。“自动”“平坦”、RGB 3成分、16進数カラー コード、色名、または省略名として指定します。“自动”オプションは,EdgeColorプロパティと同じ色を使用します。“平坦”オプションは頂点のCDataの値を使用して色を設定します。

カスタム色を使用する場合は,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) “#00FFFF”

“洋红” “我是 (1 0 1) “#FF00FF”

“黄色” “是的” [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) “#0072BD”

[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] “#4DBEEE”

[0.6350 0.0780 0.1840] “# A2142F”

マーカーの塗りつぶし色。“自动”“平坦”、RGB 3成分、16進数カラー コード、色名、または省略名として指定します。“自动”オプションは座標軸の颜色プロパティと同じ色を使用します。“平坦”オプションは頂点のCDataの値を使用して色を設定します。

カスタム色を使用する場合は,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) “#00FFFF”

“洋红” “我是 (1 0 1) “#FF00FF”

“黄色” “是的” [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) “#0072BD”

[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] “#4DBEEE”

[0.6350 0.0780 0.1840] “# A2142F”

このプロパティは円、正方形、菱形、星形五角形、星形六角形、4.種類の三角形のマーカー タイプにのみ影響します。

例:(0.3 0.2 0.1)

例:“绿色”

例:“#D2F9A7”

座標のデータ

すべて展開する

x座標のデータ。ZDataと同じサイズの行列または長さNのベクトルとして指定します。ここで[m,n]=尺寸(ZData)です。

データ型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|明确的|日期时间|持续时间

XDataの選択モード。次の値のいずれかとして指定します。

  • “自动”ZDataの列インデックスを使用します。

  • “手册”— 手動で指定した値を使用します。値を指定するには、プロット関数の入力引数を使用するかXDataプロパティを直接設定します。

XDataにリンクされている変数。MATLABワークスペースの変数名を含む文字ベクトルまたは string として指定します。MATLAB はベース ワークスペース内の変数を評価してXDataを生成します。

既定ではリンクされている変数はないため、この値は空の文字ベクトルです。変数をリンクしてもMATLABはXDataの値をすぐに更新しません。データ値の更新を強制するには、関数刷新数据を使用します。

メモ

1つのデータソースプロパティを異なる次元のデータを含む変数に変更すると,すべてのデータソースプロパティを適切な値に変更するまでは,関数が警告を生成し,グラフが描画されない可能性があります。

例:“x”

y座標のデータ。ZDataと同じサイズの行列または長さMのベクトルとして指定します。ここで[m,n]=尺寸(ZData)です。

データ型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|明确的|日期时间|持续时间

YDataの選択モード。次の値のいずれかとして指定します。

  • “自动”ZDataの行インデックスを使用します。

  • “手册”— 手動で指定した値を使用します。値を指定するには、プロット関数の入力引数を使用するかYDataプロパティを直接設定します。

YDataにリンクされている変数。MATLABワークスペースの変数名を含む文字ベクトルまたは string として指定します。MATLAB はベース ワークスペース内の変数を評価してYDataを生成します。

既定ではリンクされている変数はないため、この値は空の文字ベクトルです。変数をリンクしてもMATLABはYDataの値をすぐに更新しません。データ値の更新を強制するには、関数刷新数据を使用します。

メモ

1つのデータソースプロパティを異なる次元のデータを含む変数に変更すると,すべてのデータソースプロパティを適切な値に変更するまでは,関数が警告を生成し,グラフが描画されない可能性があります。

例:“是的”

z座標のデータ。行列として指定します。

データ型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|明确的|日期时间|持续时间

ZDataにリンクされている変数。MATLABワークスペースの変数名を含む文字ベクトルまたは string として指定します。MATLAB はベース ワークスペース内の変数を評価してZDataを生成します。

既定ではリンクされている変数はないため、この値は空の文字ベクトルです。変数をリンクしてもMATLABはZDataの値をすぐに更新しません。データ値の更新を強制するには、関数刷新数据を使用します。

メモ

1つのデータソースプロパティを異なる次元のデータを含む変数に変更すると,すべてのデータソースプロパティを適切な値に変更するまでは,関数が警告を生成し,グラフが描画されない可能性があります。

例:“z”

カラー データと透明度データ

すべて展開する

頂点の色。次のいずれかの形式で指定します。

  • 2.次元配列 — カラーマップの色を使用します。CDataZDataと同じサイズの配列に設定して各頂点の色を指定します。これらの値と現在のカラーマップとの対応はCDataMappingプロパティで決まります。脸色プロパティが“texturemap”に設定されている場合は,CDataZDataと同じサイズにする必要はありません。ただし、型はまたはuint8でなければなりません。CDataの値はZDataで定義された表面に適合するようにマッピングされます。

  • 3.次元配列 — トゥルーカラーを使用します。CDataを mxnx3の配列に設定して各頂点の色を RGB 3成分で指定します。ここで[m,n]=尺寸(ZData)です。RGB 3成分は、色の赤、緑、青成分の強度を指定する 3.成分のベクトルです。配列の最初のページは赤、2.番目のページは緑、3.番目のページは青の成分になります。表面にはカラーマップの色ではなくトゥルーカラーが使用されるので、CDataMappingプロパティは無効になります。

    • CData型または型の場合,RGB 3成分の値[0 0 0]は黒に対応し,[1 1 1]は白に対応します。

    • CDataが整数型の場合,すべてのデータの範囲を使用して表面の色が決定されます。たとえばCDatauint8型の場合,[0 0 0]は黒に対応し,[255 255 255]は白に対応します。CDataint8型の場合,[-128 -128 -128]は黒に対応し,(127 127 127)は白に対応します。

データ型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64

CDataの選択モード。次の値のいずれかとして指定します。

  • “自动”ZDataの値を使用して色を設定します。

  • “手册”——手動で指定した値を使用します。値を指定するには,CDataプロパティを設定します。

CDataにリンクされている変数。MATLABワークスペースの変数名を含む文字ベクトルまたは string として指定します。MATLAB はベース ワークスペース内の変数を評価してCDataを生成します。

既定ではリンクされている変数はないため、この値は空の文字ベクトルです。変数をリンクしてもMATLABはCDataの値をすぐに更新しません。値の更新を強制するには、関数刷新数据を使用します。

メモ

1つのデータソースプロパティを異なる次元のデータを含む変数に変更すると,すべてのデータソースプロパティを適切な値に変更するまでは,関数が警告を生成し,グラフが描画されない可能性があります。

色のマッピング方法。“缩放”または“直接的”として指定します。このプロパティは、CDataのカラー データ値のカラーマップへのマッピングを制御するために使用します。

それぞれの方法には次の効果があります。

  • “直接的”— 現在のカラーマップのインデックスとして値を解釈します。小数部分の値は、最近傍値の小さい方の整数に丸められます。

    • 値が型または型の場合,1.以下の値はカラーマップの最初の色にマッピングされます。カラーマップの長さ以上の値は,カラーマップの最後の色にマッピングされます。

    • 値がuint8uint16uint32uint64int8int16int32またはint64型の場合,0以下の値はカラーマップの最初の色にマッピングされます。カラーマップの長さ以上の値は、カラーマップの最後の色にマッピングされます (またはその型の範囲の上限値)。

    • 値が必然的型の場合,0の値はカラーマップの最初の色にマッピングされ,1.の値はカラーマップの 2.番目の色にマッピングされます。

  • “缩放”——色の最小値と最大値の間の範囲に値がスケーリングされます。座標軸の克莱姆プロパティには色の範囲が含まれています。

各頂点の透明度データ。ZDataプロパティと同じサイズの配列として指定します。値を指定した後,脸阿尔法プロパティとEdgeAlphaプロパティを設定して透明度のタイプを制御します。脸阿尔法プロパティとEdgeAlphaプロパティの両方がスカラー値に設定されている場合,表面は字母数据の値を使用しません。

AlphaDataMappingプロパティによって,表面が字母数据プロパティの値をどのように解釈するかが決まります。

データ型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|必然的

字母数据の値の解釈。次の値のいずれかとして指定します。

  • “没有”——値を透明度値として解釈します。1.以上の値は完全に不透明に、0 以下の値は完全に透明に、0 と 1 の間の値は半透明になります。

  • “缩放”— 値を 图形の 字母地图にマッピングします。座標軸のアルファ値の範囲の最小値と最大値によって、字母地图の最初と最後の要素にマッピングされる字母数据の値が決まります。たとえば、アルファ値の範囲が[3 - 5]の場合、3.以下の値は 字母地图の最初の要素にマッピングされます。5.以上の値は 字母地图の最後の要素にマッピングされます。座標軸の阿利姆プロパティにはアルファ値の範囲が含まれています。图形のAlphamapプロパティには 字母地图が含まれています。

  • “直接的”-身材の 字母地图のインデックスとして値を解釈します。小数部分の値は、最近傍値の小さい方の整数に丸められます。

    • 値が型または型の場合、1.以下の値は 字母地图の最初の要素にマッピングされます。字母地图の長さ以上の値は、字母地图の最後の要素にマッピングされます。

    • 値が整数型の場合、0以下の値は 字母地图の最初の要素にマッピングされます。字母地图の長さ以上の値は、字母地图の最後の要素 (または整数型の最大値まで) にマッピングされます。整数型はuint8uint16uint32uint64int8int16int32int64です。

    • 値が必然的型の場合0の値はalphamapの最初の要素に,1の値はalphamapの2番目の要素にマッピングされます。

法線

すべて展開する

表面の各頂点の法線ベクトル。mxnx3の配列として指定します。ここで[m,n]=尺寸(ZData)です。法線ベクトルは頂点ごとに 1 つずつ指定します。

このプロパティの値を設定すると,対応するモードプロパティが手动に設定されます。法線ベクトルを指定しない場合,ライティングの計算用にこの値が自動的に生成されます。

データ型:|

VertexNormalsの選択モード。次の値のいずれかとして指定します。

  • “自动”— 座標データに基づいて法線ベクトルを計算します。

  • “手册”——手動で指定した値を使用します。値を指定するには,VertexNormalsプロパティを設定します。

表面の各面の法線ベクトル。(m - 1) (n - 1) x 3の配列として指定します。ここで[m,n]=尺寸(ZData)です。法線ベクトルは面ごとに 1 つずつ指定します。

このプロパティの値を設定すると,対応するモードプロパティが手动に設定されます。法線ベクトルを指定しない場合,ライティングの計算用にこの値が自動的に生成されます。

データ型:|

FaceNormalsの選択モード。次の値のいずれかとして指定します。

  • “自动”— 座標データに基づいて法線ベクトルを計算します。

  • “手册”——手動で指定した値を使用します。値を指定するには,FaceNormalsプロパティを設定します。

ライティング

すべて展開する

周囲光の強度。[0, 1]の範囲のスカラー値として指定します。周囲光は場面全体を照らす方向性のない光です。周囲光が視覚可能であるためには、座標軸に対して少なくとも 1.つの視覚可能な 光オブジェクトがなければなりません。

周囲光の色は座標軸の环境光颜色プロパティで設定します。座標軸のすべてのオブジェクトに同じ色が使用されます。

例:0.5

データ型:

拡散光の強度。[0, 1]の範囲のスカラー値として指定します。拡散光は座標軸の 光オブジェクトからの非鏡面反射です。

例:0.3

データ型:

鏡面反射の強度。[0, 1]の範囲のスカラー値として指定します。鏡面反射は座標軸の 光オブジェクトが照らす表面上の部分です。

例:0.3

データ型:

鏡面スポットのサイズ。1.以上のスカラー値として指定します。ほとんどが、20 [5]の範囲の指数です。

例:7.

データ型:

鏡面反射の色。[0, 1]の範囲のスカラー値として指定します。値が1.の場合,光源の色だけを使用して色が設定されます。値が0の場合、反射するオブジェクトの色と光源の色の両方を使用して色が設定されます。光源の色はライトの颜色プロパティに格納されています。中間の値では、その割合は線形に変化します。

例:0.5

データ型:

凡例

すべて展開する

凡例ラベル。文字ベクトルまたは字符串スカラーとして指定します。传奇コマンドを呼び出すまで,凡例は表示されません。テキストを指定しない場合,传奇“dataN”形式を使用してラベルを設定します。

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

凡例にオブジェクトを含めるか除外するかの制御。注释オブジェクトとして返されます。基となる图标显示样式プロパティを次のいずれかの値に設定します。

  • “开”——凡例にオブジェクトを含めます(既定)。

  • “关”— 凡例にオブジェクトを含めません。

たとえば,グラフィックスオブジェクトを凡例から除外するには、图标显示样式プロパティを“关”に設定します。

go.Annotation.LegendInformation.IconDisplayStyle =“关”;

あるいは,関数传奇を使用して,凡例内の項目を制御することもできます。最初の入力引数を,含めるグラフィックスオブジェクトのベクトルとして指定します。最初の入力引数に既存のグラフィックスオブジェクトを指定しない場合,それは凡例に表示されません。ただし,凡例が作成された後に座標軸に追加されたグラフィックスオブジェクトは凡例には表示されません。追加の項目を避けるには,すべてのプロットを作成した後に凡例を作成することを考慮してください。

対話機能

すべて展開する

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

  • “开”— オブジェクトを表示します。

  • “关”——オブジェクトを削除せずに非表示にします。非表示のオブジェクトのプロパティには引き続きアクセスできます。

データ ヒントの内容。数据模板オブジェクトとして指定します。基となる数据模板オブジェクトのプロパティを変更することにより,データヒントに表示される内容を制御できます。プロパティの一覧については,DataTipTemplateのプロパティを参照してください。

データ ヒントの変更の例については、カスタムデータヒントの作成を参照してください。

メモ

数据模板オブジェクトはfindobjまたは芬德尔によって返されず,copyobjによってコピーされません。

コンテキスト メニュー。快捷菜单オブジェクトとして指定します。このプロパティは,オブジェクトを右クリックしたときにコンテキストメニューを表示するために使用します。関数uicontextmenuを使用して,コンテキストメニューを作成します。

メモ

易损件プロパティが“没有”に設定されている場合または命中测试プロパティが“关”に設定されている場合には、このコンテキスト メニューは表示されません。

選択状態。“开”または“关”,もしくは数値または逻辑1.(真正的) または0()として指定します。“开”の値は 符合事实的と等価であり、“关”と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型の 开/关逻辑値として格納されます。

  • “开”— 選択されています。プロット編集モードでオブジェクトをクリックした場合、MATLABは选择プロパティを“开”に設定します。选择突出显示プロパティも“开”に設定されている場合,MATLABはオブジェクトの周囲に選択ハンドルを表示します。

  • “关”— 選択されていません。

選択時の選択ハンドルの表示。“开”または“关”,もしくは数値または逻辑1.(真正的) または0()として指定します。“开”の値は 符合事实的と等価であり、“关”と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型の 开/关逻辑値として格納されます。

  • “开”选择プロパティが“开”に設定されているときに選択ハンドルを表示します。

  • “关”选择プロパティが“开”に設定されている場合でも選択ハンドルを表示しません。

座標軸の範囲でのオブジェクトのクリップ。“开”または“关”,もしくは数値または逻辑1.(真正的) または0()として指定します。“开”の値は 符合事实的と等価であり、“关”と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型の 开/关逻辑値として格納されます。

  • “开”の値は座標軸の範囲外になるオブジェクトの部分をクリップします。

  • “关”の値は座標軸の範囲外に表示される部分があってもオブジェクト全体を表示します。プロットの作成、抓住の設定、座標軸のスケーリングの固定を行ってから、元のプロットよりも大きくなるようにオブジェクトを作成した場合、オブジェクトの一部が座標軸の範囲の外に表示されることがあります。

オブジェクトを含む座標軸の剪裁プロパティは“开”に設定しなければなりません。そうしない場合,このプロパティの効果はありません。クリップ動作の詳細については,座標軸の剪裁プロパティを参照してください。

コールバック

すべて展開する

マウスクリックコールバック。次の値のいずれかとして指定します。

  • 関数ハンドル

  • 関数ハンドルと追加の引数を含む 单间牢房配列

  • ベースワークスペース内で評価される有効なMATLABコマンドまたはMATLAB関数の文字ベクトル(非推奨)

このプロパティは、オブジェクトをクリックしたときにコードを実行するために使用します。関数ハンドルを使用してこのプロパティを指定した場合、MATLABはコールバックを実行するときに次の 2.つの引数をコールバック関数に渡します。

  • クリックしたオブジェクト — コールバック関数内から、クリックしたオブジェクトのプロパティにアクセスします。

  • イベントデータ——空の引数です。この引数が使用されないことを示すために,関数定義の中でこの引数をチルダ文字(~) に置換します。

関数ハンドルを使用してコールバック関数を定義する方法についての詳細は、コールバック定義を参照してください。

メモ

易损件プロパティが“没有”に設定されている場合または命中测试プロパティが“关”に設定されている場合には,このコールバックは実行されません。

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

  • 関数ハンドル。

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

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

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

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

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

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

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

  • 関数ハンドル。

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

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

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

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

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

コールバック実行制御

すべて展開する

コールバックの割り込み。“开”または“关”,もしくは数値または逻辑1.(真正的) または0()として指定します。“开”の値は真正的と等価であり,“关”と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型の 开/关逻辑値として格納されます。

このプロパティは実行中のコールバックが割り込み可能かどうかを決定します。2次のつのコールバックの状態について考慮する必要があります。

  • "実行中"コールバックは、現在実行しているコールバックです。

  • “割り込み”コールバックは,実行中のコールバックに割り込もうとするコールバックです。

MATLABがコールバックを呼び出すたびに,そのコールバックは実行中のコールバック(がある場合)に割り込もうとします。実行中のコールバックを所有するオブジェクトの打断プロパティが、割り込み可能かどうかを決定します。

  • 値が“开”の場合,他のコールバックがオブジェクトのコールバックに割り込むことができます。割り込みは,drawnow图形uifiguregetframe等待暂停コマンドなどの,MATLABが次にキューを処理するポイントで発生します。

    • 実行中のコールバックにこれらのいずれかのコマンドが含まれている場合、MATLABはそのポイントでコールバックの実行を停止し、割り込みコールバックを実行します。割り込みコールバックが完了すると、MATLABは実行中だったコールバックの実行を再開します。

    • 実行中のコールバックにこれらのコマンドが含まれていない場合,MATLABはそのコールバックの実行を割り込みなしで完了します。

  • 値が“关”の場合、割り込みの試行はすべてブロックされます。割り込みコールバックを所有するオブジェクトのBusyActionプロパティが,その割り込みコールバックを破棄するかキューに入れるかを決定します。

メモ

コールバックの割り込みと実行は,以下の状況では動作が異なります。

  • 割り込みコールバックがDeleteFcnCloseRequestFcnまたはSizeChangedFcnの各コールバックの場合、打断プロパティの値にかかわらず割り込みが発生します。

  • 実行中のコールバックが関数等待を現在実行している場合,打断プロパティの値にかかわらず割り込みが発生します。

  • 计时器オブジェクトは,打断プロパティ値にかかわらず,スケジュールに従って実行されます。

MATLABは,割り込みが発生したときにプロパティの状態や表示を保存しません。たとえば,gcaコマンドやgcfコマンドから返されたオブジェクトは,別のコールバックを実行するときに変更されている可能性があります。

コールバックキューイング。“队列”または“取消”として指定します。BusyActionプロパティはMATLABによる割り込みコールバックの実行の処理方法を決定します。2次のつのコールバックの状態について考慮する必要があります。

  • "実行中"コールバックは、現在実行しているコールバックです。

  • “割り込み”コールバックは,実行中のコールバックに割り込もうとするコールバックです。

MATLABがコールバックを呼び出すたびに、そのコールバックは実行中のコールバックに割り込もうとします。実行中のコールバックを所有するオブジェクトの打断プロパティが、割り込みを許可するかどうかを決定します。割り込みが許可されない場合は、割り込みコールバックを所有するオブジェクトのBusyActionプロパティが、そのコールバックを破棄するかキューに入れるかを決定します。BusyActionプロパティは次の値を取ることができます。

  • “队列”— 割り込みコールバックをキューに入れ、実行中のコールバックが終了した後に処理されるようにします。

  • “取消”— 割り込みコールバックを実行しません。

マウス クリック キャプチャ機能。次の値の 1.つとして指定します。

  • “可见”— 表示されている場合にマウス クリックをキャプチャします。看得见的プロパティが“开”に設定されていなければならず、表面オブジェクトの色が定義されている部分をクリックしなければなりません。関連付けられている色のプロパティが“没有”に設定されている部分をクリックすることはできません。プロットにマーカーが含まれている場合は、エッジまたは塗りつぶしのいずれかに色が定義されている場合にマーカー全体がクリック可能になります。表面オブジェクトがクリックに応答するか,先祖がクリックに応答するかは,命中测试プロパティが決定します。

  • “所有”— 表示状態に関係なくマウス クリックをキャプチャします。看得见的プロパティを“开”または“关”に設定でき,表面オブジェクトの色が設定されていない部分をクリックできます。表面オブジェクトがクリックに応答するか,先祖がクリックに応答するかは,命中测试プロパティが決定します。

  • “没有”——マウスクリックをキャプチャしません。表面オブジェクトをクリックすると、图形ウィンドウの現在のビュー内でその下にあるオブジェクトまでクリックが渡されます。命中测试プロパティは無効になります。

キャプチャしたマウスクリックへの応答。“开”または“关”,もしくは数値または逻辑1.(真正的) または0()として指定します。“开”の値は 符合事实的と等価であり、“关”と等価です。したがって,このプロパティの値を逻辑値として使用できます。値はmatlab.lang.OnOffSwitchState型の 开/关逻辑値として格納されます。

  • “开”表面オブジェクトの按钮向下コールバックをトリガーします。快捷菜单プロパティが定義されている場合は、コンテキスト メニューを呼び出します。

  • “关”表面オブジェクトの先祖のうち,次のいずれかの条件を満たす最も近い先祖のコールバックをトリガーします。

    • 命中测试プロパティが“开”に設定されている

    • 易损件プロパティが、先祖によるマウス クリックのキャプチャを有効にする値に設定されている

メモ

易损件プロパティは,表面オブジェクトがマウスクリックをキャプチャできるかどうかを決定します。キャプチャできない場合,命中测试プロパティは無効です。

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

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

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

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

親/子

すべて展開する

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

子。空のGraphicsPlaceholder配列,または数据提示オブジェクト配列として返されます。このプロパティを使用して,チャートにプロットされるデータヒントのリストを表示します。

孩子们プロパティを使用して子の追加や削除を行うことはできません。このリストに子を追加するには,数据提示オブジェクトのプロパティをチャートオブジェクトに設定します。

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

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

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

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

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

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

識別子

すべて展開する

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

グラフィックスオブジェクトのタイプ。“表面”として返されます。

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

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

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

互換性についての考慮事項

すべて展開する

R2020a以降は非推奨

R2006aより前に導入