'\" t
.\"     Title: BEV
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL-NS Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 08/28/2023
.\"    Manual: BRL-CAD User Commands
.\"    Source: BRL-CAD
.\"  Language: English
.\"
.TH "BEV" "nged" "08/28/2023" "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"
bev \- Performs the operations indicated in the \fIBoolean_formula\fR and stores the result in \fInew_obj\fR\&.
.SH "SYNOPSIS"
.HP \w'\fBbev\fR\ 'u
\fBbev\fR [\-t] [\-P#] {\fInew_obj\fR} {\fIBoolean_formula\fR}
.SH "DESCRIPTION"
.PP
Performs the operations indicated in the
\fIBoolean_formula \fR
and stores the result in
\fInew_obj\fR\&. The
\fInew_obj\fR
will be stored as an NMG shape (it may be converted to a polysolid by using the
\fBnmg_simplify\fR
command)\&. If the \-t option is specified, then the resulting object will consist entirely of triangular facets\&. The default is to allow facets of any complexity, including holes\&. The
\fI\-P\fR
option specifies the number of CPUs to use for the calculation (however, this is currently ignored)\&. Only simple
\fI Boolean_formulas \fR
are allowed\&. No parentheses are allowed and the operations are performed from left to right with no precedence\&. More complex expressions must be expressed as BRL\-CAD objects using the
\fBr\fR,
\fBg\fR, or
\fBc\fRcommands and evaluated using the
\fBfacetize\fR
or
\fBev\fR
commands\&.
.SH "EXAMPLES"
.PP
The example demonstrates the use of the
\fBbev\fR
command with the
\fI\-t\fR
option to create a triangulated object\&.
.PP
\fBExample\ \&1.\ \&Creating a triangulated object by intersecting two objects\fR
.PP
mged> \fBbev \-t triangulated_lens sphere1 + sphere2\fR
.RS 4
Creates a triangulated object by intersecting objects
\fIsphere1\fR
and
\fIsphere2\fR
.RE
.SH "AUTHOR"
.PP
BRL\-CAD Team
.SH "BUG REPORTS"
.PP
Reports of bugs or problems should be submitted via electronic mail to
devs@brlcad\&.org
