GSP
Quick Navigator

Search Site

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

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  ASC2G (1)

.ds Aq ’

NAME

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

CONTENTS

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

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


BRL-CAD ASC2G (1) 04/04/2016

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