Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages
ASC2DSP(1) BRL-CAD User Commands ASC2DSP(1)

asc2dsp - convert an ASCII dsp file to the BRL-CAD DSP (Displacement map) binary format

rt file.asc file.dsp

asc2dsp converts ASCII (decimal integer) cell (point) files to the binary form of a file in BRL-CAD's dsp format. Pixels are defined by whitespace-delimited, unsigned decimal integers in the range 0 to 2^16-1 (65535). The output file is in dsp binary format (one network unsigned short int per cell (point)).

The grid is oriented in the X-Y plane where width is in the X direction and length is in the Y direction. When used to create a dsp object im mged, the bottom left cell will have its bottom-left corner at X = 0, Y = 0, its bottom at Z = 0, and its top at Z equal to the value input in the ASCII file. Note that entries in the ASCII file are read in the same manner as a pix file, i.e., filling the grid from bottom to top, left to right, so the first cell defined in the ASCII file is the bottom-left cell when the dsp file is imported with mged. Note also that white space is ignored so the user can lay out the grid row by row to aid visualizing the end product (always remembering that the order of the rows will be reversed during input by mged).

An easy way to create the input file for asc2dsp is to first create it row by row in natural form with the top row being the desired top row and so on in desired viewing order. Then take the finished file and filter it through the Unix utility tac which will reverse the order of the rows (lines).

Note the user must ensure that the input file is valid for mged so that width times length equals the actual number of cells (points).

tac(1), mged(1), dsp(5)

Error conditions include invalid input characters or an input value greater than 65535. Descriptive messages are printed on stderr.


This software is Copyright (c) 2012-2019 United States Government as represented by the U.S. Army Research Laboratory.

Reports of bugs or problems should be submitted via electronic mail to
06/07/2022 BRL-CAD

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.