'\" t
.\"     Title: BREP PLOT
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL-NS Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 08/28/2023
.\"    Manual: BRL-CAD MGED User Commands
.\"    Source: BRL-CAD
.\"  Language: English
.\"
.TH "BREP PLOT" "nged" "08/28/2023" "BRL\-CAD" "BRL\-CAD MGED 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"
brep_plot \- Plot specific components of brep objects in a 3D scene\&.
.SH "SYNOPSIS"
.HP \w'\fBbrep\fR\fB\ plot\fR\ 'u
\fBbrep\fR {\fIobj\fR}\fB plot\fR [\fIC2|C3|E|F|F2d|FSBB|FSBB2d|FTBB|FTBB2d|FTD|I|L|L2d|S|SCV|SK|SK2d|SN|SUV|SUVP|T|T2d|V|CDT|CDT2d|CDTw\fR] [\fIarguments\fR]
.SH "DESCRIPTION"
.PP
If
\fIobj\fR
is not a brep object, then report that fact and exit\&. Otherwise, generate 3D scene visuals of the specified
\fIobj\fR
brep data\&. Note that the user may need to use
\fBautoview\fR
to center the view on the plotted data; the command does not automatically do so, in order to allow for debugging scenarios where it is desirable to maintain a fixed view\&.
.PP
This command has quite a few subcommands, as it is the primary means in BRL\-CAD for visually inspecting properties of BRep objects:
.HP \w'\fBC2\fR\ 'u
\fBC2\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more 2D parametric space geometric curves\&.
.RE
.HP \w'\fBC3\fR\ 'u
\fBC3\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more 3D geometric curves\&.
.RE
.HP \w'\fBE\fR\ 'u
\fBE\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more topological 3D edges\&.
.RE
.HP \w'\fBF\fR\ 'u
\fBF\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more topological faces\&.
.RE
.HP \w'\fBF2d\fR\ 'u
\fBF2d\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more topological faces in 2D parametric space\&.
.RE
.HP \w'\fBFSBB\fR\ 'u
\fBFSBB\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more face\*(Aqs surface bounding boxes (used for ray intersection testing)\&.
.RE
.HP \w'\fBFSBB2d\fR\ 'u
\fBFSBB2d\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more face\*(Aqs surface bounding boxes in 2D (used for ray intersection testing)\&.
.RE
.HP \w'\fBFTBB\fR\ 'u
\fBFTBB\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more face trim\*(Aqs bounding boxes in 3D\&.
.RE
.HP \w'\fBFTBB2d\fR\ 'u
\fBFTBB2d\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more face trim\*(Aqs bounding boxes in 2D parametric space\&.
.RE
.HP \w'\fBFTD\fR\ 'u
\fBFTD\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more face trim\*(Aqs direction \- geometric curves will have one direction as part of their definition, but such curves may be re\-used by trims and those trims may indicate their own direction independent of the curve\&.
.RE
.HP \w'\fBI\fR\ 'u
\fBI\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more surface\*(Aqs isosurface curves\&.
.RE
.HP \w'\fBL\fR\ 'u
\fBL\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more topological trimming loops in 3D\&.
.RE
.HP \w'\fBL2d\fR\ 'u
\fBL2d\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more topological trimming loops in 2D parametric space\&.
.RE
.HP \w'\fBS\fR\ 'u
\fBS\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more untrimmed surfaces\&.
.RE
.HP \w'\fBSCV\fR\ 'u
\fBSCV\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more surface\*(Aqs control vertex mesh\&.
.RE
.HP \w'\fBSK\fR\ 'u
\fBSK\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more surface\*(Aqs knots in 3D\&.
.RE
.HP \w'\fBSK2d\fR\ 'u
\fBSK2d\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more surface\*(Aqs knots in 2D parametric space\&.
.RE
.HP \w'\fBSN\fR\ 'u
\fBSN\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more surface\*(Aqs normal vectors\&.
.RE
.HP \w'\fBSUV\fR\ 'u
\fBSUV\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more surface\*(Aqs UV bounds\&.
.RE
.HP \w'\fBSUVP\fR\ 'u
\fBSUVP\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot a surface\*(Aqs 3D point at the specified 2D parametric space UV coordinates\&.
.RE
.HP \w'\fBT\fR\ 'u
\fBT\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more topological trims in 3D\&.
.RE
.HP \w'\fBT2d\fR\ 'u
\fBT2d\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more topological trims in 2D parametric space\&.
.RE
.HP \w'\fBV\fR\ 'u
\fBV\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot one or more 3D vertices\&.
.RE
.HP \w'\fBCDT\fR\ 'u
\fBCDT\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot the shaded view of a constrained Delaunay triangulation of one or more BRep faces\&.
.RE
.HP \w'\fBCDT2d\fR\ 'u
\fBCDT2d\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot the constrained Delaunay triangulation of one or more BRep faces in 2D parametric space\&.
.RE
.HP \w'\fBCDTw\fR\ 'u
\fBCDTw\fR [\fIindex[,index\&.\&.\&.]\fR | \fIindex\fR\-\fIindex\fR]
.PP
.RS 4
Plot the wireframe view of a constrained Delaunay triangulation of one or more BRep faces\&.
.RE
.SH "EXAMPLES"
.PP
\fBExample\ \&1.\ \&Plot single face\fR
.PP
mged>\fBbrep Brep_1\&.s plot F 1\fR
.PP
Plots the various loops making up the definition of Face 1 in Brep_1\&.s
.PP
\fBExample\ \&2.\ \&Plot a range of faces\fR
.PP
mged>\fBbrep Brep_1\&.s plot F 1\-10\fR
.PP
Plots the various loops making up the definition of faces 1 to 10 in Brep_1\&.s
.PP
\fBExample\ \&3.\ \&Plot a list of faces\fR
.PP
mged>\fBbrep Brep_1\&.s plot F 1,3,5,10\fR
.PP
Plots the various loops making up the definition of faces 1, 3, 5 and 10 in Brep_1\&.s
.SH "AUTHOR"
.PP
BRLCAD\-TEAM
.SH "BUG REPORTS"
.PP
Reports of bugs or problems should be submitted via electronic mail to
devs@brlcad\&.org
