QCameraLens#

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

Inheritance diagram of PySide6.Qt3DRender.Qt3DRender.QCameraLens

Synopsis#

Properties#

Functions#

Slots#

Signals#

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description#

class PySide6.Qt3DRender.Qt3DRender.QCameraLens([parent=None])#
Parameters:

parentPySide6.Qt3DCore.Qt3DCore.QNode

Constructs a QCameraLens with given parent

Note

Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.

property PᅟySide6.Qt3DRender.Qt3DRender.QCameraLens.aspectRatio: float#

Holds the current aspect ratio of the camera lens.

Note

: The return value may be undefined if the projection type is not PerspectiveProjection .

Access functions:
property PᅟySide6.Qt3DRender.Qt3DRender.QCameraLens.bottom: float#

Holds the current bottom plane of the camera lens.

Note

The return value may be undefined if the projection type is PerspectiveProjection .

Access functions:
property PᅟySide6.Qt3DRender.Qt3DRender.QCameraLens.exposure: float#

Holds the current exposure of the camera lens.

Access functions:
property PᅟySide6.Qt3DRender.Qt3DRender.QCameraLens.farPlane: float#

Holds the current near plane of the camera lens.

Access functions:
property PᅟySide6.Qt3DRender.Qt3DRender.QCameraLens.fieldOfView: float#

Holds the current field of view of the camera lens.

Note

: The return value may be undefined if the projection type is not PerspectiveProjection .

Access functions:
property PᅟySide6.Qt3DRender.Qt3DRender.QCameraLens.left: float#

Holds the current left plane of the camera lens.

Note

The return value may be undefined if the projection type is PerspectiveProjection .

Access functions:
property PᅟySide6.Qt3DRender.Qt3DRender.QCameraLens.nearPlane: float#

Holds the current near plane of the camera lens.

Access functions:
property PᅟySide6.Qt3DRender.Qt3DRender.QCameraLens.projectionMatrix: PySide6.QtGui.QMatrix4x4#

Holds the current projection matrix of the camera lens.

Access functions:
property PᅟySide6.Qt3DRender.Qt3DRender.QCameraLens.projectionType: ProjectionType#

Holds the type of the camera projection.

See also

ProjectionType

Access functions:
property PᅟySide6.Qt3DRender.Qt3DRender.QCameraLens.right: float#

Holds the current right plane of the camera lens.

Note

The return value may be undefined if the projection type is PerspectiveProjection .

Access functions:
property PᅟySide6.Qt3DRender.Qt3DRender.QCameraLens.top: float#

Holds the current top plane of the camera lens.

Note

The return value may be undefined if the projection type is PerspectiveProjection .

Access functions:
PySide6.Qt3DRender.Qt3DRender.QCameraLens.ProjectionType#

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

Constant

Description

Qt3DRender.QCameraLens.OrthographicProjection

Orthogonal projection

Qt3DRender.QCameraLens.PerspectiveProjection

Perspective projection

Qt3DRender.QCameraLens.FrustumProjection

Frustum projection

Qt3DRender.QCameraLens.CustomProjection

Custom user-defined projection

PySide6.Qt3DRender.Qt3DRender.QCameraLens.aspectRatio()#
Return type:

float

See also

setAspectRatio()

Getter of property aspectRatio .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.aspectRatioChanged(aspectRatio)#
Parameters:

aspectRatio – float

Notification signal of property aspectRatio .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.bottom()#
Return type:

float

See also

setBottom()

Getter of property bottom .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.bottomChanged(bottom)#
Parameters:

bottom – float

Notification signal of property bottom .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.exposure()#
Return type:

float

See also

setExposure()

Getter of property exposure .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.exposureChanged(exposure)#
Parameters:

exposure – float

Notification signal of property exposure .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.farPlane()#
Return type:

float

See also

setFarPlane()

Getter of property farPlane .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.farPlaneChanged(farPlane)#
Parameters:

farPlane – float

Notification signal of property farPlane .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.fieldOfView()#
Return type:

float

See also

setFieldOfView()

Getter of property fieldOfView .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.fieldOfViewChanged(fieldOfView)#
Parameters:

fieldOfView – float

