images2mpg(1)

1images2mpg(1)                Digikam tools manual                images2mpg(1)
2
3
4

NAME

6       images2mpg - MPEG portfolio images multiplexer
7

SYNTAX

9       images2mpg [ options ] -o <output MPEG file> -i <input image files>
10

REQUIREMENTS

12       This script use this packages :
13
14       ImageMagick version >= 5.4.8 [ http://www.imagemagick.org/ ]
15       MjpegTools  version >= 1.6.0 [ http://mjpeg.sourceforge.net/ ]
16
17       With this packages, 'images2mpg' use this externals binary programs :
18
19       -  'montage'  from  ImageMagick for resize the images for the TV screen
20       size.
21       - 'composite' from ImageMagick for make the transition between images.
22       - 'convert' from ImageMagick for convert the images before MPEG  encod‐
23       ing.
24       - 'identify' from ImageMagick for check the background image file size.
25       - 'ppmtoy4m' from MjpegTools for create a video stream from the image.
26       -  'yuvscaler'  from  MjpegTools for adapt the video stream size before
27       MPEG encoding.
28       - 'mpeg2enc' from MjpegTools for encode the video stream in MPEG file.
29       - 'mp2enc' from MjpegTools for encode on a MP2 file a WAV sound file if
30       necessary.
31       - 'mplex' from MjpegTools for multiplex the MPEG file and the MP2 sound
32       and convert the final MPEG file to a DVD/XVCD/SVCD/VCD format  compati‐
33       ble with vcdimager program.
34

DESCRIPTION

36       The 'images2mpg' bash script convert some images on MPEG sequences with
37       a specific duration and merge all images on an single MPEG file. It use
38       the MjpegTools and ImageMagick packages.
39
40       Between the images, you can insert a basic transition. You can also add
41       an audio track on the images sequence with a MP2 or WAV file.
42
43       All images will be automatically scaling to the good size for the video
44       format. Also a specific background color or a image file could be used.
45
46       You  can  use  this  for to build some DVD/XVCD/SVCD/VCD portfolios for
47       your home DVD player. Use 'vcdimager' for create this...
48
49       The video types and formats supported by this script are :
50
51       VCD :
52
53         Resolution : 352x288 (PAL/SECAM) / 352x240 (NTSC).
54         Frames / s : 25 (PAL/SECAM) / 30 (NTSC).
55         MPEG type : MPEG-1.
56         Video CDR duration (650Mb) : 74 minutes.
57         Video bitrate : 1,150 kbit/s.
58         Sound format : MP2.
59         Audio bitrate : 224 kbit/s.
60         DVD player compatibility : medium.
61         Image restitution : medium.
62
63       SVCD :
64
65         Resolution : 576x480 (PAL/SECAM) / 480x480 (NTSC).
66         Frames / s : 25 (PAL/SECAM) / 30 (NTSC).
67         MPEG type : MPEG-2.
68         Video CDR duration (650Mb): 60 minutes.
69         Video bitrate : 2,500 kbit/s.
70         Sound format : MP2.
71         Audio bitrate : 224 kbit/s.
72         DVD player compatibility : good.
73         Image restitution : good.
74
75       XVCD :
76
77         Resolution : 720x576 (PAL/SECAM) / 720x480 (NTSC).
78         Frames / s : 25 (PAL/SECAM) / 30 (NTSC).
79         MPEG type : MPEG-2.
80         Video CDR duration (650Mb) : 50 minutes.
81         Video bitrate : 2,500 kbit/s.
82         Sound format : MP2.
83         Audio bitrate : 224 kbit/s.
84         DVD player compatibility : medium.
85         Image restitution : excelent.
86
87       DVD :
88
89         Resolution : 720x576 (PAL/SECAM) / 720x480 (NTSC).
90         Frames / s : 25 (PAL/SECAM) / 30 (NTSC).
91         MPEG type : MPEG-2.
92         Video CDR duration (650Mb) : 15 minutes.
93         Video bitrate : 8,000 kbit/s.
94         Sound format : MP2.
95         Audio bitrate : 224 kbit/s.
96         DVD player compatibility : excelent.
97         Image restitution : excelent.
98
99       Note : The XVCD resolution is the same of DVD !
100

OPTIONS

102       -v <num> : verbose level on the console. The possible values  are   '0'
103       for none (default), '1' for informations and warnings, or '2' for debug
104       messages.
105
106       --with-gui : running with the 'Digikam'  KDE  GUI  frontend.  Specifics
107       messages  will  be  showing on the console. For more informations about
108       Digikam, see this URL : http://digikam.sourceforge.net
109
110       -t <num> : enable transition between images with a specific speed.  The
111       possible  speed  values  are '1' for slow, '2', '4', '5', '10', or '20'
112       for fast. When you enable this option, the script make with ImageMagick
113       package a beautiful merging transition between images. Warning : it's a
114       long calculating process.
115
116       The transitions durations are :
117
118       Speed  '1' : PAL/SECAM (25 f/s) = 4000 ms | NTSC (30 f/s) = 3333 ms.
119       Speed  '2' : PAL/SECAM (25 f/s) = 2000 ms | NTSC (30 f/s) = 1666 ms.
120       Speed  '4' : PAL/SECAM (25 f/s) = 1000 ms | NTSC (30 f/s) = 0833 ms.
121       Speed  '5' : PAL/SECAM (25 f/s) = 0800 ms | NTSC (30 f/s) = 0666 ms.
122       Speed '10' : PAL/SECAM (25 f/s) = 0400 ms | NTSC (30 f/s) = 0333 ms.
123       Speed '20' : PAL/SECAM (25 f/s) = 0200 ms | NTSC (30 f/s) = 0166 ms.
124
125       -T <Temporary folder> : use a specific folder for create the  temporary
126       files ('/tmp' for example). If you don't use this option, all temporary
127       files will be created in the current active folder.
128
129       -f <Video format> : MPEG video format. The possible values  are  'DVD',
130       'XVCD'  (default),  'SVCD',  or  'VCD'. See the DESCRIPTION section for
131       more details.
132
133       -n <Video type> : video type for your TV screen.  The  possible  values
134       are 'PAL' (default), 'NTSC', or 'SECAM'.
135
136       -b <background file> : specify the 768x576 pixels background image file
137       name. If you don't use this option, a  default  temporary  black  image
138       file will be used.
139
140       -c  <RGB  color>  : if you don't use the background image file, you can
141       change the default background color (black = default). Use an hexadeci‐
142       mal RGB color value (example : AA001F).
143
144       -d  <num>  : duration for each image in MPEG file. The default value is
145       10 secondes. The minimal value is 1 secondes.
146
147       -a <MPEG audio file> : MP2 audio file to merge with the video sequence.
148
149       -w <wav audio file> : WAV audio file will be converted in MP2 file  and
150       merging with the video sequence.
151
152       -o <output MPEG file> : the ouput MPEG file name. If you don't use this
153       option, a temporary file will be created.
154
155       -i <input images files> : images files name to merge in MPEG.
156
157       -I <ImageMagick bin folder> : folder for ImageMagick binary programs.
158
159       -M <Mjpegtools bin folder> : folder for MjpegTools binary programs.
160
161       -h | --help : output help information and exit.
162
163       Notes :
164
165       - The -i option must be the last option in the command line.
166       - If you use some whitespaces in the path folders/files, use '"' around
167       the complete path string.
168

RETURN VALUES

170       0 -> Process finish succefuly.
171       1 -> Error.
172

EXAMPLES

174       #  images2mpg  -f  SVCD -d 15 -w Music.wav -o MyPortfolio.mpg -i 01.jpg
175       02.jpg 03.jpg 04.jpg
176
177       Build PAL (default) SVCD MPEG file with the 'Music.wav' sound file  and
178       this image files sequence :
179
180       01.jpg 02.jpg 03.jpg 04.jpg
181
182       For  each  image  on the portfolio, the screen show duration is 15 sec‐
183       onds. The output file is  'MyPortfolio.mpg'.   There  isn't  transition
184       between images.
185
186       # images2mpg -n NTSC -t 2 -o MyPortfolio.mpg -i *.png
187
188       Build  XVCD  (default)  NTSC MPEG file with a transition between images
189       (speed 2) with  all local PNG image files.  The  image  files  sequence
190       use the local filesystem sort.
191

AUTHORS

193       This man page was written by Gilles CAULIER.
194       If  you  have  questions, remarks, problems or you just want to contact
195       the author :
196         caulier.gilles@free.fr
197
198       The main mailing list for the Digikam project is:
199         digikam-users@lists.sourceforge.net
200
201       For more info, see our website at
202         http://digikam.sourceforge.net
203