内容

• 公共类型
• 特性
• 公共函数
• 公共槽
• 信号
• 保护函数
• 详细描述

QCamera 类

( Qt3DRender::QCamera )

The QCamera class defines a view point through which the scene will be rendered. 更多...

头：	#include <Qt3DRender/QCamera>
qmake:	QT += 3drender
Since:	Qt 5.5
实例化：	Camera
继承：	Qt3DCore::QEntity

• 所有成员列表，包括继承成员
• 过时成员

公共类型

enum	CameraTranslationOption { TranslateViewCenter, DontTranslateViewCenter }

特性

aspectRatio : float bottom : float exposure : float farPlane : float fieldOfView : float left : float nearPlane : float position : QVector3D

projectionMatrix : QMatrix4x4 projectionType : Qt3DRender::QCameraLens::ProjectionType right : float top : float upVector : QVector3D viewCenter : QVector3D viewVector : const QVector3D

• 3 特性继承自 Qt3DCore::QNode
• 1 特性继承自 QObject

公共函数

	QCamera (QNode * parent = nullptr)
float	aspectRatio () const
float	bottom () const
float	exposure () const
float	farPlane () const
float	fieldOfView () const
float	left () const
QCameraLens *	lens () const
float	nearPlane () const
void	pan (float angle )
void	pan (float angle , const QVector3D & axis )
void	panAboutViewCenter (float angle )
void	panAboutViewCenter (float angle , const QVector3D & axis )
QQuaternion	panRotation (float angle ) const
QVector3D	position () const
QMatrix4x4	projectionMatrix () const
QCameraLens::ProjectionType	projectionType () const
float	right () const
void	roll (float angle )
void	rollAboutViewCenter (float angle )
QQuaternion	rollRotation (float angle ) const
void	rotate (const QQuaternion & q )
void	rotateAboutViewCenter (const QQuaternion & q )
QQuaternion	rotation (float angle , const QVector3D & axis ) const
void	tilt (float angle )
void	tiltAboutViewCenter (float angle )
QQuaternion	tiltRotation (float angle ) const
float	top () const
Qt3DCore::QTransform *	transform () const
void	translate (const QVector3D & vLocal , CameraTranslationOption option = TranslateViewCenter)
void	translateWorld (const QVector3D & vWorld , CameraTranslationOption option = TranslateViewCenter)
QVector3D	upVector () const
QVector3D	viewCenter () const
QVector3D	viewVector () const

• 4 公共函数继承自 Qt3DCore::QEntity
• 11 公共函数继承自 Qt3DCore::QNode
• 32 公共函数继承自 QObject

公共槽

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	setPosition (const QVector3D & position )
void	setProjectionMatrix (const QMatrix4x4 & projectionMatrix )
void	setProjectionType (QCameraLens::ProjectionType type )
void	setRight (float right )
void	setTop (float top )
void	setUpVector (const QVector3D & upVector )
void	setViewCenter (const QVector3D & viewCenter )

• 3 公共槽继承自 Qt3DCore::QNode
• 1 公共槽继承自 QObject

信号

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	positionChanged (const QVector3D & position )
void	projectionMatrixChanged (const QMatrix4x4 & projectionMatrix )
void	projectionTypeChanged (QCameraLens::ProjectionType projectionType )
void	rightChanged (float right )
void	topChanged (float top )
void	upVectorChanged (const QVector3D & upVector )
void	viewCenterChanged (const QVector3D & viewCenter )
void	viewVectorChanged (const QVector3D & viewVector )

• 4 信号继承自 Qt3DCore::QNode
• 2 信号继承自 QObject

保护函数

QCamera (QCameraPrivate & dd , QNode * parent = nullptr)

• 2 保护函数继承自 Qt3DCore::QNode
• 9 保护函数继承自 QObject

额外继承成员

• 11 静态公共成员继承自 QObject

详细描述

The QCamera class defines a view point through which the scene will be rendered.

成员类型文档编制

enum QCamera:: CameraTranslationOption

This enum specifies how camera view center is translated

常量	值	描述
Qt3DRender::QCamera::TranslateViewCenter	0	Translate the view center causing the view direction to remain the same
Qt3DRender::QCamera::DontTranslateViewCenter	1	Don't translate the view center causing the view direction to change

