TimedValueControlSource

class TimedValueControlSource(**properties: Any)

Superclasses: ControlSource, Object, InitiallyUnowned, Object

Subclasses: InterpolationControlSource, TriggerControlSource

Base class for ControlSource that use time-stamped values.

When overriding bind, chain up first to give this bind implementation a chance to setup things.

All functions are MT-safe.

Methods

class TimedValueControlSource
find_control_point_iter(timestamp: int) SequenceIter | None

Find last value before given timestamp in control point list. If all values in the control point list come after the given timestamp or no values exist, None is returned.

For use in control source implementations.

Parameters:

timestamp – the search key

get_all() list[TimedValue]

Returns a read-only copy of the list of TimedValue for the given property. Free the list after done with it.

get_count() int

Get the number of control points that are set.

set(timestamp: int, value: float) bool

Set the value of given controller-handled property at a certain time.

Parameters:
  • timestamp – the time the control-change is scheduled for

  • value – the control-value

set_from_list(timedvalues: list[TimedValue]) bool

Sets multiple timed values at once.

Parameters:

timedvalues – a list with TimedValue items

unset(timestamp: int) bool

Used to remove the value of given controller-handled property at a certain time.

Parameters:

timestamp – the time the control-change should be removed from

unset_all() None

Used to remove all time-stamped values of given controller-handled property

Signals

class TimedValueControlSource.signals
value_added(timed_value: ControlPoint) None

Emitted right after the new value has been added to self

Added in version 1.6.

Parameters:

timed_value – The newly added TimedValue

value_changed(timed_value: ControlPoint) None

Emitted right after the new value has been set on timed_signals

Added in version 1.6.

Parameters:

timed_value – The TimedValue where the value changed

value_removed(timed_value: ControlPoint) None

Emitted when timed_value is removed from self

Added in version 1.6.

Parameters:

timed_value – The removed TimedValue

Fields

class TimedValueControlSource
lock
nvalues
parent
priv
valid_cache
values