]> git.decadent.org.uk Git - videolink.git/blobdiff - README
Brought up to date in preparation for version 1.2.
[videolink.git] / README
diff --git a/README b/README
index c273e4379124fa69b0882ee003b849229cc6f463..1f632c0634fa3c31686e4cf3a8d7d5eb13133457 100644 (file)
--- a/README
+++ b/README
@@ -17,9 +17,9 @@ VideoLink depends on the following software:
 
 - dvdauthor
 - expat 1.x
-- Gtkmm 2.0
+- Gtkmm 2.4 or later
 - ffmpeg or mjpegtools
-- Mozilla 1.7.8 or later, or XULRunner
+- Mozilla 1.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
 
@@ -67,6 +67,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:
+
+    <a href="movie.voblist#1">Chapter 1</a><br>
+    <a href="movie.voblist#2">Chapter 2</a><br>
+    <a href="movie.voblist#3">Chapter 3</a><br>
+    <a href="movie.voblist#4">Chapter 4</a>
+
 Video standards
 
 The encoding of analogue TV and video signals varies in many different
@@ -98,6 +106,8 @@ To get a rough preview of the menus, run "videolink --preview menu-url"
 where menu-url is the URL or filename of the first page to show.
 Currently videos cannot be displayed in this preview mode.
 
+Press T to go to the "top" (main) menu or Q to quit.
+
 Processing
 
 To create a DVD filesystem, run "videolink menu-url output-dir" where
@@ -135,9 +145,9 @@ 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 version 1.8, Mozilla may signal that a page is completely
 loaded before any background images are loaded and displayed.  This
@@ -176,33 +186,25 @@ 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.
 
+Currently VideoLink code can generate up to 999 menus but it may be
+possible for me to raise this internal limit if you want more.  There
+appears to be an absolute limit of 12800 menus on a DVD.
+
 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.
+VideoLink should set the assumed screen resolution to 40 dpi, which I
+reckon to be the average resolution of a standard definition TV
+display.  This would mean that text with a font size expressed in
+millimetres or points will appear around the specified size.
+Earlier versions of VideoLink did this when built to use Mozilla 1.7.
+Unfortunately the resolution setting in Mozilla 1.8 actually affects
+measurements in pixels and not measurements in millimetres or points!
+The assumed screen resolution is always 96 dpi.
+
+Please specify measurements such as font sizes in pixels because
+measurements in millimetres or points are liable to change if and when
+I can override the assumed screen resolution again.
 
 Author and copyright
 --------------------