user: Give a detailed overview of StripsTopLevel(bpy_struct): syntax, arguments, return values, common patterns.

assistant: # StripsTopLevel(bpy_struct)

base class — [`bpy_struct`](bpy.types.bpy_struct.html#bpy.types.bpy_struct "bpy.types.bpy_struct")

*class* bpy.types.StripsTopLevel(*bpy_struct*)
:   Collection of Strips

    new_clip(*name*, *clip*, *channel*, *frame_start*)
    :   Add a new movie clip strip

        Parameters:
        :   - **name** (*string**,* *(**never None**)*) – Name for the new strip
            - **clip** ([`MovieClip`](bpy.types.MovieClip.html#bpy.types.MovieClip "bpy.types.MovieClip"), (never None)) – Movie clip to add
            - **channel** (*int in* *[**1**,* *128**]*) – Channel, The channel for the new strip
            - **frame_start** (*int in* *[**-1048574**,* *1048574**]*) – The start frame for the new strip

        Returns:
        :   New Strip

        Return type:
        :   [`Strip`](bpy.types.Strip.html#bpy.types.Strip "bpy.types.Strip")

    new_mask(*name*, *mask*, *channel*, *frame_start*)
    :   Add a new mask strip

        Parameters:
        :   - **name** (*string**,* *(**never None**)*) – Name for the new strip
            - **mask** ([`Mask`](bpy.types.Mask.html#bpy.types.Mask "bpy.types.Mask"), (never None)) – Mask to add
            - **channel** (*int in* *[**1**,* *128**]*) – Channel, The channel for the new strip
            - **frame_start** (*int in* *[**-1048574**,* *1048574**]*) – The start frame for the new strip

        Returns:
        :   New Strip

        Return type:
        :   [`Strip`](bpy.types.Strip.html#bpy.types.Strip "bpy.types.Strip")

    new_scene(*name*, *scene*, *channel*, *frame_start*)
    :   Add a new scene strip

        Parameters:
        :   - **name** (*string**,* *(**never None**)*) – Name for the new strip
            - **scene** ([`Scene`](bpy.types.Scene.html#bpy.types.Scene "bpy.types.Scene"), (never None)) – Scene to add
            - **channel** (*int in* *[**1**,* *128**]*) – Channel, The channel for the new strip
            - **frame_start** (*int in* *[**-1048574**,* *1048574**]*) – The start frame for the new strip

        Returns:
        :   New Strip

        Return type:
        :   [`Strip`](bpy.types.Strip.html#bpy.types.Strip "bpy.types.Strip")

    new_image(*name*, *filepath*, *channel*, *frame_start*, *\**, *fit_method='ORIGINAL'*)
    :   Add a new image strip

        Parameters:
        :   - **name** (*string**,* *(**never None**)*) – Name for the new strip
            - **filepath** (*string**,* *(**never None**)*) – Filepath to image
            - **channel** (*int in* *[**1**,* *128**]*) – Channel, The channel for the new strip
            - **frame_start** (*int in* *[**-1048574**,* *1048574**]*) – The start frame for the new strip
            - **fit_method** (enum in [Strip Scale Method Items](bpy_types_enum_items/strip_scale_method_items.html#rna-enum-strip-scale-method-items), (optional)) – Image Fit Method

        Returns:
        :   New Strip

        Return type:
        :   [`Strip`](bpy.types.Strip.html#bpy.types.Strip "bpy.types.Strip")

    new_movie(*name*, *filepath*, *channel*, *frame_start*, *\**, *fit_method='ORIGINAL'*)
    :   Add a new movie strip

        Parameters:
        :   - **name** (*string**,* *(**never None**)*) – Name for the new strip
            - **filepath** (*string**,* *(**never None**)*) – Filepath to movie
            - **channel** (*int in* *[**1**,* *128**]*) – Channel, The channel for the new strip
            - **frame_start** (*int in* *[**-1048574**,* *1048574**]*) – The start frame for the new strip
            - **fit_method** (enum in [Strip Scale Method Items](bpy_types_enum_items/strip_scale_method_items.html#rna-enum-strip-scale-method-items), (optional)) – Image Fit Method

        Returns:
        :   New Strip

        Return type:
        :   [`Strip`](bpy.types.Strip.html#bpy.types.Strip "bpy.types.Strip")

    new_sound(*name*, *filepath*, *channel*, *frame_start*)
    :   Add a new sound strip

        Parameters:
        :   - **name** (*string**,* *(**never None**)*) – Name for the new strip
            - **filepath** (*string**,* *(**never None**)*) – Filepath to movie
            - **channel** (*int in* *[**1**,* *128**]*) – Channel, The channel for the new strip
            - **frame_start** (*int in* *[**-1048574**,* *1048574**]*) – The start frame for the new strip

        Returns:
        :   New Strip

        Return type:
        :   [`Strip`](bpy.types.Strip.html#bpy.types.Strip "bpy.types.Strip")

    new_meta(*name*, *channel*, *frame_start*)
    :   Add a new meta strip

        Parameters:
        :   - **name** (*string**,* *(**never None**)*) – Name for the new strip
            - **channel** (*int in* *[**1**,* *128**]*) – Channel, The channel for the new strip
            - **frame_start** (*int in* *[**-1048574**,* *1048574**]*) – The start frame for the new strip

        Returns:
        :   New Strip

        Return type:
        :   [`Strip`](bpy.types.Strip.html#bpy.types.Strip "bpy.types.Strip")

    new_effect(*name*, *type*, *channel*, *frame_start*, *\**, *length=0*, *input1=None*, *input2=None*)
    :   Add a new effect strip

        Parameters:
        :   - **name** (*string**,* *(**never None**)*) – Name for the new strip
            - **type** (enum in [`'CROSS'`, `'ADD'`, `'SUBTRACT'`, `'ALPHA_OVER'`, `'ALPHA_UNDER'`, `'GAMMA_CROSS'`, `'MULTIPLY'`, `'WIPE'`, `'GLOW'`, `'COLOR'`, `'SPEED'`, `'MULTICAM'`, `'ADJUSTMENT'`, `'GAUSSIAN_BLUR'`, `'TEXT'`, `'COLORMIX'`]) –

              Type, type for the new strip

              - `CROSS`
                Crossfade – Fade out of one video, fading into another.
              - `ADD`
                Add – Add together color channels from two videos.
              - `SUBTRACT`
                Subtract – Subtract one strip’s color from another.
              - `ALPHA_OVER`
                Alpha Over – Blend alpha on top of another video.
              - `ALPHA_UNDER`
                Alpha Under – Blend alpha below another video.
              - `GAMMA_CROSS`
                Gamma Crossfade – Crossfade with color correction.
              - `MULTIPLY`
                Multiply – Multiply color channels from two videos.
              - `WIPE`
                Wipe – Sweep a transition line across the frame.
              - `GLOW`
                Glow – Add blur and brightness to light areas.
              - `COLOR`
                Color – Add a simple color strip.
              - `SPEED`
                Speed – Timewarp video strips, modifying playback speed.
              - `MULTICAM`
                Multicam Selector – Control active camera angles.
              - `ADJUSTMENT`
                Adjustment Layer – Apply nondestructive effects.
              - `GAUSSIAN_BLUR`
                Gaussian Blur – Soften details along axes.
              - `TEXT`
                Text – Add a simple text strip.
              - `COLORMIX`
                Color Mix – Combine two strips using blend modes.
            - **channel** (*int in* *[**1**,* *128**]*) – Channel, The channel for the new strip
            - **frame_start** (*int in* *[**-inf**,* *inf**]*) – The start frame for the new strip
            - **length** (*int in* *[**-inf**,* *inf**]**,* *(**optional**)*) – Length of the strip in frames, or the length of each strip if multiple are added
            - **input1** ([`Strip`](bpy.types.Strip.html#bpy.types.Strip "bpy.types.Strip"), (optional)) – First input strip for effect
            - **input2** ([`Strip`](bpy.types.Strip.html#bpy.types.Strip "bpy.types.Strip"), (optional)) – Second input strip for effect

        Returns:
        :   New Strip

        Return type:
        :   [`Strip`](bpy.types.Strip.html#bpy.types.Strip "bpy.types.Strip")

    remove(*sequence*)
    :   Remove a Strip

        Parameters:
        :   **sequence** ([`Strip`](bpy.types.Strip.html#bpy.types.Strip "bpy.types.Strip"), (never None)) – Strip to remove

    *classmethod* bl_rna_get_subclass(*id*, *default=None*, */*)
    :   Parameters:
        :   **id** (*str*) – The RNA type identifier.

        Returns:
        :   The RNA type or default when not found.

        Return type:
        :   [`bpy.types.Struct`](bpy.types.Struct.html#bpy.types.Struct "bpy.types.Struct") subclass

    *classmethod* bl_rna_get_subclass_py(*id*, *default=None*, */*)
    :   Parameters:
        :   **id** (*str*) – The RNA type identifier.

        Returns:
        :   The class or default when not found.

        Return type:
        :   type