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:

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