summaryrefslogtreecommitdiff
path: root/docs/leocad.1
blob: daeab561fd575c969f53abab757cdb4d90b4e4ba (plain)
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
.TH LEOCAD 1 "20 July 2000"
.\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
.\" other parms are allowed: see man(7), man(1)
.SH NAME
LeoCAD \- CAD program using plastic bricks.
.SH SYNOPSIS
\fIleocad \fR[\fI infile \fR[ -i \fR[\fI outfile.ext \fR]\fI \fR[\fI-w x\fR]\fI \fR[\fI-h y\fR] ] \fR] [\fI\-l path\fR] 
.SH "DESCRIPTION"
This manual page documents briefly the \fILeoCAD \fRprogram.
It was written for the Debian GNU/Linux distribution
because the original program does not have a manual page.  The information
in this manual page came from docs/LINUX.txt in the source archive.

.PP
\fILeoCAD \fR is a CAD program that uses plastic bricks similar to those found
in many toys (but not any particular brand).  It supports animation
as well as exportation to various file formats including POV-Ray.

.SH OPTIONS
Below is a summary of all of the options that \fILeoCAD\fR
accepts. Most options have two equivalent names, one of
which is a single letter preceded by -, and the other of
which is a long name preceded by --. Brackets ([ and ])
indicate that an option takes an optional argument.

.TP
.B infile
Loads the project file \fIinfile\fR

.TP
.BI "\-i [" outfile.ext ]
.ns
.TP
.BI "\-\-image [" outfile.ext ]
Saves a picture to \fIoutfile.ext \fR in the image format specified
by \fIext\fR and exits. If outfile is not given then the program will
use a name based on \fIinfile\fR. The file format is selected by \fIext\fR
and can be gif, bmp, png or jpg (if \fIext\fR is not present then the
default preferences format will be used).

.TP
.BI "\-w "width
.ns
.TP
.BI "\-\-width "width
Sets the width of the picture to \fIwidth\fR.

.TP
.BI "\-h "height
.ns
.TP
.BI "\-\-height "height
Sets the height of the picture to \fIheight\fR.

.TP
.BI "\-f "time
.ns
.TP
.BI "\-\-from "time
Start saving pictures at the step or frame \fItime\fR.

.TP
.BI "\-t "time
.ns
.TP
.BI "\-\-to "time
Save pictures until the step or frame \fItime\fR.

.TP
.B \-\-animation
Tells the program to save animations instead of instructions.

.TP
.B \-\-instructions
Tells the program to save instructions instead of animations (default).

.TP
.B \-\-highlight
Adds a border around the pieces in the step or frame they appear when saving pictures.

.TP
.BI "\-l "path
.ns
.TP
.BI "\-\-libpath "path
Use alternate pieces library found in \fIpath \fR.  The Debian version
of \fILeoCAD \fRuses /usr/share/leocad/ as the default.

.TP
.BI "\-\-libgl "library
Sets the name of the OpenGL dynamic library used by the program to \fIlibrary\fR.
The default libraries names searched are libGL.so and libMesaGL.so.

.SH ENVIRONMENT
``LEOCAD_LIB'' may be set to the path of the pieces library.

.SH EXAMPLES
.PP
 $ leocad car.lcd -i car.png -w 640 -h 480
.PP
This will start LeoCAD, load the file "car.lcd," create a png called
"car.png" with a resolution of 640x480 and exit when done.

.SH FILES
.TP
.I ~/.leocad
User preferences file

.SH BUGS
Lots of bugs so if you find one, please report it to the author.


.SH AUTHOR
\fILeoCAD \fRis written by Leonardo Zide <leo@gerf.org>.
You can visit the LeoCAD homepage at http://www.leocad.org/

This manual page was written by Patrick Mahoney <pat7@gmx.net>,
for the Debian GNU/Linux system (but may be used by others).