注釈

この章は機能を説明している参考文献に過ぎません．mlabの紹介と mlab の機能との対話して組み立て方法については mlab: 3Dプロット用のPythonスクリプト の章を参照してください．

サンプルの実行方法については， mlabスクリプトの実行 のセクションを参照してください．

カメラ処理関数

move

mayavi.mlab.move(forward=None, right=None, up=None)

カメラと焦点を平行移動します．

引数は，有効な視野を変更せずにカメラを移動する外観を生成するために，カメラと焦点を移動する相対距離を指定します．引数を指定しないで呼び出すと，デカルト座標系におけるカメラと焦点の絶対位置が返されます．

引数のない戻り値は絶対座標系ですが，引数は相対モーションを指定することに注意してください．

キーワード引数:

Forward:

float ，オプション．カメラを前方(正の場合)または後方(負の場合)に移動する空間距離．

Right:

float，オプション．カメラを右(正の場合)または左(負の場合)に移動する空間距離．

Up:

float，オプション．カメラを上(正の場合)または下(負の場合)に移動する空間距離．

戻り値

引数が指定されていない場合(またはすべてなし)，タプル(camera_position, focal_point_position)が戻されます

それ以外の場合は，Noneが戻されます

例

現在のカメラ位置を取得します．

>>> cam,foc = move()
>>> cam
array([-0.06317079, -0.52849738, -1.68316389])
>>> foc
array([ 1.25909623,  0.15692708, -0.37576693])

カメラを移動します．

>>> move(3,-1,-1.2)
>>> move()
(array([ 2.93682921, -1.52849738, -2.88316389]),
 array([ 4.25909623, -0.84307292, -1.57576693]))

開始位置に戻ります．

>>> move(-3,1,1.2)
>>> move()
(array([-0.06317079, -0.52849738, -1.68316389]),
 array([ 1.25909623,  0.15692708, -0.37576693]))

関連項目

Mlab.yaw:

カメラをヨーで動します(左右に傾けます)

Mlab.pitch:

カメラを傾ける(上下の傾き)

Mlab.roll:

カメラの絶対回転角度を制御するには

Mlab.view:

絶対空間ではなく焦点に対してカメラ位置を設定します

pitch

mayavi.mlab.pitch(degrees)

現在のビューの "右" 方向に対応する軸を中心にカメラを回転します．これにより，(カメラの位置ではなく)焦点の位置が変更されることに注意してください．

この角度は現在の方向を基準にしています．角度は固定座標系における絶対角度ではありません．

関連項目

Mlab.yaw:

"上"方向を中心とした相対回転

Mlab.roll:

絶対ロール角度(すなわち "up" 方向)

Mlab.move:

カメラと焦点の相対的な移動

roll

mayavi.mlab.roll(roll=None, figure=None)

カメラの回転絶対角度を設定または取得します．

関連項目

Mlab.view:

カメラの位置と方向をコントロールします

view

mayavi.mlab.view(azimuth=None, elevation=None, distance=None, focalpoint=None, roll=None, reset_roll=True, figure=None)

カメラの視点を設定/取得します．

view(azimuth=None, elevation=None, distance=None, focalpoint=None,
     roll=None, reset_roll=True, figure=None)

引数なしで呼び出すと，カメラの現在のビューを返します．この機能がどのように動作するかを理解するには，可視化中心とした球のサーフェスを想像してください． azimuth 引数は，x-y平面上の角度 "phi" を指定します．この角度は0-360度の範囲で変化します． elevation 引数には，z軸からの角度 "theta" を指定し，0-180度の範囲で指定します． distance 引数は，球体の半径と球体の中心である focalpoint です．

elevation が0または180に近い場合， azimuth は，x軸に対する標準x-yプロットの回転量を指すことに留意してください．したがって， view(0,0) を指定すると，xが左から右に，yが下から上に変化する典型的なx-yプロットが得られます．

キーワード引数:

azimuth:

float，オプション．方位角(0-360度)，つまり，x軸を持つx-y平面に投影された球上の位置ベクトルが示す角度です．

elevation:

float， オプション．天頂角(0-180度)，つまり，位置ベクトルとz軸によって決定される角度．

distance:

floatまたは 'auto' オプションです．カメラを配置する焦点からの距離を表す正の浮動小数点数．Mayavi 3.4.0の新機能: 'auto' が渡されると，フレーム内のオブジェクトが最適に収まるように距離が計算されます．

focalpoint:

array_likeまたは 'auto' ，オプション．カメラの焦点を表す3つの浮動小数点数の配列です．Mayavi 3.4 .0の新機能． 'auto' が渡されると，焦点はシーン内のすべてのオブジェクトの中心に配置されます．

roll:

float，オプション ロールすなわち軸を中心としたカメラの回転を制御します．

reset_roll:

boolean，オプション．Trueで， 'roll' が指定されていない場合，カメラの回転方向がリセットされます．

figure:

操作対象のMayavi図です．Noneが渡された場合は，現在のが使用されます．

戻り値

引数を指定しない場合は，現在のビューを表す4つの値 (azimuth, elevation, distance, focalpoint) の組が返されます．これらは後でビューの設定に使用できます．

引き数が与えられた場合は None を返します．

例

現在のビューを取得します

 >>> v = view()
 >>> v
(45.0, 45.0, 25.02794981, array([ 0.01118028,  0.        ,  4.00558996]))

次のように，さまざまな方法でビューを設定します．

>>> view(45, 45)
>>> view(240, 120)
>>> view(distance=20)
>>> view(focalpoint=(0,0,9))

上記の v で保存したビューに設定します．

>>> view(*v)

関連項目

Mlab.roll:

カメラのロール角度，つまり上向きの方向を制御します．

yaw

mayavi.mlab.yaw(degrees)

現在のビューの "up" 方向に対応する軸を中心にカメラを回転します．これにより，焦点(カメラの位置ではありませんが)の位置が変更されることに注意してください．

この角度は現在の方向を基準にしています．角度は固定座標系における絶対角度ではありません．

関連項目

Mlab.pitch:

"right" 方向を中心とした相対回転

Mlab.roll:

絶対ロール角度(すなわち "up" 方向)

Mlab.move:

カメラと焦点の相対的な移動