timeline_new

anim_keyframe.timeline_new() → int

Create a new timeline.

Is only possible if the previous (if exists) timeline does not completely span the available keyframes

Examples:

#
# turn on keyframing and create 4 keyframes 
#
ensight.anim_keyframe.keyframing("ON")
ensight.anim_keyframe.create_keyframe()
ensight.anim_keyframe.create_keyframe()
ensight.anim_keyframe.create_keyframe()
ensight.anim_keyframe.create_keyframe()
#
# transient data (and timelines) will be used during the animation
#
ensight.anim_keyframe.use_transient_data("ON")
#
# 
ensight.anim_keyframe.timeline_select(1)
#
# the first timeline goes from keyframe 2 to 3 (i.e, no transient
# data is used for keyframe 1 to 2)
#
ensight.anim_keyframe.timeline_start_keyframe(2)
ensight.anim_keyframe.timeline_end_keyframe(3)
#
# At keyframe 2 the "Begin" (as defined in the solution time dialog)
# time is used.  At keyframe 3 the "End" time is used.
#
ensight.anim_keyframe.timeline_start_type("use_begin")
ensight.anim_keyframe.timeline_end_type("use_end")
#
# Create a new timeline and select it for editing
#
ensight.anim_keyframe.timeline_new()
ensight.anim_keyframe.timeline_select(2)
#
# This timeline goes from keyframe 3 to 4
#
ensight.anim_keyframe.timeline_start_keyframe(3)
ensight.anim_keyframe.timeline_end_keyframe(4)
#
# At keyframe 3 the current time will be used (which will
# be the "End" time since the first timeline ends with this time
# We do not specify the time at keyframe 4 but rather increment time
# by 1.4 unit for each frame.  If we arrive at the begin/end time we will
# "swing"
#
ensight.anim_keyframe.timeline_start_type("use_current")
ensight.anim_keyframe.timeline_specify_incr("ON")
ensight.anim_keyframe.timeline_time_increment(1.4)
ensight.anim_keyframe.timeline_arrive_type("swing")

Returns:

zero on success, non-zero on error