Camera QML Type

シーンをレンダリングするための視点を定義します。詳細...

この型は非推奨です。新しいコードでの使用は強く推奨しません。

• 継承されたメンバーを含む、すべてのメンバーの一覧
• 非推奨のメンバ

プロパティ

• aspectRatio : real
• bottom : real
• exposure : real
• farPlane : real
• fieldOfView : real
• left : real
• lens : CameraLens
• nearPlane : real
• position : vector3d
• projectionMatrix : matrix4x4
• projectionType : enumeration
• right : real
• top : real
• transform : Transform
• upVector : vector3d
• viewCenter : vector3d
• viewVector : vector3d

方法

• void pan(real angle)
• void pan(real angle, vector3d axis)
• void panAboutViewCenter(real angle)
• void panAboutViewCenter(real angle, vector3d axis)
• quaternion panRotation(real angle)
• void roll(real angle)
• void rollAboutViewCenter(real angle)
• quaternion rollRotation(real angle)
• void rotate(quaternion q)
• void rotateAboutViewCenter(quaternion q)
• quaternion rotation(real angle, vector3d axis)
• void tilt(real angle)
• void tiltAboutViewCenter(real angle)
• quaternion tiltRotation(real angle)
• void translate(vector3d vLocal, enumeration option)
• void translateWorld(vector3d vWorld, enumeration option)
• void viewAll()
• void viewEntity(Entity entity)
• void viewSphere(vector3d center, real radius)

詳細説明

物件資料

aspectRatio : real

カメラの現在のアスペクト比を保持します。

bottom : real

カメラの現在の底面を保持します。

このプロパティは、projectionType がCameraLens.OrthographicProjectionの場合にのみ関連します。

exposure : real

カメラの現在の露出値を保持します。

デフォルト値は 0.0 です。

Qt 3D Extrasに含まれる MetalRoughMaterial は、現時点でカメラの露出を利用する唯一のマテリアルです。負の値を設定するとマテリアルは暗くなり、正の値を設定すると明るくなります。

カスタムマテリアルでは、この値の解釈を異なるものにすることも可能です。

farPlane : real

カメラの現在の遠平面を保持します。farPlaneよりもカメラから遠い位置にあるオブジェクトは、レンダリングされません。

fieldOfView : real

カメラの現在の垂直視野角（度単位）を保持します。

aspectRatio と合わせて、このプロパティはカメラから見えるシーンの範囲を決定します。その点では、シーンのどの範囲を撮影したいかによって、広角レンズ（水平方向の視野角が広い）や望遠レンズ（水平方向の視野角が狭い）を選ぶのと同じようなものだと考えてください。

fieldOfView は、projectionType が CameraLens.PerspectiveProjection の場合にのみ関連します。

left : real

カメラの現在の左座標を保持します。

このプロパティは、projectionType がCameraLens.OrthographicProjectionの場合にのみ関連します。

lens : CameraLens [read-only]

カメラの CameraLens コンポーネントを保持します。

nearPlane : real

現在のカメラをカメラの近接平面付近に保持します。nearPlaneよりもカメラに近いオブジェクトはレンダリングされません。

position : vector3d

カメラの現在の位置を、親エンティティを基準とした座標で保持します。

projectionMatrix : matrix4x4

カメラの現在の投影行列を保持します。

projectionType : enumeration

カメラの投影方式を保持します。デフォルト値は CameraLens.PerspectiveProjection です。

• CameraLens.OrthographicProjection - 平行線は平行のまま表示されます。オブジェクトは距離に関係なく同じ大きさに表示されます。
• CameraLens.PerspectiveProjection - 平行な線は遠くで交わるように見えます。オブジェクトは、カメラから離れるほど小さく見えます。
• CameraLens.FrustumProjection
• CameraLens.CustomProjection

Qt3DRender::QCameraLens::ProjectionTypeも参照してください 。

right : real

カメラの現在の右座標を保持します。

このプロパティは、projectionType がCameraLens.OrthographicProjectionである場合にのみ関連します。

top : real

カメラの現在の視点を保持します。

このプロパティは、projectionType がCameraLens.OrthographicProjectionの場合にのみ関連します。

