15.3.3.10 表面特性
surfaceオブジェクトのプロパティ（表面を参照）:
カテゴリー:
Callback Execution | Color and Transparency | Coordinate Data | Creation/Deletion | Display | Faces Appearance | Legend Options | Lighting | Marker Appearance | Mouse Interaction | Object Identification | Outline Appearance | Parent/Children
コールバックの実行
busyaction: "cancel"| { "queue"}
別のオブジェクトの実行中のコールバックを中断できない場合に、Octave がこのオブジェクトのコールバック プロパティの実行をどのように処理するかを定義します。これは、現在実行中のコールバック オブジェクトのinterruptibleプロパティが に設定されている場合にのみ関係します"off"。busyaction中断しているコールバック オブジェクトのプロパティは、中断しているコールバックがキューに入れられているか ( "queue"(デフォルト))、破棄されているか ( "cancel") を示します。コールバックのセクションを参照してください。
interruptible: "off"| { "on"}
このオブジェクトのコールバック関数が他のコールバックによって中断されるかどうかを指定します。デフォルトではinterruptible、、、、または関数"on"を使用するコールバックは最終的に中断されます。コールバックのセクションを参照してください。 drawnowfigurewaitforgetframepause
色と透明度
alphadata: スカラー | 行列、定義1
サーフェス オブジェクトには透明性がまだ実装されていません。 alphadata未使用です。
alphadatamapping: "direct"| "none"| { "scaled"}
サーフェス オブジェクトには透明性がまだ実装されていません。 alphadatamapping未使用です。
cdata: 配列、定義: 3行3列の倍精度浮動小数点数型
表面頂点のカラー データ値。データは、各要素の値によって現在のカラーマップに従って頂点の色が決まる同じサイズの 2D マトリックスとして"zdata"、または 3 番目の次元に各頂点の赤、青、緑の個別のコンポーネントが含まれる 3D 配列として保存されます。
cdatamapping: "direct"| { "scaled"}
"cdata" プロパティから現在のカラーマップに データをマッピングする方法を設定します。マッピングは、値を現在のカラーマップのインデックスとして "Direct"使用して色を選択します。マッピングは、 軸プロパティで指定された範囲に値をスケーリングします。 "cdata""Scale""cdata""clim"
cdatasource: 文字列、定義""
"cdata" プロパティに使用されるデータを含むワークスペース変数の名前。データはrefreshdata 関数"cdata"を使用して転送されます。
座標データ
xdata: 行列、定義[1 2 3]
x 座標のデータ。
xdatasource: 文字列、定義""
"xdata" プロパティに使用されるデータを含むワークスペース変数の名前。データはrefreshdata 関数"xdata"を使用して転送されます。
ydata: 行列、定義[1; 2; 3]
Y座標のデータ。
ydatasource: 文字列、定義""
"ydata" プロパティに使用されるデータを含むワークスペース変数の名前。データはrefreshdata 関数"ydata"を使用して転送されます。
zdata: 行列、定義 3行3列の倍精度浮動小数点数
Z 座標のデータ。
zdatasource: 文字列、定義""
"zdata" プロパティに使用されるデータを含むワークスペース変数の名前。データはrefreshdata 関数"zdata"を使用して転送されます。
作成/削除
beingdeleted: { "off"} | "on"
関数がオブジェクトの削除を開始したことを示すプロパティ。 beingdeletedオブジェクトが存在しなくなるまで true に設定されます。
createfcn: 文字列 | 関数ハンドル、定義[](0x0)
サーフェスが作成された直後に実行されるコールバック関数。関数は、ルート オブジェクトの既定のプロパティを使用して設定されます (例: set (groot, "defaultsurfacecreatefcn", 'disp ("surface created!")'))。
グラフィックス リスナー関数の記述方法については、「コールバック」セクションを参照してください。
deletefcn: 文字列 | 関数ハンドル、定義[](0x0)
サーフェスが削除される直前に実行されるコールバック関数。
グラフィックス リスナー関数の記述方法については、「コールバック」セクションを参照してください。
画面
clipping: "off"| { "on"}
clippingの場合"on"、サーフェスは親軸の制限内でクリップされます。
visible: "off"| { "on"}
visibleの場合"off"、サーフェスは画面上にレンダリングされません。
顔の外観
facealpha: スカラー | "flat"| "interp"| "texturemap", 定義1
サーフェス オブジェクトの面の透明度レベル。現在サポートされているのは double 値のみです。値 0 は完全な透明度、値 1 は透明度のないソリッド面を意味します。プロパティを"flat"、 、 に設定すると"interp"、"texturemap"面はレンダリングされません。また、面は後ろから前に並べ替えられないため、レイヤー化された透明面をレンダリングするときに予期しない結果が生じる可能性があります。
facecolor: カラースペック | "none"| { "flat"} | "interp"
サーフェス オブジェクトの面の色。有効な色指定または"none"、、、のいずれかとして指定します。 および は"flat"、各面に単一の色を設定するか、または に格納されている色値データを使用して面の頂点全体に補間された色を設定します。colorspecを参照してください。 "interp""flat""interp""cdata"
facelighting: { "flat"} | "gouraud"| "none"| "phong"
以外の値に設定すると"none"、オブジェクトの面が光と影の効果で描画されます。サポートされている値は"none"、 (照明効果なし)、"flat"(ファセット ルック)、および"gouraud"(頂点間の照明効果の線形補間) です。 "phong"は非推奨であり、 と同じ効果があります"gouraud"。
facenormals: 定義[](0x0)
edgelightingまたはプロパティfacelightingが に設定されている場合、面法線はエッジまたは面の照明に使用されます"flat"。 を設定すると、 プロパティfacenormalsもfacenormalsmodeに設定されます"manual"。
facenormalsmode: { "auto"} | "manual"
このプロパティが に設定されている場合"auto"、またはプロパティが に設定され、同じ軸に 少なくとも 1 つのオブジェクトが存在し、表示されているfacenormals場合は、 が自動的に計算されます。edgelightingfacelighting"flat"light
凡例オプション
displayname: 定義""
このサーフェスに対応する凡例エントリのテキスト。
照明
ambientstrength: スカラー、定義0.3000
周囲光の強さ。0.0 ～ 1.0 の間の値。
backfacelighting: "lit"| { "reverselit"} | "unlit"
"lit": 法線はそのまま照明に使用されます。 "reverselit": 法線は常に視点の方向を向いています。 "unlit": 法線が視点から遠ざかる面は照明されません。
diffusestrength: スカラー、定義0.6000
拡散反射の強さ。0.0 (拡散反射なし) から 1.0 (完全な拡散反射) の間の値。
specularcolorreflectance: スカラー、定義1
鏡面反射色の反射率。0.0 (基になる面の色) から 1.0 (光源の色) の間の値。
specularexponent: スカラー、定義10
鏡面反射の指数。値が低いほど、反射が広がります。
specularstrength: スカラー、定義0.9000
鏡面反射の強さ。0.0 (鏡面反射なし) から 1.0 (完全な鏡面反射) の間の値。
vertexnormals: 定義[](0x0)
edgelightingまたはプロパティfacelightingが に設定されている場合、頂点法線はエッジまたは面の照明に使用されます"gouraud"。 を設定すると、 プロパティvertexnormalsも にvertexnormalsmode設定されます"manual"。
vertexnormalsmode: { "auto"} | "manual"
このプロパティが に設定されている場合"auto"、またはプロパティが に設定され、同じ軸に 少なくとも 1 つのオブジェクトが存在し、表示されているvertexnormals場合は、 が自動的に計算されます。edgelightingfacelighting"gouraud"light
マーカーの外観
marker: "*"| "+"| "."| "<"| ">"| "^"| "_"| "d"| "diamond"| "h"| "hexagram"| { "none"} | "o"| "p"| "pentagram"| "s"| "square"| "v"| "x"| "|"
「マーカー スタイル」を参照してください。
markeredgecolor: { "auto"} | "flat"| "none"
ライン markeredgecolor プロパティを参照してください。
markerfacecolor: "auto"| "flat"| { "none"}
ラインマーカーフェイスカラープロパティを参照してください。
markersize: スカラー、定義6
ラインマーカーサイズプロパティを参照してください。
マウス操作
buttondownfcn: 文字列 | 関数ハンドル、定義[](0x0)
グラフィックス リスナー関数の記述方法については、「コールバック」セクションを参照してください。
contextmenu: グラフィックハンドル、定義[](0x0)
現在このサーフェス オブジェクトに関連付けられている uicontextmenu オブジェクトのグラフィックス ハンドル。
hittest: "off"| { "on"}
サーフェスがマウス イベントを処理するか、オブジェクトの祖先に渡すかを指定します。有効にすると、オブジェクトは を評価し"buttondownfcn"、uicontextmenu を表示し、最終的にルート になることで、マウス クリックに応答します"currentobject"。このプロパティは、オブジェクトが によって決定されるマウス クリックを受け入れることができる場合にのみ関連します"pickableparts"。pickablepartsプロパティを参照してください。
pickableparts: "all"| "none"| { "visible"}
サーフェスがマウス クリックを受け入れるかどうかを指定します。デフォルトでは、pickablepartsサーフェス"visible"の可視部分またはその子だけがマウス クリックに反応します。 の場合pickablepartsは、"all"可視部分と不可視部分 (または子) の両方がマウス クリックに反応します。 の場合は、pickablepartsオブジェクト"none"上のマウス クリックは無視され、このオブジェクトの下にあるすべてのオブジェクトに送信されます。オブジェクトがマウス クリックを受け入れるように構成されている場合、"hittest"プロパティによって処理方法が決まります。hittestプロパティを参照してください。
selected: { "off"} | "on"
プロパティは、このサーフェスが選択されているかどうかを示します。
selectionhighlight: "off"| { "on"}
selectionhighlightの場合"on"、サーフェスの選択状態が視覚的に強調表示されます。
オブジェクトの識別
tag: 文字列、定義""
グラフィック オブジェクトにラベルを付けるユーザー定義の文字列。
type（読み取り専用）：文字列
グラフィックス オブジェクトのクラス名。 type常に です"surface"。
userdata: 任意のオクターブデータ、定義[](0x0)
グラフィック オブジェクトに関連付けるユーザー定義データ。
アウトラインの外観
edgealpha: スカラー、定義1
サーフェス オブジェクトには透明性がまだ実装されていません。 edgealpha未使用です。
edgecolor: colorspec | "none"| "flat"| "interp", 定義[0 0 0]
サーフェス オブジェクトのエッジの色。有効な色指定または 、 、 のいずれかとして指定します"none"。は 、"flat"に格納されている色値データを使用して、各エッジに単一の色を設定するか、隣接する 2 つの頂点間に補間された色を設定します。 colorspec を参照してください。 "interp""flat""interp""cdata"
edgelighting: "flat"| "gouraud"| { "none"} | "phong"
以外の値に設定すると"none"、オブジェクトのエッジが光と影の効果で描画されます。サポートされている値は"none"、 (照明効果なし)、"flat"(ファセット ルック)、および"gouraud"(頂点間の照明効果の線形補間) です。 "phong"は非推奨であり、 と同じ効果があります"gouraud"。
linestyle: { "-"} | "--"| "-."| ":"| "none"
「線のスタイル」を参照してください。
linewidth: スカラー、定義0.5000
線の線幅プロパティを参照してください。
meshstyle: { "both"} | "column"| "row"
サーフェス データの行、列、またはその両方に関連付けられたエッジを表示するかどうかを指定します。
親/子
children(読み取り専用): グラフィックス ハンドルのベクトル、定義[](0x1)
サーフェスの子オブジェクトは、サーフェス オブジェクトに対してまだ実装されていません。 children未使用です。
handlevisibility: "callback"| "off"| { "on"}
handlevisibilityの場合"off"、サーフェスのハンドルは親の"children"プロパティでは表示されません。
parent: グラフィックハンドル
親グラフィック オブジェクトのハンドル。