images2mpg(1)
NAME
images2mpg - MPEG portfolio images multiplexer
SYNTAX
images2mpg [ options ] -o <output MPEG file> -i <input image files>
REQUIREMENTS
This script use this packages :
ImageMagick version >= 5.4.8 [ http://www.imagemagick.org/ ]
MjpegTools version >= 1.6.0 [ http://mjpeg.sourceforge.net/ ]
With this packages, 'images2mpg' use this externals binary programs :
- 'montage' from ImageMagick for resize the images for the TV screen
size.
- 'composite' from ImageMagick for make the transition between images.
- 'convert' from ImageMagick for convert the images before MPEG encoding.
- 'identify' from ImageMagick for check the background image file size.
- 'ppmtoy4m' from MjpegTools for create a video stream from the image.
- 'yuvscaler' from MjpegTools for adapt the video stream size before
MPEG encoding.
- 'mpeg2enc' from MjpegTools for encode the video stream in MPEG file.
- 'mp2enc' from MjpegTools for encode on a MP2 file a WAV sound file if
necessary.
- 'mplex' from MjpegTools for multiplex the MPEG file and the MP2 sound
and convert the final MPEG file to a DVD/XVCD/SVCD/VCD format compatible with vcdimager program.
DESCRIPTION
The 'images2mpg' bash script convert some images on MPEG sequences with
a specific duration and merge all images on an single MPEG file. It use
the MjpegTools and ImageMagick packages.
Between the images, you can insert a basic transition. You can also add
an audio track on the images sequence with a MP2 or WAV file.
All images will be automatically scaling to the good size for the video format. Also a specific background color or a image file could be used.
You can use this for to build some DVD/XVCD/SVCD/VCD portfolios for
your home DVD player. Use 'vcdimager' for create this...
The video types and formats supported by this script are :
- VCD :
- Resolution : 352x288 (PAL/SECAM) / 352x240 (NTSC).
Frames / s : 25 (PAL/SECAM) / 30 (NTSC).
MPEG type : MPEG-1.
Video CDR duration (650Mb) : 74 minutes.
Video bitrate : 1,150 kbit/s.
Sound format : MP2.
Audio bitrate : 224 kbit/s.
DVD player compatibility : medium.
Image restitution : medium. - SVCD :
Resolution : 576x480 (PAL/SECAM) / 480x480 (NTSC).
Frames / s : 25 (PAL/SECAM) / 30 (NTSC).
MPEG type : MPEG-2.
Video CDR duration (650Mb): 60 minutes.
Video bitrate : 2,500 kbit/s.
Sound format : MP2.
Audio bitrate : 224 kbit/s.
DVD player compatibility : good.
Image restitution : good.- XVCD :
Resolution : 720x576 (PAL/SECAM) / 720x480 (NTSC).
Frames / s : 25 (PAL/SECAM) / 30 (NTSC).
MPEG type : MPEG-2.
Video CDR duration (650Mb) : 50 minutes.
Video bitrate : 2,500 kbit/s.
Sound format : MP2.
Audio bitrate : 224 kbit/s.
DVD player compatibility : medium.
Image restitution : excelent.- DVD :
Resolution : 720x576 (PAL/SECAM) / 720x480 (NTSC).
Frames / s : 25 (PAL/SECAM) / 30 (NTSC).
MPEG type : MPEG-2.
Video CDR duration (650Mb) : 15 minutes.
Video bitrate : 8,000 kbit/s.
Sound format : MP2.
Audio bitrate : 224 kbit/s.
DVD player compatibility : excelent.
Image restitution : excelent.- Note : The XVCD resolution is the same of DVD !
OPTIONS
-v <num> : verbose level on the console. The possible values are '0'
for none (default), '1' for informations and warnings, or '2' for debug
messages.
--with-gui : running with the 'Digikam' KDE GUI frontend. Specifics
messages will be showing on the console. For more informations about
Digikam, see this URL : http://digikam.sourceforge.net
-t <num> : enable transition between images with a specific speed. The
possible speed values are '1' for slow, '2', '4', '5', '10', or '20'
for fast. When you enable this option, the script make with ImageMagick
package a beautiful merging transition between images. Warning : it's a
long calculating process.
The transitions durations are :
Speed '1' : PAL/SECAM (25 f/s) = 4000 ms | NTSC (30 f/s) = 3333 ms.
Speed '2' : PAL/SECAM (25 f/s) = 2000 ms | NTSC (30 f/s) = 1666 ms.
Speed '4' : PAL/SECAM (25 f/s) = 1000 ms | NTSC (30 f/s) = 0833 ms.
Speed '5' : PAL/SECAM (25 f/s) = 0800 ms | NTSC (30 f/s) = 0666 ms.
Speed '10' : PAL/SECAM (25 f/s) = 0400 ms | NTSC (30 f/s) = 0333 ms.
Speed '20' : PAL/SECAM (25 f/s) = 0200 ms | NTSC (30 f/s) = 0166 ms.
-T <Temporary folder> : use a specific folder for create the temporary
files ('/tmp' for example). If you don't use this option, all temporary
files will be created in the current active folder.
-f <Video format> : MPEG video format. The possible values are 'DVD',
'XVCD' (default), 'SVCD', or 'VCD'. See the DESCRIPTION section for
more details.
-n <Video type> : video type for your TV screen. The possible values
are 'PAL' (default), 'NTSC', or 'SECAM'.
-b <background file> : specify the 768x576 pixels background image file
name. If you don't use this option, a default temporary black image
file will be used.
-c <RGB color> : if you don't use the background image file, you can
change the default background color (black = default). Use an hexadecimal RGB color value (example : AA001F).
-d <num> : duration for each image in MPEG file. The default value is
10 secondes. The minimal value is 1 secondes.
-a <MPEG audio file> : MP2 audio file to merge with the video sequence.
-w <wav audio file> : WAV audio file will be converted in MP2 file and
merging with the video sequence.
-o <output MPEG file> : the ouput MPEG file name. If you don't use this
option, a temporary file will be created.
-i <input images files> : images files name to merge in MPEG.
-I <ImageMagick bin folder> : folder for ImageMagick binary programs.
-M <Mjpegtools bin folder> : folder for MjpegTools binary programs.
-h | --help : output help information and exit.
Notes :
- The -i option must be the last option in the command line.
- If you use some whitespaces in the path folders/files, use '"' around
the complete path string.
RETURN VALUES
0 -> Process finish succefuly.
1 -> Error.
EXAMPLES
# images2mpg -f SVCD -d 15 -w Music.wav -o MyPortfolio.mpg -i 01.jpg
02.jpg 03.jpg 04.jpg
Build PAL (default) SVCD MPEG file with the 'Music.wav' sound file and
this image files sequence :
01.jpg 02.jpg 03.jpg 04.jpg
For each image on the portfolio, the screen show duration is 15 seconds. The output file is 'MyPortfolio.mpg'. There isn't transition
between images.
# images2mpg -n NTSC -t 2 -o MyPortfolio.mpg -i *.png
Build XVCD (default) NTSC MPEG file with a transition between images
(speed 2) with all local PNG image files. The image files sequence
use the local filesystem sort.
AUTHORS
- This man page was written by Gilles CAULIER.
If you have questions, remarks, problems or you just want to contact the author : - caulier.gilles@free.fr
- The main mailing list for the Digikam project is:
- digikam-users@lists.sourceforge.net
- For more info, see our website at
- http://digikam.sourceforge.net
SEE ALSO
ImageMagick(1), mjpegtools(1), vcdimager(1)
- Digikam GUI WEB site project : http://digikam.sourceforge.net