Module Camera :: Class Camera

Class Camera

The Camera Data object

This object gives access to Camera-specific data in Blender.

Warning: Most member variables assume values in some [Min, Max] interval. When trying to set them, the given parameter will be clamped to lie in that range: if val < Min, then val = Min, if val > Max, then val = Max.

Method Summary
	`addScriptLink(text, event)` Add a new script link to this Camera.
	`clearIpo()` Unlink the ipo from this camera data object.
	`clearScriptLinks(links)` Delete script links from this Camera.
float	`getClipEnd()` Get the clip end value.
float	`getClipStart()` Get the clip start value.
float	`getDrawSize()` Get the draw size value.
Ipo	`getIpo()` Get the Ipo associated with this camera data object, if any.
float	`getLens()` Get the lens value.
int	`getMode()` Get this Camera's mode flags.
string	`getName()` Get the name of this Camera Data object.
float	`getScale()` Get the scale value.
list	`getScriptLinks(event)` Get a list with this Camera's script links of type 'event'.
int	`getType()` Get this Camera's type.
	`insertIpoKey(keytype)` Inserts keytype values in camera ipo at curframe.
	`setClipEnd(clipend)` Set the clip end value.
	`setClipStart(clipstart)` Set the clip start value.
	`setDrawSize(drawsize)` Set the draw size value.
	`setIpo(ipo)` Link an ipo to this camera data object.
	`setLens(lens)` Set the lens value.
	`setMode(mode1, mode2)` Set this Camera's mode flags.
	`setName(name)` Set the name of this Camera Data object.
	`setScale(scale)` Set the scale value.
	`setType(type)` Set this Camera's type.

Class Variable Summary
	`clipEnd`: The clip end value in [1.0, 5000.0].
	`clipStart`: The clip start value in [0.0, 100.0].
	`drawSize`: The draw size value in [0.1, 10.0].
Blender Ipo	`ipo`: The "camera data" ipo linked to this camera data object.
	`lens`: The lens value in [1.0, 250.0], only relevant to persp cameras.
	`mode`: The mode flags: or'ed value: 'showLimits':1, 'showMist':2.
	`name`: The Camera Data name.
	`scale`: The scale value in [0.01, 1000.00], only relevant to ortho cameras.
	`type`: The Camera type: 'persp':0 or 'ortho':1.

Method Details

addScriptLink(text, event)

Add a new script link to this Camera.

Parameters:: text - the name of an existing Blender Text.
(type=string); event - "FrameChanged", "Redraw" or "Render".
(type=string)

clearIpo()

Unlink the ipo from this camera data object.

Returns:: True if there was an ipo linked or False otherwise.

clearScriptLinks(links=None)

Delete script links from this Camera. If no list is specified, all script links are deleted.

Parameters:: links - None (default) or a list of Blender Text names.
(type=list of strings)

getClipEnd()

Get the clip end value.

Returns:: float

getClipStart()

Get the clip start value.

Returns:: float

getDrawSize()

Get the draw size value.

Returns:: float

getIpo()

Get the Ipo associated with this camera data object, if any.

Returns:: the wrapped ipo or None.
(type=Ipo)

getLens()

Get the lens value.

Returns:: float

Warning: lens is only relevant for perspective (getType) cameras.

getMode()

Get this Camera's mode flags.

Returns:: OR'ed value: 'showLimits' is 1, 'showMist' is 2, or resp. 01 and 10 in binary.
(type=int)

getName()

Get the name of this Camera Data object.

Returns:: string

getScale()

Get the scale value.

Returns:: float

Warning: scale is only relevant for ortho (getType) cameras.

getScriptLinks(event)

Get a list with this Camera's script links of type 'event'.

Parameters:: event - "FrameChanged", "Redraw" or "Render".
(type=string)

Returns:: a list with Blender Text names (the script links of the given 'event' type) or None if there are no script links at all.
(type=list)

getType()

Get this Camera's type.

Returns:: 0 for 'persp' or 1 for 'ortho'.
(type=int)

insertIpoKey(keytype)

Inserts keytype values in camera ipo at curframe. Uses module constants.

Parameters:: keytype - -LENS -CLIPPING
(type=Integer)

Returns:: py_none

setClipEnd(clipend)

Set the clip end value.

Parameters:: clipend - The new clip end value.
(type=float)

setClipStart(clipstart)

Set the clip start value.

Parameters:: clipstart - The new lens value.
(type=float)

setDrawSize(drawsize)

Set the draw size value.

Parameters:: drawsize - The new draw size value.
(type=float)

setIpo(ipo)

Link an ipo to this camera data object.

Parameters:: ipo - a "camera data" ipo.
(type=Blender Ipo)

setLens(lens)

Set the lens value.

Parameters:: lens - The new lens value.
(type=float)

Warning: lens is only relevant for perspective (getType) cameras.

setMode(mode1=None, mode2=None)

Set this Camera's mode flags. Mode strings given are turned 'on'. Those not provided are turned 'off', so cam.setMode() -- without arguments -- turns off all mode flags for Camera cam.

Parameters:: mode1 - A mode flag: 'showLimits' or 'showMist'.
(type=string); mode2 - A mode flag: 'showLimits' or 'showMist'.
(type=string)

setName(name)

Set the name of this Camera Data object.

Parameters:: name - The new name.
(type=string)

setScale(scale)

Set the scale value.

Parameters:: scale - The new scale value in [0.01, 1000.00].
(type=float)

Warning: scale is only relevant for ortho (getType) cameras.

setType(type)

Set this Camera's type.

Parameters:: type - The Camera type: 'persp' or 'ortho'.
(type=string)

Class Variable Details

clipEnd

The clip end value in [1.0, 5000.0].

clipStart

The clip start value in [0.0, 100.0].

drawSize

The draw size value in [0.1, 10.0].

ipo

The "camera data" ipo linked to this camera data object.

Type:: Blender Ipo

lens

The lens value in [1.0, 250.0], only relevant to *persp* cameras.

mode

The mode flags: or'ed value: 'showLimits':1, 'showMist':2.

name

The Camera Data name.

scale

The scale value in [0.01, 1000.00], only relevant to *ortho* cameras.

type

The Camera type: 'persp':0 or 'ortho':1.

Generated by Epydoc 2.1 on Mon Jun 13 15:31:22 2005

http://epydoc.sf.net