Tree [20d941] master /
 History



File Date Author Commit
 aview 2015-10-02 Adrian Rossiter Adrian Rossiter [f8f395] antiview: key 't', add 50% transparency
 base 2015-10-09 Adrian Rossiter Adrian Rossiter [21b75b] off_report: add ranges and volume centroid, fix...
 doc 2014-03-15 Adrian Rossiter Adrian Rossiter [aca1a0] Docs: remove library docs from built package
 doc_src 2015-04-28 Adrian Rossiter Adrian Rossiter [2049ac] Docs: update for new programs
 m4 2011-04-08 Adrian Rossiter Adrian Rossiter [6a6e25] Update AC OpenGL macros. Fix overwrite of CPPFL...
 python 2010-05-13 Adrian Rossiter Adrian Rossiter [49264b] Documentation fixes
 share 2012-04-23 Roger Kaufman Roger Kaufman [eb5359] finalizations for kaleido replacement
 src 2015-12-19 Roger Kaufman Roger Kaufman [20d941] rotation issue
 src_extra 2014-12-11 Adrian Rossiter Adrian Rossiter [b5896a] Version: update to 0.24.pre03
 .gitignore 2015-02-08 Roger Kaufman Roger Kaufman [d9474b] added new programs obj2off and symmetro
 AUTHORS 2009-07-10 Adrian Rossiter Adrian Rossiter [727d6a] Initial commit.
 COPYING 2012-12-12 Adrian Rossiter Adrian Rossiter [f3b919] Expression evaluation: use muParser
 Doxyfile.in 2014-04-02 Adrian Rossiter Adrian Rossiter [862b83] Docs: fix doxygen settings file
 INSTALL 2009-07-10 Adrian Rossiter Adrian Rossiter [727d6a] Initial commit.
 Makefile.am 2014-03-15 Adrian Rossiter Adrian Rossiter [aca1a0] Docs: remove library docs from built package
 NEWS 2015-10-02 Adrian Rossiter Adrian Rossiter [f8f395] antiview: key 't', add 50% transparency
 README 2014-12-11 Adrian Rossiter Adrian Rossiter [7633c9] Docs: update
 README.git 2014-03-15 Adrian Rossiter Adrian Rossiter [aca1a0] Docs: remove library docs from built package
 acinclude.m4 2009-07-10 Adrian Rossiter Adrian Rossiter [727d6a] Initial commit.
 bootstrap 2009-08-25 Adrian Rossiter Adrian Rossiter [33019b] Remove various warnings. Save symmetry alignmen...
 compile 2009-07-10 Adrian Rossiter Adrian Rossiter [727d6a] Initial commit.
 configure.ac 2014-12-11 Adrian Rossiter Adrian Rossiter [b5896a] Version: update to 0.24.pre03
 pad_file.xml 2013-04-04 Adrian Rossiter Adrian Rossiter [42c5d8] Docs: minor changes
 py-compile 2009-07-10 Adrian Rossiter Adrian Rossiter [727d6a] Initial commit.

Read Me

Antiprism
=========

Notes for Antiprism 0.24
------------------------

The release includes two new programs: to_nfold changes the rotational
symmetry of a polyhedron and off2obj (Roger Kaufman) converts OFF to
Wavefront OBJ format. There are also new features, improvements, and bug
fixes. See the NEWS file for more details.

Please look out for bugs, or other issues, and report them to me
at: adrian@antiprism.com

Adrian.

Adrian Rossiter <adrian@antiprism.com>
http://antiprism.com/adrian


General
-------

Antiprism is a collection of programs for generating, manipulating,
transforming and viewing polyhedra

   http://www.antiprism.com/

This is a beta release. The programs have not had wide use
and probably contain a number of bugs. Please let me know
if you come across any bugs, or anything not working as
documented.

There are two release files.

   antiprism-0.xx.tar.gz       - source code
   antiprism-0.xx_install.exe  - Windows installer

In Windows, the DOS Box started from the Antiprism Shell menu
item is configured and ready to run the Antiprism programs.

If required, the ANTIPRISM_DATA environment variable may be
set to the path of the 'data' directory in the install directory.


Building
--------

These are instructions for building from source. They aren't
needed to run the Windows executables.

Antiprism uses the autotools build system. The programs can be
built with

   ./configure
   make

and installed with (as superuser)

   make install-strip

See the INSTALL file for more details.

If there are errors relating to shared libraries when the
installed programs are run, it may be necessary to run

   sudo ldconfig

The Antiview viewer depends on GLUT. A GLUT package suitable for
developing against must be installed in order to build Antiview,
otherwise the build and install will not include this program.

If building against a locally installed GLUT package, ensure that
the headers are in a GL subdirectory. If building against OpenGLUT
or Freeglut but using their own names for headers and libraries
(rather than the usual GLUT names) run configure with --with-openglut
or --with-freeglut.

Cygwin
------
For a non-X version of Antiview (only tested on a system without
X development packages installed), first build and install Freeglut
from source, then set LDFLAGS="-L/usr/local/lib" when running the
Antiprism configure script. For an X version of Antiview, install
the X development packages and run configure with "--with-x=yes".
It should be possible to build native Windows binaries by cross-
compiling using the tools provided by Cygwin, otherwise, use the
MSYS build environment.

Mac OS X
--------
Recent changes have been made to support building on OS X (with
thanks to Ralph Sutherland), but these changes are currently
untested. Any feedback regarding successful or failed builds
would be appreciated. Run configure with "--with-x=no".


Git Code Repository
-------------------

The Git repository contains the latest development code

   https://sourceforge.net/scm/?type=git&group_id=176443

See README.git for further details.


Note to developers
------------------
All the Antiprism source code is supplied under a permissive licence.

The aim of using permissive licensing is to promote the development of
new polyhedron software by making it convenient to reuse the Antiprism
source code in other projects.

Please, support this aim. If you incorporate Antiprism source code
into your own project and make any improvements that could reasonably
be incorporated back into the Antiprism project, like bug fixes,
optimisations or new features, then please contribute your changes
for inclusion back into Antiprism under a permissive (preferably
MIT) licence.