QCamera¶

PyQt5.Qt3DRender.QCamera

Inherits from QEntity.

Description¶

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

Enums¶

CameraTranslationOption

This enum specifies how camera view center is translated

Member

Value

Description
DontTranslateViewCenter

1

Don’t translate the view center causing the view direction to change
TranslateViewCenter

0

Translate the view center causing the view direction to remain the same

Methods¶

__init__(parent: QNode = None)

Creates a new QCamera instance with the specified parent.

aspectRatio() → float

See also

setAspectRatio().

bottom() → float

See also

setBottom().

exposure() → float

See also

setExposure().

farPlane() → float

See also

setFarPlane().

fieldOfView() → float

See also

setFieldOfView().

left() → float

See also

setLeft().

lens() → QCameraLens

Returns the current lens.

nearPlane() → float

See also

setNearPlane().

pan(float)

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

pan(float, QVector3D)

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

panAboutViewCenter(float)

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

panAboutViewCenter(float, QVector3D)

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

panRotation(float) → QQuaternion

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.

position() → QVector3D

See also

setPosition().

projectionMatrix() → QMatrix4x4

See also

setProjectionMatrix().

projectionType() → ProjectionType

See also

setProjectionType().

See also

setRight().

roll(float)

Adjusts the camera roll by angle in degrees.

rollAboutViewCenter(float)

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

rollRotation(float) → QQuaternion

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.

rotate(QQuaternion)

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

rotateAboutViewCenter(QQuaternion)

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

rotation(float, QVector3D) → QQuaternion

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

setAspectRatio(float)

Sets the camera’s aspect ratio to aspectRatio.

See also

aspectRatio().

setBottom(float)

Sets the bottom of the camera to bottom.

See also

bottom().

setExposure(float)

Sets the camera’s exposure to exposure.

See also

exposure().

setFarPlane(float)

Sets the camera’s far plane to farPlane

See also

farPlane().

setFieldOfView(float)

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

See also

fieldOfView().

setLeft(float)

Sets the left of the camera to left.

See also

left().

setNearPlane(float)

Sets the camera’s near plane to nearPlane.

See also

nearPlane().

setPosition(QVector3D)

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

See also

position().

setProjectionMatrix(QMatrix4x4)

Sets the camera’s projection matrix to projectionMatrix.

See also

projectionMatrix().

setProjectionType(ProjectionType)

TODO

setRight(float)

Sets the right of the camera to right.

See also

right().

setTop(float)

Sets the top of the camera to top.

See also

top().

setUpVector(QVector3D)

Sets the camera’s up vector to upVector.

See also

upVector().

setViewCenter(QVector3D)

Sets the camera’s view center to viewCenter.

See also

viewCenter().

tilt(float)

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

tiltAboutViewCenter(float)

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

tiltRotation(float) → QQuaternion

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.

top() → float

See also

setTop().

transform() → QTransform

Returns the camera’s position via transform.

translate(QVector3D, option: CameraTranslationOption = 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.

translateWorld(QVector3D, option: CameraTranslationOption = 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.

upVector() → QVector3D

See also

setUpVector().

viewAll()

Rotates and moves the camera so that it’s viewCenter is the center of the scene’s bounding volume and the entire scene fits in the view port.

Note: Only works if the lens is in perspective projection mode.

See also

Qt3D.Render::Camera::projectionType.

viewCenter() → QVector3D

See also

setViewCenter().

viewEntity(QEntity)

Rotates and moves the camera so that it’s viewCenter is the center of the entity’s bounding volume and the entire entity fits in the view port.

Note: Only works if the lens is in perspective projection mode.

See also

Camera.projectionType.

viewMatrix() → QMatrix4x4

TODO

viewSphere(QVector3D, float)

Rotates and moves the camera so that it’s viewCenter is center and a sphere of radius fits in the view port.

Note: Only works if the lens is in perspective projection mode.

See also

Qt3D.Render::Camera::projectionType.

viewVector() → QVector3D

TODO

Signals¶

aspectRatioChanged(float)

TODO

bottomChanged(float)

TODO

exposureChanged(float)

TODO

farPlaneChanged(float)

TODO

fieldOfViewChanged(float)

TODO

leftChanged(float)

TODO

nearPlaneChanged(float)

TODO

positionChanged(QVector3D)

TODO

projectionMatrixChanged(QMatrix4x4)

TODO

projectionTypeChanged(ProjectionType)

TODO

rightChanged(float)

TODO

topChanged(float)

TODO

upVectorChanged(QVector3D)

TODO

viewCenterChanged(QVector3D)

TODO

viewMatrixChanged()

TODO

viewVectorChanged(QVector3D)

TODO