AsciiDoc Examples

The `oed` command in [app]`MGED` is used to ...

Notable aerospace firms and support organizations that use FASTGEN
include [org]_Lockheed Martin_, [org]#Boeing#, [org]`Bell Helicopter`
, [org]*Northrop Grumman* , [org]_Pratt & Whitney_ , [org]_General
Electric_ , [org]_KETRON_ , [org]_ITT_ , [org]_BAH_ , [org]_SURVICE
Engineering_ , and [org]_ASI_ .

The following list provides a description of the use and functionality
of the primary elements in the dialog box.

* [label]#Output File Name# -- This is the name of the file to receive
  the ASCII output.
* [label]#Log File Name# -- If provided, verbose status logging will
  be written to that file.

[subs="+quotes"]
....
[prompt]#mged># [cmd]#l tire#
[output]#tire:  --
   u tire-215-55R17.r
   u air-215-55R17.r
   u wheel-215-55R17.r#
....

[subs="+quotes,+macros"]
....
[prompt]#Enter X, Y, Z of vertex:# [in]#0 0 0# kbd:[Enter]
[prompt]#Enter X, Y, Z of height (H) vector:# [in]#0 0 3.5# kbd:[Enter]
[prompt]#Enter radius:# [in]#1.75# kbd:[Enter]
....

[source,c]
----
struct rt_wdb *wdbp;
if( (wdbp=wdb_fopen( new_file_name ) ) == RT_WDB_NULL ) {
    bu_exit(1, "Failed to open output file (%s)\n", new_file_name);
}
----

[%header, cols="^,^", frame="all"]
|===
|draw
|sph1.s

|Draw a previously created primitive shape
|named sph1.s
|===

[%header, cols="10*^~", frame="all"]
|===
|in
|?
|rcc
3+|?
3+|?
|?

.2+|Insert a primitive shape
.2+|Name of shape
.2+|Type of shape is a right circular cylinder
|Value of x
|Value of y
|Value of z
|Value of x
|Value of y
|Value of z
.2+|Radius of rcc

3+|Vertex
3+|Height vector
|===

.Usage of MGED's gdiff utility
[cols="2*~", frame="none", options="noheader"]
|===
2+| Usage: `[cmd]#gdiff# +++[+++[opt]#OPTION#]... [rep]#obj1# [rep]#obj2#`

|[opt]`--tol=#`, [opt]`-t#`
|Tolerance in millimeters.

|[opt]`--ray-diff`, [opt]`-R`
|Test for differences with raytracing.

|[opt]`--view-left`, [opt]`-l`
|Visualize volumes added only by left object.

|[opt]`--view-both`, [opt]`-b`
|Visualize volumes common to both objects.

|[opt]`--view-right`, [opt]`-r`
|Visualize volumes added only by right object.

|[opt]`--grazing`, [opt]`-G`
|Report differences in grazing hits (raytracing mode).
|===

.STL reader options
[cols="2*~", frame="none"]
|===
|`--binary`
|Specify that the input file is in binary STL format (the default
 assumes ASCII).

|[nowrap]`--starting-ident=[rep]#number#`
|Specify the starting ident for the regions created. The default is
 `1000`. This number will be incremented for each region, unless
 `--constant-ident` is specified.

|`--constant-ident`
|Specify that the starting ident should remain constant.

|`--material=[rep]#code#`
|Specify the material code that will be assigned to all created
 regions (the default is `1`).
|===

The COMGEOM target descriptions are processed by the Geometric
Information For Targets (GIFT <<r1>>,<<r2>>) code for use in follow-on
vulnerability assessment codes.

