annotate README.MAP @ 145:4d14c444c155 src

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