QCamera

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

Inheritance diagram of PySide2.Qt3DRender.Qt3DRender.QCamera

Synopsis

Functions

Slots

Signals

Detailed Description

class PySide2.Qt3DRender.Qt3DRender.QCamera([parent=None])

Creates a new QCamera instance with the specified parent .

PySide2.Qt3DRender.Qt3DRender.QCamera.CameraTranslationOption

This enum specifies how camera view center is translated

Constant

Description

Qt3DRender.QCamera.TranslateViewCenter

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

Qt3DRender.QCamera.DontTranslateViewCenter

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

PySide2.Qt3DRender.Qt3DRender.QCamera.aspectRatio()
Return type:

float

Holds the current aspect ratio.

PySide2.Qt3DRender.Qt3DRender.QCamera.aspectRatioChanged(aspectRatio)
Parameters:

aspectRatio – float

PySide2.Qt3DRender.Qt3DRender.QCamera.bottom()
Return type:

float

Holds the current bottom of the camera.

This property is only relevant when projectionType is OrthographicProjection .

PySide2.Qt3DRender.Qt3DRender.QCamera.bottomChanged(bottom)
Parameters:

bottom – float

PySide2.Qt3DRender.Qt3DRender.QCamera.exposure()
Return type:

float

Holds the current exposure of the camera.

The default value is 0.0.

The MetalRoughMaterial in Qt 3D Extras is currently the only provided material that makes use of camera exposure. Negative values will cause the material to be darker, and positive values will cause it to be lighter.

Custom materials may choose to interpret the value differently.

PySide2.Qt3DRender.Qt3DRender.QCamera.exposureChanged(exposure)
Parameters:

exposure – float

PySide2.Qt3DRender.Qt3DRender.QCamera.farPlane()
Return type:

float

Holds the current camera far plane. Objects that are farther from the camera than the will not be rendered.

PySide2.Qt3DRender.Qt3DRender.QCamera.farPlaneChanged(farPlane)
Parameters:

farPlane – float

PySide2.Qt3DRender.Qt3DRender.QCamera.fieldOfView()
Return type:

float

Holds the current vertical field of view in degrees.

Along with aspectRatio , this property determines how much of the scene is visible to the camera. In that respect you might think of it as analogous to choosing a wide angle (wide horizontal field of view) or telephoto (narrow horizontal field of view) lens depending on how much of a scene you want to capture.

is only relevant when projectionType is PerspectiveProjection .

PySide2.Qt3DRender.Qt3DRender.QCamera.fieldOfViewChanged(fieldOfView)
Parameters:

fieldOfView – float

PySide2.Qt3DRender.Qt3DRender.QCamera.left()
Return type:

float

Holds the current left of the camera.

This property is only relevant when projectionType is OrthographicProjection .

PySide2.Qt3DRender.Qt3DRender.QCamera.leftChanged(left)
Parameters:

left – float

PySide2.Qt3DRender.Qt3DRender.QCamera.lens()
Return type:

PySide2.Qt3DRender.Qt3DRender.QCameraLens

Holds the QCameraLens component of the camera.

PySide2.Qt3DRender.Qt3DRender.QCamera.nearPlane()
Return type:

float

Holds the current camera near plane. Objects that are closer to the camera than the will not be rendered.

PySide2.Qt3DRender.Qt3DRender.QCamera.nearPlaneChanged(nearPlane)
Parameters:

nearPlane – float

PySide2.Qt3DRender.Qt3DRender.QCamera.pan(angle)
Parameters:

angle – float

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

PySide2.Qt3DRender.Qt3DRender.QCamera.pan(angle, axis)
Parameters:

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

PySide2.Qt3DRender.Qt3DRender.QCamera.panAboutViewCenter(angle)
Parameters:

angle – float

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

PySide2.Qt3DRender.Qt3DRender.QCamera.panAboutViewCenter(angle, axis)
Parameters:

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

PySide2.Qt3DRender.Qt3DRender.QCamera.panRotation(angle)
Parameters:

angle – float

Return type:

PySide2.QtGui.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.

PySide2.Qt3DRender.Qt3DRender.QCamera.position()
Return type:

PySide2.QtGui.QVector3D

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

PySide2.Qt3DRender.Qt3DRender.QCamera.positionChanged(position)
Parameters:

positionPySide2.QtGui.QVector3D

PySide2.Qt3DRender.Qt3DRender.QCamera.projectionMatrix()
Return type:

PySide2.QtGui.QMatrix4x4

Holds the current projection matrix of the camera.

