figure

Figure ウィンドウの作成

構文

figure

figure(Name,Value)

f = figure(___)

figure(f)

figure(n)

説明

figure は、既定のプロパティ値を使用して、新しい Figure ウィンドウを作成します。結果の Figure は、現在の Figure になります。

figure(Name,Value) は 1 つ以上の名前と値のペアの引数を使用して、Figure のプロパティを変更します。たとえば、figure('Color','white') は背景色を白に設定します。

f = figure(___) は、Figure オブジェクトを返します。f は、Figure を作成した後でそのプロパティのクエリや変更に使用します。

figure(f) は、f で指定された Figure を現在の Figure にして、他のすべての Figure の前面に表示します。

figure(n) は、Number プロパティが n と等しい Figure を検出して、現在の Figure にします。そのプロパティ値をもつ Figure が存在しない場合、MATLAB^® は新しい Figure を作成し、その Number プロパティを n に設定します。

例

Figure のサイズの変更

既定の Figure を作成します。

f = figure;

Figure の位置、幅および高さを取得します。

f.Position

ans =

   680   558   560   420

これは、Figure ウィンドウがプライマリ ディスプレイの右に 680 ピクセル、左下隅から 558 ピクセルの位置に配置され、幅が 560 ピクセルで高さが 420 ピクセルであることを意味します。

位置ベクトルの第 3 と第 4 の要素を調整して、Figure の幅と高さを半分にします。

f.Position(3:4) = [280 210];

Figure のタイトルの指定

Figure を作成して、Name プロパティを指定します。既定では、生成されるタイトルには、Figure の番号が含まれます。

figure('Name','Measured Data');

Name プロパティを再び指定します。ただし、今回は NumberTitle プロパティを 'off' に設定します。生成されるタイトルに Figure の番号は含まれません。

figure('Name','Measured Data','NumberTitle','off');

複数の Figure の同時操作

2 つの Figure を作成してから、ライン プロットを作成します。plot コマンドの既定のターゲットは現在の Figure です。

f1 = figure;
f2 = figure;
plot([1 2 3],[2 4 6]);

現在の Figure を f1 に設定して、次のプロットのターゲットにします。その後、散布図を作成します。

figure(f1);
scatter((1:20),rand(1,20));

入力引数

f — ターゲット Figure

Figure オブジェクト

ターゲット Figure。Figure オブジェクトとして指定します。

n — ターゲット Figure の番号

スカラー整数値

ターゲット Figure の番号。スカラー整数値として指定します。この引数を指定した場合、MATLAB は Number プロパティが n と等しい既存の Figure を検索します。そのプロパティ値をもつ Figure が存在しない場合、MATLAB は新しい Figure を作成し、その Number プロパティを n に設定します。既定で Number プロパティ値は、Figure のタイトルに表示されます。

データ型: double

名前と値の引数

引数のオプションのペアを Name1=Value1,...,NameN=ValueN として指定します。ここで Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後になければなりませんが、ペアの順序は重要ではありません。

例: figure(Color="white") は、白の背景色をもつ Figure を作成します。

R2021a より前では、コンマを使用してそれぞれの名前と値を区切り、Name を引用符で囲みます。

例: figure("Color","white") は、白の背景色をもつ Figure を作成します。

メモ

ここでは、プロパティの一部だけを紹介しています。完全な一覧については、Figure のプロパティ を参照してください。

Name — 名前

'' (既定値) | 文字ベクトル | string スカラー

Figure の名前。文字ベクトルまたは string スカラーとして指定します。

例: figure('Name','Results') は、Figure の名前を 'Results' に設定します。

既定の名前は 'Figure n' です。ここで、n は整数です。Name プロパティを指定した場合、Figure のタイトルは 'Figure n: name' になります。Name の値のみを表示する場合は、IntegerHandle または NumberTitle を 'off' に設定します。

Color — 背景色

RGB 3 成分 | 16 進数カラー コード | 'r' | 'g' | 'b' | ...

背景色。RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。'none' を指定した場合、背景色は画面上では黒く表示されますが、Figure を印刷するとその背景は Figure ウィンドウが透明であるかのように印刷されます。

カスタム色を使用する場合は、RGB 3 成分または 16 進数カラー コードを指定します。

• RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。

• 16 進数カラー コードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く string スカラーまたは文字ベクトルです。この値は大文字と小文字を区別しません。したがって、カラー コード "#FF8800"、"#ff8800"、"#F80"、および "#f80" は等価です。

あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。

