Strip(bpy_struct)

base class — bpy_struct

subclasses — EffectStrip, ImageStrip, MaskStrip, MetaStrip, MovieClipStrip, MovieStrip, SceneStrip, SoundStrip

class bpy.types.Strip(bpy_struct)

A single container for content in the Video Sequence Editor

blend_alpha

Percentage of how much the strip’s colors affect other strips (in [0, 1], default 1.0)

Type:

float

blend_type

Method for controlling how the strip combines with other strips (default 'ALPHA_OVER')

Type:

Literal[‘REPLACE’, ‘CROSS’, ‘DARKEN’, ‘MULTIPLY’, ‘BURN’, ‘LINEAR_BURN’, ‘LIGHTEN’, ‘SCREEN’, ‘DODGE’, ‘ADD’, ‘OVERLAY’, ‘SOFT_LIGHT’, ‘HARD_LIGHT’, ‘VIVID_LIGHT’, ‘LINEAR_LIGHT’, ‘PIN_LIGHT’, ‘DIFFERENCE’, ‘EXCLUSION’, ‘SUBTRACT’, ‘HUE’, ‘SATURATION’, ‘COLOR’, ‘VALUE’, ‘ALPHA_OVER’, ‘ALPHA_UNDER’, ‘GAMMA_CROSS’]

channel

Vertical position of the strip (in [1, 128], default 0)

Type:

int

color_tag

Color tag for a strip (default 'COLOR_01')

Type:

Literal[Strip Color Items]

content_duration

Length of the underlying strip source in frames, excluding handles (in [1, 1048574], default 0, readonly)

Type:

int

content_end

Timeline frame where underlying strip source ends (in [-inf, inf], default 0, readonly)

Type:

int

content_start

Timeline frame where underlying strip source begins (in [-inf, inf], default 0.0)

Type:

float

duration

Length of the strip in frames from left handle to right handle (in [-inf, inf], default 0)

Type:

int

effect_fader

Custom fade value (in [0, 1], default 0.0)

Type:

float

frame_duration

The length of the contents of this strip before the handles are applied (in [1, 1048574], default 0, readonly)

Deprecated since version 5.10: removal planned in version 6.0

Replaced by ‘.content_duration’.

Type:

int

frame_final_duration

The length of the contents of this strip after the handles are applied (in [-inf, inf], default 0)

Deprecated since version 5.10: removal planned in version 6.0

Replaced by ‘.duration’.

Type:

int

frame_final_end

End frame displayed in the sequence editor after offsets are applied (in [-inf, inf], default 0)

Deprecated since version 5.10: removal planned in version 6.0

Replaced by ‘.right_handle’.

Type:

int

frame_final_start

Start frame displayed in the sequence editor after offsets are applied, setting this is equivalent to moving the handle, not the actual start frame (in [-inf, inf], default 0)

Deprecated since version 5.10: removal planned in version 6.0

Replaced by ‘.left_handle’.

Type:

int

frame_offset_end

Offset from the end of the strip in frames (in [-inf, inf], default 0.0)

Deprecated since version 5.10: removal planned in version 6.0

Replaced by ‘.right_handle_offset’.

Type:

float

frame_offset_start

Offset from the start of the strip in frames (in [-inf, inf], default 0.0)

Deprecated since version 5.10: removal planned in version 6.0

Replaced by ‘.left_handle_offset’.

Type:

float

frame_start

X position where the strip begins (in [-inf, inf], default 0.0)

Deprecated since version 5.10: removal planned in version 6.0

Replaced by ‘.content_start’.

Type:

float

left_handle

Timeline frame of the left handle and the start frame of the strip (in [-inf, inf], default 0)

Type:

int

left_handle_offset

Rightward frame offset of the left handle from the start of the strip content (in [-inf, inf], default 0.0)

Type:

float

lock

Lock strip so that it cannot be transformed (default False)

Type:

bool

modifiers

Modifiers affecting this strip (default None, readonly)

Type:

StripModifiers[StripModifier]

mute

Disable strip so that it does not contribute any output (default False)

Type:

bool

name

(default “”, never None)

Type:

str

right_handle

Timeline frame of the right handle, which is the first frame where the strip no longer contributes to the output (in [-inf, inf], default 0)

Type:

int

right_handle_offset

Leftward frame offset of the right handle from the end of the strip content (in [-inf, inf], default 0.0)

Type:

float

select

Whether the strip is selected (default False)

Type:

bool

select_left_handle

Whether the left handle is selected (default False)

Type:

bool

select_right_handle

Whether the right handle is selected (default False)

Type:

bool

show_retiming_keys

Show retiming keys, so they can be moved (default False)

Type:

bool

type

(default 'IMAGE', readonly)

Type:

Literal[‘IMAGE’, ‘META’, ‘SCENE’, ‘MOVIE’, ‘MOVIECLIP’, ‘MASK’, ‘SOUND’, ‘CROSS’, ‘ADD’, ‘SUBTRACT’, ‘ALPHA_OVER’, ‘ALPHA_UNDER’, ‘GAMMA_CROSS’, ‘MULTIPLY’, ‘WIPE’, ‘GLOW’, ‘COLOR’, ‘SPEED’, ‘MULTICAM’, ‘ADJUSTMENT’, ‘GAUSSIAN_BLUR’, ‘TEXT’, ‘COLORMIX’]

use_default_fade

Fade effect using the built-in default (usually makes the transition as long as the effect strip) (default False)

Type:

bool

use_linear_modifiers

Calculate modifiers in linear space instead of sequencer’s space (default False)

Type:

bool

bl_system_properties_get(*, do_create=False)

DEBUG ONLY. Internal access to runtime-defined RNA data storage, intended solely for testing and debugging purposes. Do not access it in regular scripting work, and in particular, do not assume that it contains writable data

Parameters:

do_create (bool) – Ensure that system properties are created if they do not exist yet (optional)

Returns:

The system properties root container, or None if there are no system properties stored in this data yet, and its creation was not requested

Return type:

PropertyGroup

strip_elem_from_frame(frame)

Return the strip element from a given frame or None

Parameters:

frame (int) – Frame, The frame to get the strip element from (in [-1048574, 1048574])

Returns:

strip element of the current frame

Return type:

StripElement

swap(other)

Swap the position of this strip with another

Parameters:

other (Strip) – Other, Other strip to swap with (never None)

move_to_meta(meta_sequence)

Move this strip into a meta Strip

Parameters:

meta_sequence (Strip) – Destination Meta Strip, Meta to move the strip into (never None)

parent_meta()

Returns parent meta Strip

Returns:

Parent meta strip

Return type:

Strip

invalidate_cache(type)

Invalidate cached images for strip and all dependent strips

Parameters:

type (Literal['RAW', 'COMPOSITE']) – Type, Cache Type (never None)

split(frame, split_method, *, ignore_connections=False)

Split Strip

Parameters:

  • frame (int) – Frame where to split the strip (in [-inf, inf])

  • split_method (Literal['SOFT', 'HARD']) – (never None)

  • ignore_connections (bool) – Don’t propagate split to connected strips (optional)

Returns:

Right side Strip

Return type:

Strip

classmethod bl_rna_get_subclass(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (bpy.types.Struct | None) – The value to return when not found.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct

classmethod bl_rna_get_subclass_py(id, default=None, /)
Parameters:

  • id (str) – The RNA type identifier.

  • default (type | None) – The value to return when not found.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties

Inherited Functions

References