]> git.decadent.org.uk Git - videolink.git/commitdiff
Added various notes and updated copyright date.
authorBen Hutchings <ben@decadent.org.uk>
Mon, 6 Mar 2006 19:51:09 +0000 (19:51 +0000)
committerBen Hutchings <ben@decadent.org.uk>
Sun, 2 Nov 2008 23:39:57 +0000 (23:39 +0000)
README

diff --git a/README b/README
index 3cd0e120611804bcfa14fab63079a601881ba962..5b1c255351ade23bb86266c8141659b57b385cb6 100644 (file)
--- a/README
+++ b/README
@@ -15,7 +15,7 @@ WebDVD depends on the following software:
 - dvdauthor
 - expat 1.x
 - Gtkmm 2.0
-- mjpegtools
+- mjpegtools 1.6.x (1.8 makes an incompatible change in usage of ppmtoy4m)
 - Mozilla 1.7.x (later versions may work but are untested)
 - netpbm
 - Xvfb (from XFree86 or X.org)
@@ -53,7 +53,20 @@ VOB-lists
 A VOB-list file is an XML file with the document element <vob-list>
 and containing <vob> elements as described in the dvdauthor manual
 page.  The file names in a VOB-list file are resolved relative to the
-directory containing the list file.
+directory containing the list file.  For example:
+
+    <vob-list>
+        <vob file="main.vob" chapters="0:00,4:55,12:13,17:45"/>
+        <vob file="credits.vob"/>
+    </vob-list>
+
+This will result in a title with the following chapters:
+
+    1: main.vob  0:00- 4:55
+    2: main.vob  4:55-12:13
+    3: main.vob 12:13-17:45
+    4: main.vob 17:45-  end
+    5: credits.vob
 
 Video standards
 
@@ -93,10 +106,13 @@ Limitations
 
 Each page must fit within the frame - DVD players do not support
 scrolling menus and WebDVD currently is not able to split them into
-multiple menus.  Note also that the video frame is somewhat larger
-than the visible area of a normal TV.  For this reason WebDVD applies
-a stylesheet to all pages that adds 60 pixels of padding on all sides
-of the body.
+multiple menus.  The standard frame size for PAL and SECAM is 720x576
+pixels; for NTSC it is 720x480 pixels.  The exact visible area varies
+between TVs so the background should cover all or very nearly all the
+frame whereas the important content such as text must not be placed
+near the edge.  For this reason WebDVD applies a stylesheet to all
+pages that adds 60 pixels of padding on all sides of the body; this
+doesn't apply to the background.
 
 Prior to Mozilla version 1.8, which I have not yet tested, Mozilla may
 signal that a page is completely loaded before any background images
@@ -128,15 +144,18 @@ reduce link highlighting to 1 transparent and 3 opaque colours using
 Floyd-Steinberg dithering, which is certainly good enough for
 anti-aliased text but may not be so good for complex highlighting.
 
-There is a limit of 99 "titlesets" (groups of video sequences) on a
-DVD.  Currently WebDVD does not attempt to group video sequences
-together, so there is a limit of 99 video sequences altogether.
+There is a limit of 99 "titles" on a DVD.  If you need to include more
+than this number of video sequences, you could arrange them as
+chapters of a title, so long as they use the same codecs, resolution,
+aspect ratio and sample rate.  However, each chapter will run into the
+next.  If this is a real problem, let me know, and I may be able to
+provide a better solution in a later version of WebDVD.
 
 Author and copyright
 --------------------
 
 WebDVD was written by Ben Hutchings <ben@decadentplace.org.uk>.
-Copyright 2005 Ben Hutchings.
+Copyright 2005-2006 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.)