File: help.html

package info (click to toggle)
tvtime 1.0.2-10
  • links: PTS
  • area: main
  • in suites: wheezy
  • size: 7,464 kB
  • sloc: ansic: 30,160; sh: 9,612; makefile: 624; pascal: 504; yacc: 316; asm: 249; perl: 192; cpp: 164
file content (316 lines) | stat: -rw-r--r-- 14,783 bytes parent folder | download | duplicates (12)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
     "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>tvtime: Help and FAQ</title>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  <meta http-equiv="Content-Style-Type" content="text/css">
  <link href="tvtime.css" rel="stylesheet" type="text/css">
</head>
<body>

<table width="728px" class="centered" border="0" cellpadding="0" cellspacing="0">
<colgroup>
    <col width="24px">
    <col width="125px">
    <col width="579px">
</colgroup>

<tr><td align="center" colspan="3"><a href="http://tvtime.sourceforge.net/"><img src="tvtime-logo-banner.png" alt="tvtime"/></a></td></tr>

<tr><td class="hangspace"></td>
    <td class="navbar">

    <table class="doclist" width="95%">
    <tr><td class="docentry">
        <a href="http://tvtime.sourceforge.net/why.html">why tvtime?</a></td></tr>
    <tr><td class="docentry">
        <a href="http://tvtime.sourceforge.net/downloads.php">download tvtime!</a></td></tr>
    <tr><td class="docentry">
        <a href="http://tvtime.sourceforge.net/screenshots.html">screenshots!</a></td></tr>
    <tr><td class="docentry">
        <a href="http://tvtime.sourceforge.net/links.html">related sites</a></td></tr>
    <tr><td class="docentry">
        <a href="http://tvtime.sourceforge.net/">home</a></td></tr>
    </table>

    <p></p>

    <table class="doclist" width="95%">
    <tr><th class="docbox">support</td></tr>
    <tr><td class="docentry">
        <a href="http://tvtime.sourceforge.net/cards.html">supported cards</a></td></tr>
    <tr><td class="docentry">
        <a href="help.html">help and faq</a></td></tr>
    <tr><td class="docentry">
        <a href="usage.html">using tvtime</a></td></tr>
    <tr><td class="docentry">
        <a href="problems.html">common problems</a></td></tr>
    <tr><td class="docentry">
        <a href="http://www.sourceforge.net/tracker/?group_id=64301&amp;atid=506987">report bugs</a></td></tr>
    </table>

    <p></p>

    <table cellpadding="4" width="100%">
    <tr><td class="center">
        <a href="http://sourceforge.net"><img src="http://sourceforge.net/sflogo.php?group_id=64301"
           width="88" height="31" alt="SourceForge Logo"></a></td></tr>
    <!--
    <tr><td class="center">
        <a href="http://validator.w3.org/check/referer"><img src="http://www.w3.org/Icons/valid-html401"
           alt="Valid HTML 4.01!" height="31" width="88"></a></td></tr>
    <tr><td class="center">
        <a href="http://jigsaw.w3.org/css-validator/check/referer"><img
           src="http://jigsaw.w3.org/css-validator/images/vcss" 
           height="31px" width="88px" alt="Valid CSS!" /></a></td></tr>
    -->
    <tr><td class="center">
        <a href="http://tvtime.net/"><img src="http://tvtime.sourceforge.net/tvtime3.png"
           width="88px" height="31px" alt="tvtime Logo"></a></td></tr>
    <tr><td class="center">
        <a href="mailto:vektor@dumbterm.net">email the webmaster</a></td></tr>
    </table>
    </td>

    <td>

    <table width="90%" class="centered">
    <tr><td>

        <h2 class="center">Where to get help</h2>
        <ol>
        <li>IRC with us at <tt>#livid</tt> on <a href="http://www.freenode.net">irc.freenode.net</a>.
        <li>Post bugs on <a href="http://www.sourceforge.net/tracker/?group_id=64301&amp;atid=506987">our
        Sourceforge bug tracker</a>.
        <li>Subscribe to the
        <a href="http://sourceforge.net/mail/?group_id=64301">tvtime development mailing list</a>.
        </ol>

        <h2 class="center">Frequently asked questions</h2>
        <ol>
        <li><a href="#nodeint">How do I disable deinterlacing?</a>
        <li><a href="#recording">Does tvtime support recording?</a>
        <li><a href="#screenshots">Why is the tvtime window appear
            pink in screenshots?</a>
        <li><a href="#macrovision">I see purple lines in the video from my
        DVD player.  How do I avoid Macrovision copy-protection?</a>
        <li><a href="#noise">Interference problems with soundcards</a>
        <li><a href="#tvout">Optimal settings for tvtime on TV
            output</a>
        <li><a href="#bsd">Does tvtime support FreeBSD or NetBSD?</a>
        <li><a href="#ssname">How do I force the screenshots to be a specific filename?</a>
        <li><a href="#architectures">Does tvtime support any architectures besides x86?</a>
        <li><a href="#canadacable">Where is the "canada-cable" frequency table?</a>
        <li><a href="#audioconnect">How can I map audio to my digital
            output?</a>
        <li><a href="#noaudio">My capture card does not have an audio
            output jack, what do I do?</a>
        </ol>

        <h3><a name="nodeint">1. How do I disable deinterlacing?</a></h3>

        <p>Many users seem confused about what the deinterlacing plugins do
        and what it means to disable them.  The signal output from almost any
        video source, be it a Gamecube or cable TV, is an interlaced video
        signal.  Implicitly when you display this on a computer screen, you are
        deinterlacing: you're taking interlaced content and displaying it on a
        non-interlaced display.</p>

        <p>The simplest way to do this, and the default in some TV applications,
        is to buffer every two consecutive fields together and show them
        as a single frame.  You can do this in tvtime by setting it to one of
        our Progressive modes.  That's about as close to "not deinterlacing"
        as you can get, but it's still deinterlacing.</p>

        <p>Ideally, tvtime would be able to detect progressive content sent
        over an interlaced channel, such as the output from some video games
        or DV cameras in progressive mode.  This feature is something we
        would like to have in a future release.</p>

        <h3><a name="recording">2. Does tvtime support recording?</a></h3>

        <p>tvtime does not support recording or playback of recorded
        streams, and it is unclear to us if this is in the scope of what
        tvtime should try to accomplish.  Many users ask for this feature,
        but they have very different goals.  Some users want a quick way to
        record small, low-quality clips from television.  Some want a high
        quality recorder for recording shows.  Others want to have a full PVR
        system integrated into tvtime.</p>

        <p>Currently, we would rather focus on making tvtime the best high
        quality live TV viewer for Linux, with a clean and consistent user
        experience.  We recommend using <tt>mencoder</tt> for recording
        from television, and systems like <b>MythTV</b> or <b>freevo</b> for
        a PVR system.  If you are interested in coding some sort of
        support for recording in tvtime, please contact us so we can discuss
        how it might best be integrated into tvtime.</p>

        <h3><a name="screenshots">3. Why does tvtime appear pink in
        screenshots?</a></h3>

        <p>tvtime outputs video into a <b>video overlay surface</b>, an area
        of video memory outside of the framebuffer, using the <b>XVIDEO</b>
        X extension.  Applications which take screenshots such as
        <tt>ksnapshot</tt>, <tt>gimp</tt> or <tt>xwd</tt> only see the
        colourkeyed window, and not output of tvtime.</p>

        <p>We believe it is a design flaw or driver limitation of the X 
        server or video card hardware that neither can provide the image
        to screenshot applications.  For this reason, the only known method
        of taking screenshots of tvtime along with the desktop is to use the
        <b>screenshot</b> feature inside tvtime, and cut-and-paste the
        output into a full desktop screen capture.</p>

        <h3><a name="macrovision">4. I see purple lines in the video from my
        DVD player.  How do I avoid Macrovision copy-protection?</a></h3>

        <p>If you are seeing purple lines or having problems with video signal
        quality from an external DVD player, VCR, or Laserdisc player, try
        disabling Macrovision in your bttv driver (if you have a bttv card).
        See <a href="http://septor.name/colby/bttv.html">http://septor.name/colby/bttv.html</a>
        for information on how to do that.</p>

        <h3><a name="noise">5. Interference problems with soundcards</a></h3>

        <p>If you are experiencing a generally fuzzy picture, try moving your
        tv card one or two slots away from your soundcard (inside your pc).
        Interference from the soundcard can mess up some channels.</p>

        <h3><a name="tvout">6. Optimal settings for tvtime on TV output</a></h3>

        <p>Some people are interested in using tvtime even when their output
        itself a television.  Usually this is in the context of setting up a
        home theatre PC system.  Ideally for television output, no
        deinterlacing is required;  the interlaced signal is sent to the output
        such that every top field in the input is mapped to a top field in the
        output.</p>

        <p>Unfortunately, there is no standard TV output API under Linux.  The
        VESA framebuffer setup for TV output cannot tell us which field is
        currently being displayed.  Similarily, some TV output setups under
        Linux have it as a second head in X, but again, with no field
        information. We cannot know how to supply it with interlaced content
        to ensure that fields are shown in the right order.</p>

        <p>That said, I have been told that when using the NVIDIA TV output
        drivers, supplying them with <b>top-field-first</b> frames will cause
        it to display the fields correctly.  To experiment, try tvtime
        using the <b>Progressive: Top Field First</b> deinterlacer.
        Please <a href="mailto:vektor@dumbterm.net">let me know</a> if this
        gives good results.</p>

        <h3><a name="bsd">7. Does tvtime support FreeBSD or NetBSD?</a></h3>

        <p>Currently, tvtime will not work on BSD-based systems, but the
        code to get it to work should not be too difficult.</p>

        <p>There is a driver for bt848 and bt878-based cards under BSD called
        <b>bsdbt848</b>.  The API for this driver is different from Linux's
        video4linux that tvtime was written for, so the first job would be to
        do the input code in tvtime to handle this driver.  See
        <a href="http://mplayerhq.hu">mplayer</a> for one example of some code
        that uses this driver.</p>

        <p>The only other Linux-specific feature that we use would be the
        /dev/rtc code to do high performance timing (I assume there is a BSD
        equivalent of this).</p>

        <p>If you make any progress on any of these, please let us know.
        Thanks.</p>

        <h3><a name="ssname">8. How do I force the screenshots to be a
        specific filename?</a></h3>

        <p>tvtime's screenshots can be given a filename when requested
        using <b>tvtime-command</b>.  Simply do:</p>

