Avisynth wiki - User contributions [en]

FAQ loading clips

2019-09-08T17:32:06Z

ItaloFan: /* How do I load MP4/MKV/M2TS/EVO into AviSynth? */ fixed ffdshow link

|[[AviSynth_FAQ | Main Page]] | [[FAQ_general_info | General Info]] | '''Loading clips''' | [[FAQ_frameserving | Loading Scripts]] | [[FAQ_common_errors | Common Error Messages]] | [[FAQ_different_types_content | Processing Different Content]] | [[FAQ_YV12 | Dealing with YV12]] | [[FAQ_using_virtualdub_plugins | Processing with Virtualdub Plugins]] |

=== <div id="media-formats">Which media formats can be loaded in AviSynth?</div> ===

Most video/audio formats can be loaded in AviSynth, but there are some exceptions like flv4 (VP6) and dvr-ms. If it is not possible to load a clip into AviSynth, you will have to convert it into some other format which can be loaded. Remember to choose a format for which you will have a minimal downgrade in quality as a result of the conversion.

=== <div id="ways-load">Which possibilities exist to load my clip into AviSynth?</div> ===

In general there are three ways to load your video into AviSynth:

# using an AviSynth internal filter or plugin which is designed to open some specific format.
# using the [[DirectShowSource]] plugin.
# using Graphedit.

Make sure that your clip contains maximal one video and/or one audio stream (thus remove the subtitles and remove other video/audio streams). If you want to load a clip which contains both video and audio, you have two options:

