Тип 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.