X-Git-Url: https://git.decadent.org.uk/gitweb/?p=videolink.git;a=blobdiff_plain;f=README;h=e2beea2d496acf24c97bc48dd052da9733e8f154;hp=1f632c0634fa3c31686e4cf3a8d7d5eb13133457;hb=HEAD;hpb=801ab856156749cab907fb209e81c082c3c990c4 diff --git a/README b/README index 1f632c0..e2beea2 100644 --- a/README +++ b/README @@ -18,14 +18,20 @@ VideoLink depends on the following software: - dvdauthor - expat 1.x - Gtkmm 2.4 or later -- ffmpeg or mjpegtools -- Mozilla 1.8 or later, or XULRunner -- netpbm +- either of: + - ffmpeg including mpeg2video encoding + ("ffmpeg -formats" should show "DEVSDT mpeg2video" in the codecs section) + - both of: + - mjpegtools 1.8 or later + - netpbm +- Mozilla 1.8 or later, or XULRunner 1.9 or later - Xvfb (from XFree86 or X.org) To build a complete DVD image you will also need: -- mkisofs +- either of: + - genisoimage (from cdrkit) + - mkisofs (from cdrtools) You will also need a program for producing DVD-suitable MPEG-1 or MPEG-2 video files. @@ -42,10 +48,10 @@ below. Linking to video You can link directly to local MPEG video files whose names end in -".mpeg", ".mpeg2" or ".vob". If you wish to combine multiple files -into a single video sequence ("title" in DVD terminology) or to add -chapter marks to a video sequence, create and link to a VOB-list file -(explained below) whose name ends in ".voblist". +".mpeg", ".mpeg2", ".mpg" or ".vob". If you wish to combine multiple +files into a single video sequence ("title" in DVD terminology) or to +add chapter marks to a video sequence, create and link to a VOB-list +file (explained below) whose name ends in ".voblist". VOB-lists @@ -98,8 +104,6 @@ interlaced; | | or 625/50 | The default is to use "PAL" parameters. -Currently - Preview To get a rough preview of the menus, run "videolink --preview menu-url" @@ -118,10 +122,7 @@ to the other pages and to the video files. By default, VideoLink now calls ffmpeg to generate MPEG-2 streams for menus. If you want it to use mjpegtools as it previously did, you -must add the option "--encoder mjpegtools". If you use mjpegtools -1.6.2 or earlier you must instead use "--encoder mjpegtools-old". -This is due to an incompatible change in the syntax of the ppmtoy4m -command between versions 1.6.2 and 1.8. +must add the option "--encoder mjpegtools". If this is successful you can then use mkisofs to create a DVD image from the output directory. Alternately you can write this directory @@ -149,13 +150,6 @@ reason VideoLink applies a stylesheet to all pages that adds padding equal to 10% of the frame dimension on each side of the body; this doesn't apply to the background. -Prior to version 1.8, Mozilla may signal that a page is completely -loaded before any background images are loaded and displayed. This -can result in VideoLink converting the page without the background -images. If VideoLink is built with an older version of Mozilla you -can work around this by using absolutely-positioned "inline" images, -since Mozilla will always wait for these to load. - DVD players do not have "back" buttons, so you should generally provide links to "higher" menu pages. However, they do have a button for returning to the top menu. @@ -210,7 +204,7 @@ Author and copyright -------------------- VideoLink was written by Ben Hutchings . -Copyright 2005-2006 Ben Hutchings. +Copyright 2005-2008 Ben Hutchings. This software is based in part on the work of the Independent JPEG Group. Copyright 1991-1998 Thomas G. Lane. (This applies to the file jquant2.c.)