このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
hgtransform
変換オブジェクトの作成
構文
h = hgtransform
h = hgtransform('PropertyName
',propertyvalue,...)
h = hgtransform(ax,...)
プロパティ
プロパティの一覧については、Transform のプロパティ を参照してください。
説明
h = hgtransform
は Transform
オブジェクトを作成し、そのハンドルを返します。
h = hgtransform('
は、引数リストに指定されたプロパティ値設定を使用して PropertyName
',propertyvalue,...)Transform
オブジェクトを作成します。プロパティの詳細については、Transform のプロパティ を参照してください。
h = hgtransform(ax,...)
は、現在の座標軸 (gca
) ではなく ax
で指定された座標軸に Transform
オブジェクトを作成します。オプションの ax
は、前述の構文のすべての入力引数の組み合わせより前に指定できます。
Transform
オブジェクトは他のオブジェクトを含むことができるため、可視性、サイズ、方向などに関して、Transform
オブジェクトおよびその子オブジェクトを 1 つのエンティティとして扱うことができます。複数のオブジェクトをグループ化するには、1 つの Transform
オブジェクトをそれらの親にします (つまり、オブジェクトの Parent
プロパティを変換オブジェクトのハンドルに設定する)。
h = hgtransform; surface('Parent',h,...)
Transform
オブジェクトを複数のオブジェクトの親にする主な利点は、複数の子オブジェクトに対して "変換" (並進、スケーリング、回転など) を一度に実行できることです。
Transform
オブジェクトの親は、Axes
オブジェクトまたは他の Transform
オブジェクトのいずれかです。
Transform
オブジェクトが非表示になりますが、Visible
プロパティを off
に設定すると、そのすべての子オブジェクトも非表示になります。
例外と制限
Transform
オブジェクトは、同じ座標軸に属する任意の数の axes 子オブジェクトの親になることができますが、light オブジェクトは例外です。Transform
オブジェクトは axes オブジェクトの親にはなれないため、1 つの座標軸にあるオブジェクトのみを含むことができます。Transform
オブジェクトは、同じ座標軸内の他の変換オブジェクトの親になることができます。イメージは真の 3 次元オブジェクトでないため、
Image
オブジェクトは変換できません。イメージ データを表面のCData
にテクスチャ マッピングすると 3 次元空間でのイメージ変換の効果を実現できます。text オブジェクトがデータ単位を使用しない限り、変換は text オブジェクトに影響しません。
Text
オブジェクトの位置がデータ単位で指定されている場合、変換によりテキストの左下隅が移動します。変換は、フォント サイズや方向には影響しません。フォント サイズや方向を変更するには、テキスト プロパティを使用します。
メモ
多くのプロット関数はグラフを描画する前に座標軸をクリア (座標軸の子を削除) します。座標軸を消去すると、その座標軸内の Transform
オブジェクトもすべて削除されます。
例
バージョン履歴
R2006a より前に導入