# -----------------------------------------------------------------------------
# df3util  v 0.3.0
# -----------------------------------------------------------------------------

this program is a "Swiss army knife"-type tool for working with density
pattern files (DF3), as documented in the Persistence Of Vision Raytracing
v 3.7.x manual.

df3util is part of my 'df3 tools' project, this is the initial release.

df3util depends on two libraries (in addition to the 'C' library):
    * libdf3 (v 201705L)
    * libpng (v 1.4.20 or later)

building the program:
    $ tar xf df3util-0.3.0.tar.gz
    $ cd df3util-0.3.0
    $ ./configure
    $ make
    $ # installing requires privileges, change to 'root'.
    # make install


the df3util man page is created from a .pod file.  this requires the
'pod2man(1)' program, but a pre-built page is included in the package,
just in case.

df3util is released under a GNU Public License v3 or later, see the COPYING
file for details.

the program has been tested on both the 32-bit and 64-bit versions of a
GNU/Linux distribution, on a 64-bit machine.  however, I have not been able
to build or test on a 32-bit OS running on a 32-bit machine (haven't the
hardware).

note - this is a hobbyist project by a (pretty poor) hobbyist programmer,
and in part this program simply "evolved" rather than being planned.
that, together with my total lack of maths (and struggle with geometry), means
that there is a lot of room for improvement (and probably many bugs or errors
which I'm blind to).  all hints, tips, and or constructive criticisms
helping to improve the code will be welcomed.  please add "df3util" in the
subject line.

contact: jr <creature.eternal@gmail.com>.

enjoy.


ps - if you find this software useful and you're not on the breadline,
please make a donation to one of the good causes below.  thank you.

    - Médecins Sans Frontières, http://www.msf.org/

    - Free Software Foundation, https://fsf.org/

    - Royal National Lifeboat Institution, https://rnli.org/

    - a registered charity of your choice.

