BO

## Name

bo — Used to create or retrieve binary opaque objects.

## Synopsis

`bo` {[-i u {type}] | [-o]} {`destination`} {`source`}

## DESCRIPTION

Used to create or export binary opaque objects. One of -i or -o must be specified to input or output data respectively. The -i option will create a binary object, and the -o option will write out a binary object's data. Currently, only uniform binary objects (arrays of values) are supported on input. On input, the destination is the name of the object to be created, and the source is the path to a file to read. On output, destination is the path to a file to write out with the contents of the binary object specified as the source. The type may be one of:

f -> float
d -> double
c -> char (8 bit)
s -> short (16 bit)
i -> int (32 bit)
l -> long (64 bit)
C -> unsigned char (8 bit)
S -> unsigned short (16 bit)
I -> unsigned int (32 bit)
L -> unsigned long (64 bit)

Note: this command was previously named "dbbinary".

## EXAMPLES

The examples show the use of the bo command to both create (-i option) and to retrieve a binary object (-o option).

Example 1. Create an opaque uniform binary object of characters with a specified name containing the contents of a particular file.

`mged>` `bo -i u c cmds /usr/brlcad/html/manuals/mged/mged_cmds.html`

Creates an opaque uniform binary object of characters with the name cmds that contains the contents of the file /usr/brlcad/html/manuals/mged/mged_cmds.html.

Example 2. Import data for a displacement map (DSP) object

`mged>` `bo -i u S dsp.data /path/to/file.dsp`

This imports a file named file.dsp that contains DSP data, i.e., raw data in unsigned short (16-bit) format. The data is saved in the .g database into an object named dsp.data. When creating a DSP, this dsp.data object can be specified as the data source.

Example 3. Copy the contents of a particular binary object into a specified file.

`mged>` `bo -o /home/jim/cmds.html cmds`

Copies the contents of the binary object named cmds into the file named /home/jim/cmds.html.

## AUTHOR

BRL-CAD Team

## BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to `<devs@brlcad.org>`