Mercurial > libdvdnav.hg
comparison README.MAP @ 96:2fcb4f228308 src
Adding "Personalizing DVD Viewing" files from <kevin_smathers@hp.com>
Not yet enabled. Will be enabled soon.
author | jcdutton |
---|---|
date | Tue, 17 Sep 2002 10:47:02 +0000 |
parents | |
children | bba82ef5d75a |
comparison
equal
deleted
inserted
replaced
95:e7ebabe059b9 | 96:2fcb4f228308 |
---|---|
1 Contents | |
2 | |
3 WHAT ARE MAP FILES | |
4 HOWTO | |
5 FINDING MAP FILES | |
6 WHOM TO BLAME | |
7 | |
8 WHAT ARE MAP FILES | |
9 ================== | |
10 | |
11 Map files are an experimental feature that lets you customize the way | |
12 you watch DVDs. If you are opposed to violence, are sickened by gore, | |
13 or would rather your two year old didn't ask you just yet why that | |
14 woman in the movie was naked, you might want to create a map file. | |
15 | |
16 Map files identify sections of the movie that will be skipped during | |
17 playback. You can skip any section you like with the only restriction | |
18 (right now) that the movie player must play at least the last VOBU | |
19 (about a fifth of a second) of each chapter in the movie in order | |
20 to detect chapter changes correctly. | |
21 | |
22 Included with this patch is an example map file that describes most | |
23 of the potentially objectionable content in the new "The Lord of the | |
24 Rings" DVD. I've added a comment after each block that identifies | |
25 what content it contains so that you can customize the file to your | |
26 preferences. The map file looks something like this: | |
27 | |
28 # The Lord of the Rings: Fellowship of the Ring | |
29 # (Widescreen Theatrical Release) | |
30 debug | |
31 domain 8, title 1, program 1, start 0x0000, end 0x1f0a # Introduction | |
32 | |
33 # history of middle earth | |
34 #domain 2, title 1, program 1, start 0x9cba, end 0xcea4 # violence/war | |
35 #domain 2, title 1, program 1, start 0xf018, end 0x1272c # violence/war | |
36 domain 2, title 1, program 1, start 0x11ff3, end 0x1272c # gore | |
37 #domain 2, title 1, program 1, start 0x173f1, end 0x185d6 # violence/death | |
38 | |
39 Place the map file in your .xine directory to enable the selected | |
40 cuts as follows: | |
41 | |
42 cp FELLOWSHIP.map ~/.xine | |
43 | |
44 The debug command tells the map code that you would like to see the | |
45 VOBU numbers as the movie is playing. Comment out this line to hide | |
46 this output. The remaining lines are all either comments or blocks. | |
47 Each block has a start and an end, and whenever Xine tries to load | |
48 a VOBU between the start and end, it will be redirected to the end | |
49 block instead. | |
50 | |
51 | |
52 HOWTO | |
53 ===== | |
54 | |
55 To create your own map files you would create a new map file using the | |
56 title of the disk as the filename, and add the debug line to it. The | |
57 map file should be placed in your '.xine' directory and have a '.map' | |
58 extension added. For example "The Lord Of The Rings" map must be stored | |
59 in the file ~/.xine/FELLOWSHIP.map | |
60 | |
61 After you create the file with the DEBUG line you will see output that | |
62 looks like this in window where you started Xine: | |
63 | |
64 FELLOWSHIP: domain 8, title 1, program 1, start 2205, next 22a8 | |
65 FELLOWSHIP: domain 8, title 1, program 1, start 22a8, next 234b | |
66 FELLOWSHIP: domain 8, title 1, program 1, start 234b, next 23eb | |
67 FELLOWSHIP: domain 8, title 1, program 1, start 23eb, next 248a | |
68 | |
69 Each line represents one VOBU, and the start and end addresses match | |
70 the start and end addresses that you should place in the map file | |
71 if you want to skip that block. If you want to skip multiple blocks | |
72 you would just add one line with the start address of the first block | |
73 to skip, and the end address of the last block to skip. For example | |
74 to skip these four blocks you would add the following line to your | |
75 map file: | |
76 | |
77 domain 8, title 1, program 1, start 0x2205, end 0x248a # 4 blocks | |
78 | |
79 Xine uses a buffered input chain so that if you pause the viewer you | |
80 won't find the same VOBU being displayed on the terminal as is | |
81 currently on the screen. In my testing the correct VOBU to use if | |
82 you pause exactly on the section you want to cut will be about five | |
83 or six lines above the last one printed to the screen. Replay the | |
84 scene with the deletion to see if you caught the correct blocks. | |
85 | |
86 | |
87 WHERE TO FIND MAP FILES | |
88 ======================= | |
89 | |
90 If you create a map file for a new movie, please send it to me. If | |
91 there is widespread interest I'll put up a site where map files can | |
92 be located and downloaded. | |
93 | |
94 | |
95 WHOM TO BLAME | |
96 ============= | |
97 | |
98 If the patch doesn't work for you (and you want it to) you can contact | |
99 me at 'kevin_smathers@hp.com'. | |
100 | |
101 If the patch works for you and you don't want it to, remember that | |
102 not everyone in the world has the same needs. The freedom to censor | |
103 movies in our own homes is quite different from the government | |
104 interfering into libraries and other public forums to censor movies | |
105 for us. |