Clip properties
From Avisynth wiki
Revision as of 21:11, 12 March 2016 by Raffriff42 (Talk | contribs)
You can access a variety of clip properties in AviSynth scripts. For example, if the variable clip holds a video clip, then clip.height is its height in pixels, clip.framecount is its length in frames, and so on. Clip properties can be manipulated just like script variables, except that they are read-only (in C terminology, they cannot be L-values).
The full list of properties:
- int clip.Width
- Returns the width of the clip in pixels.
- int clip.Height
- Returns the height of the clip in pixels.
- int clip.FrameCount
- Returns the total number of video frames contained in the clip.
- float clip.FrameRate
- Returns approximate framerate. Video framerate is actually a ratio of two 32-bit integers;
- so for the precise number, use FrameRateNumerator and FrameRateDenominator.
- int clip.FrameRateNumerator
- Returns the framerate numerator.
- int clip.FrameRateDenominator
- Returns the framerate denominator.
- int clip.AudioRate
- Returns the audio sample rate.
- int clip.AudioLength
- Returns the total number of audio samples, per audio channel.
- Be aware of possible overflow on extremely long clips (with >= 231 audio samples) – see Examples below.
- int clip.AudioLengthLo([ int m ]) (from v2.60)
- int clip.AudioLengthHi([ int d ]) (from v2.60)
- clip.AudioLengthLo returns the total number of audio samples, modulo m, which is 109 by default.
- clip.AudioLengthHi returns the total number of audio samples, divided by d, which is 109 by default.
- Therefore, assuming m==d, the (possibly 64-bit) total equals AudioLengthHi × m + AudioLengthLo.
- (see Examples below)
- float clip.AudioLengthF
- Returns the total number of audio samples as a float-point number.
- No overflow limit, but there is a possible precision limit – see Examples below.
- string clip.AudioLengthS (from v2.60)
- Returns the total number of audio samples as a string.
- float clip.AudioDuration (from v2.60)
- Returns the audio duration in seconds.
- int clip.AudioChannels
- Returns the number of audio channels.
- int clip.AudioBits
- Returns the audio bit depth, eg, 8, 16, 24 or 32.
- bool clip.IsAudioFloat
- Returns true if the audio format is Float.
- bool clip.IsAudioInt
- Returns true if the audio format is an integer type.
- bool clip.IsRGB
- Returns true if the color format is RGB, false otherwise.
- bool clip.IsRGB24
- Returns true if the color format is RGB24, false otherwise.
- bool clip.IsRGB32
- Returns true if the color format is RGB32, false otherwise.
- bool clip.IsYUV
- Returns true if the color format is YUV, false otherwise.
- bool clip.IsYUY2 (clip)
- Returns true if the color format is YUY2, false otherwise.
- bool clip.IsY8 (from v2.60)
- Returns true if the color format is Y8, false otherwise.
- bool clip.IsYV12
- Returns true if the color format is YV12, false otherwise.
- bool clip.IsYV16 (from v2.60)
- Returns true if the clip color format is YV16, false otherwise.
- bool clip.IsYV24 (v2.60)
- Returns true if the color format is YV24, false otherwise.
- bool clip.IsYV411 (from v2.60)
- Returns true if the color format is YV411, false otherwise.
- string clip.PixelType (from v2.60)
- Returns the pixel type as a string, eg "RGB32".
- bool clip.IsFieldBased
- Returns true if the clip is field-based. What this means is explained here.
- bool clip.IsFrameBased
- Returns true if the clip is frame-based. What this means is explained here.
- bool clip.IsPlanar
- Returns true if the color format is Planar, false otherwise.
- bool clip.IsInterleaved
- Returns true if the color format is Interleaved, false otherwise.
- bool clip.GetParity([ int f ])
- Returns true if frame f (default 0) is the top field of a field-based clip, or if it is a full frame with top field first of a frame-based clip.
- bool clip.HasAudio
- Returns true if the clip has audio, false otherwise.
- bool clip.HasVideo
- Returns true if the clip has video, false otherwise.
Examples
- Clip duration = 10 seconds. All AudioLength forms agree.
ColorBars(width=440, height=440) Trim(0, 299) Info Levels(0, 1.0, 255, 64, 255-64, coring=false) Subtitle( \ "\nAudioLength = " + String(AudioLength) \ + "\nAudioLengthS = '" + AudioLengthS + "'" \ + "\nAudioLengthF = " + String(AudioLengthF) \ + "\nAudioLengthLo= " + String(AudioLengthLo) \ + "\nAudioLengthHi= " + String(AudioLengthHi) \ , font="courier", text_color=$ffffff, size=32, align=4, lsp=0)
- Clip duration approximately 24 hours.
Integer AudioLength overloads (wraps around to a negative number), while the floating-point form has lost several digits of precision.
Note the AudioLengthHi / AudioLengthLo arithmetic:
- total = 4 × 109 + 147195848
- total = 4147195848
Back to AviSynth Syntax.