特性文档编制

aspectRatio : float

Holds the current aspect ratio.

访问函数：

float	aspectRatio () const
void	setAspectRatio (float aspectRatio )

通知程序信号：

void	aspectRatioChanged (float aspectRatio )

bottom : float

Holds the current bottom of the camera.

访问函数：

float	bottom () const
void	setBottom (float bottom )

通知程序信号：

void	bottomChanged (float bottom )

exposure : float

Holds the current exposure of the camera.

访问函数：

float	exposure () const
void	setExposure (float exposure )

通知程序信号：

void	exposureChanged (float exposure )

farPlane : float

Holds the current camera far plane.

访问函数：

float	farPlane () const
void	setFarPlane (float farPlane )

通知程序信号：

void	farPlaneChanged (float farPlane )

fieldOfView : float

Holds the current field of view in degrees.

访问函数：

float	fieldOfView () const
void	setFieldOfView (float fieldOfView )

通知程序信号：

void	fieldOfViewChanged (float fieldOfView )

left : float

Holds the current left of the camera.

访问函数：

float	left () const
void	setLeft (float left )

通知程序信号：

void	leftChanged (float left )

nearPlane : float

Holds the current camera near plane.

访问函数：

float	nearPlane () const
void	setNearPlane (float nearPlane )

通知程序信号：

void	nearPlaneChanged (float nearPlane )

position : QVector3D

Holds the camera's position in coordinates relative to the parent entity.

访问函数：

QVector3D	位置 () const
void	setPosition (const QVector3D & position )

通知程序信号：

void	positionChanged (const QVector3D & position )

projectionMatrix : QMatrix4x4

Holds the current projection matrix of the camera.

访问函数：

QMatrix4x4	projectionMatrix () const
void	setProjectionMatrix (const QMatrix4x4 & projectionMatrix )

通知程序信号：

void	projectionMatrixChanged (const QMatrix4x4 & projectionMatrix )

projectionType : Qt3DRender::QCameraLens::ProjectionType

Holds the type of the camera projection.

• CameraLens .OrthographicProjection
• CameraLens .PerspectiveProjection
• CameraLens .FrustumProjection
• CameraLens .CustomProjection

访问函数：

QCameraLens::ProjectionType	projectionType () const
void	setProjectionType (QCameraLens::ProjectionType type )

通知程序信号：

void	projectionTypeChanged (QCameraLens::ProjectionType projectionType )

另请参阅 Qt3DRender::QCameraLens::ProjectionType .

right : float

Holds the current right of the camera.

访问函数：

float	right () const
void	setRight (float right )

通知程序信号：

void	rightChanged (float right )

top : float

Holds the current top of the camera.

访问函数：

float	top () const
void	setTop (float top )

通知程序信号：

void	topChanged (float top )

upVector : QVector3D

Holds the camera's up vector in coordinates relative to the parent entity.

访问函数：

QVector3D	upVector () const
void	setUpVector (const QVector3D & upVector )

通知程序信号：

void	upVectorChanged (const QVector3D & upVector )

viewCenter : QVector3D

Holds the camera's view center in coordinates relative to the parent entity.

访问函数：

QVector3D	viewCenter () const
void	setViewCenter (const QVector3D & viewCenter )

通知程序信号：

void	viewCenterChanged (const QVector3D & viewCenter )

viewVector : const QVector3D

Holds the camera's view vector in coordinates relative to the parent entity.

访问函数：

QVector3D

viewVector () const

通知程序信号：

void	viewVectorChanged (const QVector3D & viewVector )

成员函数文档编制

QCamera:: QCamera ( QNode * parent = nullptr)

Default constructs an instance of QCamera.

[protected] QCamera:: QCamera ( QCameraPrivate & dd , QNode * parent = nullptr)

Copy constructor.

QCameraLens *QCamera:: lens () const

Returns the current lens.

void QCamera:: pan ( float angle )

Adjusts the pan angle of the camera by angle in degrees.

void QCamera:: pan ( float angle , const QVector3D & axis )

Adjusts the pan angle of the camera by angle in degrees on a chosen axis .

void QCamera:: panAboutViewCenter ( float angle )

Adjusts the camera pan about view center by angle in degrees.

