annotate DOCS/DXR3 @ 2677:794dec2fae64

using const modifier
author nick
date Sun, 04 Nov 2001 11:51:36 +0000
parents bbda31b5433b
children b9732eaa82d9
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.
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
39 These can be downloaded from dxr3.sourceforge.net
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
40
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
41 * <mplayerdir>/libavcodec from ffmpeg (only required if you intend to
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
42 play formats other than mpeg-(1/2), highly recommended!) there are
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
43 two ways of doing this:
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
44 1. Download and install ffmpeg from ffmpeg.sourceforge.net.
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
45 Configure it with --enable-shared
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
46 2. Download ffmpeg from ffmpeg.sourceforge.net, copy the entire
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
47 contents from <ffmpegdir>/libavcodec into <mplayer>/libavcodec
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
48 (symlinking won't work!). Then edit <mplayerdir>/libavcodec/utils.c
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
49 and move the line containing register_avcodec(&mpeg1video_encoder);
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
50 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
51 instance below register_avcodec(&rawvideo_encoder);
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
52
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
53 * Run <mplayerdir>/configure and make sure that DXR3/H+ support =yes
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
54 and optionally that libavcodec or ffmpeg.so = yes
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
55
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
56 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
57 problems.
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
58
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
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
61 3. Usage
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 After installation you will have two new outdevices in mplayer:
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
64 -vo dxr3 For video output
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
65 -ao dxr3 For audio output
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
66
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
67 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
68 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
69 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
70 codecs.conf and make sure videocodec mpegpes is listed above mpeg12.
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
71 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
72 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
73 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
74 section will have to specify "-vc mpeg12" if you want to playback
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
75 any of these video types without "-vo dxr3"!
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
76
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
77 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
78 codecs.conf file (search for "videocodec <codecname>"), copy the entire
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
79 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
80 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
81 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
82
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
83
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
84
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
85 4. Todo
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
86
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
87 * Make the osd use the subpic feature of the dxr3 (High)
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
88 * Overlay output (Medium)
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
89 * Driver options (Medium)
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
90 * Add an onscreen menu for "live" performance tuning (Low)
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
91
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
92 (yuv2rgb (24bpp) asm optimizations, not my job though... but
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
93 this will improve playback of anything not mpeg-(1/2) for us
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
94 all)
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
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
98 5. Contacting me
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 You can contact me either by e-mailing me, dholm@iname.com or by using
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
101 icq: 798427
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
102 Feedback, bugreports and general suggestions are appreciated
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
103 (preferably by e-mail)
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
104 My name is David Holm for those of you who are incapable of reading
bbda31b5433b dxr3 instructions by David Holm <dholm@telia.com>
arpi
parents:
diff changeset
105 a heading. ;)
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
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