<pre>
    tvtime-command SCREENSHOT "current.png"
</pre>

        <p>And the screenshot will output as <b>current.png</b>.  This is
        useful for scripts which upload the latest image from the TV to a
        webpage, for example.</p>

        <h3><a name="architectures">9. Does tvtime support any architectures
        besides x86??</a></h3>

        <p>Some work was done by Helge Kreutzmann to try tvtime on
        alpha Linux.  We determined that disabling the wine loader was
        enough to get tvtime to compile and run.  tvtime 0.9.11 should
        compile at least on this architecture.</p>

        <p>Besides that, most other architectures are simply untested.
        If anyone is seriously interested in another architecture, has
        some coding ability, and has sufficient hardware resources to try
        tvtime on another architecture, please email me at
        <a href="mailto:vektor@dumbterm.net">vektor@dumbterm.net</a>.</p>

        <p>As a miminum, your system should have a video card that can
        handle high bandwidth uploads (in our default configuration we
        upload 40 megabytes per second) and supports hardware video
        overlays, preferably using the XVIDEO extension.  As well, we require
        a video4linux or video4linux2-compatible driver and about the CPU
        power of a reasonable P3.</p>

        <h3><a name="canadacable">10. Where is the "canada-cable" frequency
        table?</a></h3>

        <p>If you needed to use the "<tt>canada-cable</tt>" frequency table in
        another TV application, then your capture card's tuner has been
        misdetected as a PAL tuner when it is actually an NTSC tuner.  Please
        see <a href="problems.html#tvwonder">this support question on our
        hardware support page</a> for information on how to fix this
        problem.</p>

        <h3><a name="audioconnect">11. How can I map audio to my digital
            output?</a></h3>

        <p>Many bt878-based cards also support digital capture of the
        audio.  This can be accessed using the <tt>btaudio</tt> kernel
        module, which registers an OSS sound device that supports 32 KHz
        audio capture.  On a capable card, loading the module gives
        something like this in your system logs:</p>

