X-Git-Url: https://git.decadent.org.uk/gitweb/?a=blobdiff_plain;ds=sidebyside;f=README;h=d673eca94058387b375999feae53302ea396afd6;hb=3b8f19cf0feb2b02d92fb9b27dd182d045c42d46;hp=fa2fdddf9828f85bb23237c50be013ded30c1175;hpb=84fb85103e80499cc8dc7929375e9a1798e043da;p=videolink.git
diff --git a/README b/README
index fa2fddd..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.7.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,14 +104,14 @@ 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"
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
@@ -108,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
@@ -139,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.
@@ -183,36 +187,24 @@ 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
--------------------
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.)