[FFmpeg-cvslog] doc: image2: update docs for glob input patterns

Alexander Strasser git at videolan.org
Fri Apr 6 15:22:59 CEST 2012


ffmpeg | branch: master | Alexander Strasser <eclipse7 at gmx.net> | Fri Apr  6 00:21:43 2012 +0200| [f36377304215fa4cbf8e5b590ddec53a9ebda06f] | committer: Alexander Strasser

doc: image2: update docs for glob input patterns

* adapt examples to new syntax
* mention that glob chars need to be enabled by a preceding % char
* note that globbing will be performed if both a printf and globbing
  pattern would be possible judging from the input pattern

Signed-off-by: Alexander Strasser <eclipse7 at gmx.net>

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=f36377304215fa4cbf8e5b590ddec53a9ebda06f
---

 doc/ffmpeg.texi |   18 +++++++++++++-----
 1 files changed, 13 insertions(+), 5 deletions(-)

diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi
index a9edad4..2ed3fae 100644
--- a/doc/ffmpeg.texi
+++ b/doc/ffmpeg.texi
@@ -1077,11 +1077,19 @@ ffmpeg -f image2 -i foo-%03d.jpeg -r 12 -s WxH foo.avi
 The syntax @code{foo-%03d.jpeg} specifies to use a decimal number
 composed of three digits padded with zeroes to express the sequence
 number. It is the same syntax supported by the C printf function, but
-only formats accepting a normal integer are suitable. When importing
-an image sequence, -i also accepts shell-like wildcard patterns such as
- at code{foo-*.jpeg}, @code{foo-???.jpeg} or @code{foo-00[234]*.jpeg}.
-It will probably be necessary to escape these patterns so they do not
-get interpreted by your shell.
+only formats accepting a normal integer are suitable.
+
+When importing an image sequence, -i also supports expanding shell-like
+wildcard patterns (globbing) internally. To lower the chance of interfering
+with your actual file names and the shell's glob expansion, you are required
+to activate glob meta characters by prefixing them with a single @code{%}
+character, like in @code{foo-%*.jpeg}, @code{foo-%?%?%?.jpeg} or
+ at code{foo-00%[234%]%*.jpeg}.
+If your filename actually contains a character sequence of a @code{%} character
+followed by a glob character, you must double the @code{%} character to escape
+it. Imagine your files begin with @code{%?-foo-}, then you could use a glob
+pattern like @code{%%?-foo-%*.jpeg}. For input patterns that could be both a
+printf or a glob pattern, ffmpeg will assume it is a glob pattern.
 
 @item
 You can put many streams of the same type in the output:



More information about the ffmpeg-cvslog mailing list