Тип QML Camera

Определяет точку обзора, через которую будет рендериться сцена. Подробнее...

• Список всех членов, включая наследуемые
• Устаревшие члены

Свойства

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

Методы

• void pan(real angle, vector3d axis)
• void pan(real angle)
• void panAboutViewCenter(real angle, vector3d axis)
• void panAboutViewCenter(real angle)
• 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.

MetalRoughMaterial в Qt 3D Extras в настоящее время является единственным доступным материалом, использующим экспозицию камеры. Отрицательные значения сделают материал темнее, а положительные — светлее.

Пользовательские материалы могут интерпретировать это значение по-разному.

farPlane : real

Содержит текущую дальнюю плоскость камеры. Объекты, которые находятся дальше от камеры, чем farPlane, не будут отображаться.

fieldOfView : real

Содержит текущий вертикальный угол обзора камеры в градусах.

Вместе со свойством aspectRatio это свойство определяет, какая часть сцены видна для камеры. В этом отношении можно представить его аналогичным выбору широкоугольного (широкого горизонтального угла обзора) или телеобъектива (узкого горизонтального угла обзора) объектива, в зависимости от того, какую часть сцены вы хотите запечатлеть.

fieldOfView актуально только когда projectionType равно CameraLens.PerspectiveProjection.

left : real

Содержит текущую левую границу камеры.

Это свойство актуально только когда projectionType равно CameraLens.OrthographicProjection.

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.

upVector : vector3d

Содержит текущий вектор «вверх» камеры в координатах, относительных к родительскому элементу.

Вектор «вверх» указывает, куда направлен верх камеры. Представьте, что вы делаете фотографию: установив камеру и нацелив её на объект, вы можете повернуть её влево или вправо, что даст портретное или ландшафтное (или наклонное!) изображение. Свойство upVector позволяет управлять этим видом перемещения.

viewCenter : vector3d

Содержит текущий центр обзора камеры в координатах, относительных к родительскому элементу.

Интуитивно центр обзора — это место, на которое направлена камера.

[только для чтения] viewVector : vector3d

Содержит вектор обзора камеры в координатах, относительных к родительскому элементу.

Этот вектор описывает смещение от камеры (position) к её цели (viewCenter).

Документация методов

void pan(real angle, vector3d axis)

Изменяет панорамирование камеры вокруг центра обзора на angle градусов вдоль axis.

void pan(real angle)

Изменяет угол панорамирования камеры на angle градусов.

void panAboutViewCenter(real angle, vector3d axis)

Изменяет панорамирование камеры вокруг центра обзора на angle градусов вдоль axis.

void panAboutViewCenter(real angle)

Изменяет панорамирование камеры вокруг центра обзора на 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.