unreal.MovieSceneScriptingFloatChannel

class unreal.MovieSceneScriptingFloatChannel(outer: Object | None = None, name: Name | str = 'None')

Bases: MovieSceneScriptingChannel

Movie Scene Scripting Float Channel

C++ Source:

  • Plugin: SequencerScripting

  • Module: SequencerScripting

  • File: MovieSceneScriptingFloat.h

Editor Properties: (see get_editor_property/set_editor_property)

  • channel_name (Name): [Read-Write]

add_key(time, new_value, sub_frame=0.000000, time_unit=MovieSceneTimeUnit.DISPLAY_RATE, interpolation=MovieSceneKeyInterpolation.AUTO) → MovieSceneScriptingFloatKey

Add a key to this channel. This initializes a new key and returns a reference to it.

Parameters:

  • time (FrameNumber) – The frame this key should go on. Respects TimeUnit to determine if it is a display rate frame or a tick resolution frame.

  • new_value (float) – The value that this key should be created with.

  • sub_frame (float) – Optional [0-1) clamped sub-frame to put this key on. Ignored if TimeUnit is set to Tick Resolution.

  • time_unit (MovieSceneTimeUnit) – Is the specified InTime in Display Rate frames or Tick Resolution.

  • interpolation (MovieSceneKeyInterpolation) – Interpolation method the key should use.

Returns:

The key that was created with the specified values at the specified time.

Return type:

MovieSceneScriptingFloatKey

compute_effective_range() → SequencerScriptingRange

Compute the effective range of this channel, for example, the extents of its key times

Returns:

A range that represents the greatest range of times occupied by this channel, in the sequence’s frame resolution

Return type:

SequencerScriptingRange

evaluate_keys(range, frame_rate) → Array[float]

Gets baked keys in this channel.

Parameters:
Returns:

An array of float’s contained by this channel. Returns baked keys in the specified range.

Return type:

Array[float]

get_default() → float

Get this channel’s default value that will be used when no keys are present. Only a valid value when HasDefault() returns true.

Return type:

float

get_keys() → Array[MovieSceneScriptingKey]

Gets all of the keys in this channel.

Returns:

An array of UMovieSceneScriptingFloatKey’s contained by this channel. Returns all keys even if clipped by the owning section’s boundaries or outside of the current sequence play range.

Return type:

Array[MovieSceneScriptingKey]

get_keys_by_index(indices) → Array[MovieSceneScriptingKey]

Gets the keys in this channel specified by the specific index Indices: The indices from which to get the keys from

Parameters:

indices (Array[int32]) –

Returns:

An array of UMovieSceneScriptingKey’s contained by this channel. Returns all keys specified by the indices, even if out of range.

Return type:

Array[MovieSceneScriptingKey]

get_num_keys() → int32

Returns number of keys in this channel.

Return type:

int32

get_post_infinity_extrapolation() → RichCurveExtrapolation
Returns:

Gets the Post-infinity extrapolation state. See ERichCurveExtrapolation for more detail.

Return type:

RichCurveExtrapolation

get_pre_infinity_extrapolation() → RichCurveExtrapolation
Returns:

Gets the Pre-infinity extrapolation state. See ERichCurveExtrapolation for more detail.

Return type:

RichCurveExtrapolation

has_default() → bool
Returns:

Does this channel have a default value set?

Return type:

bool

remove_default() → None

Remove this channel’s default value causing the channel to have no effect where no keys are present

remove_key(key) → None

Removes the specified key. Does nothing if the key is not specified or the key belongs to another channel.

Parameters:

key (MovieSceneScriptingKey) –

set_default(default_value) → None

Set this channel’s default value that should be used when no keys are present. Sets bHasDefaultValue to true automatically.

Parameters:

default_value (float) –

set_post_infinity_extrapolation(extrapolation) → None

Sets the Post-infinity extrapolation state. See ERichCurveExtrapolation for more detail.

Parameters:

extrapolation (RichCurveExtrapolation) – The new extrapolation mode this key should use for evaluating after this key.

set_pre_infinity_extrapolation(extrapolation) → None

Sets the Pre-infinity extrapolation state. See ERichCurveExtrapolation for more detail.

Parameters:

extrapolation (RichCurveExtrapolation) – The new extrapolation mode this key should use for evaluating before this key.