BO(nged)
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)
| 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).
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.
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.
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.
COPYRIGHT
This software is Copyright (c) 1989-2021 by the United States Government as represented by U.S. Army Research Laboratory.
BUG REPORTS
Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org