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".
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.
Reports of bugs or problems should be submitted via electronic
mail to <devs@brlcad.org>