1LibSpiro is a shared library designed to give programs the ability to create
2smooth continuous curves based on a given set of codes and X,Y constraints.
3
4The main user(s) of Libspiro are Font editing programs such as FontForge,
5and forked copies have been seen in more artistic programs such as InkScape,
6or in libraries such as GEGL. There may be other possible uses in future,
7and this library has strong potential in graphical and vector type programs.
8
9Developers interested in also sharing and making use of LibSpiro will likely
10want to read (these README files too to understand LibSpiro better):
11README-RaphLevien
12README-GeorgeWilliams
13
14There is a large amount of information and math on RaphLevien's website for
15developers interested in how LibSpiro works.
16
17Developers interested in example programs, can take a look at spiro.c found
18within FontForge, InkScape, GEGL and call-test.c included with this library.
19
20Installation
21============
22
23Installing from Git master requires 2 preparatory steps:
24
25First, you need to create the `configure' script if you do not have it yet.
26This will require autoreconf and automake to build `configure'.
27> autoreconf -i
28> automake --foreign -Wall
29
30
31Second, you then use the usual steps to compile it.
32Various operating systems and setups will need `configure' options set.
33The INSTALLATION file has detailed info for `configure' options.
34Example install steps for Linux, FreeBSD, Win32/64 are shown below:
35
36Installing on Linux
37> ./configure
38> make
39> make check
40> sudo make install
41
42Installing on FreeBSD10 (using clang3.3 or 3.6)
43> ./configure --prefix=$(pwd)/BUILD
44> make clean
45> make
46> make install
47
48Installing on Windows 32-bit
49> ./configure --host=i686-w64-mingw32 --prefix=$(pwd)/build-w32
50> make clean
51> make
52> make install
53
54Installing on Windows 64-bit
55> ./configure --host=x86_64-w64-mingw32 --prefix=$(pwd)/build-w64
56> make clean
57> make
58> make install
59
60NOTE: Some Distros and Operating Systems may require you to run 'ldconfig'
61to recognize LibSpiro if you are not rebooting your computer first before
62installing another program that depends on LibSpiro. To do this, you may
63need to run 'ldconfig' in 'su -' mode after you have done 'make install':
64
65	$ su -
66	# ldconfig
67	# exit
68	$
69