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.フルスタムプロジェクション
- CameraLensカスタムプロジェクション
Qt3DRender::QCameraLens::ProjectionTypeも参照してください 。
right : real
カメラの現在の右を保持する。
このプロパティは、projectionType がCameraLens.OrthographicProjection の場合のみ関係します。
top : real
カメラの現在の上端を保持する。
このプロパティは、projectionType がCameraLens.OrthographicProjection の場合のみ関係します。
transform : Transform [read-only]
カメラのTransformコンポーネントを保持する。
upVector : vector3d
親エンティティからの相対座標で、カメラの現在のアップベクトルを保持します。
アップベクトルは、カメラの上部がどの方向を向いているかを示します。写真を撮ることを想像してみてください。自分の位置を決め、カメラをターゲットに向けた後、カメラを左右に回転させ、ポートレートまたはランドスケープ（またはアングル！）のショットを撮るかもしれません。
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)
カメラのパンまたは Y 軸の左右回転を調整するために、angle に対して計算されたパン回転を度単位で返します。
void roll(real angle)
カメラロールをangle 度単位で調整します。
void rollAboutViewCenter(real angle)
ビューセンターのカメラロールをangle 度単位で調整します。
quaternion rollRotation(real angle)
カメラの Z 軸のロールまたは左右の傾きを調整するために、angle に対して計算されたロール回転を度単位で返します。
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)
カメラの傾きまたは X 軸の上下回転を調整するために、angle に対して計算された傾き回転を度単位で返します。
void translate(vector3d vLocal, enumeration option)
カメラの位置とビューベクトルをローカル座標でvLocal だけ平行移動します。option では、ビューセンターを変換するかどうかを切り替えることができます。
- カメラ.TranslateViewCenter
- カメラ.DontTranslateViewCenter
Qt3DRender::QCamera::CameraTranslationOptionも参照してください 。
void translateWorld(vector3d vWorld, enumeration option)
カメラの位置とビューベクトルをワールド座標でvWorld だけ平行移動します。option では、ビューセンターを変換するかどうかを切り替えることができます。
- カメラ.TranslateViewCenter
- カメラ.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も参照してください 。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
