QCameraLens Class

(Qt3DRender::QCameraLens)

Qt3DRender::QCameraLens specifies the projection matrix that will be used to define a Camera for a 3D scene. More...

Header:	#include <Qt3DRender/QCameraLens>
qmake:	QT += 3drender
Since:	Qt 5.5
Instantiated By:	CameraLens
Inherits:	Qt3DCore::QComponent

• List of all members, including inherited members
• Obsolete members

Public Types

enum	ProjectionType { OrthographicProjection, PerspectiveProjection, FrustumProjection, CustomProjection }

Properties

aspectRatio : float bottom : float exposure : float farPlane : float fieldOfView : float left : float

nearPlane : float projectionMatrix : QMatrix4x4 projectionType : ProjectionType right : float top : float

• 1 property inherited from Qt3DCore::QComponent
• 3 properties inherited from Qt3DCore::QNode
• 1 property inherited from QObject

Public Functions

	QCameraLens(Qt3DCore::QNode *parent = nullptr)
float	aspectRatio() const
float	bottom() const
float	exposure() const
float	farPlane() const
float	fieldOfView() const
float	left() const
float	nearPlane() const
QMatrix4x4	projectionMatrix() const
Qt3DRender::QCameraLens::ProjectionType	projectionType() const
float	right() const
void	setFrustumProjection(float left, float right, float bottom, float top, float nearPlane, float farPlane)
void	setOrthographicProjection(float left, float right, float bottom, float top, float nearPlane, float farPlane)
void	setPerspectiveProjection(float fieldOfView, float aspectRatio, float nearPlane, float farPlane)
float	top() const
void	viewAll(Qt3DCore::QNodeId cameraId)
void	viewEntity(Qt3DCore::QNodeId entityId, Qt3DCore::QNodeId cameraId)

• 2 public functions inherited from Qt3DCore::QComponent
• 13 public functions inherited from Qt3DCore::QNode
• 31 public functions inherited from QObject

Public Slots

void	setAspectRatio(float aspectRatio)
void	setBottom(float bottom)
void	setExposure(float exposure)
void	setFarPlane(float farPlane)
void	setFieldOfView(float fieldOfView)
void	setLeft(float left)
void	setNearPlane(float nearPlane)
void	setProjectionMatrix(const QMatrix4x4 &projectionMatrix)
void	setProjectionType(Qt3DRender::QCameraLens::ProjectionType projectionType)
void	setRight(float right)
void	setTop(float top)

• 1 public slot inherited from Qt3DCore::QComponent
• 3 public slots inherited from Qt3DCore::QNode
• 1 public slot inherited from QObject

Signals

void	aspectRatioChanged(float aspectRatio)
void	bottomChanged(float bottom)
void	exposureChanged(float exposure)
void	farPlaneChanged(float farPlane)
void	fieldOfViewChanged(float fieldOfView)
void	leftChanged(float left)
void	nearPlaneChanged(float nearPlane)
void	projectionMatrixChanged(const QMatrix4x4 &projectionMatrix)
void	projectionTypeChanged(QCameraLens::ProjectionType projectionType)
void	rightChanged(float right)
void	topChanged(float top)
void	viewSphere(const QVector3D &center, float radius)

• 3 signals inherited from Qt3DCore::QComponent
• 4 signals inherited from Qt3DCore::QNode
• 2 signals inherited from QObject

Static Public Members

const QMetaObject

staticMetaObject

• 9 static public members inherited from QObject

Protected Functions

QCameraLens(Qt3DRender::QCameraLensPrivate &dd, Qt3DCore::QNode *parent = nullptr)

• 2 protected functions inherited from Qt3DCore::QNode
• 9 protected functions inherited from QObject

Detailed Description

Qt3DRender::QCameraLens specifies the projection matrix that will be used to define a Camera for a 3D scene.

Member Type Documentation

enum QCameraLens::ProjectionType

Specifies which parameters of Qt3DRender::QCameraLens are used to compute the projection matrix.

Constant	Value	Description
Qt3DRender::QCameraLens::OrthographicProjection	0	Orthogonal projection
Qt3DRender::QCameraLens::PerspectiveProjection	1	Perspective projection
Qt3DRender::QCameraLens::FrustumProjection	2	Frustum projection
Qt3DRender::QCameraLens::CustomProjection	3	Custom user-defined projection

