---
title: "VideoClip"
description: "API documentation for VideoClip"
url: https://developer.disguise.one/python-api/docs/videoclip/
---

# VideoClip

Base class (inherits properties and methods): _[Resource](/python-api/docs/resource#resource)_

## Properties

#### **Video\_Input** : _[LogicalVideoInDevice](/python-api/docs/logicalvideoindevice#logicalvideoindevice)_

#### **acesExposure** : _float_

Input exposure transform (stops)

_Category: Colour Shift  
UserName: Input exposure_

#### **acesGamma** : _float_

Input gamma transform

_Category: Colour Shift  
UserName: Input gamma_

#### **acesTransform** : _[AcesInputTransformParameters](/python-api/docs/acesinputtransformparameters#acesinputtransformparameters)_

ACES Input transform (IDT)

_Category: Colour Shift  
UserName: Input transform_

#### **audioBiasSec** : _float_

If multi-channel audio files are not synchronised correctly, adjust this value to delay (-ve) or advance (+ve) audio relative to video

_Category: Audio  
UserName: Audio bias (s)_

#### **audioOuts** : _[AudioOutputs](/python-api/docs/audiooutputs#audiooutputs)_

set up the audio outputs used for each channel by creating a new AudioOut object, setting its outputs, and then sharing between all clips needing that configuration

_Category: Audio  
UserName: Audio outputs_

#### **audioTracks** : _List\[[AudioTrack](/python-api/docs/audiotrack#audiotrack)\]_

Additional audio tracks will play synchronously with the video clip, to logical audio outputs 0, 1, 2, etc

_Category: Audio  
UserName: Audio tracks_

#### **bilinear\_filtering** : _int_

Set to ‘on’ if the video file should be bilinear filtered when scaled; otherwise, uses point-samping

_Options: {0: ‘Off’, 1: ‘On’}  
Category: Filtering  
UserName: Bilinear filtering_

#### **bottom** : _int_

Amount to crop from the bottom edge of the video frame, in pixels

_Category: Cropping  
UserName: Crop bottom_

#### **clip** : _[Rect](/python-api/docs/rect#rect)_

#### **clip\_type** : _int_

Controls how the video file is scaled to fit the canvas size

_Options: {0: ‘Clip to canvas’, 1: ‘Fit into canvas’, 2: ‘Stretch to canvas’, 3: ‘Pixel-perfect’}  
Category: Cropping  
UserName: Clip type_

#### **colourProfile** : _[ColourProfile](/python-api/docs/colourprofile#colourprofile)_

Colour/Gamma space of the video clip

_Category: Colour Shift  
UserName: Colour profile_

#### **colourShift** : _[ColourShift](/python-api/docs/colourshift#colourshift)_

Colour parameters for video file

_Category: Colour Shift  
UserName: Colour shift_

#### **dataRate** : _float_ _(Read-Only)_

Data rate of the clip playback (MB/sec)

_UserName: Data rate (MB/sec)_

#### **enabledVersion** : _str_ _(Read-Only)_

The version of the latest enabled fragment, i.e. “1”, “2”, “3”, etc. or "" if there is no underlying video files currently associated with the clip

#### **end** : _int_

End frame index of the video clip. Use this to trim frames from the end of the clip

_Category: Edit  
UserName: Clip end_

#### **file** : _[VideoAsset](/python-api/docs/videoasset#videoasset)_

Select video asset

_Category: Versions  
UserName: Video asset_

#### **fileFps** : _float_ _(Read-Only)_

FPS of the original video

_UserName: Original FPS_

#### **fileFrameSize** : _[Vec2](/python-api/docs/vec2#vec2)_ _(Read-Only)_

Resolution of the original video file (pixels)

_UserName: Resolution_

#### **fileNFrames** : _int_ _(Read-Only)_

Number of frames in the original video file

_UserName: Number of frames_

#### **fps** : _float_

Current frames-per-second of the video clip

_Category: Edit  
UserName: FPS_

#### **frame\_blending** : _int_

Set to ‘on’ if the video file should be frame-blended for smoothness. Use this when playback frame-rate is different to original frame rate

_Options: {0: ‘Off’, 1: ‘On’, 2: ‘Auto’}  
Category: Filtering  
UserName: Frame blending_

#### **hasAudio** : _bool_ _(Read-Only)_

Whether the video has embedded audio or not

Will always return false if there is no underlying video files currently associated with the clip

#### **in\_** : _int_

Loop in-point of the video clip

_Category: Edit  
UserName: Loop in_

#### **isVideoIn** : _bool_ _(Read-Only)_

#### **left** : _int_

Amount to crop from the left edge of the video frame, in pixels

_Category: Cropping  
UserName: Crop left_

#### **logicalVideoIn** : _[LogicalVideoInDevice](/python-api/docs/logicalvideoindevice#logicalvideoindevice)_ _(Read-Only)_

#### **nBeats** : _float_

If quantised, the video file will play over this number of beats

_Category: Quantisation  
UserName: Beats_

#### **ocioShaderProperties** : _[OcioShaderProperties](/python-api/docs/ocioshaderproperties#ocioshaderproperties)_

Available OCIO transform parameters for a given colour space.

_Category: Colour Shift  
UserName: OCIO transform properties_

#### **ocioTransform** : _[OcioColourSpace](/python-api/docs/ociocolourspace#ociocolourspace)_

OCIO colour space of the clip

_Category: Colour Shift  
UserName: Input transform_

#### **out** : _int_

Loop out-point of the video clip

_Category: Edit  
UserName: Loop out_

#### **prefetchOptions** : _[PrefetchLookaheads](/python-api/docs/prefetchlookaheads#prefetchlookaheads)_

Advanced : edit these settings if the clip isn’t playing well. Usually only required for very large clips

_Category: Prefetch  
UserName: Prefetch options_

#### **proxyInfo** : _str_ _(Read-Only)_

The proxy level of the latest enabled fragment, i.e. “Full”, “1/16”, “1/8”, etc. or "" if there is no underlying video files currently associated with the clip

#### **quantised** : _int_

If set to ‘yes’, the video file will play over a specified number of beats, rather than at defined frame rate

_Options: {0: ‘No’, 1: ‘Yes’}  
Category: Quantisation  
UserName: Quantised_

#### **right** : _int_

Amount to crop from the right edge of the video frame, in pixels

_Category: Cropping  
UserName: Crop right_

#### **sampleRateOption** : _int_

_Options: {0: ‘44.1’, 1: ‘48’}  
Category: Versions_

#### **speed** : _float_

_Category: Versions  
UserName: Speed_

#### **start** : _int_

Start frame index of the video clip. Use this to trim frames from the start of the clip

_Category: Edit  
UserName: Clip start_

#### **top** : _int_

Amount to crop from the top edge of the video frame, in pixels

_Category: Cropping  
UserName: Crop top_

#### **transportDuration** : _[Timecode](/python-api/docs/timecode#timecode)_ _(Read-Only)_

#### **video\_file** : _[VideoAsset](/python-api/docs/videoasset#videoasset)_

Select video asset

_Category: Versions  
UserName: Video asset_

#### **zoom** : _[Vec2](/python-api/docs/vec2#vec2)_

The point of interest zoomed in towards when the content is scaled

_Category: Cropping  
UserName: Zoom point_

#### **zoom\_point** : _[Vec2](/python-api/docs/vec2#vec2)_

## Static Methods

#### **consolidateAllClips**()

#### **createVideoInClip**(name: _str_, videoIn: _[LogicalVideoInDevice](/python-api/docs/logicalvideoindevice#logicalvideoindevice)_) -> _[VideoClip](/python-api/docs/videoclip#videoclip)_