MATLAB Function Reference

Line Properties

Line プロパティ

コールバックルーチンの割込み。BusyAction プロパティを使って、実行中のコールバックルーチンに割込みを行うイベントの取り扱い方法を制御することができます。実行中のコールバックルーチンがあれば、続いて呼び込まれるコールバックルーチンは、常にそれを中断しようとします。実行中のオブジェクトのコールバックのInterruptibleプロパティがon (デフォルト)に設定されていれば、イベントキューが処理されるつぎの点で割込みが起こります。Interruptibleプロパティがoffならば、(実行中のコールバックをもつオブジェクトの)BusyActionプロパティは、MATLABがイベントを処理する方法を指定します。つぎのような選択があります。

• cancel - 2番目のコールバックルーチンを実行しようとしたイベントを破棄します。
• queue - 現在のコールバックが終了するまで、2番目のコールバックルーチンを実行しようとするイベントを待機させます。

ボタンを押したときのコールバックルーチン。マウスポインタがLineオブジェクト上にあるときにマウスボタンを押すと、必ず実行されるコールバックルーチン。このルーチンには、正しいMATLAB表現、または、M-ファイル名を文字列として定義してください。式は、MATLABワークスペース内で実行します。

空行列。Line オブジェクトは、子オブジェクトをもちません。

クリッピングモード。MATLAB は、デフォルトでLine オブジェクトを Axes のプロットボックスにクリップします。Clippingプロパティをoffに設定すると、Line オブジェクトは Axesのプロットボックスの外に表示します。Line オブジェクトを作成し、holdを onにし、軸のスケーリングを固定 (axis manual)、その後でより長い Line オブジェクトを作成したときに、このようなことが起こります。

Line のカラー。 Lineのカラーを指定する3要素のRGBベクトル、または、MATLAB の既定のカラー名。カラーの設定については、ColorSpecのリファレンスページを参照してください。

オブジェクト作成時に実行されるコールバックルーチン。このプロパティは、MATLAB が Line オブジェクトを作成するときに実行するコールバックルーチンを定義します。Lineオブジェクトに対するデフォルト値として、このプロパティを定義しなくてはいけません。たとえば、

set(0,'DefaultLineCreateFcn','set(gca,''LineStyleOrder'',''-.|--'')')

