Struct ParallelTimeline

pub struct ParallelTimeline(/* private fields */);

Kanzi animation system consists of animations and timelines:

• Animations define how to animate a property.
• Timelines map the animations to time and the objects you want to animate.

Parallel timeline allows you to group timelines which Kanzi plays at the same time. Use this timeline to organize collections of timelines and create a composition of timelines.

You can add child timelines to your parallel timeline by calling its addChild() function. You can also adjust the position of a child timeline, inside your parallel timeline, by setting the start time of the child timeline. A child timeline’s start and global time are defined in the content time space of a parallel timeline. You can clip a child timeline by giving it a negative start time and the portion before the zero time will be clipped.

You can not add a child timeline once a parellel timeline has started animating, that is, after the playback of the parallel timeline has been added to a timeline clock. Doing so will result in an undefined behavior.

Since a parallel timeline is a group of its child timelines, the content duration of parallel timeline is defined as the union of its child timeline’s durations, and is affected by their respective start times. For example, if you add a single timeline with a duration of 10 milliseconds and a start time of 5 milliseconds as a child to a parallel timeline, then the content duration of your parallel timeline would become 15 milliseconds.

Do note that a parallel timeline without any children has a 0 millisecond content duration.

Timeline properties affecting the playback, such as start time, repeat count, duration scale factor, direction behavior, clip start and clip duration, which are specified in parallel timeline, also affect its child timelines. For example, if direction behavior of parallel timeline is set to reverse, then all its child timelines are played in reverse manner, from the end to beginning. In this case, the time for child timelines will appear as going backwards.

Examples

To create a parallel timeline:

To play an animation regardless of the timeline type:

Implementations

impl ParallelTimeline

pub fn create1(domain: &Domain) -> Result<ParallelTimeline, Error>

Creates a parallel timeline.

Arguments

• domain - Domain.

Returns

Parallel timeline.

impl ParallelTimeline

pub fn create( domain: &Domain, anonymous: impl AsRef<KanziStr>, ) -> Result<ParallelTimeline, Error>

Creates a parallel timeline.

Arguments

• domain - Domain.

Returns

Parallel timeline.

Methods from Deref<Target = Object>

pub fn as_ptr(&self) -> *mut ObjectWrapper

pub fn as_wrapper(&self) -> &ObjectWrapper

pub fn as_object(&self) -> &Object

Represents any type inheriting from Object as &Object. This is useful for comparisions when PartialEq traits failed to compare objects of different types.

let child = screen.get_child(0)?;
let parent = child.get_parent()?.into_error(ErrorKind::ObjectNotFound)?;
// assert_eq!(screen, parent); // <- Fails to compile!
assert_eq!(screen.as_object(), parent.as_object());

pub fn get_native(&self) -> Result<NonNull<c_void>, Error>

Gets a pointer to the backing C++ instance.

pub fn is_stale(&self) -> bool

Checks whether the weak reference has expired.

pub fn get_property<T>( &self, property_type: &PropertyType<T>, ) -> Result<<T as VariantConstraint>::RetArg, Error>

where T: PropertyTypeConstraint,

Returns the current value of a property disregarding modifiers.

Base value is affected by the following inputs where the highest entry in the list determines the base value:

1. Local value set with setProperty or loaded from kzb
2. Value set by a style affecting the property.
3. Value defined by class metadata.

Modifiers are not applied, the highest-priority base value is returned.

If no inputs to the property value can be established the system returns the value default value from property type metadata.

Arguments

• property_type - The property type identifying the property to retrieve.

Returns

The evaluated property value.

pub fn get_optional_property<T>( &self, property_type: &PropertyType<T>, ) -> Result<Option<<T as VariantConstraint>::RetArg>, Error>

where T: PropertyTypeConstraint,

Returns the current value of a property disregarding modifiers, but does not default to the value in property metadata if there are no inputs to the property value.

If there is no value sources, None is returned.

If no inputs to the property value can be established the system returns the value default value from property type metadata.

Arguments

• property_type - The property type identifying the property to retrieve.

Returns

The evaluated property value.

pub fn set_property<T>( &self, property_type: &PropertyType<T>, value: <T as VariantConstraint>::DataArg<'_>, ) -> Result<(), Error>

where T: PropertyTypeConstraint,

Sets the local value of a property type.

pub fn has_value<T>( &self, property_type: &PropertyType<T>, ) -> Result<bool, Error>

where T: PropertyTypeConstraint,

Evaluates whether there are any inputs into the property value. Both value sources and modifiers are taken into account.

Returns

Returns true if there are inputs into the property value, false otherwise.

pub fn remove_local_value<T>( &self, property_type: &PropertyType<T>, ) -> Result<(), Error>

where T: PropertyTypeConstraint,

Removes the local value associated with the property.

pub fn get_metaclass(&self) -> Result<Metaclass, Error>

Returns the metaclass of the dynamic type of the object.

pub fn get_domain(&self) -> Result<Domain, Error>

Returns the domain the object belongs to.

pub fn set_flag_keep_during_patching<T>( &self, property_type: &PropertyType<T>, ) -> Result<(), Error>

where T: PropertyTypeConstraint,

Sets the flag to indicate that the property was loaded from KZB.

pub fn debug_string(&self) -> Result<String, Error>

Builds a string representation of the object intended for debugging purposes.

Trait Implementations

impl Clone for ParallelTimeline

fn clone(&self) -> ParallelTimeline

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl ConcreteObjectConstraint for ParallelTimeline

fn create_instance( domain: &Domain, name: impl AsRef<KanziStr>, ) -> Result<Self, Error>

impl Debug for ParallelTimeline

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Deref for ParallelTimeline

type Target = Timeline

The resulting type after dereferencing.

fn deref(&self) -> &<ParallelTimeline as Deref>::Target

Dereferences the value.

impl Inheritable for ParallelTimeline

unsafe fn downcast_unchecked<T>(self) -> T

where T: Inherits<Self>,

Downcast the object to a more specific type.

unsafe fn downcast_unchecked_ref<T>(&self) -> &T

where T: Inherits<Self>,

Downcast the object reference to a more specific type.

impl Inherits<Object> for ParallelTimeline

fn upcast(self) -> Base

fn upcast_ref(&self) -> &Base

impl Inherits<Timeline> for ParallelTimeline

fn upcast(self) -> Base

fn upcast_ref(&self) -> &Base

impl MetaclassConstraint for ParallelTimeline

fn get_static_metaclass() -> &'static Metaclass

Gets metaclass associated with a given type.

impl ObjectConstraint for ParallelTimeline

fn downcast<T>(self) -> Result<Option<T>, Error>

where T: MetaInherits<Self>,

Casts metaclass to a more specific type by value.

fn downcast_ref<T>(&self) -> Result<Option<&T>, Error>

where T: MetaInherits<Self>,

Casts metaclass to a more specific type by reference.

fn is_a<T>(&self) -> Result<bool, Error>

where T: MetaInherits<Self>,

Determines whether the class this metaclass describes derives from a class described by specified metaclass.

fn downgrade(self) -> Weak<Self>

fn downgrade_ref(&self) -> Weak<Self>

fn lock(self) -> ThreadObject<Self>

fn lock_ref(&self) -> ThreadObject<Self>

impl<T> PartialEq<T> for ParallelTimeline

where T: ObjectConstraint,

fn eq(&self, rhs: &T) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T> PartialEq<Weak<T>> for ParallelTimeline

where T: ObjectConstraint,

fn eq(&self, rhs: &Weak<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ParallelTimeline