~ubuntu-branches/ubuntu/maverick/tvtime/maverick

« back to all changes in this revision

Viewing changes to docs/html/help.html

  • Committer: Bazaar Package Importer
  • Author(s): Simon Law
  • Date: 2004-01-13 18:00:36 UTC
  • Revision ID: james.westby@ubuntu.com-20040113180036-h996q67t476jymsu
Tags: upstream-0.9.12
ImportĀ upstreamĀ versionĀ 0.9.12

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
 
2
     "http://www.w3.org/TR/html4/strict.dtd">
 
3
<html>
 
4
<head>
 
5
<title>tvtime: Help and FAQ</title>
 
6
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
 
7
  <meta http-equiv="Content-Style-Type" content="text/css">
 
8
  <link href="tvtime.css" rel="stylesheet" type="text/css">
 
9
</head>
 
10
<body>
 
11
 
 
12
<table width="728px" class="centered" border="0" cellpadding="0" cellspacing="0">
 
13
<colgroup>
 
14
    <col width="24px">
 
15
    <col width="125px">
 
16
    <col width="579px">
 
17
</colgroup>
 
18
 
 
19
<tr><td align="center" colspan="3"><a href="http://tvtime.sourceforge.net/"><img src="tvtime-logo-banner.png" alt="tvtime"/></a></td></tr>
 
20
 
 
21
<tr><td class="hangspace"></td>
 
22
    <td class="navbar">
 
23
 
 
24
    <table class="doclist" width="95%">
 
25
    <tr><td class="docentry">
 
26
        <a href="http://tvtime.sourceforge.net/why.html">why tvtime?</a></td></tr>
 
27
    <tr><td class="docentry">
 
28
        <a href="http://tvtime.sourceforge.net/downloads.php">download tvtime!</a></td></tr>
 
29
    <tr><td class="docentry">
 
30
        <a href="http://tvtime.sourceforge.net/screenshots.html">screenshots!</a></td></tr>
 
31
    <tr><td class="docentry">
 
32
        <a href="http://tvtime.sourceforge.net/links.html">related sites</a></td></tr>
 
33
    <tr><td class="docentry">
 
34
        <a href="http://tvtime.sourceforge.net/">home</a></td></tr>
 
35
    </table>
 
36
 
 
37
    <p></p>
 
38
 
 
39
    <table class="doclist" width="95%">
 
40
    <tr><th class="docbox">support</td></tr>
 
41
    <tr><td class="docentry">
 
42
        <a href="help.html">help and faq</a></td></tr>
 
43
    <tr><td class="docentry">
 
44
        <a href="usage.html">using tvtime</a></td></tr>
 
45
    <tr><td class="docentry">
 
46
        <a href="problems.html">common problems</a></td></tr>
 
47
    <tr><td class="docentry">
 
48
        <a href="http://www.sourceforge.net/tracker/?group_id=64301&amp;atid=506987">report bugs</a></td></tr>
 
49
    </table>
 
50
 
 
51
    <p></p>
 
52
 
 
53
    <table cellpadding="4" width="100%">
 
54
    <tr><td class="center">
 
55
        <a href="http://sourceforge.net"><img src="http://sourceforge.net/sflogo.php?group_id=64301"
 
56
           width="88" height="31" alt="SourceForge Logo"></a></td></tr>
 
57
    <!--
 
58
    <tr><td class="center">
 
59
        <a href="http://validator.w3.org/check/referer"><img src="http://www.w3.org/Icons/valid-html401"
 
60
           alt="Valid HTML 4.01!" height="31" width="88"></a></td></tr>
 
61
    <tr><td class="center">
 
62
        <a href="http://jigsaw.w3.org/css-validator/check/referer"><img
 
63
           src="http://jigsaw.w3.org/css-validator/images/vcss" 
 
64
           height="31px" width="88px" alt="Valid CSS!" /></a></td></tr>
 
65
    -->
 
66
    <tr><td class="center">
 
67
        <a href="http://tvtime.net/"><img src="http://tvtime.sourceforge.net/tvtime3.png"
 
68
           width="88px" height="31px" alt="tvtime Logo"></a></td></tr>
 
69
    <tr><td class="center">
 
70
        <a href="mailto:vektor@dumbterm.net">email the webmaster</a></td></tr>
 
71
    </table>
 
72
    </td>
 
73
 
 
74
    <td>
 
75
 
 
76
    <table width="90%" class="centered">
 
77
    <tr><td>
 
