6 copyright: Copyright (C) 2003-2011 Ushodaya Enterprises Limited
9 url: http://www.ffmpeg.org/
10 creator: Charles Yates
16 description: Read an audio and/or video file using FFmpeg
18 - Audio sync discrepancy with some content.
19 - Not all libavformat supported formats are seekable.
21 Seeking is not always accurate. Sometimes it doesn't seek to I-frames so you
22 may get junk for a few frames.
24 More than 2 channels of audio more than 16 bits is not supported.
27 - identifier: argument # 'argument' is a reserved name for a value supplied to the factory
31 A file name specification or URL in the form:
32 [{protocol}|{format}]:{resource}[?{format-parameter}[&{format-parameter}...]]
33 For example, video4linux2:/dev/video1?width=320&height=240
34 Note: on the bash command line, & must be escaped as '\&'.
35 Use 'f-list' to see a list of supported file formats.
36 Use 'vcodec-list' to see a list of supported video decoders.
37 Use 'acodec-list' to see a list of supported audio decoders.
41 widget: fileopen # could provide a button to use a file-open dialog
43 - identifier: audio_index # the name is the mlt_properties name
47 Choose the index of audio stream to use (-1 is off).
48 When this value is equal to the maximum size of a 32-bit signed integer
49 or the string "all" then all audio tracks are coalesced into a bundle of
50 channels on one audio track.
57 - identifier: video_index
60 description: Choose the index of video stream to use (-1 is off)
68 title: Decoding threads
70 description: Choose the number of threads to use in the decoder(s)
77 unit: threads # the unit is a label that appears after the widget
79 - identifier: force_aspect_ratio
80 title: Sample aspect ratio
82 description: Optionally override a (mis)detected aspect ratio
85 minimum: 0.001 # just a UI suggestion
86 maximum: 9.999 # just a suggestion
87 # no default property means it should be blank in the UI and not applied unless provided
89 - identifier: source_fps
92 scale: 2 # scale is the number of digits to display after the decimal point
93 description: the framerate of the resource
97 - identifier: seekable
98 title: Supports seeking
99 description: if the resource can seek
114 - identifier: noimagecache
115 title: Disable image caching
123 title: Number of images cache
126 By default, this producer caches images to facilitate YADIF deinterlace,
127 which needs previous and next frames. Also, caching helps with frame-
128 stepping within a player. The default number of images cached is supplied
129 by the MLT framework, which is currently 4, but you can override it
130 with this property. You can also disable caching by setting it to 0.
131 If you are using parallel processing with YADIF deinterlacing, then
132 you might need to increase caching to prevent inadvertent backward seeks.
133 One can also set this value globally for all instances of avformat by
134 setting the environment variable MLT_AVFORMAT_CACHE.
136 - identifier: force_progressive
137 title: Force progressive
138 description: When provided, this overrides the detection of progressive video.
144 - identifier: force_tff
145 title: Force top field first
146 description: When provided, this overrides the detected field order of interlaced video.
152 - identifier: force_fps
153 title: Force frame rate
154 description: When provided, this attempts to override the detected frame rate of the video.
160 - identifier: force_colorspace
161 title: Force colorspace
162 description: When provided, this overrides the detected colorspace of the video (Y'CbCr only).
169 - identifier: video_delay
172 Manually adjust A/V synchronization.
173 A negative value advances the video instead of delaying it.
179 - identifier: reconnect
180 title: Automatically reconnect?
182 Whether to attempt to automatically reconnect to a live source when a
189 - identifier: exit_on_disconnect
190 title: Exit upon disconnection?
192 When this is set, the program will terminate with an error if a live source
193 becomes disconnected.