'\" t
.\"     Title: BOLT
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL-NS Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 04/13/2022
.\"    Manual: BRL-CAD User Commands
.\"    Source: BRL-CAD
.\"  Language: English
.\"
.TH "BOLT" "nged" "04/13/2022" "BRL\-CAD" "BRL\-CAD User Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
bolt \- Creates a BRL\-CAD \&.g file containing bolts\&.
.SH "SYNOPSIS"
.HP \w'\fBbolt\fR\ 'u
\fBbolt\fR [\fIoptions\fR...]
.SH "DESCRIPTION"
.PP

\fBbolt\fR
is a program to create a BRL\-CAD data base of one of four different kinds of bolts\&. Up to twenty\-six bolts of one type and size may be created\&.
\fBbolt\fR
uses libwdb to create a database file\&. This program may be run interactively or the user may specify options on a command line\&. If the user chooses to run the program interactively he answers the questions as the program prompts him\&. Below are the options that can be used on the command line\&.
.SH "OPTIONS"
.PP
\fB\-o#\fR
.RS 4
Type of bolt to be created: 1=>bolt head; 2=>bolt head and washer; 3=>bolt head, washer, and bolt stem; and 4=>bolt head and bolt stem\&.
.RE
.PP
\fB\-f \fR\fIname\&.g\fR
.RS 4
BRL\-CAD file name\&.
.RE
.PP
\fB\-n #\fR
.RS 4
The number of bolts to be created\&. This number must be less than or equal to 26 (or it will be set to 26)\&.
.RE
.PP
\fB\-hd #\fR
.RS 4
Diameter of bolt head, flat edge to flat edge, in millimeters\&.
.RE
.PP
\fB\-hh #\fR
.RS 4
Height of bolt head in millimeters\&.
.RE
.PP
\fB\-wd #\fR
.RS 4
Diameter of washer in millimeters\&.
.RE
.PP
\fB\-wh #\fR
.RS 4
Height of washer in millimeters\&.
.RE
.PP
\fB\-sd #\fR
.RS 4
Diameter of bolt stem in millimeters\&.
.RE
.PP
\fB\-sh #\fR
.RS 4
Height of bolt stem in millimeters\&.
.RE
.SH "EXAMPLES"
.PP
\fBExample\ \&1.\ \&Interactive bolt Session\fR
.PP

.sp
.if n \{\
.RS 4
.\}
.nf
$ bolt
Enter option:
     1 \- bolt head
     2 \- bolt head & washer
     3 \- bolt head, washer, & stem
     4 \- bolt head & stem
1
Enter name of mged file to be created (25 char max)\&.
     bolt\&.g
Enter the number of bolts to be created (26 max)\&.
     3
Enter diameter (flat edge to flat edge) & height of bolt head\&.
     30 10

option:  1 \- bolt head
file:  bolt\&.g
head diameter:  30\&.000000, & height:  10\&.000000
washer diameter:  0\&.000000, & height:  0\&.000000
stem diameter:  0\&.000000, & height:  0\&.000000
number of bolts:  3
    
.fi
.if n \{\
.RE
.\}
.sp

.PP
\fBExample\ \&2.\ \&Single-Line bolt Command\fR
.PP

\fBbolt \-o1 \-fbolt\&.g \-n3 \-hd30 \-hh10\fR
.PP
Both examples produce the same output \- the bolt heads (option 1) are created with a diameter of 30mm and a height of 10mm in a database file called bolt\&.g\&.
.SH "AUTHOR"
.PP
Susan A\&. Coates
.SH "COPYRIGHT"
.PP
This software is Copyright (c) 2005\-2021 United States Government as represented by the U\&.S\&. Army Research Laboratory\&.
.SH "SEE ALSO"
.PP
handle(1), window(1), window_frame(1), gastank(1)
.SH "BUG REPORTS"
.PP
Reports of bugs or problems should be submitted via electronic mail to
devs@brlcad\&.org
