Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ASC2DSP(1)		     BRL-CAD User Commands		    ASC2DSP(1)

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

SYNOPSIS
       rt file.asc file.dsp

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

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

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

AUTHORS
       BRL-CAD Team

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

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

BRL-CAD				  08/27/2021			    ASC2DSP(1)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | DIAGNOSTICS | AUTHORS | COPYRIGHT | BUG REPORTS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=asc2dsp&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help