ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

newplot

グラフィックス オブジェクトの描画位置の決定

構文

newplot
h = newplot
h = newplot(hsave)

説明

関数 newplot は、次に入力するグラフィックス コマンドの Figure や Axes オブジェクトを用意します。

h = newplot は、次に入力するグラフィックス コマンドの Figure や Axes オブジェクトを用意し、現在の Axes のハンドル番号を返します。

h = newplot(hsave) は Axes を用意して返しますが、ハンドルのベクトルにすることが可能な hsave 引数に割り当て済みのハンドルのオブジェクトは削除しません。hsave が空でない場合、現在の Figure の現在の Axes の代わりに、hsave を含む Figure と Axes が、プロットのために準備されます。hsave が空の場合、関数 newplot は、入力なしで呼び出されたように動作します。

詳細

すべて折りたたむ

ヒント

単純な 2 次元プロットを作成するには、代わりに関数 plot を使用します。

高水準のグラフィックスのコードの先頭に関数 newplot を使用することで、グラフィックスの出力のターゲットとなる Figure や Axes が決められます。関数 newplot を実行することで、現在の Figure と現在の Axes を変更できます。基本的には、既存の Figure や Axes 内にグラフィックスを描画するには、3 種類のオプションがあります。

  • プロパティを変更したり、オブジェクトを消去せずに、新規のグラフィックスを追加

  • 新規のオブジェクトを描画する前に、ハンドルが隠されていない既存のすべてのオブジェクトを消去

  • ハンドルが隠されているかどうかにかかわらず、すべての既存のオブジェクトを消去し、新規のオブジェクトを描画する前に、ほとんどのプロパティを既定の設定にリセット (詳細は、次の表を参照)

Figure と座標軸の NextPlot プロパティが、newplot の動作を決定します。次の 2 つの表に、プロパティ値と共にそれらの動作を説明します。

最初に、newplot は現在の Figure の NextPlot プロパティを読み取り、それに従って動作します。

NextPlot

動作

new

新規 Figure を作成し、現在の Figure として利用します。

add

既存のグラフィックス オブジェクトを消去せずに、現在の Figure に描画します。

replacechildren

HandleVisibility プロパティが on に設定されているすべての子オブジェクトを削除し、Figure の NextPlot プロパティを add にリセットします。

コマンド clf の実行と同じように、現在の Figure オブジェクトを消去します。

replace

すべての子オブジェクトを (HandleVisibility プロパティの設定にかかわらず) 削除し、次の例外を除いて、Figure のプロパティを既定の設定にリセットします。

関数 NextPlot は、ユーザー定義の既定の設定にかかわらず、add にリセットされます。

これは、現在の Figure を消去してリセットし、コマンド clf reset を実行することと等価です。

newplot は、どの Figure に描画するかを決めてから、現在の Axes の NextPlot プロパティを読み込み、次のように実行します。

NextPlot

説明

add

既存のすべてのグラフィックス オブジェクトを保持しながら、現在の Axes に描画します。

replacechildren

HandleVisibility プロパティが on に設定されているすべての子オブジェクトを削除しますが、Axes のプロパティはリセットしません。これは、cla コマンドのように現在の Axes を消去します。

replace

すべての子オブジェクトを (HandleVisibility プロパティの設定にかかわらず) 削除し、PositionUnits 以外の座標軸のプロパティを既定の設定にリセットします。

これは、cla reset コマンドのように現在の Axes を消去し、リセットします。

参考

| | | | | | |

R2006a より前に導入

この情報は役に立ちましたか?