transform : Transform [read-only]

カメラの「Transform」コンポーネントを保持します。

upVector : vector3d

カメラの現在のアップベクトルを、親エンティティを基準とした座標系で保持します。

upベクトルは、カメラの「上」がどの方向を向いているかを示します。写真を撮る場面を想像してみてください。位置を決めてカメラを被写体に向けた後、カメラを左や右に回転させて、縦向きや横向き（あるいは斜め！）のショットを撮ることもあるでしょう。upVectorを使用すると、この種の動きを制御することができます。

viewCenter : vector3d

カメラの現在の視点中心を、親エンティティを基準とした座標で保持します。

直感的には、viewCenter はカメラが向いている位置となります。

viewVector : vector3d [read-only]

親エンティティを基準とした座標系で、カメラの視線ベクトルを保持します。

このベクトルは、カメラ (position) からそのターゲット (viewCenter) までの変位を表します。

メソッドのドキュメント

void pan(real angle)

カメラのパン角度をangle 度分調整します。

void pan(real angle, vector3d axis)

axis において、ビューの中心を基準に、カメラのパンをangle 度分調整します。

void panAboutViewCenter(real angle)

ビューの中心を基準に、カメラのパン角度をangle 度分調整します。

void panAboutViewCenter(real angle, vector3d axis)

axis において、ビューの中心を基準に、カメラのパンをangle 度分調整します。

quaternion panRotation(real angle)

angle に対する計算されたパン回転を度単位で返します。これは、カメラのパン（Y軸周りの左右回転）を調整するために使用されます。

void roll(real angle)

カメラのロール角度をangle 度分調整します。

void rollAboutViewCenter(real angle)

カメラのロール角度を、ビューの中心を基準にangle 度分調整します。

quaternion rollRotation(real angle)

angle に対する計算されたロール回転量を度単位で返します。これは、Z軸上のカメラのロール（左右への傾き）を調整するために用いられます。

void rotate(quaternion q)

q でクォータニオンを使用してカメラを回転させます。

void rotateAboutViewCenter(quaternion q)

q 内のクォータニオンを使用して、ビューの中心を軸としてカメラを回転させます。

quaternion rotation(real angle, vector3d axis)

angle に対する計算された回転角度を、度単位で、指定されたaxis の向きに基づいて返します。

void tilt(real angle)

カメラの傾き角度をangle 度分調整します。

void tiltAboutViewCenter(real angle)

ビューの中心を基準に、カメラのチルトをangle 度分調整します。

quaternion tiltRotation(real angle)

angle に対する計算されたチルト回転角を度単位で返します。これは、カメラのチルト（X軸方向の上下回転）を調整するために使用されます。

void translate(vector3d vLocal, enumeration option)

カメラの位置とそのビューベクトルを、ローカル座標系でvLocal だけ平行移動させます。option を使用すると、ビューの中心を平行移動させるかどうかを切り替えることができます。

• Camera.TranslateViewCenter
• Camera.DontTranslateViewCenter

「Qt3DRender::QCamera::CameraTranslationOption」も参照してください 。

void translateWorld(vector3d vWorld, enumeration option)

カメラの位置とそのビューベクトルを、ワールド座標系でvWorld だけ平行移動させます。option を使用すると、ビューの中心を平行移動させるかどうかを切り替えることができます。

• Camera.TranslateViewCenter
• Camera.DontTranslateViewCenter

「Qt3DRender::QCamera::CameraTranslationOption」も参照してください 。

void viewAll()

カメラを回転・移動させ、そのviewCenter がシーンのバウンディングボリュームの中心となり、シーン全体がビューポートに収まるようにします。

「Qt3D.Render::Camera::projectionType」も参照してください 。

void viewEntity(Entity entity)

カメラを回転・移動させ、その「viewCenter 」がエンティティのバウンディングボリュームの中心となり、entity 全体がビューポートに収まるようにします。

「Qt3D.Render::Camera::projectionType」も参照してください 。

void viewSphere(vector3d center, real radius)

カメラを回転・移動させ、そのviewCenter がcenter となり、radius の球体がビューポートに収まるようにします。

Qt3D.Render::Camera::projectionTypeも参照してください 。