Skip to documentation
BRL-CAD
DocumentationAll documentsEnglish

BO(nged)

NAME

bo - Creates or retrieves binary opaque objects.

On this page

SYNOPSIS

bo -i u [h|n]type destination source
bo -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 creates a binary object, and the -o option writes out a binary object’s data. Currently, only uniform binary objects (arrays of values) are supported on input.

On input, destination is the name of the object to create and source is the path to a file to read. Input data defaults to host byte order. Prefix type with h to specify host byte order explicitly or n to specify network byte order. The base 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".

On output, destination is the path to a host-order file containing the binary object specified as source.

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 nS dsp.data /path/to/file.dsp

This imports a standard network-order DSP file containing unsigned short (16-bit) data. 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. Multibyte values are written in host byte order.

AUTHOR

BRL-CAD Team

BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org