annotate DOCS/DXR3 @ 3196:ca4aaadbfb0a

extrachecks for weird configs GUI (--enable-gui --disable-png for instance)
author pl
date Thu, 29 Nov 2001 16:47:07 +0000
parents 1d4fb4d9aab5
children 039a973b3dda
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
3186
1d4fb4d9aab5 Patch by D. Holm to make audio with dxr3 working.
atmos4
parents: 2770
diff changeset
4 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
5 you might have to reload the em8300 modules
1d4fb4d9aab5 Patch by D. Holm to make audio with dxr3 working.
atmos4
parents: 2770
diff changeset
6 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
7 next time you use the dxr3 audio interface.
1d4fb4d9aab5 Patch by D. Holm to make audio with dxr3 working.
atmos4
parents: 2770
diff changeset
8
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
9 1. Introduction
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
10
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
11 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
12 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
13 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
14 powerful enough for synced software dvd playback. And even the faster
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
15 (intel-based) computers had troubles with artifacts.
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
16 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
17 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
18 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
19 realmagic boards, I don't know which).
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
20 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
21 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
22 correctly). So they bought the designs for the Hollywood plus and
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
23 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
24 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
25 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
26 complete illogical to me, but I have had great experiences with
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
27 bt(brooktree) circuits in the past, so I don't mind.
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
28 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
29 hardware decoder since most computers these days have no problem doing
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
30 this in software and have cycles left for posprocessing (removing of
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
31 artefacts and other garbage produced by compression).
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
32 These days, you have two uses for this card:
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
33 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
34 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
35 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
36 out).
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
37
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
38
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
39
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
40 2. Requirements
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
41
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
42 * 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
43 including the dev-api.
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
44 These can be downloaded from dxr3.sourceforge.net (I suggest using
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
45 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
46 which are only available through cvs)
2646
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 * <mplayerdir>/libavcodec from ffmpeg (only required if you intend to
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
49 play formats other than mpeg-(1/2), highly recommended!) there are
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
50 two ways of doing this:
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
51 1. Download and install ffmpeg from ffmpeg.sourceforge.net.
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
52 Configure it with --enable-shared
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
53 2. Download ffmpeg from ffmpeg.sourceforge.net, copy the entire
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
54 contents from <ffmpegdir>/libavcodec into <mplayer>/libavcodec
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
55 (symlinking won't work!). Then edit <mplayerdir>/libavcodec/utils.c
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
56 and move the line containing register_avcodec(&mpeg1video_encoder);
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
57 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
58 instance below register_avcodec(&rawvideo_encoder);
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
59
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
60 * Run <mplayerdir>/configure and make sure that DXR3/H+ support =yes
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
61 and optionally that libavcodec or ffmpeg.so = yes
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
62
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
63 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
64 problems.
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
65
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
66
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
67
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
68 3. Usage
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
69
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
70 After installation you will have two new outdevices in mplayer:
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
71 -vo dxr3 For video output
3186
1d4fb4d9aab5 Patch by D. Holm to make audio with dxr3 working.
atmos4
parents: 2770
diff changeset
72 -ao dxr3 For audio output
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
73
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
74 MPEG-1, MPEG-2, VCD and DVD Notes
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
75 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
76 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
77 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
78 codecs.conf and make sure videocodec mpegpes is listed above mpeg12.
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
79 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
80 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
81 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
82 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
83 any of these video types _without_ "-vo dxr3"!
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
84
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
85 DIVX Notes
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
86 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
87 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
88 could possibly be any faster than OpenDivX4Linux...
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
89
3186
1d4fb4d9aab5 Patch by D. Holm to make audio with dxr3 working.
atmos4
parents: 2770
diff changeset
90 Other codecs:
1d4fb4d9aab5 Patch by D. Holm to make audio with dxr3 working.
atmos4
parents: 2770
diff changeset
91 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
92 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
93 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
94 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
95 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
96 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
97
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
3186
1d4fb4d9aab5 Patch by D. Holm to make audio with dxr3 working.
atmos4
parents: 2770
diff changeset
100 4. Contacting me
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
101
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
102 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
103 icq: 798427
2770
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
104 Feedback, bugreports and general suggestions are appreciated (preferably
b9732eaa82d9 DXR3 beta2 patch by David Holm.
atmos4
parents: 2646
diff changeset
105 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
106 reading a heading. ;)
2646
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
107
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
108