PySide2.Qt3DRender.Qt3DRender.QCamera.projectionMatrixChanged(projectionMatrix)
Parameters:

projectionMatrixPySide2.QtGui.QMatrix4x4

PySide2.Qt3DRender.Qt3DRender.QCamera.projectionType()
Return type:

ProjectionType

Holds the type of the camera projection. The default value is PerspectiveProjection .

  • OrthographicProjection - Parallel lines appear parallel. Objects appear the same size regardless of distance.

  • PerspectiveProjection - Parallel lines appear to meet in the distance. Objects appear to shrink the farther they are from the camera.

  • FrustumProjection

  • CustomProjection

See also

ProjectionType

PySide2.Qt3DRender.Qt3DRender.QCamera.projectionTypeChanged(projectionType)
Parameters:

projectionTypeProjectionType

PySide2.Qt3DRender.Qt3DRender.QCamera.right()
Return type:

float

Holds the current right of the camera.

This property is only relevant when projectionType is OrthographicProjection .

PySide2.Qt3DRender.Qt3DRender.QCamera.rightChanged(right)
Parameters:

right – float

PySide2.Qt3DRender.Qt3DRender.QCamera.roll(angle)
Parameters:

angle – float

Adjusts the camera roll by angle in degrees.

PySide2.Qt3DRender.Qt3DRender.QCamera.rollAboutViewCenter(angle)
Parameters:

angle – float

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

PySide2.Qt3DRender.Qt3DRender.QCamera.rollRotation(angle)
Parameters:

angle – float

Return type:

PySide2.QtGui.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.

PySide2.Qt3DRender.Qt3DRender.QCamera.rotate(q)
Parameters:

qPySide2.QtGui.QQuaternion

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

PySide2.Qt3DRender.Qt3DRender.QCamera.rotateAboutViewCenter(q)
Parameters:

qPySide2.QtGui.QQuaternion

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

PySide2.Qt3DRender.Qt3DRender.QCamera.rotation(angle, axis)
Parameters:
Return type:

PySide2.QtGui.QQuaternion

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

PySide2.Qt3DRender.Qt3DRender.QCamera.setAspectRatio(aspectRatio)
Parameters:

aspectRatio – float

Holds the current aspect ratio.

PySide2.Qt3DRender.Qt3DRender.QCamera.setBottom(bottom)
Parameters:

bottom – float

Holds the current bottom of the camera.

This property is only relevant when projectionType is OrthographicProjection .

PySide2.Qt3DRender.Qt3DRender.QCamera.setExposure(exposure)
Parameters:

exposure – float

Holds the current exposure of the camera.

The default value is 0.0.

The MetalRoughMaterial in Qt 3D Extras is currently the only provided material that makes use of camera exposure. Negative values will cause the material to be darker, and positive values will cause it to be lighter.

Custom materials may choose to interpret the value differently.

PySide2.Qt3DRender.Qt3DRender.QCamera.setFarPlane(farPlane)
Parameters:

farPlane – float

Holds the current camera far plane. Objects that are farther from the camera than the will not be rendered.

PySide2.Qt3DRender.Qt3DRender.QCamera.setFieldOfView(fieldOfView)
Parameters:

fieldOfView – float

Holds the current vertical field of view in degrees.

Along with aspectRatio , this property determines how much of the scene is visible to the camera. In that respect you might think of it as analogous to choosing a wide angle (wide horizontal field of view) or telephoto (narrow horizontal field of view) lens depending on how much of a scene you want to capture.

is only relevant when projectionType is PerspectiveProjection .

PySide2.Qt3DRender.Qt3DRender.QCamera.setLeft(left)
Parameters:

left – float

Holds the current left of the camera.

This property is only relevant when projectionType is OrthographicProjection .

PySide2.Qt3DRender.Qt3DRender.QCamera.setNearPlane(nearPlane)
Parameters:

nearPlane – float

Holds the current camera near plane. Objects that are closer to the camera than the will not be rendered.

PySide2.Qt3DRender.Qt3DRender.QCamera.setPosition(position)
Parameters:

positionPySide2.QtGui.QVector3D

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

PySide2.Qt3DRender.Qt3DRender.QCamera.setProjectionMatrix(projectionMatrix)
Parameters:

projectionMatrixPySide2.QtGui.QMatrix4x4

Holds the current projection matrix of the camera.

PySide2.Qt3DRender.Qt3DRender.QCamera.setProjectionType(type)
Parameters:

typeProjectionType

