NAME

bo - Used to create or retrieve binary opaque objects.

SYNOPSIS

bo {[-i {type}] | [-o]} {{destination} {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 type argument must be supplied when -i is used, to indicate the type of uniform binary object to be created. On input, the destination 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, destination 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).

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