BO
nged
BRL-CAD
BRL-CAD User Commands

# bo

Used to create or retrieve binary opaque objects.

          bo

    	-i u
    	-o

          type dest source
          type dest source

## DESCRIPTION

Used to create or retrieve binary opaque objects. Currently, only uniform binary objects (arrays of values) are supported. One of -i or -o must be specified. The -i is for "input," or creating a binary object, and the -o option is used for "output," or retrieving a binary object. The u type argument must be supplied when -i is used, to indicate the type of uniform binary object to be created. On input, the dest is the name of the object to be created, and the source is the path to a file containing the values in the local host format. On output, dest is the path to a file to receive the contents of the binary object whose name appears in 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).

### 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.

### 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>, or via the "cadbug.sh" script.