Tovid Wiki

This page will introduce the slideshow options in todisc (' tovid disc ') introduced in tovid 0.32.

Sorry, this page is yet to be written as a proper article - any volunteers?

In the meantime here are some excerpts from the manpage:


You can also use todisc to make slideshows.

This can either be a single slideshow, or multiple slideshows on the same menu. (for SVCD only single slideshow is supported). Remember to use -slides rather than -files for passing in the images. Images can be any filetype that imagemagick supports: for example JPEG, PNG, GIF, TGA BMP etc. For a single slideshow do not use -titles: use -menu-title to set the slideshow title.

For a single slideshow the default is an animated menu that transitions from slide to slide. The default transition type is ’crossfade’, which fades each slide into the next and loops back to the first slide at the end. If instead you use -static, then a static ’polaroid stack’ menu of all the slides is created, with a single button for navigating with the enter key. You may have to experiment to find out which DVD remote button advances the slides, on my player it is different for DVD and SVCD. Try the ’next chapter’ (skip ?) button and the play or enter buttons.

If you want to limit the number of slides in the menu to a subset of all files entered with -slides, then use -menu-slide-total INT. Be sure to use a long enough audio file for -bgaudio or set -menu-length so the menu is long enough to support the slides plus transitions.

You can also put multiple slideshows on one menu. To do this, use -slides IMAGES for each slideshow desired. You can even mix videos with slideshows by using -files -slides -titles multiple times.

      Example of a single slideshow with an animated menu with transitions:
      $ todisc -menu-title "Autumn in Toronto" -slides images/*.jpg \
        -menu-slide-total 20 -slide-transition crossfade -bgaudio slideshow.wav \
        -out myslideshow
      Example of multiple slideshows on one menu:
      $ todisc -menu-title "Autumn in Toronto" \
        -slides photos/september/*.jpg \
        -slides photos/october/*.jpg \
        -slides photos/november/*.jpg \
        -tile3x1 -rotate -5 5 -5 -align center \
        -bgaudio background.wav \
        -out myslideshow
      Example of mixed videos and slideshows:
      $ todisc -menu-title "Autumn in Toronto" \
        -files \
        -slides  photos/september/*.jpg \
        -files harvest.mpg \
        -slides photos/october/*.jpg \
        -titles "Fall Fair" "September" "Harvest" "October" \
        -background autumn.png \
        -bgaudio bg.mp3 \
        -out myslideshow
      See the other slideshow options in the Slideshow options'
      section of the manpage.
    Slideshow options
      -slides IMAGES
             Use  -slides IMAGES to pass in images for a slideshow.  The 
             default is to make an animated menu of the slides,
             moving from one slide to the next. If you use -static, a 
             ’polaroid stack’ montage is created.  This composites
             the  slides onto the background in ’random’ locations with 
             random rotations.  -slides  IMAGES can be used multiple times
             if you wish to make a menu with multiple slideshows (DVD only).  
                 You can also make a menu of mixed videos and slideshows by using
             -slides IMAGES, and -files VIDEOS multiple times.  For such a
             menu, the number of -titles needs to match the number of -files
             passed in plus the number of slideshows.  (Each  time  you  use
             -slides  counts  as one title.)  To use a transition between the 
             slides, use -slide-transition crossfade|fade.
                  See -slide-transition -menu-slide-total
      -menu-slide-total INT
             Use INT number of the slides that were passed in with -slides to 
             make the animated or static slide menu.   The
             length of the menu is determined by 1) -menu-length NUM if 
             given,  and by 2) the length of the audio from
             -bgaudio.  For submenu slideshows, it is determined by 1) 
             -submenu-length NUM if given,  and by 2) the  length
             of the audio from -submenu-audio FILE(S).
      -submenu-slide-total INT
             This option is the same as -menu-slide-total except that it is 
             for submenu slideshows.
      -slide-transition crossfade|fade [crossfade]
             The type of fade transition between slides in a animated slide 
             menu.  Be sure the menu length is long enough
             to support the 1 second transitions between the slides.  The 
             length is determined by  1) the length of the
             -bgaudio  AUDIO   2)  the  length given with -menu-length NUM.  
             For submenu slideshows, it is determined by 1)
             -submenu-length NUM if given,  and by 2) the length of the audio 
             from -submenu-audio FILE(S).
                  The ’crossfade’ transition fades from one slide to another.  
             The ’fade’ transition fades in and out from  and
             to black.  If you don’t use this option, the default is to use 
             a ’crossfade’ transition.
             See -menu-slide-total , -bgaudio , -menu-length , 
             -submenu-length, and -submenu-audio.
      -slideshow-menu-thumbs FILES
             Use the FILES instead of the 1st image in each slideshow as the 
             thumb that shows on the menu.  This option is
             for multiple slideshows or mixed slideshow/video menus only.
      -slides-to-bin FILES
             FILES will be resized to 640x480 using a ’box’ filter - this 
             is called ’binning’.  It will reduce the  ’signal
             to  noise’ ratio for the image in the animated slide menu.  Use 
             this if you get some unwanted effects for certain images, such
             as pixels shifting in  what should be a static  image.   See also
            -slides-to-blur and -slide-border
      -slides-to-blur FILES
             FILES  will  be  blurred a small amount - which will help on 
             slides that still have noise even after ’binning’
             with -slides-to-bin.  The default blur is 0x0.2 - you can  
             increase this with -slide-blur  ARG.   See also
             -slides-to-bin and -slide-border.
      -slide-blur VALUE or LIST of VALUES [0x0.2]
             The  argument to use for blurring files.  It will be passed to 
             imagemagick: convert -blur ARG.  The format of
             the arg is {radius}x{sigma} and the default is 0x0.2. Using 
             values between 0x0.1 and  0x0.9 is probably the
             best range.   Use a single value for all,  or a list to 
             have a different blur for each file passed with
             -slides-to-blur.  You must pass in -files-to-blur FILES to use 
             this option.  Blurring can help with video ’noise’ problems.  See
             also -slides-to-bin and -slide-border
      -slide-border WIDTH [100]
             Pad the slides with a border for the animated slide menu.  
             The default without using an argument is 100.
             Using this option can also solve some noise/ringing effects if 
             used alone or in conjunction  with  ’binning’
             (-slides-to-bin) or blurring (-slides-to-blur).
      -slide-frame WIDTH [12]
             Frame  the  slides for the animated slideshow menu.  The default 
             width with no argument is 12.  See also -slide-frame-color
      -slide-frame-color | -slide-frame-colour
             The color of the slide frame if passing -slide-frame.   The  
             default  if  you  don’t  use  this  option  is  a
             color-safe white: rgb(235,235,235).
             If  doing  multiple slideshows or mixed videos and slideshow(s), 
             then use the animated slideshow as a showcase
             video.  It will be composed of slides from each slideshow in the 
             menu.  The thumb for  each  slideshow  button
             will  be  static.   If you used with a mixed menu of videos and 
             slideshows, then the video thumbs WILL be ani‐
             mated, so you may wish to use -static or -textmenu with the 
             option in that case.
             If doing multiple slideshows or mixed videos and slideshow(s), 
             then use the animated slideshow as a background
             video.  See -showcase-slideshow for additional details.
             todisc  is  alpha  software,  so  for  your  protection todisc 
             prompts you to back up your files first.  It is
             unlikely that todisc will destroy or overwrite your photos, but 
             as with  any  largely  untested  software  you should back up
             first.   If  you  have already backed up and do not want to be
             prompted every time, use this option.
      -use-dvd-slideshow CONFIG (FILE)
             If you pass this option without an argument, todisc will use the 
             dvd-slideshow program to create the animated
             slide menu, assuming you have this program installed.   The 
             optional argument is the dvd-slideshow configuration file  - if
             you don’t use this argument todisc will create it for you.  If
             you want  to  use  the ’Ken  Burns  effect’  -  then  the
             configuration file argument is required.  Note: the configuration
             file will override many of the above options for slideshows.