Member Function Documentation

QCameraLens::QCameraLens(Qt3DCore::QNode *parent = nullptr)

Constructs a QCameraLens with given parent

[protected] QCameraLens::QCameraLens(Qt3DRender::QCameraLensPrivate &dd, Qt3DCore::QNode *parent = nullptr)

Default constructs an instance of QCameraLens.

[slot] void QCameraLens::setAspectRatio(float aspectRatio)

Sets the projection's aspect ratio to aspectRatio. This triggers a projection matrix update.

Note: this has no effect if the projection type is not Qt3DRender::QCameraLens::PerspectiveProjection.

Note: Setter function for property aspectRatio.

See also aspectRatio().

[slot] void QCameraLens::setBottom(float bottom)

Sets the projection's bottom window coordinate to bottom. This triggers a projection matrix update.

Note: this has no effect if the projection type is Qt3DRender::QCameraLens::PerspectiveProjection.

Note: Setter function for property bottom.

See also bottom().

[slot] void QCameraLens::setExposure(float exposure)

Sets the camera lens' exposure

Note: Setter function for property exposure.

See also exposure().

[slot] void QCameraLens::setFarPlane(float farPlane)

Sets the projection's far plane to farPlane. This triggers a projection matrix update.

Note: Setter function for property farPlane.

See also farPlane().

[slot] void QCameraLens::setFieldOfView(float fieldOfView)

Sets the projection's field of view to fieldOfView degrees. This triggers a projection matrix update.

Note: this has no effect if the projection type is not Qt3DRender::QCameraLens::PerspectiveProjection.

Note: Setter function for property fieldOfView.

See also fieldOfView().

void QCameraLens::setFrustumProjection(float left, float right, float bottom, float top, float nearPlane, float farPlane)

Defines an orthographic projection based on left, right, bottom, top, nearPlane, farPlane.

[slot] void QCameraLens::setLeft(float left)

Sets the projection's lower left window coordinate to left. This triggers a projection matrix update.

Note: this has no effect if the projection type is Qt3DRender::QCameraLens::PerspectiveProjection.

Note: Setter function for property left.

See also left().

[slot] void QCameraLens::setNearPlane(float nearPlane)

Sets the projection's near plane to nearPlane. This triggers a projection matrix update.

Note: Setter function for property nearPlane.

See also nearPlane().

void QCameraLens::setOrthographicProjection(float left, float right, float bottom, float top, float nearPlane, float farPlane)

Defines an orthographic projection based on left, right, bottom, top, nearPlane, farPlane.

void QCameraLens::setPerspectiveProjection(float fieldOfView, float aspectRatio, float nearPlane, float farPlane)

Defines a perspective projection based on fieldOfView, aspectRatio, nearPlane, farPlane.

[slot] void QCameraLens::setProjectionMatrix(const QMatrix4x4 &projectionMatrix)

Sets the project matrix to projectionMatrix.

Note: This will set the projection type to Qt3DRender::QCameraLens::CustomProjection and thus ignore all other camera parameters that might have been specified.

Note: Setter function for property projectionMatrix.

See also projectionMatrix().

[slot] void QCameraLens::setProjectionType(Qt3DRender::QCameraLens::ProjectionType projectionType)

Sets the lens' projection type projectionType.

Note: Qt3DRender::QCameraLens::Frustum and Qt3DRender::QCameraLens::PerspectiveProjection are two different ways of specifying the same projection.

Note: Setter function for property projectionType.

See also projectionType().

[slot] void QCameraLens::setRight(float right)

Sets the projection's upper right window coordinate to right. This triggers a projection matrix update.

Note: this has no effect if the projection type is Qt3DRender::QCameraLens::PerspectiveProjection.

Note: Setter function for property right.

See also right().

[slot] void QCameraLens::setTop(float top)

Sets the projection's top window coordinate to top. This triggers a projection matrix update.

Note: this has no effect if the projection type is Qt3DRender::QCameraLens::PerspectiveProjection.

Note: Setter function for property top.

See also top().

void QCameraLens::viewAll(Qt3DCore::QNodeId cameraId)

void QCameraLens::viewEntity(Qt3DCore::QNodeId entityId, Qt3DCore::QNodeId cameraId)

[signal] void QCameraLens::viewSphere(const QVector3D &center, float radius)