Complex example
The text file is on the left with comments, and the sample output is on the right.

dvd-slideshow was run with the following arguments:

dvd-slideshow -n 'test complex' -f complex.txt

# set some variables:
debug=0 # debug

# define background but don't display it:
background:0::background.jpg

# note that tenths or hundredths of seconds can be specified:
fadein:2.58 		sample
# title slides have an upper and lower title:
title:5.5:Top Title:Lower Title 		sample

fadeout:2.8 		sample
# display a picture
picture2.jpg:3 		sample
crossfade:2 sample
# there are also effects which you can use:
# scroll right/left, crop, and kenburns.
# let's go through a "crop" first, because the syntax is simpler:
# image.jpg:dur:sub:crop:x0,y0;x1,y1
# Crops the image about the coordinates specified.
# Full box description:
# x0,y0;x1,y1
# Specifies the top-left(0) and bottom-right(1) points.
# Keyword description:
# frame 0%-100%;frame_location
# where 0%-100% indicates the fraction of the final
# dvd window width/height, and frame_location refers
# to the CENTER POINT of the picture,
# and 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

picture1.jpg:2:Picture 1 cropped:crop:50%;topleft
# now let's start playing the audio on track 1:
strojovna_07-TEXEMPO-30s.ogg:1 		sample
# kenburns is the most flexible effect:
# image.jpg:dur:sub:kenburns:start_box;end_box
# Where now we have start and end boxes, defined in
# the same way as in the "crop" function, but now
# we have two boxes defined.
# The video will then slowly morph from the start to the end, doing
# whatever cropping/zooming is necessary. This takes a long time to
# process each frame!
# You can add a subtitle during the transition, but it's optional
# Note that to pass no subtitle, you need to use '::'

# Full box description:
# xs0,ys0;xs1,ys1;xe0,ye0;xe1,ye1
# Specifies the top-left(0) and bottom-right(1) points.
# Keyword description:
# start 0%-100%;start_location;end 0%-100%;end_location
# Kenburns examples:
# image.jpg:dur:sub:kenburns:651,390;1134,759;372,330;1365,1089
# image.jpg:dur:sub:kenburns:30%;60%,60%;75%;40%,50%
# image.jpg:dur:sub:kenburns:50%;topleft;50%;bottomright
# image.jpg:dur:sub:kenburns:100%;left;0,0;720,480
# image.jpg:dur:sub:kenburns:100%;left;imageheight;left

picture1.jpg:4:zoom out:kenburns:25%;middle;100%;middle 		sample sample sample
# Another example of a kenburns effect:
picture1.jpg:4:Wow, it's moving!:kenburns:50%;topleft;50%;bottomright 		sample sample sample sample
# pause at the end with another crop:
picture1.jpg:2:Picture 1 cropped:crop:50%;bottomright 		sample
fadeout:2
background:1 		sample
# now let's start playing the audio on track 2:
# this is independent of audio track 1
strojovna_07-TEXEMPO-30s.ogg:2

fadein:2 		sample
pano.jpg:2:cool panorama picture sample
# zoom in to left side of panorama:
pano.jpg:4::kenburns:100%;left;imageheight;left 		sample sample sample
# pause
pano.jpg:2:pausing...:crop:imageheight;left 		sample
# You can scroll across a panorama picture by using the "scroll right"
# or "scroll left" effects (up/down works also).
# This will automatically pan across the image:
# image.jpg:duration:subtitle:scroll:left
# a duration of 10 is way too fast for the image below. Change
# it to 30 to make it look better, but it take longer to render.
pano.jpg:10:Scrolling way to fast:scroll:right 		sample sample sample sample
# pause
pano.jpg:2:pausing...:crop:imageheight;right
# note that this is the same as the following syntax, but it's much
# easier to deal with instead of the older method:
# pano.jpg:2::crop:4610,0;5334,480

# we could do the kenburn effect backwards to zoom out, but
# I hope you get the idea... 		sample
crossfade:3 sample
picture2.jpg:3 sample
fadeout:2 sample
background:2:This is the background sample
Now, you can run dvdauthor to make a menu:

dvd-menu -b background.jpg -o dvd_fs_complex -t 'Test complex' -f test_complex.xml -n 'Simple DVD'

you can view the resulting dvd directory using xine:

xine -g -u 0 dvd:"`pwd`/dvd_fs_complex/"

View the video in XVID format:
sample
SourceForge.net Logo