Imported Upstream version 1.15.1
[deb_xorg-server.git] / hw / dmx / config / man / vdltodmx.man
1 .\" $XFree86$
2 .\" Copyright 2002 Red Hat Inc., Durham, North Carolina.
3 .\" All Rights Reserved.
4 .\"
5 .\" Permission is hereby granted, free of charge, to any person obtaining
6 .\" a copy of this software and associated documentation files (the
7 .\" "Software"), to deal in the Software without restriction, including
8 .\" without limitation on the rights to use, copy, modify, merge,
9 .\" publish, distribute, sublicense, and/or sell copies of the Software,
10 .\" and to permit persons to whom the Software is furnished to do so,
11 .\" subject to the following conditions:
12 .\"
13 .\" The above copyright notice and this permission notice (including the
14 .\" next paragraph) shall be included in all copies or substantial
15 .\" portions of the Software.
16 .\"
17 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
18 .\" EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
19 .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
20 .\" NON-INFRINGEMENT. IN NO EVENT SHALL RED HAT AND/OR THEIR SUPPLIERS
21 .\" BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
22 .\" ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
23 .\" CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
24 .\" SOFTWARE.
25 .\"
26 .\" Authors:
27 .\" Rickard E. (Rik) Faith <faith@redhat.com>
28 .\"
29 .TH vdltodmx 1 __vendorversion__
30 .SH NAME
31 vdltodmx - dmx configuration file parser and printer
32 .SH SYNOPSIS
33 .B vdltodmx
34 .I infile
35 .I outfile
36 .SH DESCRIPTION
37 .I vdltodmx
38 reads the input file, which should be in VDL configuration file format.
39 After a successful parse, a file in Xdmx configuration file format is
40 written to the output file.
41 .P
42 The VDL file format is used with
43 .IR xmovie ,
44 which is available from
45 http://www.llnl.gov/icc/lc/img/xmovie/xmovie.html
46 .SH EXAMPLE
47 Given the following VDL-format file:
48 .RS
49 .nf
50 0
51 2
52 #
53 #
54 2560 2048 Left two-thirds [restrict=*:2]
55 2
56 :2.1 1280 2048 0 0 0 0
57 :2.2 1280 2048 1280 0 0 0
58 4
59 1280 1024 0 0
60 1280 1024 0 1024
61 1280 1024 1280 0
62 1280 1024 1280 1024
63 #
64 2560 2048 Right two-thirds [restrict=*:2]
65 2
66 :2.2 1280 2048 0 0 0 0
67 :2.3 1280 2048 1280 0 0 0
68 4
69 1280 1024 1280 0
70 1280 1024 1280 1024
71 1280 1024 2560 0
72 1280 1024 2560 1024
73 .fi
74 .RE
75 the following DMX-format file will be produced:
76 .RS
77 .nf
78 #
79 #
80 virtual "Left two-thirds" 2560x2048 {
81 display :2.1 1280x2048;
82 display :2.2 1280x2048 @1280x0;
83 }
84 #
85 virtual "Right two-thirds" 2560x2048 {
86 display :2.2 1280x2048;
87 display :2.3 1280x2048 @1280x0;
88 }
89 .fi
90 .RE
91 .SH BUGS
92 If the VDL file is not in the expected format, the program will probably
93 dump core.
94 .SH "SEE ALSO"
95 Xdmx(1), xdmxconfig(1), vdl(3), xmovie(1)