Line 削除時のコールバックルーチンの削除。Lineオブジェクトを削除する(たとえば、 delete の実行や、Axesや Figure を消去する）とき、実行するコールバックルーチン。MATLABは、オブジェクトのプロパティを削除する前にルーチンを実行するので、これらの値はコールバックルーチンに対して利用可能です。

消去モード。このプロパティは、Lineオブジェクトを描いたり、消去するMATLABの機能を制御するものです。消去モードは、連続的に動きを表現するアニメーションの作成に有効なものです。すなわち、アニメーションでは、パフォーマンスを改良したり、希望する効果を得るために、個々のオブジェクトを再描画する方法を制御する必要があります。

• normal (デフォルト) - すべてのオブジェクトが正しく描画されることを保証するために必要な3次元解析を行い、表示範囲を再描画します。このモードは、最も正確な図を表示することができますが、非常に時間のかかるものです。他のモードは、かなり時間の短縮にはなりますが、完全な図を再表示することはできず、精度は悪くなります。
• none - Lineは移動したり、壊されても、消去されません。 EraseMode に noneを使って消去した後で、スクリーン上でオブジェクトが視覚可能であっても、MATLABは以前の位置に関する情報を格納しないので、印刷できません。
• xor - Lineは、その下のスクリーンの各ピクセルのインデックスとの排他的論理和(XOR)により、表示と消去が行われます。Lineの消去は、Lineの下のオブジェクトの色に影響を与えません。しかし、Lineのカラーは、その下のスクリーンのカラーに依存します。
• background - axesのバックグランドColorの中でそれを描くことで、ラインを消去します。または、axeのColorが、noneに設定されている場合、フィギュアのバックグランド Colorを使って消去します。これは、消去したラインに隠れていたオブジェクトに影響を与えますが、ラインは、常に適切に色付けされます。

Non-normal Erase モードでの印刷

MATLABは、すべてのオブジェクトのEraseModeが、normalであるかのようにフィギュアを印刷します。これは、EraseModeに、none, xor, backgroundのいずれかを設定して作成されたグラフィックオブジェクトは、スクリーンでの表示と印刷用紙での表示が異なって見えることを意味しています。スクリーン上で、MATLABは、カラー層を数学的に合わせて(たとえば、ピクセルカラーとその後ろにあるピクセルのカラーとの排他的な和を計算する)、最大のレンダリングスピードを得るための3次元のソートを無視しています。しかし、これらの技法は、印刷出力には適用されません。

MATLABのコマンドgetframeや、他のスクリーンキャプチャアプリケーションを使って、非ノーマルなモードでのオブジェクトを含むフィギュアのイメージを作成することができます。

マウスクリックによる選択。 HitTest は、Line上でのマウスクリックの結果、Lineがカレントのオブジェクト(gcoコマンドとFigureのCurrentObjectプロパティにより出力される)になり得るかどうかを指定します。HiTestがoffならば、Line上をクリックすると、その下のオブジェクト(このオブジェクトを含むAxesかもしれません)を選択します。

コマンドラインユーザとGUIによるオブジェクトのハンドルへのアクセスの制御。このプロパティは、オブジェクトのハンドルが、その子オブジェクトの親のリスト内で、どのようなときに、視覚可能であるときを決定します。HandleVisibilityプロパティは、(ダイアログボックスのような)ユーザインタフェースデバイスのみを含んでいるFigure内に、コマンドラインから誤って書き込むことや削除することを防ぐために有効です。

コールバックルーチンの中断モード。Interruptibleプロパティは、Lineのコールバックルーチンが、連続的に呼び込まれるコールバックルーチンによって、中断されるかどうかを制御します。ButtonDownFcnに対して定義されたコールバックルーチンのみが、Interruptibleプロパティにより影響を受けます。MATLABは、ルーチン内でdrawnow, figure, getframe, pauseコマンドが実行されるときのみ、コールバックルーチンを中断できるイベントを確認します。

ラインスタイル。 このプロパティは、ラインスタイルを指定します。使用可能なラインスタイルを以下に示します。

シンボル	ラインスタイル
-	実線 (デフォルト)
--	破線
:	点線
-.	鎖線
none	線なし

ラインの幅。ポイント数で指定します(1ポ イント= ¹/72 インチ)。デフォルトのLineWidthは、0.5ポイントです。

マーカシンボル。Marker プロパティは、データ点を表示するマークを指定します。Markerプロパティに対して、 LineStyleプロパティとは独立に値を指定できます。サポートされているマーカは、以下の通りです。

マーカ	詳細
+	プラス記号
o	円
*	アスタリスク
.	点
x	ｘ印
s	四角形
d	ダイアモンド
^	上向き三角形
v	下向き三角形
>	右向き三角形
<	左向き三角形
p	五角形
h	六角形
none	マーカなし(デフォルト)

マーカのエッジのカラー。マーカのカラー、または、塗りつぶされたマーカ(円、四角形、ダイアモンド、五角形、六角形、4種類の三角形)のエッジのカラー。ColorSpec は、使うカラーを定義します。noneはカラーを指定しないので、マーカに着色せず、 見えません。 autoは、MarkerEdgeColorをLineのColorプロパティと同じカラーに設定します。

マーカの面のカラー。閉じた形のマーカ(円、四角形、ダイアモンド、五角形、六角形、4種類の三角形)を塗りつぶすカラー。ColorSpec は、使うカラーを定義します。noneは、マーカの内側を透明にし、バックグランドが見えるようにします。autoは、塗りつぶすカラーをAxesのカラーに設定するか、AxesのColorプロパティがnoneに設定されていたら、Figureのカラーに設定します。

マーカサイズ。マーカのサイズをポイント数で指定します。MarkerSize に対するデフォルト値は、6ポイントです(1ポイント= ¹/72 インチ)。MATLABは、店マーカ('.'にて指定)を指定したサイズの1/3で描きます。

Line の親オブジェクト。 Line の親オブジェクトであるAxes のハンドル番号。このプロパティを新しい Axes のハンドル番号に変更することにより、Lineオブジェクトを他の Axes に移動できます。

選択されたオブジェクト。このプロパティが onのとき、MATLAB は、SelectionHighlightプロパティもonならば、ハンドル番号の選択状態を示すハンドルを表示します。たとえば、このプロパティを設定するためにButtonDownFcnを定義すると、マウスでオブジェクトを選択することができます。

選択時のオブジェクトの強調。Selectedプロパティが on のとき、MATLAB は各々の頂点にハンドルを描くことにより、選択された状態を表わします。SelectionHighlightが offならば、MATLAB はハンドルを描きません。

ユーザ指定のオブジェクトのラベル。Tagプロパティは、ユーザ指定のラベルを使ってグラフィックスオブジェクトを識別する方法を提供します。これは、オブジェクトのハンドル番号をグローバル変数として定義したり、コールバックルーチン間で引数として渡すことを必要とする、対話的なグラフィックスプログラムを構築するときに、特に有効です。任意の文字列でTagを定義できます。

グラフィックスオブジェクトのクラス。Line オブジェクトでは、Typeは、常に文字列 'line'です。

Lineに関連したコンテキストメニュー。 Lineと同じFigure内に作成するUicontextmenuオブジェクトのハンドルに、このプロパティをアサインします。コンテキストメニューを作成するには、関数uicontextmenuを使います。Line上を右クリックすると、コンテキストメニューを表示します。

ユーザ指定のデータ。任意のデータをLine オブジェクトに関連付けることができます。MATLAB は、このデータを使いませんが、setとgetを使って、アクセスすることができます。

ラインの可視化。デフォルトでは、すべてのLine が視覚可能です。offに設定すると、Line は見えなくなりますが、それでも存在していて、そのプロパティに対してsetと getを使うことができます。

X座標。 Line を定義する x 座標のベクトル。YDataと ZDataは、行数が同じでなくてはいけません。("例題"を参照)。

Y座標。Line を定義する y 座標のベクトル。XDataとZDataは、行数が同じでなくてはいけません("例題"を参照)。

Z座標。Line を定義するz座標のベクトル。XDataと YData は、行数が同じでなくてはいけません。("例題"を参照)。

参考：

line

LineSpec