blendersynth.blender.bsyn_object
Base class for all BlenderSynth objects.
- class blendersynth.blender.bsyn_object.BsynObject[source]
Generic class for BlenderSynth objects.
Assigned an .obj (eg bpy.types.Mesh for a Mesh) which is the main Blender object it represents.
- animate_path(frames=(0, 250), fracs=(0, 1))[source]
Animate object along path.
- Parameters:
frames (
tuple
) – tuple of keyframes to animate at - length Nfracs (
tuple
) – tuple of fractions along path to animate at - length N
- property axes: ndarray
Return 3x3 rotation matrix (normalized) to represent axes
- follow_path(path, zero=True, animate=True, frames=(0, 250), fracs=(0, 1))[source]
Follow path, with optional animation setting.
- Parameters:
path (
Curve
) – Curve objectzero (
bool
) – If True, set camera location to (0, 0, 0) [aligns camera with path]animate (
bool
) – If True, animate camera along pathframes (
tuple
) – tuple of keyframes to animate at - length Nfracs (
tuple
) – tuple of fractions along path to animate at - length N
- property location: mathutils.Vector
Location of object
- property matrix_world
Return world matrix of object(s).
- path_keyframe(frame, offset)[source]
Set keyframe for camera path offset
- Parameters:
frame (
int
) – Frame numberoffset (
float
) – Offset fraction (0-1)
- render_visibility(value, frame=None)
Show/hide object in render
- Parameters:
value (
bool
) – True to show, False to hideframe (
int
) – Optional frame for animating
- rotate_by(rotation)[source]
Add a rotation to the object. Must be in XYZ order, euler angles, radians.
- property rotation_euler: mathutils.Euler
Rotation in euler XYZ angles
- set_dimensions(dimensions, frame=None)
Set dimensions of object.
- Parameters:
dimensions (
VectorLikeOrScalar
) – Dimensions to set. Either single value or 3 long vectorframe (
int
) – Optional frame for animating
- set_location(location, frame=None)
Set location of object.
- Parameters:
location (
VectorLike
) – Location vector to setframe (
int
) – Optional frame for animating
- set_rotation_euler(rotation, frame=None)
Set euler rotation of object.
- Parameters:
rotation (
VectorLike
) – Rotation vectorframe (
int
) – Optional frame for animating
- set_scale(scale, frame=None)
Set scale of object.
- Parameters:
scale (
VectorLikeOrScalar
) – Scale to set. Either single value or 3 long vectorframe (
int
) – Optional frame for animating
- track_to(obj)[source]
Track to object.
- Parameters:
obj (
Union
[BsynObject
,Object
]) – BsynObject or Blender Object to track to
- viewport_visibility(value, frame=None)
Show/hide object in viewport
- Parameters:
value (
bool
) – True to show, False to hideframe (
int
) – Optional frame for animating