annotate DOCS/DXR3 @ 3208:98a587aaf505

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