色名	省略名	RGB 3 成分	16 進数カラー コード	外観
"red"	"r"	[1 0 0]	"#FF0000"
"green"	"g"	[0 1 0]	"#00FF00"
"blue"	"b"	[0 0 1]	"#0000FF"
"cyan"	"c"	[0 1 1]	"#00FFFF"
"magenta"	"m"	[1 0 1]	"#FF00FF"
"yellow"	"y"	[1 1 0]	"#FFFF00"
"black"	"k"	[0 0 0]	"#000000"
"white"	"w"	[1 1 1]	"#FFFFFF"
"none"	該当なし	該当なし	該当なし	色なし

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分	16 進数カラー コード	外観
[0 0.4470 0.7410]	"#0072BD"
[0.8500 0.3250 0.0980]	"#D95319"
[0.9290 0.6940 0.1250]	"#EDB120"
[0.4940 0.1840 0.5560]	"#7E2F8E"
[0.4660 0.6740 0.1880]	"#77AC30"
[0.3010 0.7450 0.9330]	"#4DBEEE"
[0.6350 0.0780 0.1840]	"#A2142F"

データ型: double | char

Position — 描画可能領域の位置とサイズ

[left bottom width height]

描画可能領域の位置とサイズ。[left bottom width height] の形式のベクトルとして指定します。この領域には、Figure の境界線、タイトル バー、メニュー バーおよびツール バーは含まれません。

次の表で、Position ベクトルの各要素について説明します。

要素	説明
left	プライマリ ディスプレイの左端から、ウィンドウ内側の左端までの距離。この値は、複数のモニターがあるシステムでは負の値になる場合があります。 Figure がドッキングしている場合、この値は、MATLAB デスクトップ内の Figure パネルを基準にした値になります。
bottom	プライマリ ディスプレイの下端から、ウィンドウ内側の下端までの距離。この値は、複数のモニターがあるシステムでは負の値になる場合があります。 Figure がドッキングしている場合、この値は、MATLAB デスクトップ内の Figure パネルを基準にした値になります。
width	figure の内側の左右の端の間の距離。
height	ウィンドウ内側の上下の端の距離。

すべての測定値は、Units プロパティで指定した単位で表されます。

Figure がドッキングしているときには、Figure の Position プロパティは指定できません。

MATLAB Online™ では、Position ベクトルの bottom 要素および left 要素は無視されます。

境界線、タイトル バー、メニュー バーおよびツール バーを含むウィンドウ全体を配置するには、OuterPosition プロパティを使用します。

メモ

Windows^® オペレーティング システムでは、最小ウィンドウ幅と最大ウィンドウ サイズが適用されます。これらの範囲を超える Figure サイズを指定した場合、表示される Figure は指定されたサイズではなく、これらの範囲に従います。

Units — 測定の単位

'pixels' (既定値) | 'normalized' | 'inches' | 'centimeters' | 'points' | 'characters'

測定の単位。次の表のいずれかの値として指定します。

単位の値	説明
'pixels' (既定)	ピクセル。 R2015b 以降、Windows および Macintosh システムにおいて、ピクセル単位の距離はシステム解像度に依存しません。 Windows システムの 1 ピクセルは 1/96 インチです。 Macintosh システムの 1 ピクセルは 1/72 インチです。 Linux® システムでは、ピクセルのサイズは使用しているシステムの解像度によって決まります。
'normalized'	これらの単位は親コンテナーを基準として正規化されます。コンテナーの左下隅が (0,0) で、右上隅が (1,1) になります。
'inches'	インチ。
'centimeters'	センチメートル。
'points'	ポイント。1 ポイントは 1/72 インチです。
'characters'	これらの単位は、グラフィックス ルート オブジェクトの既定の uicontrol フォントを基にしています。 文字の幅 = 文字 x の幅。 文字の高さ = 2 行のテキストのベースライン間の距離。 既定の uicontrol フォントにアクセスするには、get(groot,'defaultuicontrolFontName') または set(groot,'defaultuicontrolFontName') を使用します。

MATLAB ではすべての単位を親オブジェクトの左下隅から測定します。

このプロパティは Position プロパティに影響します。Units プロパティを変更した場合、この既定値を想定する他の関数に影響を与えないように、計算の完了後に値を既定値に戻すことを検討してください。

Units プロパティと Position プロパティを指定する順序は次のように影響します。

• Position プロパティの前に Units プロパティを指定する場合、MATLAB は指定した単位を使用して Position を設定します。

• Position プロパティの後に Units プロパティを指定する場合、MATLAB は既定の Units を使用して位置を設定します。その後、MATLAB は Position の値を、指定した単位における等価の値に変換します。

詳細

現在の Figure

現在の Figure は、axes や colormap などのグラフィックス コマンドのターゲットです。通常、これは最後に作成された Figure、または最後にマウスでクリックされた Figure となります。gcf コマンドは、現在の Figure を返します。

ヒント

• グラフィックス ルート オブジェクトを使用して、他の型のオブジェクトの既定値をルート レベルで設定します。たとえば、今後のすべての Figure の既定のカラーマップを summer カラーマップに設定します。

  set(groot,'DefaultFigureColormap',summer)

  プロパティを元の MATLAB の既定値に戻すには、'remove' キーワードを使用します。

  set(groot,'DefaultFigureColormap','remove')

  既定値の設定についての詳細は、既定のプロパティ値を参照してください。

バージョン履歴

R2006a より前に導入

参考

関数

• axes | gcf | gca | clf | cla | shg

プロパティ

• Figure のプロパティ