78
 
 
79
        <h2 class="center">Where to get help</h2>
 
80
        <ol>
 
81
        <li>IRC with us at <tt>#livid</tt> on <a href="http://www.freenode.net">irc.freenode.net</a>.
 
82
        <li>Post bugs on <a href="http://www.sourceforge.net/tracker/?group_id=64301&amp;atid=506987">our
 
83
        Sourceforge bug tracker</a>.
 
84
        <li>Subscribe to the
 
85
        <a href="http://sourceforge.net/mail/?group_id=64301">tvtime development mailing list</a>.
 
86
        </ol>
 
87
 
 
88
        <h2 class="center">Frequently asked questions</h2>
 
89
        <ol>
 
90
        <li><a href="#nodeint">How do I disable deinterlacing?</a>
 
91
        <li><a href="#recording">Does tvtime support recording?</a>
 
92
        <li><a href="#screenshots">Why is the tvtime window appear
 
93
            pink in screenshots?</a>
 
94
        <li><a href="#macrovision">I see purple lines in the video from my
 
95
        DVD player.  How do I avoid Macrovision copy-protection?</a>
 
96
        <li><a href="#noise">Interference problems with soundcards</a>
 
97
        <li><a href="#tvout">Optimal settings for tvtime on TV
 
98
            output</a>
 
99
        <li><a href="#bsd">Does tvtime support FreeBSD or NetBSD?</a>
 
100
        <li><a href="#ssname">How do I force the screenshots to be a specific filename?</a>
 
101
        <li><a href="#architectures">Does tvtime support any architectures besides x86?</a>
 
102
        <li><a href="#canadacable">Where is the "canada-cable" frequency table?</a>
 
103
        <li><a href="#audioconnect">How can I map audio to my digital
 
104
            output?</a>
 
105
        <li><a href="#noaudio">My capture card does not have an audio
 
106
            output jack, what do I do?</a>
 
107
        </ol>
 
108
 
 
109
        <h3><a name="nodeint">1. How do I disable deinterlacing?</a></h3>
 
110
 
 
111
        <p>Many users seem confused about what the deinterlacing plugins do
 
112
        and what it means to disable them.  The signal output from almost any
 
113
        video source, be it a Gamecube or cable TV, is an interlaced video
 
114
        signal.  Implicitly when you display this on a computer screen, you are
 
115
        deinterlacing: you're taking interlaced content and displaying it on a
 
116
        non-interlaced display.</p>
 
117
 
 
118
        <p>The simplest way to do this, and the default in some TV applications,
 
119
        is to buffer every two consecutive fields together and show them
 
120
        as a single frame.  You can do this in tvtime by setting it to one of
 
121
        our Progressive modes.  That's about as close to "not deinterlacing"
 
122
        as you can get, but it's still deinterlacing.</p>
 
123
 
 
124
        <p>Ideally, tvtime would be able to detect progressive content sent
 
125
        over an interlaced channel, such as the output from some video games
 
126
        or DV cameras in progressive mode.  This feature is something we
 
127
        would like to have in a future release.</p>
 
128
 
 
129
        <h3><a name="recording">2. Does tvtime support recording?</a></h3>
 
130
 
 
131
        <p>tvtime does not support recording or playback of recorded
 
132
        streams, and it is unclear to us if this is in the scope of what
 
133
        tvtime should try to accomplish.  Many users ask for this feature,
 
134
        but they have very different goals.  Some users want a quick way to
 
135
        record small, low-quality clips from television.  Some want a high
 
136
        quality recorder for recording shows.  Others want to have a full PVR
 
137
        system integrated into tvtime.</p>
 
138
 
 
139
        <p>Currently, we would rather focus on making tvtime the best high
 
140
        quality live TV viewer for Linux, with a clean and consistent user
 
141
        experience.  We recommend using <tt>mencoder</tt> for recording
 
142
        from television, and systems like <b>MythTV</b> or <b>freevo</b> for
 
143
        a PVR system.  If you are interested in coding some sort of
 
144
        support for recording in tvtime, please contact us so we can discuss
 
145
        how it might best be integrated into tvtime.</p>
 
146
 
 
147
        <h3><a name="screenshots">3. Why does tvtime appear pink in
 
148
        screenshots?</a></h3>
 
149
 
 
150
        <p>tvtime outputs video into a <b>video overlay surface</b>, an area
 
151
        of video memory outside of the framebuffer, using the <b>XVIDEO</b>
 
