X-Git-Url: https://git.decadent.org.uk/gitweb/?a=blobdiff_plain;ds=sidebyside;f=README;h=d673eca94058387b375999feae53302ea396afd6;hb=3b8f19cf0feb2b02d92fb9b27dd182d045c42d46;hp=d7b003c3700e95ad7956fb943bd52560c18714da;hpb=848b64a0be9d0fb5fbff354796f91a042a5dd4c1;p=videolink.git
diff --git a/README b/README
index d7b003c..d673eca 100644
--- a/README
+++ b/README
@@ -17,15 +17,21 @@ VideoLink depends on the following software:
- dvdauthor
- expat 1.x
-- Gtkmm 2.0
-- ffmpeg or mjpegtools
-- Mozilla 1.8 or later, or XULRunner
-- netpbm
+- Gtkmm 2.4 or later
+- 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 (currently 1.9.1 is not compatible)
- 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
@@ -67,6 +73,14 @@ This will result in a title with the following chapters:
4: main.vob 17:45- end
5: credits.vob
+You can link to the start of a chapter by adding "#" and the chapter
+number after the VOB-list's file name. For example:
+
+ Chapter 1
+ Chapter 2
+ Chapter 3
+ Chapter 4
+
Video standards
The encoding of analogue TV and video signals varies in many different
@@ -90,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"
@@ -110,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
@@ -141,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.
@@ -202,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.)