15.2.7 プロットウィンドウの操作
デフォルトでは、Octave はプロンプトが印刷されるとき、または入力を待機しているときにプロット ウィンドウを更新します。この drawnow関数は、プロット ウィンドウを更新するために使用されます。
: drawnow ()
: drawnow ("expose")
: drawnow (term, file, debug_file)
図のウィンドウとその子を更新します。
イベント キューがフラッシュされ、生成されたコールバックが実行されます。
オプションの引数を使用すると"expose"、グラフィック オブジェクトのみが更新され、他のイベントやコールバックは処理されません。
の 3 番目の呼び出し形式はdrawnowデバッグ用であり、文書化されていません。
See also: refresh.
変更された図形のみが更新されます。このrefresh 関数を使用すると、変更されていない場合でも現在の図形を更新できます。
: refresh ()
: refresh (h)
図を更新して強制的に再描画します。
引数なしで呼び出されると、現在の図が再描画されます。それ以外の場合は、グラフィック ハンドルhを持つ図が再描画されます。
See also: drawnow.
plot通常、またはのような高レベルのプロット関数は、対象の軸の状態を初期化するか（デフォルト）、後続のプロットを前のプロットの上に描画するかを決定するためにmesh呼び出します 。2 つのプロットを重ねて描画するには、 関数を使用するか、軸のnextplot プロパティを手動で変更します。たとえば、 newplothold
hold on; x = -10:0.1:10; plot (x, sin (x)); plot (x, cos (x)); hold off;
正弦波と余弦波を同じ軸に表示します。ホールド状態がオフの場合、このような連続したプロット コマンドでは最後のプロットのみが表示されます。
: newplot ()
: newplot (hfig)
: newplot (hax)
: hax = newplot (…)
新しいプロットを生成するためのグラフィック エンジンを準備します。
この関数は、すべての高レベル プロット関数の開始時に呼び出されます。通常、ユーザー プログラムでは必要ありません。 現在の図と軸のフィールド newplot を照会して、何をするかを決定します。"NextPlot"
図 NextPlot アクション
"new" 新しい図を作成し、それを現在の図にします。
"add"（デフォルト） 現在の図に新しいグラフィック オブジェクトを追加します。
"replacechildren" HandleVisibility が に設定されている子オブジェクトを削除します"on"。NextPlot プロパティを に設定します "add"。これにより、通常は図がクリアされますが、メニューバーなどの非表示のオブジェクトはそのまま残ります。これは と同等ですclf。
"replace" 図のすべての子オブジェクトを削除し、すべての図のプロパティをデフォルトにリセットします。ただし、Position、Units、PaperPosition、PaperUnits の 4 つのプロパティはリセットされません。これは と同等ですclf reset。
軸 NextPlot アクション
"add" 現在の軸に新しいグラフィック オブジェクトを追加します。これは と同等ですhold on。
"replacechildren" HandleVisibility が に設定されている子オブジェクトを削除します"on"が、軸のプロパティは変更しません。これにより、通常はプロットがクリアされますが、軸のログ スケーリングなどの特別な設定は保持されます。これは と同等ですcla。
"replace"（デフォルト） 軸のすべての子オブジェクトを削除し、すべての軸プロパティをデフォルトにリセットします。ただし、位置、単位のプロパティはリセットされません。これは と同等ですcla reset。
オプションの入力hfigまたはhax が指定されている場合は、現在の図と軸ではなく、指定された図または軸を準備します。
オプションの戻り値hax は、作成された軸オブジェクト (図ではない) へのグラフィックス ハンドルです。
Caution:newplot 呼び出すと、現在の図と現在の軸が変更される場合があります。
: hold
: hold on
: hold off
: hold (hax, …)
"hold"新しいグラフィック オブジェクトをプロットに追加するか、既存のオブジェクトを置き換えるかを決定するプロット エンジンの状態 を切り替えたり設定したりします。
hold on
後続のプロット コマンドが 1 つのグラフに表示されるように、プロット データと設定を保持します。線の色と線のスタイルは、追加された新しいプロットごとに詳細化されます。
hold all (deprecated)
と同等ですhold on。
hold off
各新しいプロット コマンドの前にグラフをクリアし、軸のプロパティをリセットするデフォルトのグラフィック設定を復元します (デフォルト)。
hold
現在の保留状態を切り替えます。
追加の引数haxを指定すると、 によって返される現在の軸ではなく、この軸の保持状態が変更されますgca。
現在の保留状態を照会するには、ishold関数を使用します。
: tf = ishold
: tf = ishold (hax)
: tf = ishold (hfig)
次のプロットが現在のプロットに追加される場合は true を返し、次のプロットを描画する前にプロット デバイスがクリアされる場合は false を返します。
最初の引数が軸ハンドルhaxまたは図ハンドル hfigの場合、現在のプロットではなくこのプロットに対して操作を行います。
See also: hold, newplot.
現在の図をクリアするには、clf関数を呼び出します。現在の軸をクリアするには、cla関数を呼び出します。現在の図をウィンドウ スタックの先頭に移動するには、shg関数を呼び出します。グラフィックス オブジェクトを削除するには、deleteそのインデックスを 呼び出します。図ウィンドウを閉じるには、close関数を呼び出します。
: clf
: clf reset
: clf (hfig)
: clf (hfig, "reset")
: h = clf (…)
現在の図ウィンドウをクリアします。
clf"on"可視ハンドル (HandleVisibility = ) を持つ子グラフィック オブジェクトを削除することによって動作します。
オプションの引数"reset"が指定されている場合は、非表示のハンドルを持つ子オブジェクトも含め、すべての子オブジェクトを削除し、すべての図のプロパティをデフォルトにリセットします。ただし、Position、Units、PaperPosition、PaperUnits のプロパティはリセットされません。
最初の引数hfigが図形ハンドルの場合、 によって返される現在の図形ではなく、この図形に対して操作を行いますgcf。
オプションの戻り値hは、クリアされた図ウィンドウのグラフィックス ハンドルです。
See also: cla, close, delete, reset.
: cla
: cla reset
: cla (hax)
: cla (hax, "reset")
現在のまたは指定された ( hax ) 軸オブジェクトをクリアします。
claHandleVisibilityは、可視ハンドル ( = )を持つ子グラフィック オブジェクトを削除することによって動作します"on"。これにより、通常、視覚オブジェクトの軸がクリアされますが、軸の制限、目盛りとラベル、カメラ ビューなどはそのまま残ります。さらに、軸のプロパティColorOrderIndex、 LinestyleOrderIndexを 1 に変更すると、線の自動色付けとスタイル設定がリセットされます。
オプションの引数"reset"が指定されている場合は、非表示のハンドルを持つものも含め、すべての子オブジェクトを削除し、すべての軸プロパティをデフォルトにリセットします。ただし、次のプロパティはリセットされません: Position、Units。
最初の引数hax が軸ハンドルである場合、gcaによって返される現在の軸ではなく、この軸に対して操作を行います。
See also: clf, delete, reset.
: shg
グラフウィンドウを表示します。
この関数は現在の図を表示し、他のすべてのプロット ウィンドウの上に配置します。
プログラミングノート:現在の図が存在すると仮定すること shgと同じです。figure (gcf)
See also: figure, drawnow, gcf.
: delete file
: delete file1 file2 …
: delete (file)
: delete (file1, file2, …)
: delete (handle)
指定されたファイルまたはグラフィック ハンドルを削除します。
ファイルには、次のようなグロブパターンが含まれている場合があります。*'. 同じ関数呼び出しで、削除するファイルを複数指定できます。
ハンドルは、削除するグラフィック ハンドルのスカラーまたはベクトルです。
プログラミング ノート: グラフィックス オブジェクトを削除することは、図全体をクリアせずにプロットから機能を削除する適切な方法です。
See also: clf, cla, unlink, rmdir.
: close
: close (h)
: close figname
: close all
: close all hidden
: close all force
: status = close (…)
図ウィンドウを閉じます。
引数なしで呼び出されると、現在の図を閉じます。これは と同等ですclose (gcf)。入力hがグラフィック ハンドル、またはグラフィック ハンドルのベクトルの場合、h内の各図を閉じます。閉じる図は、すべての図のプロパティと照合される名前figname"Name"で指定することもできます。
引数"all"が指定されると、可視ハンドル (HandleVisibility = "on") を持つすべての図形が閉じられます。
追加の引数"hidden"が指定された場合、非表示の図形も含め、すべての図形が閉じられます。
追加の引数が指定されている場合は、ウィンドウが閉じないように変更されている "force"場合でも図は閉じられます。"closerequestfcn"
オプションの出力ステータスが要求された場合、図ウィンドウが正常に閉じられた場合は Octave は 1 を返します。
実装に関する注意:は、現在の図のcloseハンドルh"closerequestfcn"を作成し、図のプロパティ で指定された関数を呼び出すこと によって動作します。デフォルトでは、関数closereqが使用されます。呼び出された関数によって、図の削除が遅延または中止される可能性があります。コールバック関数を実行せずに図を削除するには、 を使用しますdelete。ウィンドウを閉じるコールバック関数を記述する場合は、再帰を避けるためにcloseを使用しないでください。
See also: closereq, delete.
: closereq ()
現在の図を閉じて、それに関連付けられているすべてのグラフィック オブジェクトを削除します。
デフォルトでは、"closerequestfcn"新しいプロット図のプロパティはこの関数を指します。
See also: close, delete.