Тип QML камеры

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

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

Свойства

• aspectRatio : real
• bottom : real
• exposure : real
• farPlane : real
• fieldOfView : real
• left : real
• nearPlane : real
• position : vector3d
• projectionMatrix : matrix4x4
• projectionType : перечисление
• 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 : перечисление

Содержит тип проекции камеры. Значение по умолчанию — 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

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

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

[только для чтения] 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.