.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH DIME "1" "September 21, 2003"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
dxfsphere \- generate  a triangle mesh approximating a sphere by recursive subdivision in .dxf format using libdime
.SH SYNOPSIS
.B dxfsphere [-c] [-t] [-i] [-o outfile] level
.SH DESCRIPTION
This manual page documents briefly the
.B dxfsphere
command.
This manual page was written for the Debian GNU/Linux distribution
because the original program does not have a manual page.
Instead, it has documentation in the GNU Info format; see below.
.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
.\" respectively.
\fBdxfsphere\fP is a program that
 generate a triangle mesh approximating a sphere by
 recursive subdivision. First approximation is an platonic
 solid; each level of refinement increases the number of
 triangles by a factor of 4.
.P
 Level 3 (128 triangles for an octahedron) is a good tradeoff if
 gouraud shading is used to render the database.
.SH OPTIONS
.TP
.B level
level is an integer >= 1 setting the recursion level (default 1).
.TP
.B \-c,
 causes triangles to be generated with vertices in counterclockwise
 order as viewed from the outside in a RHS coordinate system.
 The default is clockwise order.
.TP
.B \-t,
starts with a tetrahedron instead of an octahedron
.TP
.B \-i,
starts with a icosahedron instead of an octahedron
.TP
.B \-o,
outfile (default is stdout)
.TP
.B \-h,
Show useage.
.SH SEE ALSO
files in: 
.BR /usr/share/doc/libdime/,
.BR /usr/share/doc/libdime-dev/.
.br
The programs are documented fully by
.IR http://www.coin3d.org/lib/dime/ ,
available via the Internet.
.SH AUTHOR
This manual page was written by A. Maitland Bottoms <bottoms@debian.org>,
for the Debian GNU/Linux system (but may be used by others).