Holds the type of the camera projection. The default value is PerspectiveProjection .

  • OrthographicProjection - Parallel lines appear parallel. Objects appear the same size regardless of distance.

  • PerspectiveProjection - Parallel lines appear to meet in the distance. Objects appear to shrink the farther they are from the camera.

  • FrustumProjection

  • CustomProjection

See also

ProjectionType

PySide2.Qt3DRender.Qt3DRender.QCamera.setRight(right)
Parameters:

right – float

Holds the current right of the camera.

This property is only relevant when projectionType is OrthographicProjection .

PySide2.Qt3DRender.Qt3DRender.QCamera.setTop(top)
Parameters:

top – float

Holds the current top of the camera.

This property is only relevant when projectionType is OrthographicProjection .

PySide2.Qt3DRender.Qt3DRender.QCamera.setUpVector(upVector)
Parameters:

upVectorPySide2.QtGui.QVector3D

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

The up vector indicates which direction the top of the camera is facing. Think of taking a picture: after positioning yourself and pointing the camera at your target, you might rotate the camera left or right, giving you a portrait or landscape (or angled!) shot. allows you to control this type of movement.

PySide2.Qt3DRender.Qt3DRender.QCamera.setViewCenter(viewCenter)
Parameters:

viewCenterPySide2.QtGui.QVector3D

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

Intuitively, the is the location the camera is pointing at.

PySide2.Qt3DRender.Qt3DRender.QCamera.tilt(angle)
Parameters:

angle – float

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

PySide2.Qt3DRender.Qt3DRender.QCamera.tiltAboutViewCenter(angle)
Parameters:

angle – float

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

PySide2.Qt3DRender.Qt3DRender.QCamera.tiltRotation(angle)
Parameters:

angle – float

Return type:

PySide2.QtGui.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.

PySide2.Qt3DRender.Qt3DRender.QCamera.top()
Return type:

float

Holds the current top of the camera.

This property is only relevant when projectionType is OrthographicProjection .

PySide2.Qt3DRender.Qt3DRender.QCamera.topChanged(top)
Parameters:

top – float

PySide2.Qt3DRender.Qt3DRender.QCamera.transform()
Return type:

PySide2.Qt3DCore.Qt3DCore.QTransform

Holds the QTransform component of the camera.

PySide2.Qt3DRender.Qt3DRender.QCamera.translate(vLocal[, option=TranslateViewCenter])
Parameters:

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.

PySide2.Qt3DRender.Qt3DRender.QCamera.translateWorld(vWorld[, option=TranslateViewCenter])
Parameters:

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.

PySide2.Qt3DRender.Qt3DRender.QCamera.upVector()
Return type:

PySide2.QtGui.QVector3D

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

The up vector indicates which direction the top of the camera is facing. Think of taking a picture: after positioning yourself and pointing the camera at your target, you might rotate the camera left or right, giving you a portrait or landscape (or angled!) shot. allows you to control this type of movement.

PySide2.Qt3DRender.Qt3DRender.QCamera.upVectorChanged(upVector)
Parameters:

upVectorPySide2.QtGui.QVector3D

PySide2.Qt3DRender.Qt3DRender.QCamera.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 or orthographic projection mode.

See also

Qt3D.Render::Camera::projectionType

PySide2.Qt3DRender.Qt3DRender.QCamera.viewCenter()
Return type:

PySide2.QtGui.QVector3D

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

Intuitively, the is the location the camera is pointing at.

PySide2.Qt3DRender.Qt3DRender.QCamera.viewCenterChanged(viewCenter)
Parameters:

viewCenterPySide2.QtGui.QVector3D

PySide2.Qt3DRender.Qt3DRender.QCamera.viewEntity(entity)
Parameters:

entityPySide2.Qt3DCore.Qt3DCore.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 or orthographic projection mode.

See also

Camera.projectionType

PySide2.Qt3DRender.Qt3DRender.QCamera.viewMatrix()
Return type:

PySide2.QtGui.QMatrix4x4

Holds the camera’s view matrix in coordinates relative to the parent entity.

PySide2.Qt3DRender.Qt3DRender.QCamera.viewMatrixChanged()
PySide2.Qt3DRender.Qt3DRender.QCamera.viewSphere(center, radius)
Parameters:

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 or orthographic projection mode.

See also

Qt3D.Render::Camera::projectionType

PySide2.Qt3DRender.Qt3DRender.QCamera.viewVector()
Return type:

PySide2.QtGui.QVector3D

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

This vector decribes the displacement from the camera ( position ) to its target ( viewCenter ).

PySide2.Qt3DRender.Qt3DRender.QCamera.viewVectorChanged(viewVector)
Parameters:

viewVectorPySide2.QtGui.QVector3D