doc/cad3d.sgml

   1 <refmeta>
   2 <refentrytitle>cad3d</refentrytitle>
   3 <manvolnum>1</manvolnum>
   4 </refmeta>
   5
   6 <refnamediv>
   7 <refname>cad3d</refname>
   8 <refpurpose>convert a <Application>Survex</Application> <filename>.3d</filename> file into formats which can be read by CAD and drawing packages
   9 </refpurpose>
  10 </refnamediv>
  11
  12 <refsynopsisdiv>
  13 <cmdsynopsis>
  14 <command>cad3d</command>
  15 <arg choice="opt">options</arg>
  16 <arg choice="req">.3d file</arg>
  17 <arg choice="opt">output file</arg>
  18 </cmdsynopsis>
  19 </refsynopsisdiv>
  20
  21 <refsect1><title>Description</title>
  22 <!-- FIXME: more info (opts, etc) -->
  23
  24 <para>
  25 Cad3d can currently output DXF, Skencil, or SVG files for import into CAD
  26 packages.  It can also produce Compass .plt files, which are primarily intended
  27 for importing into Carto, but can also be used with Compass itself, and a number
  28 of other formats (POS, ...).
  29 </para>
  30
  31 <refsect2>
  32 <title>POS Format</title>
  33
  34 <Para>
  35 The POS format is a Survex-specific format containing a
  36 list of stations with coordinates (ordered x,y,z [East, North,
  37 Up]) and complete names.
  38 </Para>
  39
  40 <Para>
  41 The stations are sorted by name such that numbers occur in the correct order
  42 (so ``2'' before ``10'').  Numbers with a prefix and/or suffix are sorted by the
  43 number part first, so you'd get:
  44 </Para>
  45
  46 <screen>040.sv8
  47 040.sv8a
  48 040.sv8b
  49 040.sv8c
  50 040.sv9
  51 040.sv10
  52 040.sv11
  53 40_entrance_tag
  54 40b_entrance_tag</screen>
  55 </refsect2>
  56
  57 </refsect1>