このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

cameratoolbar

カメラ ツール バーをプログラム内から制御

構文

cameratoolbar

cameratoolbar(state)

tf = cameratoolbar('GetVisible')

cameratoolbar(reset)

cameratoolbar('SetMode',mode)

m = cameratoolbar('GetMode')

cameratoolbar('SetCoordSys',coordsys)

p = cameratoolbar('GetCoordSys')

cameratoolbar(parent,___)

h = cameratoolbar(___)

説明

cameratoolbar は、座標軸のカメラとライトを対話的に操作可能にするカメラ ツール バーを現在の Figure に表示します。利用可能な Figure がない場合は、MATLAB^® が関数 figure を呼び出して Figure を作成します。

ビジュアル カメラ ツール バー インターフェイスは、uifigure で作成された Figure でサポートされていません。ただし、figure で作成された Figure では、ビジュアル カメラ ツール バー インターフェイスを必要としない cameratoolbar 関数構文を使用できます。

cameratoolbar(state) は、指定された可視性オプションを備えたカメラ ツール バーを表示します。

tf = cameratoolbar('GetVisible') は、現在の Figure にカメラ ツール バーの可視性を返します (表示の場合は 1、非表示の場合は 0)。

cameratoolbar(reset) は、現在のカメラ、シーンライト、またはターゲットを操作開始前の状態にリセットします。

cameratoolbar('SetMode',mode) は、カメラ モーション コントロール モードを設定します。各モードの説明については、カメラ ツール バーを参照してください。

m = cameratoolbar('GetMode') は、現在のカメラ モーション コントロール モードを返します。各モードの説明については、カメラ ツール バーを参照してください。

cameratoolbar('SetCoordSys',coordsys) は、カメラ モーションの主軸を設定します。各座標軸の説明については、カメラ ツール バーを参照してください。

p = cameratoolbar('GetCoordSys') は、カメラ モーションの現在の主軸を返します。各座標軸の説明については、カメラ ツール バーを参照してください。

cameratoolbar(parent,___) は、指定された親 Figure にカメラ ツール バーを表示します。

h = cameratoolbar(___) は、Toolbar オブジェクトを返します。

例

Figure に新しいカメラ ツール バーを作成

Figure を作成し、カメラ ツール バーを Figure に追加します。なお、Figure ウィンドウの [表示] メニューから [カメラ ツール バー] を選択してカメラ ツール バーを表示することもできます。カメラ ツール バーは、Figure の既定のツール バーの下に表示されます。

f = figure;
tb = cameratoolbar(f);

'SetMode' を使用してカメラ ツール バー モードをズームに設定します。

cameratoolbar('SetMode','zoom')

入力引数

state — ツール バーの可視性状態

'show' | 'hide' | 'toggle' | 'close'

ツール バーの可視性状態。次の値のいずれかとして指定します。

• 'show' — カメラ ツール バーを表示します。

• 'hide' — カメラ ツール バーを非表示にします。

• 'toggle' — 'show' 状態と 'hide' 状態の間でカメラ ツール バーの可視性を切り替えます。

• 'close' — カメラ ツール バーを Figure から削除します。

state 入力引数は、関数 figure を使用して作成された Figure でのみ有効です。

reset — リセット オプション

'ResetCameraAndSceneLight' | 'ResetCamera' | 'ResetSceneLight' | 'ResetTarget' | 'NoReset'

既定の状態に戻すリセット オプション。次の値のいずれかとして指定します。

• 'ResetCameraAndSceneLight' — 現在のカメラとシーンライトをリセットします。

• 'ResetCamera' — 現在のカメラをリセットします。

• 'ResetSceneLight' — 現在のシーンライトをリセットします。

• 'ResetTarget' — 現在のターゲットをリセットします。

• 'NoReset' — いずれのカメラ コントロールの状態も設定しません。このオプションは、関数 figure を使用して作成された Figure でのみ有効です。

'ResetCameraAndSceneLight'、'ResetCamera'、'ResetSceneLight'、および 'ResetTarget' オプションは、関数 uifigure または関数 figure を使用して作成された Figure で有効です。関数 figure を使用して作成された Figure の場合は、ツール バーで対応するボタンをクリックしてカメラおよびシーンライトをリセットすることもできます。

mode — カメラ モーション コントロール モード

'orbit' | 'orbitscenelight' | 'pan' | 'dollyhv' | 'dollyfb' | 'zoom' | 'roll' | 'nomode'

カメラ モーション コントロール モード。次の値のいずれかとして指定します。

• 'orbit' — カメラを旋回移動します。

• 'orbitscenelight' — シーンライトを旋回移動します。

• 'pan' — カメラを移動 (パン)/傾斜します。

• 'dollyhv' — カメラを水平/垂直方向に移動します。

• 'dollyfb' — カメラを前方/後方に移動します。

• 'zoom' — カメラをズームします。

• 'roll' — カメラを回転します。

• 'nomode' — カメラ モードなし。

各モードの説明については、カメラ ツール バーを参照してください。

関数 figure を使用して作成された Figure の場合は、ツール バーで対応するボタンをクリックしてカメラ モードを設定することもできます。

coordsys — カメラ モーションの主軸

'x' | 'y' | 'z' | 'none'

カメラ モーションの主軸。次の値のいずれかとして指定します。

• 'x' — 主軸 X。

• 'y' — 主軸 Y。

• 'z' — 主軸 Z。

• 'none' — 主軸なし。

各座標軸の説明については、カメラ ツール バーを参照してください。

関数 figure を使用して作成された Figure の場合は、ツール バーで対応するボタンをクリックして主軸を設定することもできます。

parent — 親 Figure

Figure オブジェクト

親 Figure。Figure オブジェクトとして指定します。

出力引数

tf — カメラ ツール バーの可視性

1 | 0

カメラ ツール バーの可視性。logical 値として返されます。カメラ ツール バーが表示されている場合、tf は logical 1 (true) です。それ以外の場合、tf は logical 0 (false) です。

m — カメラ モーション コントロール モード

文字配列

カメラ モーション コントロール モード。文字配列として返されます。各モードの説明については、カメラ ツール バーを参照してください。

p — カメラ モーションの主軸

文字配列

カメラ モーションの主軸。文字配列として返されます。各座標軸の説明については、カメラ ツール バーを参照してください。

h — カメラ ツール バー

Toolbar オブジェクト

カメラ ツール バー。Toolbar オブジェクトとして指定します。

バージョン履歴

R2006a より前に導入

R2022a: 関数 uifigure を使用して作成された Figure の構文サポート

ビジュアル カメラ ツール バー インターフェイスを直接オンにしない構文が、関数 uifigure を使用して作成された Figure でサポートされるようになりました。

参考

rotate3d | zoom

トピック

• カメラ ツール バーを使用した視点のコントロール