dvd-slideshow(1) | dvd-slideshow | dvd-slideshow(1) |
dvd-slideshow - Creates a slideshow movie in DVD video format from a list of pictures and effects.
dvd-slideshow [-n <slideshow name>] [-o <output directory>] [-b <background jpeg>] [-a <audiofile1> -a <audiofile2> -a <audiofileN>] [-p] [-flv] [-mp4] [-s WxH] [-L] [-H] [-mp2] [-r] [-nosmp] [-border <bordersize>] [-theme <themename>] [-f] <input text file>
Creates a video from a bunch of images. The default video format is designed to produce DVDs, but other formats can be created for the web also (.flv). You can add music on the command line or in the text input file. Supports several effects like fadein, fadeout, crossfade, crop, and 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.
titlebar:duration:Upper title text:Lower title text
Makes a title slide using <Upper title text> as a title at the top
of the screen, and <Lower title text> as a lower title, in a band
at the bottom of the screen. Each title is optional. If one is missing,
it will not be displayed. White ands are underlayed behind the text for
better contrast. Further control of the font, size, and position of the
title text can be achieved by setting variables (see the VARIABLES
section).
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.
Transitions:
Transitions do not add time to the overall slideshow, they just get
overlaid on top of the adjacent images. Because of this, the transition
duration can not be greater than half of the adjacent image
duration.
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.
wipe:duration:subtitle:[up|down|left|right]
Wipes from one picture to the next. The direction is optional and will
default to left.
chapter
Force manual chapter marker timing. Chapter markers will only be created
where the "chapter" keyword occurs. The default is to add
chapter markers at every slide.
include:includefile.txt
Other input files can be included in the input .txt file. The file
includefile.txt will be concatenated in the place where the line
occurs..
exit
Stops the slideshow at the current point as if the input.txt file ended at
this point. Useful for debugging
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.
Note that in high quality mode (-H), some calculations will be made to see how slow the scroll is, and if it is slow enough, sub-pixel sampling will be used to make the scroll effect look much smoother. Sounds good, right? Well, it will take a LOT longer to process the frames also!
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
If you want to concatenate two audio files, just place them one right after another in the .txt file.
You can specify lots of variables and options throughout the
dvd-slideshow script. Settings can be passed on the command line, in a
default ~/.dvd-slideshow/dvd-slideshowrc file, or within the input text
file. The order in which the script reads the settings is as follows:
Default script settings --> ~/.dvd-slideshow/dvd-slideshowrc --> command
line --> input text file
so each successive setting will over-ride the previous settings if they are
already set.
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
high_quality=0 # use high-quality mode (set to 1)
autocrop=1 # autocrop images to fill full screen
border=0 # add border of N pixels between image and dvd edge
sharpen=0 # Enable image sharpening for all images
widescreen=0 # use widescreen mode (16:9) instead of 4:3
## Default font:
font=/usr/share/fonts/default/Type1/n019004l.pfb # Helvetical bold URW
font
## Subtitle: subtitle_type="dvd" # use
"render" to force rendering of text.
subtitle_font_size=24
subtitle_font='/usr/share/fonts/default/Type1/n019004l.pfb' # Helvetical
bold URW font
subtitle_color="white"
subtitle_outline_color="black"
subtitle_location="bottom"
subtitle_location_x=0
subtitle_location_y=105
## Title:
title_font_size=48
title_font_color="black" # or use hex "#RRGGBB"
title_font='/usr/share/fonts/default/Type1/n019004l.pfb' # Helvetical bold
URW font
## top title:
toptitle_font_size=48
toptitle_font_color="black" # or use hex "#RRGGBB"
toptitle_bar_height=125 # 0 for no 50% white behind text
toptitle_text_location_x=80
toptitle_text_location_y=50
# bottom title:
bottomtitle_font_size=36
bottomtitle_font_color="black" # or use hex "#RRGGBB"
bottomtitle_bar_location_y=156 # relative to bottom of image
bottomtitle_bar_height=55 # 0 for no 50% white behind text
bottomtitle_text_location_x=0
bottomtitle_text_location_y=155
# kenburns:
kenburns_acceleration=1 # seconds of slow acceleration for kenburns
# use 0 for no acceleration, or, use a percent of the effect time:
# kenburns_acceleration=25% # will accelerate for the first 25% of the
effect.
# logo:
logo=path/to/logofile.png # will be overlaid on top of all frames. Must be
pre-sized manually.
logo_gravity=SouthEast # Position of logo overlay. North | South | East |
West | NorthEast | NorthWest | SouthEast | SouthWest
A theme is just a file containing a list of configuration variables, and possibly also background images, fonts, or audio in the same directory.
Any of the configuration variables can be placed in a dvd-slideshow theme file to control dvd-slideshow also..br
This will be explained more later...
dvd-slideshow
dvd-menu
dir2slideshow
gallery1-to-slideshow
jigl2slideshow
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/
0.8.4 | Scott Dylewski |