annotate DOCS/DXR3 @ 3201:039a973b3dda

Newest DXR3 patch (improved 1.0rc2) by David Holm.
author atmos4
date Thu, 29 Nov 2001 17:31:58 +0000
parents 1d4fb4d9aab5
children 98a587aaf505
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
3201
039a973b3dda Newest DXR3 patch (improved 1.0rc2) by David Holm.
atmos4
parents: 3186
diff changeset
4 2001-11-28: ffmpeg replaced with mp1e, divx playback
039a973b3dda Newest DXR3 patch (improved 1.0rc2) by David Holm.
atmos4
parents: 3186
diff changeset
5 won't get much faster than this, huge thanks
039a973b3dda Newest DXR3 patch (improved 1.0rc2) by David Holm.
atmos4
parents: 3186
diff changeset
6 goes out to Ivan Kalvachev for helping me
039a973b3dda Newest DXR3 patch (improved 1.0rc2) by David Holm.
atmos4
parents: 3186
diff changeset
7 fix the final mp1e bugs (and contributing
039a973b3dda Newest DXR3 patch (improved 1.0rc2) by David Holm.
atmos4
parents: 3186
diff changeset
8 to the libvo2 development)
039a973b3dda Newest DXR3 patch (improved 1.0rc2) by David Holm.
atmos4
parents: 3186
diff changeset
9
3186
1d4fb4d9aab5 Patch by D. Holm to make audio with dxr3 working.
atmos4
parents: 2770
diff changeset
10 2001-11-27: -ao dxr3 now works, still a few bugs though
1d4fb4d9aab5 Patch by D. Holm to make audio with dxr3 working.
atmos4
parents: 2770
diff changeset
11 you might have to reload the em8300 modules
1d4fb4d9aab5 Patch by D. Holm to make audio with dxr3 working.
atmos4
parents: 2770
diff changeset
12 after a playback or you might get static the
1d4fb4d9aab5 Patch by D. Holm to make audio with dxr3 working.
atmos4
parents: 2770
diff changeset
13 next time you use the dxr3 audio interface.
1d4fb4d9aab5 Patch by D. Holm to make audio with dxr3 working.
atmos4
parents: 2770
diff changeset
14
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
15 1. Introduction
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
16
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
17 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
18 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
19 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
20 powerful enough for synced software dvd playback. And even the faster
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
21 (intel-based) computers had troubles with artifacts.
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
22 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
23 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
24 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
25 realmagic boards, I don't know which).
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
26 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
27 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
28 correctly). So they bought the designs for the Hollywood plus and
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
29 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
30 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
31 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
32 complete illogical to me, but I have had great experiences with
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
33 bt(brooktree) circuits in the past, so I don't mind.
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
34 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
35 hardware decoder since most computers these days have no problem doing
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
36 this in software and have cycles left for posprocessing (removing of
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
37 artefacts and other garbage produced by compression).
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
38 These days, you have two uses for this card:
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
39 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
40 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
41 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
42 out).
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
43
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
44
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
45
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
46 2. Requirements
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
47
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
48 * 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
49 including the dev-api.
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
50 These can be downloaded from dxr3.sourceforge.net (I suggest using
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
51 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
52 which are only available through cvs)
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
53
3201
039a973b3dda Newest DXR3 patch (improved 1.0rc2) by David Holm.
atmos4
parents: 3186
diff changeset
54 * Second, if you want DivX playback you need to download and install
039a973b3dda Newest DXR3 patch (improved 1.0rc2) by David Holm.
atmos4
parents: 3186
diff changeset
55 RTE from zapping.sourceforge.net compile and install it BEFORE
039a973b3dda Newest DXR3 patch (improved 1.0rc2) by David Holm.
atmos4
parents: 3186
diff changeset
56 running configure in the mplayer dir.
039a973b3dda Newest DXR3 patch (improved 1.0rc2) by David Holm.
atmos4
parents: 3186
diff changeset
57
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
58 * Run <mplayerdir>/configure and make sure that DXR3/H+ support =yes
3201
039a973b3dda Newest DXR3 patch (improved 1.0rc2) by David Holm.
atmos4
parents: 3186
diff changeset
59 and optionally that mp1e rte = yes, if it's = no, please mail me
039a973b3dda Newest DXR3 patch (improved 1.0rc2) by David Holm.
atmos4
parents: 3186
diff changeset
60 your configure.log and I'll fix it.
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
61
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
62 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
63 problems.
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
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
66
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
67 3. Usage
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
68
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
69 After installation you will have two new outdevices in mplayer:
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
70 -vo dxr3 For video output
3186
1d4fb4d9aab5 Patch by D. Holm to make audio with dxr3 working.
atmos4
parents: 2770
diff changeset
71 -ao dxr3 For audio output
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
72
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
73 MPEG-1, MPEG-2, VCD and DVD Notes
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
74 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
75 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
76 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
77 codecs.conf and make sure videocodec mpegpes is listed above mpeg12.
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
78 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
79 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
80 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
81 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
82 any of these video types _without_ "-vo dxr3"!
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
83
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
84 DIVX Notes
3201
039a973b3dda Newest DXR3 patch (improved 1.0rc2) by David Holm.
atmos4
parents: 3186
diff changeset
85 When playing divx's add "-vc odivx"
039a973b3dda Newest DXR3 patch (improved 1.0rc2) by David Holm.
atmos4
parents: 3186
diff changeset
86 I've switched to mp1e from ffmpeg so it should be lightning fast now.
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
87
3186
1d4fb4d9aab5 Patch by D. Holm to make audio with dxr3 working.
atmos4
parents: 2770
diff changeset
88 Other codecs:
1d4fb4d9aab5 Patch by D. Holm to make audio with dxr3 working.
atmos4
parents: 2770
diff changeset
89 Currently they don't work. I'm working on implementing libvo2 which
1d4fb4d9aab5 Patch by D. Holm to make audio with dxr3 working.
atmos4
parents: 2770
diff changeset
90 will be a much more convenient and faster way of working with
1d4fb4d9aab5 Patch by D. Holm to make audio with dxr3 working.
atmos4
parents: 2770
diff changeset
91 vo<->codec interaction. If libvo2 takes longer to develop than I
1d4fb4d9aab5 Patch by D. Holm to make audio with dxr3 working.
atmos4
parents: 2770
diff changeset
92 have estimated perhaps I'll add more codec support to libvo. Otherwise
1d4fb4d9aab5 Patch by D. Holm to make audio with dxr3 working.
atmos4
parents: 2770
diff changeset
93 you'll just have to wait for libvo2. (there is an implementation
1d4fb4d9aab5 Patch by D. Holm to make audio with dxr3 working.
atmos4
parents: 2770
diff changeset
94 for other codecs, but I think it's pretty broken currently ;)
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
95
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
96
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
97
3186
1d4fb4d9aab5 Patch by D. Holm to make audio with dxr3 working.
atmos4
parents: 2770
diff changeset
98 4. Contacting me
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
99
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
100 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
101 icq: 798427
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
102 Feedback, bugreports and general suggestions are appreciated (preferably
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
103 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
104 reading a heading. ;)
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
105
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
106