# MovieClip(ID)

base classes — `bpy_struct`, `ID`

class `bpy.types.``MovieClip`(ID)

  MovieClip data-block referencing an external movie file

  `animation_data`

    Animation data for this data-block

    Type: | `AnimData`, (readonly)

  `colorspace_settings`

    Input color space settings

    Type: | `ColorManagedInputColorspaceSettings`, (readonly)

  `display_aspect`

    Display Aspect for this clip, does not affect rendering

    Type: | float array of 2 items in [0.1, inf], default (0.0, 0.0)

  `filepath`

    Filename of the movie or sequence file

    Type: | string, default “”, (never None)

  `fps`

    Detected frame rate of the movie clip in frames per second

    Type: | float in [-inf, inf], default 0.0, (readonly)

  `frame_duration`

    Detected duration of movie clip in frames

    Type: | int in [-inf, inf], default 0, (readonly)

  `frame_offset`

    Offset of footage first frame relative to it’s file name (affects only how footage is loading, does not change data associated with a clip)

    Type: | int in [-inf, inf], default 0

  `frame_start`

    Global scene frame number at which this movie starts playing (affects all data associated with a clip)

    Type: | int in [-inf, inf], default 0

  `grease_pencil`

    Grease pencil data for this movie clip

    Type: | `GreasePencil`

  `proxy`

    Type: | `MovieClipProxy`, (readonly)

  `size`

    Width and height in pixels, zero when image data cant be loaded

    Type: | int array of 2 items in [-inf, inf], default (0, 0), (readonly)

  `source`

    Where the clip comes from

    - `SEQUENCE` Image Sequence, Multiple image files, as a sequence.
    - `MOVIE` Movie File, Movie file.

    Type: | enum in [‘SEQUENCE’, ‘MOVIE’], default ‘SEQUENCE’, (readonly)

  `tracking`

    Type: | `MovieTracking`, (readonly)

  `use_proxy`

    Use a preview proxy and/or timecode index for this clip

    Type: | boolean, default False

  `use_proxy_custom_directory`

    Create proxy images in a custom directory (default is movie location)

    Type: | boolean, default False

  `metadata`()

    Retrieve metadata of the movie file

    Returns: | Dict-like object containing the metadata
    Return type: | `IDPropertyWrapPtr`

  classmethod `bl_rna_get_subclass`(id, default=None)

    Parameters: | id (string) – The RNA type identifier.
    Returns: | The RNA type or default when not found.
    Return type: | `bpy.types.Struct` subclass

  classmethod `bl_rna_get_subclass_py`(id, default=None)

    Parameters: | id (string) – The RNA type identifier.
    Returns: | The class or default when not found.
    Return type: | type

Inherited Properties

`bpy_struct.id_data` `ID.name` `ID.name_full` `ID.is_evaluated` `ID.original` `ID.users` | `ID.use_fake_user` `ID.tag` `ID.is_library_indirect` `ID.library` `ID.override_library` `ID.preview`

Inherited Functions

`bpy_struct.as_pointer` `bpy_struct.driver_add` `bpy_struct.driver_remove` `bpy_struct.get` `bpy_struct.is_property_hidden` `bpy_struct.is_property_overridable_library` `bpy_struct.is_property_readonly` `bpy_struct.is_property_set` `bpy_struct.items` `bpy_struct.keyframe_delete` `bpy_struct.keyframe_insert` `bpy_struct.keys` `bpy_struct.path_from_id` `bpy_struct.path_resolve` `bpy_struct.pop` | `bpy_struct.property_overridable_library_set` `bpy_struct.property_unset` `bpy_struct.type_recast` `bpy_struct.values` `ID.evaluated_get` `ID.copy` `ID.override_create` `ID.user_clear` `ID.user_remap` `ID.make_local` `ID.user_of_id` `ID.animation_data_create` `ID.animation_data_clear` `ID.update_tag`

References

`bpy.context.edit_movieclip` `BlendData.movieclips` `BlendDataMovieClips.load` `BlendDataMovieClips.remove` `CameraBackgroundImage.clip` `CameraSolverConstraint.clip` `CompositorNodeKeyingScreen.clip` `CompositorNodeMovieClip.clip` `CompositorNodeMovieDistortion.clip` | `CompositorNodePlaneTrackDeform.clip` `CompositorNodeStabilize.clip` `CompositorNodeTrackPos.clip` `FollowTrackConstraint.clip` `ObjectSolverConstraint.clip` `Scene.active_clip` `Sequences.new_clip` `SpaceClipEditor.clip`