On this page you will find:
The Vortex Library main repository is included inside the Af-Arch repository. Af-Arch project uses Vortex Library as its data transport layer.
If you are planing to download Vortex Library and using it as a stand alone library apart from Af-Arch you can get current stable releases at: http://www.sourceforge.net/projects/vortexlibrary
You can also get the latest repository status, which is considered to be stable, by checking out a svn copy executing the following:
svn co https://dolphin.aspl.es/svn/publico/af-arch/trunk/libvortex-1.1
If you are using Microsoft Windows platform use the url above. SubVersion client programs for windows can be found at: http://tortoisesvn.tigris.org (really recommended) or http://rapidsvn.tigris.org.
Of course you will have to download the Vortex Library dependencies. Check the this section to know more about library dependencies.
If you are running a POSIX (unix-like including cygwin) environment you can use autotools to configure the project so you can compile it. Type the following once you have downloaded the source code:
bash:~$ cd libvortex-1.1 bash:~/libvortex$-1.1 ./autogen.sh
This will configure your project trying to find the dependencies needed.
Once the configure process is done you can type:
bash:~/libvortex-1.1$ make install
The previous command will require permissions to write inside the destination directory. If you have problems, try to execute the previous command as root.
Because readline doesn't provide a standard way to get current installation location, the following is provided to configure readline installation. You have to use the READLINE_PATH environment var as follows:
bash:~/libvortex-1.1$ READLINE_PATH=/some/path/to/readline make
make program will use the content of READLINE_PATH var to build an include header directive and an include lib directive as follows:
READLINE_PATH=/some/path/to/readline -I$(READLINE_PATH)/include -L$(READLINE_PATH)/lib
You don't need to pay attention to this description if you don't have problems with your readline installation.
Inside the src directory can be found a Makefile.win file. This Makefile.win have been created to be run under mingw environment. You will have to download the mingw environment and the msys package.
Then configure your local Makefile.win file according to your environment, and use some as follow:
CC=gcc-3.3 vortex_dll=libvortex-1.1 MODE=console make -f Makefile.win
Of course, the CC variable may point to another gcc, check the one that is installed on your system but, make sure you are not using the gcc provided by a cygwin installation. It will produce a faulty libvortex-1.1.dll not usable by any native Microsoft Windows program.
The MODE variable can be set to "windows". This will disable the console output. "console" value will allow to enable vortex log info to console.
The vortex_dll variable must not be changed. This variable is controlled by a top level Makefile.win inside the Af-Arch project so that Makefile.win can control the library naming. To follow the same convention naming will save you lot of problems in the future.
Additionally, if you chose to provide the libraries directly you will have to download the libraries the Vortex Library depends on inside a directory, for example, "c:\libraries". Use lowercase letter for your files and directories names, it will save you lot of time. Now, edit the Makefile.win to comment out those lines referring to pkg-config (LIBS and CFLAGS) and uncomment those lines referring to BASE_DIR variable.
Now type:
CC=gcc-3.3 vortex_dll=libvortex-1.1 MODE=console BASE_DIR=c:/libraries make -f Makefile.win
This process will produce a libvortex-1.1.dll (actually the dynamic libraries) and a import library called libvortex-1.1.dll.a. The import library will be needed to compile your application under windows against Vortex Library so it get linked to libvortex-1.1.dll.
Once you have installed the library you can type:
gcc `pkg-config --cflags --libs vortex-1.1` your-program.c -o your-program
On windows platform using cygwin the previous example also works.
On mingw environments you should use something like:
gcc your-program.c -o your-program
-Ic:/libraries/include/vortex-1.1/ \
-I"c:/libraries/include" \
-I"c:/libraries/include/axl" \
-L"c:/libraries/lib" \
-L"c:/libraries/bin" \
-lws2_32 \
-laxl -lm
Where c:/libraries contains the installation of the Vortex Library (headers files installed on c:/libraries/include/vortex-1.1, import library: libvortex-1.1.dll.a and dll: libvortex-1.1.dll) and LibAxl installation.
The -lws2_32 will provide winsocks2 reference to your program.