X-Git-Url: https://git.decadent.org.uk/gitweb/?p=videolink.git;a=blobdiff_plain;f=README;h=e2beea2d496acf24c97bc48dd052da9733e8f154;hp=fa2fdddf9828f85bb23237c50be013ded30c1175;hb=HEAD;hpb=84fb85103e80499cc8dc7929375e9a1798e043da diff --git a/README b/README index fa2fddd..e2beea2 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 or later - 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.)