Module Camera :: Class Camera
[frames | no frames]

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
Camera __copy__()
Make a copy of this camera
  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.

Instance Variable Summary
  alpha: The PassePart alpha [0.0, 1.0].
  angle: The lens value in degrees [7.323871, 172.847331], only relevant to *persp* cameras.
  clipEnd: The clip end value in [1.0, 5000.0].
  clipStart: The clip start value in [0.0, 100.0].
  dofDist: The dofDist value in [0.0, 5000.0].
  drawLimits: Toggle the option to show limits in the 3d view.
  drawMist: Toggle the option to show mist in the 3d view.
  drawName: Toggle the option to show the camera name in the 3d view.
  drawPassepartout: Toggle the option to show pass part out in the 3d view.
  drawSize: The display size for the camera an the 3d view [0.1, 10.0].
  drawTileSafe: Toggle the option to show tile safe in the 3d view.
bool fakeUser: When set to True, this datablock wont be removed, even if nothing is using it.
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.
string or None lib: path to the blend file this datablock is stored in (readonly).
  mode: The mode flags: ORed value: 'showLimits':1, 'showMist':2.
string name: unique name within each blend file.
IDGroup properties: Returns an IDGroup reference to this datablocks's ID Properties.
  scale: The scale value in [0.01, 1000.00], only relevant to *ortho* cameras.
  shiftX: The horizontal offset of the camera [-2.0, 2.0].
  shiftY: The vertical offset of the camera [-2.0, 2.0].
bool tag: A temporary tag that to flag data as being used within a loop.
  type: The Camera type: 'persp' or 'ortho'
int users: The number of users this datablock has.

Method Details

__copy__()

Make a copy of this camera
Returns:
a copy of this camera
           (type=Camera)

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. (deprecated) See the ipo attribute.
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. (deprecated) See the clipEnd attribute.
Returns:
float

getClipStart()

Get the clip start value. (deprecated) See the clipStart attribute.
Returns:
float

getDrawSize()

Get the draw size value. (deprecated) See the drawSize attribute.
Returns:
float

getIpo()

Get the Ipo associated with this camera data object, if any. (deprecated)
Returns:
the wrapped ipo or None. (deprecated) See the ipo attribute.
           (type=Ipo)

getLens()

Get the lens value. (deprecated) See the lens attribute.
Returns:
float

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

getMode()

Get this Camera's mode flags. (deprecated) See the mode attribute.
Returns:
OR'ed value: 'showLimits' is 1, 'showMist' is 2, or respectively, 01 and 10 in binary.
           (type=int)

getName()

Get the name of this Camera Data object. (deprecated) See the name attribute.
Returns:
string

getScale()

Get the scale value. (deprecated) See the scale attribute.
Returns:
float

Warning: scale is only relevant for ortho (type) 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. (deprecated) See the type attribute.
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. (deprecated) See the clipEnd attribute.
Parameters:
clipend - The new clip end value.
           (type=float)

setClipStart(clipstart)

Set the clip start value. (deprecated) See the clipStart attribute.
Parameters:
clipstart - The new lens value.
           (type=float)

setDrawSize(drawsize)

Set the draw size value. (deprecated) See the drawSize attribute.
Parameters:
drawsize - The new draw size value.
           (type=float)

setIpo(ipo)

Link an ipo to this camera data object. (deprecated) See the ipo attribute.
Parameters:
ipo - a "camera data" ipo.
           (type=Blender Ipo)

setLens(lens)

Set the lens value. (deprecated) See the lens attribute.
Parameters:
lens - The new lens value.
           (type=float)

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

setMode(mode1=None, mode2=None)

Set this Camera's mode flags. Mode strings given are turned 'on'. (deprecated) See the mode attribute. 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. (deprecated) See the name attribute.
Parameters:
name - The new name.
           (type=string)

setScale(scale)

Set the scale value. (deprecated) See the scale attribute.
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. (deprecated) See the type attribute.
Parameters:
type - The Camera type: 'persp' or 'ortho'.
           (type=string)

Instance Variable Details

alpha

The PassePart alpha [0.0, 1.0].

angle

The lens value in degrees [7.323871, 172.847331], only relevant to *persp* cameras.

clipEnd

The clip end value in [1.0, 5000.0].

clipStart

The clip start value in [0.0, 100.0].

dofDist

The dofDist value in [0.0, 5000.0].

drawLimits

Toggle the option to show limits in the 3d view.

drawMist

Toggle the option to show mist in the 3d view.

drawName

Toggle the option to show the camera name in the 3d view.

drawPassepartout

Toggle the option to show pass part out in the 3d view.

drawSize

The display size for the camera an the 3d view [0.1, 10.0].

drawTileSafe

Toggle the option to show tile safe in the 3d view.

fakeUser

When set to True, this datablock wont be removed, even if nothing is using it. All data has this disabled by default except for Actions.
Type:
bool

ipo

The "camera data" ipo linked to this camera data object. Set to None to clear the ipo.
Type:
Blender Ipo

lens

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

lib

path to the blend file this datablock is stored in (readonly).

lib will be None unless you are using external blend files with (File, Append/Link)

Note: the path may be relative, to get the full path use Blender.sys.expandpath
Type:
string or None

mode

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

name

unique name within each blend file.

The name is case sensitive and 21 characters maximum length.

Note: a blend file may have naming collisions when external library data is used, be sure to check the value of lib.

Note: Setting a value longer then 21 characters will be shortened
Type:
string

properties

Returns an IDGroup reference to this datablocks's ID Properties.
Type:
IDGroup

scale

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

shiftX

The horizontal offset of the camera [-2.0, 2.0].

shiftY

The vertical offset of the camera [-2.0, 2.0].

tag

A temporary tag that to flag data as being used within a loop. always set all tags to True or False before using since blender uses this flag for its own internal operations.
Type:
bool

type

The Camera type: 'persp' or 'ortho'

users

The number of users this datablock has. (readonly) Zero user datablocks are de-allocated after reloading and saving.
Type:
int

Generated by Epydoc 2.1 on Thu May 10 20:31:59 2007 http://epydoc.sf.net