slackbuilds_ponce/gis/therion
B. Watson b09a23d034
gis/therion: Nitpick: tab => space in README.
Signed-off-by: B. Watson <urchlay@slackware.uk>

Signed-off-by: Willy Sudiarto Raharjo <willysr@slackbuilds.org>
2023-04-29 18:11:54 +07:00
..
doinst.sh
README
slack-desc
therion.info
therion.SlackBuild

Therion is a complete platform which processes survey data and 
generates maps or 3D models of caves. This suite may be useful for 
professional or amateur cavers and researchers in geology or 
speleology fields. 

The package includes the following components:
- therion: the basic executable program that works as a command-line 
  compiler and processes input files, which are - including 2D maps - 
  in text format, to create files with 2D maps or 3D model. 2D maps 
  can be generated in PDF or SVG formats or other formats handled by 
  GIS platforms (DXF, ESRI, KML) or Aven (Survex format). 3D models 
  can be generated in the native format (handled by the component 
  Loch) or other formats (Compass, 3DMF, VRML, Survex, ecc.) handled 
  by appropriate viewers.  
- xtherion: the executable program that launches the GUI   (Graphical 
  User Interface). Xtherion works as text editor, map editor, and 
  compiler (instead of therion). This component is not essential: 
  output files can be generated by therion preparing the input files 
  with external programs as text or maps editors. 
- Loch: a 3D model viewer that supports high-resolution rendering to 
  file and stereo view using 3D-glasses. This component is not 
  essential: output 3D models can be displayed with other external 
  viewers.
- thbook.pdf: the Therion Book, it contains the documentation to use 
  Therion, generated with pdfTEX during the build process. It will be 
  installed in /usr/doc/therion-[VERSION]. This component is not 
  essential: a copy of the book (in basic size format) is also 
  available in the project homepage.
  
The build of the optional components is enabled by default. You can 
exclude one or more of them by passing to the script the respective 
environment variables:

- LOCH=no This disables the build of the native 3D viewer Loch. In 
          this case wxWidgets and VTK are not required.
- GUI=no  This disables the build of Xtherion.
- BOOK=no This disables the build of thbook.pdf.

If you leave enabled the build of Loch, the compilation works also 
if you have wxGTK3 (without the dependency wxWidgets) installed in 
your system. Other libraries based on wxWidgets (like wxPython3 or 
wxPython4 for example) could be detected and used but they are not 
tested. 

The build requires the library {fmt} as dependency and the source 
uses by default an internal {fmt}. This library is available as 
slackbuild in Slackbuilds.org (for Slackware 15.0) and a prebuild 
package in the official release (for Slackware current). If the 
library is installed in your system you would use it. In this case 
you can set the build for use of the external library passing an 
environment variable to the script as following:

  FMT=yes ./therion.SlackBuild

WARNINGS
Note that the platform works only with some standards, interpreters or 
programs (like METAPOST, TEX, tcl/tk, ImageMagick, ecc.) that are 
available in a full installation of Slackware, and some extensions of 
these (like LCDF Typetools, Bwidget, and tkImg) that are available in 
Slackbuilds.org. Without these dependencies Therion fails during the 
package build (almost) or in runtime for some features (e.g. tkImg, 
that is not detected by the build process).

After the installation, a full and extended integrated behavior, 
optimized with the custom configuration, requires to set or uncomment 
appropriate values in the initialization files in /etc/therion. 

Sample data can be downloaded from the project homepage. They can be 
used to practice about Therion.

See the thbook.pdf for more information.