15.3.3.8 パッチプロパティ
patchオブジェクトのプロパティ（パッチを参照）:
カテゴリー:
Callback Execution | Color and Transparency | Coordinate Data | Creation/Deletion | Display | 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
色と透明度
alphadatamapping: "direct"| "none"| { "scaled"}
パッチ オブジェクトには透明性がまだ実装されていません。 alphadatamapping未使用です。
cdata: スカラー | 行列 | 配列、定義[](0x0)
パッチ オブジェクトの色を、その x/y/z 座標データに相対的に定義するデータ。パッチの色は、現在のカラーマップのインデックスを使用して定義することも、RGB トリプレットとして定義することもできます。この場合、RGB 色は 3 番目の次元に沿って定義されます。これらの色は、パッチ オブジェクト全体、個々の面、または個々の頂点に対して個別に定義することができ、"cdata"次のように形状によって決定されます。
"cdata"が現在のカラーマップのスカラー インデックスまたは 1 x 1 x 3 の RGB トリプレットである 場合、すべての面とエッジの色を定義します。
パッチ オブジェクトに N 個の面があり、"cdata"カラーマップ インデックスの 1 x N ベクトルまたは 1 x N x 3 RGB 配列である場合、各面の色を定義します。
パッチ オブジェクトに N 個の面があり、面ごとに M 個の頂点があり、cdataM 行 N 列のカラーマップ インデックスの行列または M x N x 3 の RGB 配列である場合、各頂点の色を定義します。( の形状は、、、および の"cdata"形状と一致する必要があります。) "xdata""ydata""zdata"
cdatamapping: "direct"| { "scaled"}
"cdata"または"cdata"プロパティから現在のカラーマップに データをマッピングする方法を設定します。マッピングでは、または の値を現在のカラーマップのインデックスとして "Direct"使用して色を選択します。マッピングでは、またはの値が axes プロパティで指定された範囲にスケーリングされます。 "cdata""facevertexcdata""Scaled""cdata""facevertexcdata""clim"
facealpha: スカラー | "flat"| "interp"、定義1
パッチ オブジェクトの面の透明度レベル。現在サポートされているのは double 値のみで、値 0 は完全な透明度、値 1 は透明度のないソリッド面を意味します。プロパティを または に設定すると"flat"、"interp"面はレンダリングされません。また、面は後ろから前に並べ替えられないため、レイヤー化された透明な面をレンダリングするときに予期しない結果が生じる可能性があります。
facecolor: {colorspec} | "none"| "flat"| "interp", 定義[0 0 0]
パッチ オブジェクトの面の色。有効な色指定または"none"、、、のいずれかとして指定します。 および は"flat"、各面に単一の色を設定するか、または、またはプロパティに格納されている色値データを使用して、面の頂点全体に補間された色を設定します。colorspecを参照してください。 "interp""flat""interp""cdata""facevertexcdata"
facelighting: { "flat"} | "gouraud"| "none"| "phong"
以外の値に設定すると"none"、オブジェクトの面が光と影の効果で描画されます。サポートされている値は"none"、 (照明効果なし)、"flat"(ファセット ルック)、および"gouraud"(頂点間の照明効果の線形補間) です。 "phong"は非推奨であり、 と同じ効果があります"gouraud"。
facevertexalphadata: 定義[](0x0)
パッチ オブジェクトに対して面頂点の透明度コントロールはまだ実装されていません。 facevertexalphadata未使用です。
facevertexcdata: スカラー | 行列、定義[](0x0)
パッチ オブジェクトの色を、その面頂点データに相対的に定義するデータ。パッチの色は、現在のカラーマップのインデックスを使用するか、RGB トリプレットとして定義できます。RGB 色は の行で定義されます"facevertexcdata"。これらの色は、パッチ オブジェクト全体、個々の面、または個々の頂点に対して個別に定義でき、次のように の形状によって決定されます"facevertexcdata"。
が現在のカラーマップのスカラー インデックスまたは 1 行 3 列の RGB トリプレットである場合facevertexcdata、すべての面とエッジの色を定義します。
パッチ オブジェクトに N 個の面があり、facevertexcdataN 行 1 列のインデックスの列ベクトルまたは N 行 3 列の RGB 行列である場合、N 個の面のそれぞれの色を定義します。
パッチ オブジェクトに M 個の頂点があり、facevertexcdataインデックスの M 行 1 列のベクトルまたは M 行 3 列の RGB 行列である場合、各頂点の色を定義します。
座標データ
faces: ベクトル | 行列、定義[1 2 3]
パッチ面の接続リストは M x N 行列として保存され、M 面のそれぞれは最大 N 個の頂点の行によって定義され、各要素には頂点プロパティに保存されている頂点の行インデックスが含まれます。頂点が N 個未満の面では、空の行要素を埋めるために NaN 値が使用されます。
vertices: ベクトル | 行列、定義 3行2列の倍精度浮動小数点数
パッチ頂点リストは N x 3 行列として保存され、各行にはベクトルの x、y、z 座標が含まれ、faces プロパティと共に使用されてパッチ構造を定義します。
xdata: ベクトル | 行列、定義[0; 1; 0]
パッチ頂点の x 座標。
ydata: ベクトル | 行列、定義[1; 1; 0]
パッチ頂点の Y 座標。
zdata: ベクトル | 行列、定義[](0x0)
パッチ頂点の Z 座標。
作成/削除
beingdeleted: { "off"} | "on"
関数がオブジェクトの削除を開始したことを示すプロパティ。 beingdeletedオブジェクトが存在しなくなるまで true に設定されます。
createfcn: 文字列 | 関数ハンドル、定義[](0x0)
パッチが作成された直後に実行されるコールバック関数。関数は、ルート オブジェクトのデフォルト プロパティを使用して設定されます (例: set (groot, "defaultpatchcreatefcn", 'disp ("patch created!")'))。
グラフィックス リスナー関数の記述方法については、「コールバック」セクションを参照してください。
deletefcn: 文字列 | 関数ハンドル、定義[](0x0)
パッチが削除される直前に実行されるコールバック関数。
グラフィックス リスナー関数の記述方法については、「コールバック」セクションを参照してください。
画面
clipping: "off"| { "on"}
clippingの場合"on"、パッチは親軸の制限内でクリップされます。
visible: "off"| { "on"}
visibleの場合"off"、パッチは画面上にレンダリングされません。
凡例オプション
displayname: 定義""
このパッチに対応する凡例エントリのテキスト。
照明
ambientstrength: スカラー、定義0.3000
周囲光の強さ。0.0 ～ 1.0 の間の値。
backfacelighting: "lit"| { "reverselit"} | "unlit"
"lit": 法線はそのまま照明に使用されます。 "reverselit": 法線は常に視点の方向を向いています。 "unlit": 法線が視点から遠ざかる面は照明されません。
diffusestrength: スカラー、定義0.6000
拡散反射の強さ。0.0 (拡散反射なし) から 1.0 (完全な拡散反射) の間の値。
facenormals: 定義[](0x0)
edgelightingまたはプロパティfacelightingが に設定されている場合、面法線はエッジまたは面の照明に使用されます"flat"。 を設定すると、 プロパティfacenormalsもfacenormalsmodeに設定されます"manual"。
facenormalsmode: { "auto"} | "manual"
このプロパティが に設定されている場合"auto"、またはプロパティが に設定され、同じ軸に 少なくとも 1 つのオブジェクトが存在し、表示されているfacenormals場合は、 が自動的に計算されます。edgelightingfacelighting"flat"light
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常に です"patch"。
userdata: 任意のオクターブデータ、定義[](0x0)
グラフィック オブジェクトに関連付けるユーザー定義データ。
アウトラインの外観
edgealpha: スカラー | 行列、定義1
パッチ オブジェクトには透明性がまだ実装されていません。 edgealpha未使用です。
edgecolor: colorspec | "none"| "flat"| "interp", 定義[0 0 0]
パッチ オブジェクトのエッジの色。有効な色指定または"none"、、、のいずれかとして指定します。 および は"flat"、各エッジに単一の色を設定するか、または に格納されている色値データを使用してエッジの頂点間に補間された色を設定します。colorspecを参照してください。 "interp""flat""interp""cdata"
edgelighting: "flat"| "gouraud"| { "none"} | "phong"
以外の値に設定すると"none"、オブジェクトのエッジが光と影の効果で描画されます。サポートされている値は"none"、 (照明効果なし)、"flat"(ファセット ルック)、および"gouraud"(頂点間の照明効果の線形補間) です。 "phong"は非推奨であり、 と同じ効果があります"gouraud"。
linestyle: { "-"} | "--"| "-."| ":"| "none"
「線のスタイル」を参照してください。
linewidth: スカラー、定義0.5000
線の線幅プロパティを参照してください。
親/子
children(読み取り専用): グラフィックス ハンドルのベクトル、定義[](0x1)
パッチ オブジェクトの子オブジェクトは、パッチ オブジェクトにはまだ実装されていません。 children未使用です。
handlevisibility: "callback"| "off"| { "on"}
handlevisibilityの場合"off"、パッチのハンドルは親の"children"プロパティには表示されません。
parent: グラフィックハンドル
親グラフィック オブジェクトのハンドル。