* Demux the audio stream and load the streams separately in AviSynth.
* Try to load the clip in AviSynth. This might or might not work. For AVIs, make sure you have a good AVI splitter installed, e.g. [http://sourceforge.net/project/showfiles.php?group_id=205650 Gabest's AVI splitter]. (Yes, Windows comes with an own AVI splitter, which will work in most cases.)

When loading a clip into AviSynth it is advised to follow the following guidelines:

* When it is possible to load your clip into AviSynth using either AviSource or a specific plugin then do so, since this is more reliable than the alternatives which are listed below.
* If the above fails, load your clip using the DirectShowSource plugin.
* If the above fails, create a Graphedit file connecting only the pins necessary to render the file.
* If the above fails, convert your clip into a different format (into one which is supported by AviSynth).

=== <div id="adv-dss">What are the advantages and disadvantages of using DirectShowSource to load your media files?</div> ===

''advantages of DirectShowSource:''

* Many video and audio formats are supported through DirectShowSource (have a look at ffdshow for example).

''disadvantages of DirectShowSource:''

* It's less reliable than AviSource and specific video/audio input plugins.
* Seeking problems.
* It might be much trouble to get specific DirectShow filter doing the decoding for you. In many cases you will have multiple decoders that can decode the same specific format. The one which will be used is the one with the highest merit (see below ...). It might be difficult to ensure that a specific decoder is doing the decoding.

=== <div id="direct-stream">Has AviSynth a direct stream copy mode like VirtualDub?</div> ===

No, the video and the audio are decompressed when opening them into AviSynth.

There is a modification of AviSynth v2.55 which supports 'direct stream copy' for both video and audio. This modification is called DSynth and can be downloaded [http://esby.free.fr/ here]. Perhaps it will be updated and merged into the official AviSynth builds one day.

=== <div id="avi">How do I load AVI files into AviSynth?</div> ===

Use [[AviSource]] to load your AVI files in AviSynth. Example:

AviSource("d:\filename.avi")

or without the audio:

AviSource("d:\filename.avi", false)

If AviSynth is complaining about not being able to load your avi (couldn't decompress ...) you need to install an appropriate codec. [http://www.headbands.com/gspot/ GSpot], for example, will tell you what codec you need to install in order to be able to open your avi.

Forcing a decoder being used for loading the clip into AviSynth:

# load your avi using the XviD codec:
AviSource("d:\filename.avi", fourCC="XVID") # opens an avi (for example encoded with DivX3) using the XviD Codec

# load your dv-avi using the Canopus DV Codec:
AviSource("d:\filename.avi", fourCC="CDVC")

=== <div id="avi-aud">Can I load video with audio from AVI into AviSynth?</div> ===

It is always possible to demux your audio from the AVI file and load it separately in AviSynth using an audio decoder, but in some cases (for example: AVI with MP2/MP3/AC3/DTS audio) it is possible to load it directly in AviSynth.

For loading your AVI with audio you need (1) a VfW (Video for Windows) codec to open (that is decode) your video in AviSynth and an ACM (Audio Compression Manager) codec to open your audio in AviSynth. For many video and audio format such codecs are available, but certainly not for all of them.

[[Importing_media#AVI_with_audio|Here]] (...) you can find those codecs.

=== <div id="mpeg">How do I load MPEG-1/MPEG-2/DVD VOB/TS/PVA into AviSynth?</div> ===

[[DGDecode]] is an external plugin and supports MPEG-1, MPEG-2 / VOB, TS (with MPEG-4 ASP video) and PVA streams. Open them into [[DGIndex]] first and create a D2V file which can be opened in AviSynth (note that it will only open the video into AviSynth):

A few examples:

# DGDecode:
LoadPlugin("d:\dgdecode.dll")
MPEG2Source("d:\filename.d2v")

If your transport stream (*.TS) contains MPEG-4 AVC video you need to demux the raw video stream from it and use [[DGAVCDecode]] to open it in AviSynth. See [[#non-avi|here]] for its usage.

Note: [http://code.google.com/p/ffmpegsource/ FFMpegSource] is also an external plugin you can use for loading the above and more. It does several Quicktime, AVI, MPEG, FLV, and others as well. If you can't get the audio to load right, use FFVideoSource and FFAudioSource separate and it should work properly. No issues with MPEG-1, 2, VOB, or TS. Some issues on H.264, though, so DGAVCDecode is still the best for that. FFMS will auto-index any file you put into it which is great for scripted conversions.

=== <div id="quickt">How do I load QuickTime files into AviSynth?</div> ===

There are two ways to load your quicktime movies into AviSynth (and also RawSource for uncompressed movs): QTSource and QTReader. The former one is very recent and able to open many quicktime formats (with the possibility to open them as YUY2), but you need to install QuickTime player in order to be able to use this plugin. The latter one is very old, no installation of a player is required in order to be able to open quicktime formats in AviSynth.

QTSource:

You will need Quicktime 6 for getting video only or Quicktime 7 for getting audio and video.

# YUY2 (default):
QTInput("FileName.mov", color=2)

# with audio (in many cases possible with QuickTime 7)
QTInput("FileName.mov", color=2, audio=1)

# raw (with for example a YUYV format):
QTInput("FileName.mov", color=2, mode=1, raw="yuyv")

# dither = 1; converts raw 10bit to 8bit video (v210 = 10bit uyvy):
QTInput("FileName.mov", color=2, dither=1, raw="v210")

QTReader:

If that doesn't work, or you don't have QuickTime, download the QTReader plugin (can be found in Dooms download section):

LoadVFAPIPlugin("C:\QTReader\QTReader.vfp", "QTReader")
QTReader("C:\quicktime.mov")

=== <div id="raw">How do I load raw source video files into AviSynth?</div> ===

The external plugin RawSource supports all kinds of raw video files with the YUV4MPEG2 header and without header (video files which contains YUV2, YV16, YV12, RGB or Y8 video data).

Examples:

# This assumes there is a valid YUV4MPEG2-header inside:
RawSource("d:\yuv4mpeg.yuv")

# A raw file with RGBA data:
RawSource("d:\src6_625.raw",720,576,"BGRA")

# You can enter the byte positions of the video frames directly (which can be found with yuvscan.exe).
# This is useful if it's not really raw video, but e.g. uncompressed MOV files or a file with some kind of header:
RawSource("d:\yuv.mov", 720, 576, "UYVY", index="0:192512 1:1021952 25:21120512 50:42048512 75:62976512")

=== <div id="rm">How do I load RM/RMVB (RealMedia) into AviSynth?</div> ===

RM/RMVB (RealMedia / RealMedia Variable Bitrate usually containing Real Video/Audio): install the [http://sourceforge.net/projects/guliverkli/ rmvb splitter] and the Real codecs by installing RealPlayer/[http://www.free-codecs.com/download/Real_Alternative.htm RealAlternative]. Create the script:

DirectShowSource("d:\clip.rmvb", fps=25, convertfps=true) # adjust fps if necessary

=== <div id="wmv">How do I load Windows Media Video into AviSynth?</div> ===

WMV/ASF (Windows Media Video / Advanced Systems Format; usually containing WMV/WMA) is not fully supported by ffdshow, so you will have to install wmv codecs. Get [http://msdn.microsoft.com/en-us/library/dd757738%28v=vs.85%29.aspx WMF SDK v9 for W2K or later for XP/Vista] which contains the codecs (and the DMO wrappers necessary to use DMO filters in DirectShow). (Note that Microsoft's own VC1 codec is not supported in W2K since you need WMF SDK v11.) Create the script:

DirectShowSource("d:\clip.wmv", fps=25, convertfps=true) # adjust fps if necessary

=== <div id="non-avi">How do I load MP4/MKV/M2TS/EVO into AviSynth?</div> ===

If your media file contains MPEG-4 ASP video, then there are two possibilities of opening them in AviSynth:

1) Using the plugin [[FFmpegSource]]. All included dlls except ffmpegsource.dll should be copied to your system folder. Some examples:

# loading the video from MKV and returning a timecodes file:
FFmpegSource("D:\file.mkv", vtrack = -1, atrack = -2, timecodes="timecodes_file.txt")

# loading the video and audio from a MP4 and returning a timecodes file:
FFmpegSource("D:\file_aac.mp4", vtrack = -1, atrack = -1, timecodes="timecodes_file.txt")

It's important to generate a timecode file to check whether the video has a constant framerate. If this the case you don't need to use the timecode file and you can process the video in any way you want. However, many non-AVI files contain video with a variable framerate (AVI files always have a constant framerate though), and in that case you need to make sure of the following two things:

* Don't change the framerate and the number of frames in AviSynth. If you do this (and you don't change the timecodes file manually) your video and audio in your final encoding will be out of sync.
* [[VFR#encoding_to_vfr_.28mkv.29|Use the timecodes file again]] when muxing your encoded video and audio. If you don't do this your video and audio in your final encoding will be out of sync.

The main reason for this is that FFmpegSource opens the video as it is. It doesn't add or remove frames to convert it to constant framerate video to ensure sync.

2) Get [[Ffdshow|ffdshow]] and open the MP4/MKV file with DirectShowSource, thus for example

DirectShowSource("D:\file.mkv", convertfps=true) # convertfps=true ensures sync if your video has a variable framerate

If your media file contains MPEG-4 AVC video, then there are two possibilities of opening them in AviSynth:

1) Using the plugin [[FFmpegSource]]. See above for its usage. At the moment, the supported containers are: AVI, MKV and MP4.

2) Get [[DGAVCDecode]]. At the moment you need to extract the raw stream (*.264) from the container first (using MKVExtract, MPlayer, TSRemux or whatever program can extract those streams). Open the raw stream file in DGAVCIndex to create an index file (say track1.dga). Open the index file in AviSynth:

# raw video demuxed from M2TS (Blu-ray BDAV MPEG-2 transport streams)
LoadPlugin("C:\Program Files\AviSynth\plugins\DGAVCDecode.dll")
AVCSource("D:\track1.dga")

=== <div id="wavpcm">How do I load WAVE PCM files into AviSynth?</div> ===

Use WavSource to open your WAVE PCM files (assuming that they are smaller than 4GB):

WavSource("D:\file.wav")

Use the plugin RaWav to open your WAVE PCM files that are larger than 4GB ([http://dotwhat.net/w64/9033/ Sonic Foundry Video Editor Wave64 Files or W64]). The RaWavSource() load method are now included in [http://www.codeplex.com/NicAudio NicAudio 2.0] (see next point):

RaWavSource("D:\file.w64", SampleRate=96000, SampleBits=24, Channels=6)

# or when a W64 header is present
RaWavSource("D:\file.w64", SampleRate=6) # assumes the presence of a W64 header and reads the needed info from it

=== <div id="mpeg-aud">How do I load MP1/MP2/MP3/MPA/AC3/DTS/LPCM into AviSynth?</div> ===

Use NicAudio for loading your MP1/MP2/MPA/AC3/DTS/LPCM in AviSynth:
Use DirectShowSource() for MP3

Some examples:

LoadPlugin("C:\Program Files\AviSynth25\plugins\NicAudio.dll")

# AC3 audio:
V = BlankClip(height=576, width=720, fps=25)
A = NicAC3Source("D:\audio.AC3")
# A = NicAC3Source("D:\audio.AC3", channels=2) # downmix to stereo
AudioDub(V, A)

# LPCM audio (48 kHz, 16 bit and stereo):
V = BlankClip(height=576, width=720, fps=25)
A = NicLPCMSource("D:\audio.lpcm", 48000, 16, 2)
AudioDub(V, A)

=== <div id="aud-other">How do I load aac/flac/ogg files into AviSynth?</div> ===

Use ffdshow (set AAC to libfaad or realaac), and use

DirectShowSource("d:\audio.aac")

For WAVE_FORMAT_EXTENSIBLE, ogg, flac, wma, and other formats, [http://forum.doom9.org/showthread.php?t=108254 BassAudio and the correspoding libraries and Add-Ons] can be used. Note that BassAudioSource can decode stereo aac/mp4, but it can't decode multichannel aac.

Some examples:

bassAudioSource("C:\ab\Dido\001 Here With Me.m4a")

bassAudioSource("C:\ab\Dido\001 Here With Me.aac")

=== <div id="pics">How do I load pictures into AviSynth?</div> ===

1) Use [[ImageReader]] or [[ImageSource]] to load your pictures into AviSynth (can load the most popular formats, except GIF and animated formats). See internal documentation for information.

2) Use the Immaavs plugin for GIF, animated formats and other type of pictures.

# single picture:
immareadpic("x:\path\pic.bmp")

# animation:
immareadanim("x:\path\anim.gif")

# image sequence:
immareadseq("x:\path\seq%3.3d.png", start=5, stop=89, fps=25, textmode=2, posx=50, posy=50)

|[[AviSynth_FAQ | Main Page]] | [[FAQ_general_info | General Info]] | '''Loading clips''' | [[FAQ_frameserving | Loading Scripts]] | [[FAQ_common_errors | Common Error Messages]] | [[FAQ_different_types_content | Processing Different Content]] | [[FAQ_YV12 | Dealing with YV12]] | [[FAQ_using_virtualdub_plugins | Processing with Virtualdub Plugins]] |

[[Category:AviSynth FAQ]]

AutoCrop

2019-08-29T22:24:02Z

ItaloFan: spelling, grammar, punctuation

{{FilterCat4|External_filters|Plugins|Adjustment_filters|Borders and Cropping}}
{{Filter3
|[https://web.archive.org/web/20050404182221/http://www.videofringe.com/autocrop/ Glenn Bussell], len0x
|v1.2
|3=[http://len0x.leffe.dnsalias.com/autocrop12.zip autocrop12.zip]
|4=Borders and Cropping
|5=[https://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
|6=[https://forum.doom9.org/showthread.php?t=37204 Doom9 Thread] - [https://forum.doom9.org/showthread.php?t=87602 Update]
}}

== Description ==
[[AutoCrop]] is an AviSynth filter that automatically crops the black borders from a clip. It operates in either preview mode where it overlays the recommended cropping information on
the existing clip, or cropping mode where it really crops the clip. It can also ensure width and height are multiples of specified numbers so the cropped clip can be passed to the video compressor of your choice without problems.
<br>
<br>
== Requirements ==
* AviSynth 2.5.8 or [https://sourceforge.net/projects/avisynth2/ greater]
* Supported color formats: [[YUY2]], [[YV12]]
<br>
== [[Script variables|Syntax and Parameters]] ==
AutoCrop takes 12 parameters, but they are all optional so you can just do <code>AutoCrop()</code> to get a feel for how the filter works. Parameters can either be specified in order or by name. I suggest specifying by name, as there are a lot of parameters!
<br>
<br>
:{{Template:FuncDef|AutoCrop (clip, int "mode", int "wMultOf", int "hMultOf", int "leftAdd", int "topAdd", int "rightAdd", int "bottomAdd", int "threshold", int "samples", int "samplestartframe", int "sampleendframe", float "aspect")}}
<br>
::{{Par2| |clip| }}
:::Input clip.
<br>
::{{Par2|mode|int|1}}
:::*0 : Crop - Crops the image
:::*1 : Preview - Suggested cropping information is overlayed on the existing clip, including a crop command that you can use to replace AutoCrop with.
:::*2 : Log - Logs the cropping parameters to the file "AutoCrop.log" in the current directory.
:::*3 : Crop & Log - combination of modes 0 and 2
<br>
::{{Par2|wMultOf|int|4}}
::{{Par2|hMultOf|int|2}}
:::Ensures that the width of the cropped clip will be a multiple of the number specified. Use this to ensure that clip is a valid for whatever codec you are going to compress with. hMultOf is the same, but for the height.
<br>
::{{Par2|leftAdd|int|0}}
:::Forces autocrop to crop an additional 'leftAdd' pixels after it completes auto detection. You can use this option in conjunction with wMultOf. Useful for cropping out bad quality lines on the side of VHS captures.

::{{Par2|topAdd|int|0}}
:::Forces autocrop to crop an additional 'topAdd' pixels after it completes auto detection. You can use this option in conjunction with hMultOf. Useful for cropping out bad quality lines on the top of VHS captures.

::{{Par2|rightAdd|int|0}}
:::Same as leftAdd but for the right side.

::{{Par2|bottomAdd|int|0}}
:::Same as topAdd but for the bottom side.
<br>
::{{Par2|threshold|int|40}}
:::Threshold is the average luminance a line must have before it's considered non blank. For DVD sources values as low as 20 should work reliably. For VHS sources raising the value may be necessary.
<br>
::{{Par2|sample|int|5}}
:::The number of frames to examine when determining the cropping information. This directly affects the startup time of the filter. This number dramatically effects the amount of time taken for the filter to startup. Increasing the number to 10 will basically double the startup time.
<br>
::{{Par2|samplestartframe|int|0}}
::{{Par2|sampleendframe|int|-1}}
:::These parameters set the first and last frame to be looked at when determining the cropping parameters. Defaults are the first frame(0) and last frame(-1).
:::If you want to take the cropping information from a single frame, set samplestartframe and sampleendframe to the same number and samples to be 1
<br>
::{{Par2|aspect|int|0}}
:::*-1 : Maintain aspect ratio of the source clip
:::*0 : Aspect is ignored
:::*>0 : Aspect ratio will be set to this. For example for a 4:3 aspect ratio you would pass 4.0/3.0 or 1.33333333333. Note that 4/3 won't work since the .0 is needed to tell AviSynth the value is a float.
<br>
== Examples ==
AutoCrop with default values:
[[AviSource]]("Blah.avi")
AutoCrop(mode=1, wMultOf=4, hMultOf=2, leftAdd=0, topAdd=0, rightAdd=0, bottomAdd=0, \
threshold=40, samples=5, samplestartframe=0, sampleendframe=-1, aspect=0)
<br>
== Changelog ==
Version Date Changes<br>
v1.2 01/03/2005 - fixed bug when preview and actual crop values were different
- fixed bug when AR was not properly enforced (rounding errors)
- threshold 0 ensures that no cropping is done unless necessary for AR
- fixed bug when leftAdd and rightAdd parameters were not properly working in YUY2 mode
- wMulfOf and hMultOf cannot be zero now
- wMultOf is relaxed to be mod2 for YV12 (previously mod4)
- added mode=3 which is mode 0 plus mode 2 (cropping and logging at the same time)<br>
v1.1 06/17/2003 - Added ability to set a range of frames to sample for cropping information.
- Reduced default number of frames to sample to 5.
- Reduced default threshold to 30, this change and the one above should perform give
equal or better performance for DVD sources much quicker.
- Minor documentation updates.<br>
v1.0 03/09/2003 - A new version of AutoCrop which solves the YV12 cropping problems found in version 0.51.<br>
v0.51 27/02/2003 - New version 0.51 with (hopefully) working wMultOf and hMultOf in YV12 mode.<br>
v0.5 26/02/2003 - This version (finally) adds YV12 support.<br>
v0.4 01/30/2003 - This version of AutoCrop is compiled for AviSynth 2.5 it will not work with any of the 2.0 releases.
- The preview argument (which was a boolean) has been removed and replaced with the new mode argument
(which is an int) this was to allow for the implementation of the logging mode and the future blanking mode.
- Aspect Ratio support. Support for maintaining and setting aspect ratios is included.
- Logging mode. Image is left untouched, cropping information is written to the file "AutoCrop.log"
in the current directory.<br>
v0.3 11/05/2005 - Setting wMultOf=width now behaves correctly. ie. Just letterboxes the clip.
- Debugging information no longer written to disk.<br>
v0.1 11/03/2002 - Initial release for AviSynth 2.0
<br>
== Archived Downloads ==
{| class="wikitable" border="1"; width="600px"
|-
!!width="100px"| Version
!!width="150px"| Download
!!width="150px"| Mirror
|-
!v1.2
|[http://len0x.leffe.dnsalias.com/autocrop12.zip autocrop12.zip]
|[https://web.archive.org/web/20130311200834/http://len0x.leffe.dnsalias.com/autocrop12.zip autocrop12.zip]
|-
!v1.1
|[https://web.archive.org/web/20041204083940/http://www.avisynth.org/warpenterprises/files/autocrop_25_dll_20030617.zip autocrop_25_dll_20030617.zip]
|
|-
!v1.0
|[https://web.archive.org/web/20031214011808/http://www.avisynth.org/warpenterprises/files/autocrop_25_dll_20030309.zip autocrop_25_dll_20030309.zip]
|
|-
!v0.3
|[http://www.avisynth.nl/users/warpenterprises/files/autocrop_20_dll_20021105.zip autocrop_20_dll_20021105.zip]
|[https://web.archive.org/web/20031214011808/http://www.avisynth.org/warpenterprises/files/autocrop_20_dll_20021105.zip autocrop_20_dll_20021105.zip]
|}
<br>
== External Links ==
*[https://avisynth.org.ru/docs/english/externalfilters/autocrop.htm avisynth.org.ru] - AutoCrop documentation.
*[https://github.com/KG7x/xvid4psp/tree/master/AutoCrop GitHub] - AutoCrop mod by XviD4PSP. Original [https://code.google.com/archive/p/xvid4psp/ Google Code repository].
<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Borders_and_Cropping|External Filters]] ←'''