<pre>
    btaudio: driver version 0.7 loaded [digital+analog]
    btaudio: Bt878 (rev 2) at 01:0b.1, irq: 6,
             latency: 64, mmio: 0xf16ff000
    btaudio: using card config "default"
    btaudio: registered device dsp2 [digital]
    btaudio: registered device dsp3 [analog]
    btaudio: registered device mixer1
</pre>

        <p>On my system <tt>/dev/dsp2</tt> can now be used to read
        digital audio from the card at 32 KHz.  This can be then sent
        out to an arbitrary soundcard using a program such
        as <tt>sox</tt>.</p>

<pre>
    sox -r 32000 -w -t ossdsp /dev/dsp2 -t ossdsp /dev/dsp
</pre>

        <p>This command reads the input at 32 KHz from
        <tt>/dev/dsp2</tt> and writes it out to my soundcard
        at <tt>/dev/dsp</tt>.  Having this run while using tvtime
        will enable you to perform arbitrary maps of the audio, such
        as playing it out the digital output of your soundcard.</p>

        <h3><a name="noaudio">12. My capture card does not have an audio
            output jack, what do I do?</a></h3>

        <p>If your capture card does not has a pass-through audio
        jack, you can use the <a href="#audioconnect">technique
        described above</a> to map the audio from the internal
        digital capture out to your soundcard.</p>

        </td></tr>
    </table>

    </td></tr>
</table>

</body>
</html>