主要内容

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

Surfaceのプロパティ

基本的な表面の外観と動作

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

S =表面;c = s.CData;s.CDataMapping = 'direct';

すべて展開する

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

説明
“平”

CDataプロパティの値に基づいて面ごとに異なる色を使用します。まず,CDataプロパティをZDataと同じサ@ @ズの行列として指定しなければなりません。各面の最初の頂点(正のx方向とy方向)のカラ,値が,面全体の色を決定します。この値はFaceAlphaプロパティが的插值函数に設定されている場合は使用できません。

的插值函数

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

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” [10 0 0] “# FF0000”

“绿色” ‘g’ [0 10 0] “# 00 ff00”

“蓝” “b” [0 0 1] “# 0000 ff”

“青色” “c” [0 1 1] “# 00飞行符”

“红色” “米” [10 0 1] “#就”

“黄色” “y” [11 10 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”

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

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

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

  • 的插值函数- - - - - -AlphaDataプロパティの値に基づいて面ごとに内挿された透明度を使用します。頂点の値を内挿することにより,各面に異なる透明度が使用されます。まずAlphaDataプロパティをZDataプロパティと同じサ@ @ズの行列として指定しなければなりません。FaceColorプロパティも,的插值函数に設定しなければなりません。

  • “texturemap”- - - - - -AlphaDataのデ,タを表面に適合するように変換します。

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

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

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

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

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

メモ

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

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

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

  • “灯”-面をラie浏览器ティングしません。

  • “点燃”-頂点法線に従って面をラie浏览器ティングします。

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

エッジ

すべて展開する

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

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

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

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

的插值函数

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” [10 0 0] “# FF0000”

“绿色” ‘g’ [0 10 0] “# 00 ff00”

“蓝” “b” [0 0 1] “# 0000 ff”

“青色” “c” [0 1 1] “# 00飞行符”

“红色” “米” [10 0 1] “#就”

“黄色” “y” [11 10 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”

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

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

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

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

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

ラ▪▪ンスタ▪▪ル 説明 結果として得られる線
“- - -” 実線

“——” 破線

“:” 点線

“-”。 一点鎖線

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

ラ@ @ン幅。ポ@ @ント単位の正の値として指定します。1ポaapl . exeントは1/72 aapl . exeンチです。ラ。

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

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

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

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

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

メモ

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

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

  • “平”-各エッジにラie浏览器トを一様に適用します。

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

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

メモ

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

マカ

すべて展開する

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

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

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

マ,カ,の輪郭の色。“汽车”“平”, 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” [10 0 0] “# FF0000”

“绿色” ‘g’ [0 10 0] “# 00 ff00”

“蓝” “b” [0 0 1] “# 0000 ff”

“青色” “c” [0 1 1] “# 00飞行符”

“红色” “米” [10 0 1] “#就”

“黄色” “y” [11 10 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”

マカの塗りぶし色。“汽车”“平”, 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” [10 0 0] “# FF0000”

“绿色” ‘g’ [0 10 0] “# 00 ff00”

“蓝” “b” [0 0 1] “# 0000 ff”

“青色” “c” [0 1 1] “# 00飞行符”

“红色” “米” [10 0 1] “#就”

“黄色” “y” [11 10 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”

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

例:[0.3 0.2 0.1]

例:“绿色”

例:“# D2F9A7”

座標のデ,タ

すべて展開する

X座標のデタ。ZDataと同じサ@ @ズの行列または长度(n)のベクトルとして指定します。ここで[m,n] = size(ZData)です。

デ,タ型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|datetime|持续时间

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

  • “汽车”- - - - - -ZDataの列@ @ンデックスを使用します。

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

Y座標のデ,タ。ZDataと同じサ@ @ズの行列または长度(米)のベクトルとして指定します。ここで[m,n] = size(ZData)です。

デ,タ型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|datetime|持续时间

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

  • “汽车”- - - - - -ZDataの行@ @ンデックスを使用します。

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

Z座標のデ,タ。行列として指定します。

デ,タ型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|datetime|持续时间

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

すべて展開する

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

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

  • 3次元配列-トゥルカラを使用します。CDataをm x n x 3の配列に設定して各頂点の色をRGB 3成分で指定します。ここで[m,n] = size(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プロパティを設定します。

直接カラ,マッピングまたはスケ,リングしたカラ,マッピング。次の値のいずれかとして指定します。

  • 按比例缩小的-軸の这一プロパティで指定したカラーマップの部分全体にカラーデータを変換し,データ値を色に線形にマッピングします。このマッピングの詳細にいては,caxisのリファレンスペ,ジを参照してください。

  • 直接—カラデタを直接カラマップのンデックスとして使用します。カラ,デ,タは,1 ~ .长度(colormap)の範囲の整数値でなければなりません。Matlabは,1より小さい値をカラーマップ内の最初の色に、长度(colormap)より大きな値をカラ,マップの最後の色にマップします。小数部分の値は,最近傍値の小さい方の整数に丸められます。

各頂点の透明度デ,タ。ZDataプロパティと同じサ@ @ズの配列として指定します。値を指定した後,FaceAlphaプロパティとEdgeAlphaプロパティを設定して透明度のタ@ @プを制御します。FaceAlphaプロパティとEdgeAlphaプロパティの両方がスカラ,値に設定されている場合,曲面はAlphaDataの値を使用しません。

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

デ,タ型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|逻辑

AlphaDataの値の解釈。次の値のいずれかとして指定します。

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

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

  • “直接”—图のalphamapのンデックスとして値を解釈します。小数部分の値は,最近傍値の小さい方の整数に丸められます。

    • 値が型または型の場合,1以下の値はalphamapの最初の要素にマッピングされます。Alphamapの長さ以上の値は,Alphamapの最後の要素にマッピングされます。

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

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

法線

すべて展開する

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

このプロパティの値を設定すると,対応するモ,ドプロパティがmanualに設定されます。法線ベクトルを指定しない場合,ラ。

デ,タ型:|

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

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

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

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

このプロパティの値を設定すると,対応するモ,ドプロパティがmanualに設定されます。法線ベクトルを指定しない場合,ラ。

デ,タ型:|

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

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

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

ラ@ @ティング

すべて展開する

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

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

例:0.5

デ,タ型:

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

例:0.3

デ,タ型:

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

例:0.3

デ,タ型:

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

例:7

デ,タ型:

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

例:0.5

デ,タ型:

凡例

すべて展開する

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

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

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

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

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

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

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

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

対話機能

すべて展開する

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

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

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

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

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

このプロパティはデ,タヒントが固定された表面にのみ適用されます。

メモ

DataTipTemplateオブジェクトはfindobjまたはfindallによって返されず,copyobjによってコピ,されません。

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

メモ

PickablePartsプロパティが“没有”に設定されている場合またはHitTestプロパティが“关闭”に設定されている場合には,このコンテキストメニュ,は表示されません。

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

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

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

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

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

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

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

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

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

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

コ,ルバック

すべて展開する

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

  • 関数ハンドル

  • 関数ハンドルと追加の引数を含むcell配列

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

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

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

  • @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @。この引数が使用されないことを示すために、関数定義の中でこの引数をチルダ文字()に置換します。

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

メモ

PickablePartsプロパティが“没有”に設定されている場合またはHitTestプロパティが“关闭”に設定されている場合には,このコ,ルバックは実行されません。

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

  • 関数ハンドル。

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

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

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

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

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

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

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

  • 関数ハンドル。

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

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

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

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

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

コ,ルバック実行制御

すべて展開する

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

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

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

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

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

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

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

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

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

メモ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    • HitTestプロパティが“上”に設定されている

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

メモ

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

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

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

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

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

親/子

すべて展開する

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

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

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

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

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

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

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

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

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

識別子

すべて展開する

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

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

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

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

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

互換性にいての考慮事項

すべて展開する

R2020a以降は非推奨

R2006aより前に導入