[bibliography]
.References
* [[[r1, 1]]] Lawrence W. Bain, Mathew J. Reisinger, "The GIFT Code User
Manual; Vol I, Introduction and Input Requirements," BRL
Report No. 1802, July 1975. (AD# B0060371)
* [[[r2, 2]]] Gary G. Kuehl, Lawrence W. Bain, Mathew J. Reisinger, "The
GIFT Code User Manual; Vol II, the Output Options," ARRADCOM Technical
Report No. ARBRL-TR-02189, September 1979. (AD# A078364)

[%header, cols="^h,~", frame="all"]
|===
|Event
|Description

|r
|*Ray*.  A ray is cast.  The formatting associated with r will print
 regardless of whether a region is encountered.

|h
|*Header*. First output after a ray hits anything.  Formatting at
  *h* is output once per ray.

|p
|*Partition*.  Output for each region encountered by the ray.
 Typically this will be where most of the information about a model is
 reported.

|f
|*Footnote*.  Last output statement after a ray hits anything; a
 "footnote" line after the ray has completed its evaluations; once
 per ray.

|g
|*Gap*.  Output written once for each gap the ray may encounter.

|m
|*Miss*.  If triggered, prints a message that nothing was hit;
 maximum once per ray.

|o
|*Overlap*.  Output written once for each overlap along the
 ray.
|===

[[_percent]]
% :: Start a `/bin/sh` shell process for the user.  The
[prompt]#mged># prompt will be replaced by a system prompt for the
shell, and the user may perform any legal shell commands.  The `mged`
process waits for the shell process to finish, which occurs when the
user exits the shell.  This only works in a command window associated
with a tty (i.e., the window used to start `mged` in classic mode).
+
.Example:
[subs="+quotes"]
....
[prompt]#mged># [in]#%#   <1>
[prompt]#$# [in]#ls -al#  <2>
[prompt]#$# [in]#exit#    <3>
[prompt]#mged>#     <4>
....
<1> Start a new shell process.
<2> Issue any shell commands.
<3> Exit the shell.
<4> Continue editing in `mged`.

****
[cols=">h,<", frame="all"]
|===
| AUTHORS:
| Lee A. Butler +
  Eric W. Edwards +
  Betty J. Schueler +
  Robert G. Parker +
  John R. Anderson

| ORGANIZATION:
| *U.S. Army Research Laboratory* +
  Aberdeen Proving Ground, MD  21005-5068

| REPORT:
| ARL-SR-102 +
  April 2001
|===
****

The g-dxf command converts BRL-CAD objects to the previously mentioned
AutoCAD DXF format.  The syntax for this command is as follows:

`[cmd]*g-dxf* +++[+++[opt]_options_] [rep]#input.g# object(s)`

The options for the g-dxf command are as follows:

[opt]`-i` :: requests the output DXF file to be in inches (default is
millimeters).
[opt]`-o [rep]#output.dxf#` :: specifies the file to receive
the DXF output (default is stdout).
[opt]`-p` :: requests that the output DXF file consist of POLYFACE
MESH entities (the default is 3DFACE entities).

The command also accepts the [opt]`-v`, [opt]`-r`, [opt]`-a`,
[opt]`-n`, [opt]`-x`, and [opt]`-X` options, which have been discussed
in the import converters portion of this document
(xref:tutorials:converting/chapter4.adoc#_sec_convert_to_brlcad[Converting
to BRL-CAD]).

include::../header.adoc[]

= B(nged)

== NAME

B - Clears the mged display of any currently displayed objects, then
displays the list of objects provided in the parameter list.

== SYNOPSIS

*B* +[+[-A -o] | _attribute name_ {_value_}...] [-s] [-C +#/#/#+] [-R] [_objects_]

== DESCRIPTION

Clears the mged display of any currently displayed objects, then
displays the list of objects provided in the parameter
list. Equivalent to the [cmd]*Z* command followed by the command
[cmd]*draw* _<objects>_. The _-C_ option provides the user a way to
specify a color that overrides all other color specifications
including combination colors and region id-based colors. The _-A_ and
_-o_ options allow the user to select objects by attribute. The _-s_
option specifies that subtracted and intersected objects should be
drawn with solid lines rather than dot-dash lines. The -R option means
do not automatically resize the view if no other objects are
displayed. See the [cmd]*draw* command for a detailed description of
the options.

== EXAMPLES

The following are run from the MGED command prompt.

.Display a named object
====
[prompt]#mged># [ui]`B some_object`

The display clears, and the object named _some_object_ is displayed.
====

.Draw objects having an attribute with a value
====
[prompt]#mged># [ui]`B -A -o Comment {First comment} Comment {Second comment}`

The display clears, then draws objects that have a "Comment" attribute
with a value of either "First comment" or "Second comment."
====

== AUTHOR

BRL-CAD Team

include::../footer.adoc[]