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

FreeBSD Manual Pages

  
 
  

home | help
ASC2G(1)			    BRL-CAD			      ASC2G(1)

NAME
       asc2g - convert a BRL-CAD mged geometry database	from ASCII to binary
       form.

SYNOPSIS
       asc2g input.asc output.g

DESCRIPTION
       asc2g is	a utility provided by BRL-CAD used to convert mged(1) geometry
       databases in ASCII form outputted by g2asc(1) to	the new	binary format.
       The utility will	always create the new binary format, but it will
       accept either of	the two	ASCII formats (See HISTORY).

       The local machine binary	representation of a mged database is
       inherently non-portable.	 asc2g,	along with its converse	g2asc are
       simple filters which convert between the	binary form and	an ASCII
       representation.

       This was	traditionally performed	so the files could be transferred to
       another machine in a portable format. Although no longer	necessary for
       the current binary geometry database files that are created by mged
       ("v5" format), the conversion process is	still necessary	if
       manipulating older ("v4"	format)	geometry database files.

EXAMPLE
       g2asc file.g file.asc

       On the local machine, convert the mged databases	to ASCII using g2asc

       scp file.asc remote:file.asc

       Transfer	the converted databases	to the remote machine

       ssh remote "asc2g file.asc file.g"

       On the remote machine, convert the files	back to	the binary
       representation for that machine using asc2g

OPTIONS
       asc2g does not take any options.	However, you have to supply the	input
       and output files.

FILES
       input.asc is a file previously created using g2asc and output.g is the
       name of the file	where the resulting binary database should be stored.

SEE ALSO
       g2asc(1), brlcad(1), mged(1)

DIAGNOSTICS
       The diagnostics are intended to be self-explanatory. Any	warning
       messages	are written to standard	error.

BUGS
       Reports of bugs or problems should be submitted via e-mail to
       _devs@brlcad.org_.

HISTORY
       Release 6.0 introduced a	new ASCII format. This format is simply	a Tcl
       script that, when executed by a simplified geometry command interpreter
       (in essence, a properly empowered Tcl interpreter), rebuilds the
       database	from which it was derived.

       In contrast, the	old ASCII format consisted of a	sequence of one-line
       records that corresponded to the	old database format records.

AUTHOR
       Charles Michael Kennedy

       Michael John Muuss

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

DISCLAIMER
       The ASCII representation	of BRL-CAD geometry databases is not a fixed
       format and is allowed to	change without deprecation notice. In general,
       this will not occur any more frequently than the	binary geometry
       database	format changes,	though both are	open specifications.
       Regardless, the ASCII representation is subject to change without
       notice and should not be	relied upon by external	codes. (See HISTORY).

BRL-CAD				  07/08/2017			      ASC2G(1)

NAME | SYNOPSIS | DESCRIPTION | EXAMPLE | OPTIONS | FILES | SEE ALSO | DIAGNOSTICS | BUGS | HISTORY | AUTHOR | COPYRIGHT | DISCLAIMER

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

home | help