Notification signal of property fieldOfView .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.left()#
Return type:

float

See also

setLeft()

Getter of property left .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.leftChanged(left)#
Parameters:

left – float

Notification signal of property left .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.nearPlane()#
Return type:

float

See also

setNearPlane()

Getter of property nearPlane .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.nearPlaneChanged(nearPlane)#
Parameters:

nearPlane – float

Notification signal of property nearPlane .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.projectionMatrix()#
Return type:

PySide6.QtGui.QMatrix4x4

Getter of property projectionMatrix .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.projectionMatrixChanged(projectionMatrix)#
Parameters:

projectionMatrixPySide6.QtGui.QMatrix4x4

Notification signal of property projectionMatrix .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.projectionType()#
Return type:

ProjectionType

Getter of property projectionType .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.projectionTypeChanged(projectionType)#
Parameters:

projectionTypeProjectionType

Notification signal of property projectionType .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.right()#
Return type:

float

See also

setRight()

Getter of property right .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.rightChanged(right)#
Parameters:

right – float

Notification signal of property right .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.setAspectRatio(aspectRatio)#
Parameters:

aspectRatio – float

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 PerspectiveProjection .

See also

aspectRatio()

Setter of property aspectRatio .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.setBottom(bottom)#
Parameters:

bottom – float

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 PerspectiveProjection .

See also

bottom()

Setter of property bottom .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.setExposure(exposure)#
Parameters:

exposure – float

Sets the camera lens’ exposure

See also

exposure()

Setter of property exposure .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.setFarPlane(farPlane)#
Parameters:

farPlane – float

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

See also

farPlane()

Setter of property farPlane .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.setFieldOfView(fieldOfView)#
Parameters:

fieldOfView – float

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 PerspectiveProjection .

See also

fieldOfView()

Setter of property fieldOfView .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.setFrustumProjection(left, right, bottom, top, nearPlane, farPlane)#
Parameters:
  • left – float

  • right – float

  • bottom – float

  • top – float

  • nearPlane – float

  • farPlane – float

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

PySide6.Qt3DRender.Qt3DRender.QCameraLens.setLeft(left)#
Parameters:

left – float

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 PerspectiveProjection .

See also

left()

Setter of property left .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.setNearPlane(nearPlane)#
Parameters:

nearPlane – float

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

See also

nearPlane()

Setter of property nearPlane .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.setOrthographicProjection(left, right, bottom, top, nearPlane, farPlane)#
Parameters:
  • left – float

  • right – float

  • bottom – float

  • top – float

  • nearPlane – float

  • farPlane – float

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

PySide6.Qt3DRender.Qt3DRender.QCameraLens.setPerspectiveProjection(fieldOfView, aspect, nearPlane, farPlane)#
Parameters:
  • fieldOfView – float

  • aspect – float

  • nearPlane – float

  • farPlane – float

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

PySide6.Qt3DRender.Qt3DRender.QCameraLens.setProjectionMatrix(projectionMatrix)#
Parameters:

projectionMatrixPySide6.QtGui.QMatrix4x4

Sets the project matrix to projectionMatrix.

Note

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

Setter of property projectionMatrix .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.setProjectionType(projectionType)#
Parameters:

projectionTypeProjectionType

Sets the lens’ projection type projectionType.

Note

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

See also

projectionType()

Setter of property projectionType .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.setRight(right)#
Parameters:

right – float

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 PerspectiveProjection .

See also

right()

Setter of property right .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.setTop(top)#
Parameters:

top – float

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 PerspectiveProjection .

See also

top()

Setter of property top .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.top()#
Return type:

float

See also

setTop()

Getter of property top .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.topChanged(top)#
Parameters:

top – float

Notification signal of property top .

PySide6.Qt3DRender.Qt3DRender.QCameraLens.viewAll(cameraId)#
Parameters:

cameraIdPySide6.Qt3DCore.Qt3DCore.QNodeId

PySide6.Qt3DRender.Qt3DRender.QCameraLens.viewEntity(entityId, cameraId)#
Parameters:
PySide6.Qt3DRender.Qt3DRender.QCameraLens.viewSphere(center, radius)#
Parameters: