File: zapping.xml

package info (click to toggle)
zapping 0.10~cvs6-4
  • links: PTS
  • area: main
  • in suites: squeeze
  • size: 9,828 kB
  • ctags: 11,841
  • sloc: ansic: 111,154; asm: 11,770; sh: 9,816; xml: 2,742; makefile: 1,282; perl: 488
file content (285 lines) | stat: -rw-r--r-- 9,167 bytes parent folder | download | duplicates (6)
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
<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY app "<application>Zapping</application>">
  <!ENTITY cmd "<command>zapping</command>">
  <!ENTITY version "0.10">
]>
<refentry id="zapping">
  <refmeta>
    <refentrytitle>zapping</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>zapping</refname>
    <refpurpose>a Gnome TV and Teletext viewer</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis>
      <command>zapping</command>
      <arg>-b, --bpp <replaceable>NUMBER</replaceable></arg>
      <arg>-c, --command <replaceable>STRING</replaceable></arg>
      <arg>--console-errors</arg>
      <arg>--cpu-features <replaceable>FEATURES</replaceable></arg>
      <arg>-d, --debug</arg>
      <arg>--device <replaceable>FILENAME</replaceable></arg>
      <arg>--dword-align</arg>
      <arg>-n, --tunerless-norm <replaceable>STRING</replaceable></arg>
      <arg>--no-overlay, --remote</arg>
      <arg>--no-plugins</arg>
      <arg>--no-vbi</arg>
      <arg>--no-xv-image</arg>
      <arg>--no-xv-video</arg>
      <arg>-v, --no-xv</arg>
      <arg>--xv-image-port <replaceable>NUMBER</replaceable></arg>
      <arg>--xv-port <replaceable>NUMBER</replaceable>,
      --xv-video-port <replaceable>NUMBER</replaceable></arg>
      <arg>-y, --yuv-format <replaceable>STRING</replaceable></arg>
      <arg>-z, --no-zsfb</arg>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1 id="description">
    <title>Description</title>

    <para>&app; is a program to watch TV on a computer, within the
    Gnome environment. You can take screenshots and record video and
    audio. &app; has a Teletext viewer built in and supports Closed
    Caption and Teletext subtitles. For more information open the
    Gnome help and choose Applications -> Multimedia ->
    Zapping.  This manual page refers to &cmd; version &version;.</para>
  </refsect1>

  <refsect1 id="options">
    <title>Options</title>

    <variablelist>

      <varlistentry>
	<term><option>-b, --bpp
	<replaceable>NUMBER</replaceable></option></term>
	<listitem>
	  <para>Color depth of the X display. In TrueColor mode (24 or
	  32 bits per pixel) you might get a very distorted image that
	  spreads all around the desktop. This usually means &app;
	  could not correctly determine the color depth, which can be
	  given here.</para> 
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>-c, --command
	<replaceable>COMMAND</replaceable></option></term> 
	<listitem>
	  <para>Execute the given command and exit. This was intended
	  to create a sort of batch mode, you may want to use <citerefentry>
	      <refentrytitle>zapping_remote</refentrytitle>
	      <manvolnum>1</manvolnum>
	    </citerefentry> instead. Only one command is
	  implemented. The <option>set_channel</option> command allows
	  to change the channel by giving the channel name or RF
	  channel number, for example:</para>
	  <programlisting>
