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, video4linux:/dev/video1?width:320&height:240
34 Note: on the bash command line, & must be escaped as '\&'.
35 Also, note the use of ':' instead of '=' for parameters.
36 Use 'f-list' to see a list of supported file formats.
37 Use 'vcodec-list' to see a list of supported video decoders.
38 Use 'acodec-list' to see a list of supported audio decoders.
42 widget: fileopen # could provide a button to use a file-open dialog
44 - identifier: audio_index # the name is the mlt_properties name
48 Choose the index of audio stream to use (-1 is off).
49 When this value is equal to the maximum size of a 32-bit signed integer
50 or the string "all" then all audio tracks are coalesced into a bundle of
51 channels on one audio track.
58 - identifier: video_index
61 description: Choose the index of video stream to use (-1 is off)
71 description: Set the start time offset to use within the clip
76 widget: timecode # this is a special form of time value/code entry (e.g. see Kino)
81 description: Set the ending time offset to use within the clip
85 widget: timecode # as opposed to time, which could be confused for a wallclock-style time widget
88 title: Decoding threads
90 description: Choose the number of threads to use in the decoder(s)
97 unit: threads # the unit is a label that appears after the widget
99 - identifier: force_aspect_ratio
100 title: Sample aspect ratio
102 description: Optionally override a (mis)detected aspect ratio
105 minimum: 0.001 # just a UI suggestion
106 maximum: 9.999 # just a suggestion
107 # no default property means it should be blank in the UI and not applied unless provided
109 - identifier: resource
112 description: file or protocol specification
115 - identifier: source_fps
118 scale: 2 # scale is the number of digits to display after the decimal point
119 description: the framerate of the resource
123 - identifier: aspect_ratio
124 title: Sample aspect ratio
126 The sample aspect ratio of the resource.
127 This is determined on every frame read.
133 description: duration
136 - identifier: seekable
137 title: Supports seeking
138 description: if the resource can seek
153 - identifier: noimagecache
154 title: Disable image caching
161 - identifier: new_seek
162 title: Use new seeking
164 When this is not provided (recommended), it is enabled only for H.264 in
165 MPEG-2 Transport Streams.
171 - identifier: force_progressive
172 title: Force progressive
173 description: When provided, this overrides the detection of progressive video.
179 - identifier: force_tff
180 title: Force top field first
181 description: When provided, this overrides the detected field order of interlaced video.
187 - identifier: force_fps
188 title: Force frame rate
189 description: When provided, this attempts to override the detected frame rate of the video.
195 - identifer: force_colorspace
196 title: Force colorspace
197 description: When provided, this overrides the detected colorspace of the video (Y'CbCr only).
204 - identifier: video_delay
207 Manually adjust A/V synchronization.
208 A negative value advances the video instead of delaying it.