]> git.decadent.org.uk Git - videolink.git/blobdiff - README
Added more standard headers that are strictly required.
[videolink.git] / README
diff --git a/README b/README
index dfa4ff5fbbf3a6d8b4264eee90796d36eb85f28c..e51a3e6c240ce2ccd36ecc2e8f12f289042fb9ba 100644 (file)
--- a/README
+++ b/README
@@ -19,7 +19,7 @@ VideoLink depends on the following software:
 - expat 1.x
 - Gtkmm 2.0
 - ffmpeg or mjpegtools
-- Mozilla 1.7.x (later versions may work but are untested)
+- Mozilla 1.7.8 or later, or XULRunner
 - netpbm
 - Xvfb (from XFree86 or X.org)
 
@@ -42,10 +42,10 @@ below.
 Linking to video
 
 You can link directly to local MPEG video files whose names end in
-".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" 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
 
@@ -135,16 +135,16 @@ multiple menus.  The frame size is dictated by the video standard; see
 above.  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 VideoLink 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.
+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 Mozilla version 1.8, which I have not yet tested, Mozilla may
-signal that a page is completely loaded before any background images
-are loaded and displayed.  This results in snapshots that do not
-include background images.  You can work around this by using
-absolutely-positioned "inline" images, or attempt to build VideoLink
-against Mozilla 1.8.
+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
@@ -176,6 +176,40 @@ 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 VideoLink.
 
+There is a limit of 128 menus in each "domain" of a DVD, which is
+further reduced by dvdauthor to a practical limit of 119 menus.
+Currently VideoLink generates all menus in a single domain (the VMGM
+domain).  Later versions of VideoLink should support larger numbers of
+menus by using multiple domains.
+
+Bugs
+----
+
+Under Mozilla 1.7, VideoLink sets the assumed screen resolution to
+40 dpi, which I reckon to be the average resolution of a standard
+definition TV display.  This should mean that text with a font size
+expressed in millimetres or points will appear around the specified
+size.  Unfortunately this setting has a different effect under
+Mozilla/XULRunner 1.8:
+
+Mozilla   Assumed    Requested     Actual size
+version  resolution    size     (pixels) (inches)
+           (dpi)
+
+  1.7    default:96    20 px       20      0.5
+  1.7    default:96    36 pt       48      1.2
+  1.7        40        20 px       20      0.5
+  1.7        40        36 pt       20      0.5
+  1.8    default:96    20 px       20      0.5
+  1.8    default:96    36 pt       48      1.2
+  1.8        40        20 px       48      1.2
+  1.8        40        36 pt       48      1.2
+
+From version 0.10, until I have a proper solution, VideoLink will not
+set the assumed screen resolution under Mozilla 1.8.  I must advise
+against using font sizes in millimetres or points since they will vary
+between browser versions.
+
 Author and copyright
 --------------------