zapping -c "set_channel BBC"
</programlisting>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--console-errors</option></term>
	<listitem>
	  <para>Redirect the error messages to the console, useful for
	  bug reports.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--cpu-features</option>
        <replaceable>FEATURES</replaceable></term>
	<listitem>
	  <para>Override the CPU detection for tests. Possible
	  features are: none, mmx, 3dnow, sse, sse2, sse3,
	  altivec. When your CPU does not support the given features
	  &app; may crash.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>-d, --debug</option></term>
	<listitem>
	  <para>Print debug messages on standard output. You should
	  include this information when submitting a bug report, as it
	  can help to trace the problem.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--device
	<replaceable>FILENAME</replaceable></option></term>
	<listitem>
	  <para>Kernel video device to use, usually
	  <filename>/dev/video</filename>. You can specify
	  <filename>emulator</filename> for tests.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--dword-align</option></term>
	<listitem>
	  <para>Forces doubleword alignment of the video in overlay
	  mode. Can help when the image is distorted at certain sizes
	  but looks fine at others.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>-n, --tunerless-norm
	<replaceable>STRING</replaceable></option></term>
	<listitem>
	  <para>This option has no function but is recognized for
	  compatibility with earlier versions of &app;. It determined
	  the video standard to be used when your TV card has no
	  tuner, one of NTSC, PAL or SECAM.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--no-overlay, --remote</option></term>
	<listitem>
	  <para>Do not overlay video. The <option>--remote</option>
	  option refers to the X display. Overlay is only possible if
	  the graphics card and TV card are plugged into the same
	  computer. Capture mode is possible on a remote display (on
	  another computer or in a nested display) but requires a high
	  network bandwidth.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--no-plugins</option></term>
	<listitem>
	  <para>Do not use any plugins, usually for testing purposes.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--no-vbi</option></term>
	<listitem>
	  <para>Do not capture and decode VBI data, i.e. Teletext,
	  Subtitles, Closed Caption and station names. This option is
	  intended for tests and applies only to the current
	  session. To override it or disable VBI support permanently
	  see the Devices -> VBI section in the &app; preferences.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--no-xv-video</option></term>
	<listitem>
	  <para>Do not use the XVideo extension for video overlay.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--no-xv-image</option></term>
	<listitem>
	  <para>Do not use the XVideo extension for hardware image
	  scaling.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>-v, --no-xv</option></term>
	<listitem>
	  <para>Do not use the XVideo extension for video overlay or
	  hardware image scaling.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--xv-image-port
	<replaceable>NUMBER</replaceable></option></term>
	<listitem>
	  <para>Number of the XVideo port to use for hardware image
	  scaling. Zapping lists the available ports with the
	  <option>-d</option> option.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--xv-port <replaceable>NUMBER</replaceable>,
	--xv-video-port	<replaceable>NUMBER</replaceable></option></term>
	<listitem>
	  <para>Number of the XVideo port (similar to a device) to use
	  for video overlay. Zapping lists the available ports with the
	  <option>-d</option> option.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>-y, --yuv-format
	<replaceable>STRING</replaceable></option></term>
	<listitem>
	  <para>This option has no function but is recognized for
	  compatibility with earlier versions of &app;. It determined
	  the pixel format in capture mode when XVideo hardware image
	  scaling was available, either YUYV or YVU420.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>-z, --no-zsfb</option></term>
	<listitem>
	  <para>This option has no function but is recognized for
	  compatibility with earlier versions of &app;. It used to
	  prevent the execution of <citerefentry>
	      <refentrytitle>zapping_setup_fb</refentrytitle>
	      <manvolnum>1</manvolnum>
	    </citerefentry> on startup. Now &app; calls the helper
	  application only if necessary.</para>
	</listitem>
      </varlistentry>

    </variablelist>
  </refsect1>

  <refsect1 id="see-also">
    <title>See also</title>

    <para><citerefentry>
	<refentrytitle>zapping_remote</refentrytitle>
        <manvolnum>1</manvolnum>
      </citerefentry>, <citerefentry>
	<refentrytitle>zapping_setup_fb</refentrytitle>
        <manvolnum>1</manvolnum>
      </citerefentry></para>
  </refsect1>

  <refsect1 id="authors">
    <title>Authors</title>
    <para>&app; was written by Iñaki García Etxebarria, Michael
    H. Schimek (mschimek@users.sourceforge.net) and many
    contributors.</para>
    <para>This manual page was written by Michael H. Schimek based on
    work by Christian Marillat.</para>
  </refsect1>

  <refsect1 id="contact">
    <title>Contact</title>

    <para>&app; homepage: http://zapping.sourceforge.net</para>
    <para>Please report bugs with the &app; bug tracker
    http://sourceforge.net/tracker/?group_id=2599 or mail us at
    zapping-misc@lists.sourceforge.net</para>
  </refsect1>

</refentry>
<!--
Local Variables:
mode: sgml
coding: utf-8
indent-tabs-mode: nil
End:
 -->