annotate DOCS/DXR3 @ 2795:51bb2caa5f2a

warning for unknown parameters is quite enough
author nick
date Sat, 10 Nov 2001 15:01:47 +0000
parents b9732eaa82d9
children 1d4fb4d9aab5
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
1 DXR3/H+ video/audio output plugins manual by David Holm
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
2 =======================================================
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
3
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
4 1. Introduction
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
5
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
6 The DXR3 and Hollywood+ are two not too different mpeg-(1/2) and ac3
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
7 hardware playback cards that came at about the same time as the first
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
8 dvd-rom drives hit the market. At that time most computers weren't
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
9 powerful enough for synced software dvd playback. And even the faster
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
10 (intel-based) computers had troubles with artifacts.
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
11 Sigma Designs came up with the great idea to create a hardware
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
12 mpeg-(1/2), ac3 decoder. Sigma Designs are known for their realmagic
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
13 hardware (or they bought the company who came up with the first
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
14 realmagic boards, I don't know which).
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
15 Later Creative Labs thought, hey, we also wan't this product, and to
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
16 distribute it with our dvd-drives (the DVD Encore packages if I recall
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
17 correctly). So they bought the designs for the Hollywood plus and
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
18 replaced the circuit used to produce a proper video feed for tv's
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
19 called adv7170 or adv7175a depending on which h+ board you own with
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
20 a bt865. The reason for this is beyond my understanding as this seems
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
21 complete illogical to me, but I have had great experiences with
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
22 bt(brooktree) circuits in the past, so I don't mind.
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
23 Well, nowadays most people have no use for a mpeg-(1/2) or ac3
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
24 hardware decoder since most computers these days have no problem doing
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
25 this in software and have cycles left for posprocessing (removing of
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
26 artefacts and other garbage produced by compression).
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
27 These days, you have two uses for this card:
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
28 1. You have a slow computer which you use for vcd/dvd playback
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
29 2. You discover what I have done with the implementation of this as
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
30 an audio/video output device for mplayer (read on and you'll find
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
31 out).
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
32
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
33
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
34
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
35 2. Requirements
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
36
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
37 * First of all you will need the DXR3/H+ drivers properly installed,
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
38 including the dev-api.
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
39 These can be downloaded from dxr3.sourceforge.net (I suggest using
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
40 the CVS version since most of the time I use the latest features
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
41 which are only available through cvs)
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
42
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
43 * <mplayerdir>/libavcodec from ffmpeg (only required if you intend to
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
44 play formats other than mpeg-(1/2), highly recommended!) there are
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
45 two ways of doing this:
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
46 1. Download and install ffmpeg from ffmpeg.sourceforge.net.
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
47 Configure it with --enable-shared
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
48 2. Download ffmpeg from ffmpeg.sourceforge.net, copy the entire
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
49 contents from <ffmpegdir>/libavcodec into <mplayer>/libavcodec
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
50 (symlinking won't work!). Then edit <mplayerdir>/libavcodec/utils.c
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
51 and move the line containing register_avcodec(&mpeg1video_encoder);
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
52 out of the CONFIG_ENCODERS #ifdef block and place it outside, for
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
53 instance below register_avcodec(&rawvideo_encoder);
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
54
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
55 * Run <mplayerdir>/configure and make sure that DXR3/H+ support =yes
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
56 and optionally that libavcodec or ffmpeg.so = yes
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
57
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
58 From here on compilation (of at least my code ;) should go without
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
59 problems.
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
60
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
61
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
62
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
63 3. Usage
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
64
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
65 After installation you will have two new outdevices in mplayer:
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
66 -vo dxr3 For video output
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
67 -ao dxr3 For audio output (due to an unresolved bug
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
68 this is not recommended/useful!)
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
69
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
70 MPEG-1, MPEG-2, VCD and DVD Notes
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
71 There are some notes to take into account here for optimum playback.
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
72 When playing any mpeg-(1/2) file, this including usage of the "-dvd"
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
73 and "-vcd" options you must either add the "-vc mpegpes" or edit
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
74 codecs.conf and make sure videocodec mpegpes is listed above mpeg12.
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
75 If you fail to do this you will only get software playback which kinda
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
76 spoils most of the useful features of this card except for tv-out ;).
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
77 Remember that if you edit the codecs.conf file and move the mpegpes
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
78 section will have to specify "-vc mpeg12" if you want to playback
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
79 any of these video types _without_ "-vo dxr3"!
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
80
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
81 DIVX Notes
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
82 When playing divx's add "-vc odivx", if you get any other divx codec
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
83 to run faster tell me which one because I'll be interested in how it
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
84 could possibly be any faster than OpenDivX4Linux...
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
85
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
86 Unsupported Codecs:
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
87 If you ever get a codec unsupported message, lookup the codec in the
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
88 codecs.conf file (search for "videocodec <codecname>"), copy the entire
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
89 codec section and send it to me and I'll make sure it works with the
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
90 next patch (or the next after that if I have a thousand things to take
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
91 care of first ;) my e-mail is at the bottom of this page.
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
92
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
93 4. Todo
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
94
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
95 * Scale video played using windows codecs (High)
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
96 * Make the osd use the subpic feature of the dxr3 (almost done)(High)
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
97 * Driver options (probably not until libvo2) (Medium)
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
98
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
99
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
100
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
101 5. Contacting me
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
102
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
103 You can contact me either by e-mailing me, <dholm@iname.com> or by using
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
104 icq: 798427
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
105 Feedback, bugreports and general suggestions are appreciated (preferably
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
106 by e-mail). My name is David Holm for those of you who are incapable of
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
107 reading a heading. ;)
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
108
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
109