152
        X extension.  Applications which take screenshots such as
 
153
        <tt>ksnapshot</tt>, <tt>gimp</tt> or <tt>xwd</tt> only see the
 
154
        colourkeyed window, and not output of tvtime.</p>
 
155
 
 
156
        <p>We believe it is a design flaw or driver limitation on the X or
 
157
        video card hardware that neither can provide the image to screenshot
 
158
        applications.  For this reason, the only known method of taking
 
159
        screenshots of tvtime along with the desktop is to use the
 
160
        <b>screenshot</b> feature inside tvtime, and cut-and-paste the
 
161
        output into a full desktop screen capture.</p>
 
162
 
 
163
        <h3><a name="macrovision">4. I see purple lines in the video from my
 
164
        DVD player.  How do I avoid Macrovision copy-protection?</a></h3>
 
165
 
 
166
        <p>If you are seeing purple lines or having problems with video signal
 
167
        quality from an external DVD player, VCR, or Laserdisc player, try
 
168
        disabling Macrovision in your bttv driver (if you have a bttv card).
 
169
        See <a href="http://www.colby.edu/personal/k/kjseptor/bttv.html">http://www.colby.edu/personal/k/kjseptor/bttv.html</a>
 
170
        for information on how to do that.</p>
 
171
 
 
172
        <h3><a name="noise">5. Interference problems with soundcards</a></h3>
 
173
 
 
174
        <p>If you are experiencing a generally fuzzy picture, try moving your
 
175
        tv card one or two slots away from your soundcard (inside your pc).
 
176
        Interference from the soundcard can mess up some channels.</p>
 
177
 
 
178
        <h3><a name="tvout">6. Optimal settings for tvtime on TV output</a></h3>
 
179
 
 
180
        <p>Some people are interested in using tvtime even when their output
 
181
        itself a television.  Usually this is in the context of setting up a
 
182
        home theatre PC system.  Ideally for television output, no
 
183
        deinterlacing is required;  the interlaced signal is sent to the output
 
184
        such that every top field in the input is mapped to a top field in the
 
185
        output.</p>
 
186
 
 
187
        <p>Unfortunately, there is no standard TV output API under Linux.  The
 
188
        VESA framebuffer setup for TV output cannot tell us which field is
 
189
        currently being displayed.  Similarily, some TV output setups under
 
190
        Linux have it as a second head in X, but again, with no field
 
191
        information. We cannot know how to supply it with interlaced content
 
192
        to ensure that fields are shown in the right order.</p>
 
193
 
 
194
        <p>There are two possible solutions.  I have been told that with the
 
195
        NVIDIA TV output drivers, when using XVIDEO, if you supply them with
 
196
        <b>top-field-first</b> frames, they will display the fields correctly.
 
197
        To experiment, try tvtime using the <b>Progressive: Top Field First</b>
 
198
        deinterlacer.  This may give good results.  The second option would be
 
199
        using a card with a TV output driver that gives field information.
 
200
        An example is the Matrox G400/G450/G550 driver in <b>DirectFB</b>.
 
201
        We have an output mode in tvtime specifically for this driver, but
 
202
        it is experimental and currently not being further developed.</p>
 
203
 
 
204
        <h3><a name="bsd">7. Does tvtime support FreeBSD or NetBSD?</a></h3>
 
205
 
 
206
        <p>Currently, tvtime will not work on BSD-based systems, but the
 
207
        code to get it to work should not be too difficult.</p>
 
208
 
 
209
        <p>There is a driver for bt848 and bt878-based cards under BSD called
 
210
        <b>bsdbt848</b>.  The API for this driver is different from Linux's
 
211
        video4linux that tvtime was written for, so the first job would be to
 
212
        do the input code in tvtime to handle this driver.  See
 
213
        <a href="http://mplayerhq.hu">mplayer</a> for one example of some code
 
214
        that uses this driver.</p>
 
215
 
 
216
        <p>The only other Linux-specific features that we use would be the
 
217
        /dev/rtc code to do high performance timing (I assume there is a BSD
 
218
        equivalent of this), and potentially the wine loader for the DScaler
 
219
        DLLs may need updating.</p>
 
220
 
 
221
        <p>If you make any progress on any of these, please let us know.
 
222
        Thanks.</p>
 
223
 
 
224
        <h3><a name="ssname">8. How do I force the screenshots to be a
 
225
        specific filename?</a></h3>
 
226
 
 
227
        <p>tvtime's screenshots can be given a filename when requested
 