void QCamera:: panAboutViewCenter ( float angle , const QVector3D & axis )

Adjusts the camera pan about view center by angle in degrees on axis .

QQuaternion QCamera:: panRotation ( float angle ) const

Returns the calculated pan rotation in relation to the angle in degrees taken in to adjust the camera's pan or left/right rotation on the Y axis.

void QCamera:: roll ( float angle )

Adjusts the camera roll by angle in degrees.

void QCamera:: rollAboutViewCenter ( float angle )

Adjusts the camera roll about view center by angle in degrees.

QQuaternion QCamera:: rollRotation ( float angle ) const

Returns the calculated roll rotation in relation to the angle in degrees taken in to adjust the camera's roll or lean left/right rotation on the Z axis.

void QCamera:: rotate (const QQuaternion & q )

Rotates the camera with the use of a Quaternion in q .

void QCamera:: rotateAboutViewCenter (const QQuaternion & q )

Rotates the camera about the view center with the use of a Quaternion in q .

QQuaternion QCamera:: rotation ( float angle , const QVector3D & axis ) const

Returns the calculated rotation in relation to the angle in degrees and chosen axis taken in.

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

Sets the camera's aspect ratio to aspectRatio .

注意： Setter 函数对于特性 aspectRatio .

另请参阅 aspectRatio ().

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

Sets the bottom of the camera to bottom .

注意： Setter 函数对于特性 bottom .

另请参阅 bottom ().

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

Sets the camera's exposure to exposure .

注意： Setter 函数对于特性 exposure .

另请参阅 exposure ().

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

Sets the camera's far plane to farPlane

注意： Setter 函数对于特性 farPlane .

另请参阅 farPlane ().

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

Sets the camera's field of view to fieldOfView in degrees.

注意： Setter 函数对于特性 fieldOfView .

另请参阅 fieldOfView ().

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

Sets the left of the camera to left .

注意： Setter 函数对于特性 left .

另请参阅 left ().

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

Sets the camera's near plane to nearPlane .

注意： Setter 函数对于特性 nearPlane .

另请参阅 nearPlane ().

[slot] void QCamera:: setPosition (const QVector3D & position )

Sets the camera's position in 3D space to position .

注意： Setter 函数对于特性 position .

另请参阅 position ().

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

Sets the camera's projection matrix to projectionMatrix .

注意： Setter 函数对于特性 projectionMatrix .

另请参阅 projectionMatrix ().

[slot] void QCamera:: setProjectionType ( QCameraLens::ProjectionType type )

Sets the camera's projection type to type .

注意： Setter 函数对于特性 projectionType .

另请参阅 projectionType ().

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

Sets the right of the camera to right .

注意： Setter 函数对于特性 right .

另请参阅 right ().

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

Sets the top of the camera to top .

注意： Setter 函数对于特性 top .

另请参阅 top ().

[slot] void QCamera:: setUpVector (const QVector3D & upVector )

Sets the camera's up vector to upVector .

注意： Setter 函数对于特性 upVector .

另请参阅 upVector ().

[slot] void QCamera:: setViewCenter (const QVector3D & viewCenter )

Sets the camera's view center to viewCenter .

注意： Setter 函数对于特性 viewCenter .

另请参阅 viewCenter ().

void QCamera:: tilt ( float angle )

Adjusts the tilt angle of the camera by angle in degrees.

void QCamera:: tiltAboutViewCenter ( float angle )

Adjusts the camera tilt about view center by angle in degrees.

QQuaternion QCamera:: tiltRotation ( float angle ) const

Returns the calculated tilt rotation in relation to the angle in degrees taken in to adjust the camera's tilt or up/down rotation on the X axis.

Qt3DCore::QTransform *QCamera:: transform () const

Returns the camera's position via transform.

void QCamera:: translate (const QVector3D & vLocal , CameraTranslationOption option = TranslateViewCenter)

Translates the camera's position and its view vector by vLocal in local coordinates. The option allows for toggling whether the view center should be translated.

void QCamera:: translateWorld (const QVector3D & vWorld , CameraTranslationOption option = TranslateViewCenter)

Translates the camera's position and its view vector by vWorld in world coordinates. The option allows for toggling whether the view center should be translated.