collada.camera.PerspectiveCamera

class collada.camera.PerspectiveCamera(id, znear, zfar, xfov=None, yfov=None, aspect_ratio=None, xmlnode=None)

Bases: collada.camera.Camera

Perspective camera as defined in COLLADA tag <perspective>.

__init__(id, znear, zfar, xfov=None, yfov=None, aspect_ratio=None, xmlnode=None)

Create a new perspective camera.

Note: aspect_ratio = tan(0.5*xfov) / tan(0.5*yfov)

You can specify one of:

• xfov alone
• yfov alone
• xfov and yfov
• xfov and aspect_ratio
• yfov and aspect_ratio

Any other combination will raise collada.common.DaeMalformedError

Parameters:

• id (str) – Identifier for the camera
• znear (float) – Distance to the near clipping plane
• zfar (float) – Distance to the far clipping plane
• xfov (float) – Horizontal field of view, in degrees
• yfov (float) – Vertical field of view, in degrees
• aspect_ratio (float) – Aspect ratio of the field of view
• xmlnode – If loaded from xml, the xml node

Methods

__init__(id, znear, zfar[, xfov, yfov, …])	Create a new perspective camera.
bind(matrix)	Create a bound camera of itself based on a transform matrix.
load(collada, localscope, node)	Load and return a class instance from an XML node.
save()	Saves the perspective camera’s properties back to xmlnode

id = None

Identifier for the camera

xfov = None

Horizontal field of view, in degrees

yfov = None

Vertical field of view, in degrees

aspect_ratio = None

Aspect ratio of the field of view

znear = None

Distance to the near clipping plane

zfar = None

Distance to the far clipping plane

xmlnode = None

ElementTree representation of the data.

save()

Saves the perspective camera’s properties back to xmlnode

static load(collada, localscope, node)

Load and return a class instance from an XML node.

Inspect the data inside node, which must match this class tag and create an instance out of it.

Parameters:

• collada (collada.Collada) – The collada file object where this object lives
• localscope (dict) – If there is a local scope where we should look for local ids (sid) this is the dictionary. Otherwise empty dict ({})
• node – An Element from python’s ElementTree API

bind(matrix)

Create a bound camera of itself based on a transform matrix.

Parameters:matrix (numpy.array) – A numpy transformation matrix of size 4x4 Return type:collada.camera.BoundPerspectiveCamera