228
        using <b>tvtime-command</b>.  Simply do:</p>
 
229
 
 
230
<pre>
 
231
    tvtime-command SCREENSHOT "current.png"
 
232
</pre>
 
233
 
 
234
        <p>And the screenshot will output as <b>current.png</b>.  This is
 
235
        useful for scripts which upload the latest image from the TV to a
 
236
        webpage, for example.</p>
 
237
 
 
238
        <h3><a name="architectures">9. Does tvtime support any architectures
 
239
        besides x86??</a></h3>
 
240
 
 
241
        <p>Some work was done by Helge Kreutzmann to try tvtime on
 
242
        alpha Linux.  We determined that disabling the wine loader was
 
243
        enough to get tvtime to compile and run.  tvtime 0.9.11 should
 
244
        compile at least on this architecture.</p>
 
245
 
 
246
        <p>Besides that, most other architectures are simply untested.
 
247
        If anyone is seriously interested in another architecture, has
 
248
        some coding ability, and has sufficient hardware resources to try
 
249
        tvtime on another architecture, please email me at
 
250
        <a href="mailto:vektor@dumbterm.net">vektor@dumbterm.net</a>.</p>
 
251
 
 
252
        <p>As a miminum, your system should have a video card that can
 
253
        handle high bandwidth uploads (in our default configuration we
 
254
        upload 40 megabytes per second) and supports hardware video
 
255
        overlays, preferably using the XVIDEO extension.  As well, we require
 
256
        a video4linux or video4linux2-compatible driver and about the CPU
 
257
        power of a reasonable P3.</p>
 
258
 
 
259
        <h3><a name="canadacable">10. Where is the "canada-cable" frequency
 
260
        table?</a></h3>
 
261
 
 
262
        <p>If you needed to use the "<tt>canada-cable</tt>" frequency table in
 
263
        another TV application, then your capture card's tuner has been
 
264
        misdetected as a PAL tuner when it is actually an NTSC tuner.  Please
 
265
        see <a href="problems.html#tvwonder">this support question on our
 
266
        hardware support page</a> for information on how to fix this
 
267
        problem.</p>
 
268
 
 
269
        <h3><a name="audioconnect">11. How can I map audio to my digital
 
270
            output?</a></h3>
 
271
 
 
272
        <p>Many bt878-based cards also support digital capture of the
 
273
        audio.  This can be accessed using the <tt>btaudio</tt> kernel
 
274
        module, which registers an OSS sound device that supports 32 KHz
 
275
        audio capture.  On a capable card, loading the module gives
 
276
        something like this in your system logs:</p>
 
277
 
 
278
<pre>
 
279
    btaudio: driver version 0.7 loaded [digital+analog]
 
280
    btaudio: Bt878 (rev 2) at 01:0b.1, irq: 6,
 
281
             latency: 64, mmio: 0xf16ff000
 
282
    btaudio: using card config "default"
 
283
    btaudio: registered device dsp2 [digital]
 
284
    btaudio: registered device dsp3 [analog]
 
285
    btaudio: registered device mixer1
 
286
</pre>
 
287
 
 
288
        <p>On my system <tt>/dev/dsp2</tt> can now be used to read
 
289
        digital audio from the card at 32 KHz.  This can be then sent
 
290
        out to an arbitrary soundcard using a program such
 
291
        as <tt>sox</tt>.</p>
 
292
 
 
293
<pre>
 
294
    sox -r 32000 -w -t ossdsp /dev/dsp2 -t ossdsp /dev/dsp
 
295
</pre>
 
296
 
 
297
        <p>This command reads the input at 32 KHz from
 
298
        <tt>/dev/dsp2</tt> and writes it out to my soundcard
 
299
        at <tt>/dev/dsp</tt>.  Having this run while using tvtime
 
300
        will enable you to perform arbitrary maps of the audio, such
 
301
        as playing it out the digital output of your soundcard.</p>
 
302
 
 
303
        <h3><a name="noaudio">12. My capture card does not have an audio
 
304
            output jack, what do I do?</a></h3>
 
305
 
 
306
        <p>If your capture card does not has a pass-through audio
 
307
        jack, you can use the <a href="#audioconnect">technique
 
308
        described above</a> to map the audio from the internal
 
309
        digital capture out to your soundcard.</p>
 
310
 
 
311
        </td></tr>
 
312
    </table>
 
313
 
 
314
    </td></tr>
 
315
</table>
 
316
 
 
317
</body>
 
318
</html>