Content-type: text/html
dvd-slideshow - Creates a mpeg slideshow movie from a list of pictures and effects.
dvd-slideshow -o <output directory> [-b <background jpeg>] [-n <slideshow name>] [-a <audiofile1> -a <audiofile2> -a <audiofileN>] -f <input text file> [-p] [-L] [-mp2]
Creates a dvd-compatible mpeg2 file from a bunch of jpegs. You can add music on the command line or in the text input file. Supports several effects like fadein/fadeout/crossfade/crop/kenburns. dvd-slideshow is designed to work with dvd-menu to create a dvd navigation menu that you can then burn onto a dvd. There are also some helper scripts to convert a directory of pictures or your favorite online photo album to a dvd.
musictitle:duration:subtitle:Title:Artist;Album
Makes a black frame with the song info printed in the bottom left corner. Yes, that is a semicolon between Artist and Album.
background:duration:subtitle:image.jpg
Makes a slide with the current background image (or black if no image is passed). If a new image name is passed, the background will be reset to that picture. Examples:
"background:2" will display the current background for 2 seconds.
"background:2::image.jpg" will set the background to image.jpg and also display it for 2 seconds.
"background:0::image.jpg" will set the background image to image.jpg, but will not use it until the next picture.
"black" or "white" can be used instead of an image name to display a black or white background.
fadein:duration:subtitle
Fades in to the next slide
fadeout:duration:subtitle
Fades out to the background
crossfade:duration:subtitle
Fades from one slide to the next.
crop
image.jpg:duration:subtitle:crop:x0,y0;x1,y1
Crops the image about the coordinates specified (in the original image coordinate system).
Crop keyword description:
Because it is difficult to figure out the exact locations where you want to crop, it is possible to use special keywords for the locations where you want to crop the image. The basic format is:
frame_size%;frame_location
where frame_size indicates the relative scale(%) in percent of the final dvd window width/height, and frame_location refers to the location of the center point of the picture relative to the dvd window.
Frame_location can be any of the following keywords:
topleft top topright
left middle right
bottomleft bottom bottomright
or
x%,y%
where % is a percentage of the window width,height
starting from the top left corner of the dvd window.
or
imagewidth | imageheight
where the image width or height will be scaled to
fill the full width or height of the dvd screen.
Crop examples:
image.jpg:dur:sub:crop:651,390;1134,759
image.jpg:dur:sub:crop:30%;60%,60%
image.jpg:dur:sub:crop:50%;topleft
image.jpg:dur:sub:crop:imageheight;left
kenburns
image.jpg:duration:subtitle:kenburns:start_box;end_box
Where now we have starting (s) and ending (e) boxes, defined in the same way as in the "crop" function, above. The kenburns effect will crop/zoom from the start to the end for the given duration.
Full box description:
xs0,ys0;xs1,ys1;xe0,ye0;xe1,ye1
Specifies the top-left(0) and bottom-right(1) points.
Keyword description:
start_frame_size%;start_location;end_frame_size%;end_location
Kenburns examples:
image.jpg:5::kenburns:651,390;1134,759;372,330;1365,1089
image.jpg:5:sub:kenburns:30%;60%,60%;75%;40%,50%
image.jpg:5:sub:kenburns:50%;topleft;50%;bottomright
image.jpg:5:sub:kenburns:100%;left;0,0;720,480
image.jpg:5:sub:kenburns:100%;left;imageheight;left
scroll
image.jpg:duration:subtitle:scroll:left
image.jpg:duration:subtitle:scroll:right
image.jpg:duration:subtitle:scroll:up
image.jpg:duration:subtitle:scroll:down
This is most useful for displaying panorama-style pictures that are much wider than they are tall. For example, "scroll:right" will automatically resize the picture so that the image height is equal to the video display height (480) before scrolling right.
audiofile:track:effect1:effect1_params:effect2:effect2_params
The audiofile can be a .ogg, .mp3, or .wav file.
Track is the resulting dvd audio track.
Audio Effects are audio effects where you can specify things like fadein and fadeout for the audio. Example:
audiofile:1:fadein:3:fadeout:2
debug=1 # 0 (low) to 3 (lots of info)
pal=0 # 0=ntsc 1=pal
ac3=1 # 0=mp2 1=ac3 audio
copy=0 # add copies of original images to the output directory
autocrop=1 # autocrop images to fill full screen
font_dir="/usr/share/fonts"
font1="n019004l.pfb" # helvetica bold URW fonts
font2="helb____.ttf" # helvetica bold truetype
## font sizes:
subtitle_font_size=24
title1_font_size=48
title2_font_size=36
## top title:
title1_bar_height=125 # 0 for no 50% white behind text
title1_text_location_x=80
title1_text_location_y=50
# bottom title:
title2_bar_location_y=324 # relative to top of image
title2_bar_height=55 # 0 for no 50% white behind text
title2_text_location_x=0
title2_text_location_y=325
dvd-slideshow
dvd-menu
dvd-iso Depreciated. Use dvd-menu -iso instead
dir2slideshow
gallery2slideshow
jigl2slideshow
man/dvd-slideshow.1
man/dvd-menu.1
man/dir2slideshow.1
doc/dvd-slideshow.html
doc/dvd-menu.html
doc/changelog.html
doc/dvd-encode.html
doc/gallery2slideshow.html
doc/jigl2slideshow.html
doc/README.html
There are a few heavily-commented examples available in the examples section of the dvd-slideshow webpage, which you can find at http://dvd-slideshow.sourceforge.net
Scott Dylewski <scott at dylewski dot com>
http://dvd-slideshow.sourceforge.net/
dvd-menu(1)