このページでは

PerspectiveCamera QML Type

3Dシーンのコンテンツを表示するためのパースペクティブカメラを定義します。詳細...

Import Statement: import QtQuick3D
Inherits:

Camera

Inherited By:

FrustumCamera

プロパティ

詳細説明

Camera は、3DシーンのコンテンツがView3D などの2D表面にどのように投影されるかを定義します。シーンの内容を可視化するには、少なくとも1つのCamera が必要です。

Camera は、シーン内の他の空間的なNode と同様に、配置や回転を行うことができます。Node の位置と向きによって、シーン内でのCamera の位置や、その向きが決まります。Camera のデフォルトの向きでは、前方ベクトルはZ軸の負の方向を、上方向ベクトルはY軸の正の方向を指します。

透視図法によるカメラ投影図

PerspectiveCameraは、標準的なCamera タイプです。これにより、遠くにあるオブジェクトが小さく見える、リアルなシーンの投影が得られます。フラスタムは、fieldOfView プロパティおよび近クリップ面と遠クリップ面によって定義されます。

次の例では、シーン内の座標 [0, 200, 300] に、視野角 90 度、下向きピッチ 30 度の PerspectiveCamera を作成します。

PerspectiveCamera {
    position: Qt.vector3d(0, 200, 300)
    eulerRotation.x: -30
    fieldOfView: 90
}

関連項目: Qt Quick 3D - View3D Example、OrthographicCamera 、FrustumCamera 、およびCustomCamera 。

プロパティのドキュメント

clipFar : real

このプロパティは、PerspectiveCamera のフラスタムの遠方クリップ平面を定義します。Camera から遠方クリップ平面よりも遠くにあるジオメトリは、表示されません。

デフォルト値は 10000.0 です。単位はユーザーのジオメトリ単位に依存し、この値はグローバルなカメラ位置を基準としています。

clipNear : real

このプロパティは、PerspectiveCamera の視錐台における近クリップ平面を定義します。近クリップ平面よりもCamera に近い位置にあるジオメトリは、表示されません。

デフォルト値は 10.0 です。単位はユーザーのジオメトリ単位に依存し、この値はグローバルなカメラ位置を基準としています。

fieldOfView : real

このプロパティには、カメラの視野角(度単位)が格納されます。これは、fieldOfViewOrientation プロパティがPerspectiveCamera.Vertical に設定されているか、PerspectiveCamera.Horizontal に設定されているかによって、垂直方向または水平方向の視野角のいずれかになります。

デフォルト値は 60.0 です。

fieldOfViewOrientation : enumeration

このプロパティは、カメラの視野が指定される向きを保持します。

定数説明
PerspectiveCamera.Vertical指定された視野角は垂直方向のものです。つまり、視野角とは、カメラからビューポートの左上中央まで引いた線と、カメラからビューポートの右下中央まで引いた線との間の角度を指します。アスペクト比を維持するために、水平方向のアスペクト比が調整されます。
PerspectiveCamera.Horizontal指定された視野角は水平方向であり、視野角は、カメラからビューポートの左中央まで引かれた線と、カメラからビューポートの右中央まで引かれた線との間の角度となります。アスペクト比を維持するために、水平方向のアスペクト比が調整されます。

デフォルト値はPerspectiveCamera.Vertical です。

© 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.