FreeWRL Home Page

Setting up Ubuntu (currently 12.04.2) to compile FreeWRL

These notes were originally written by Dave Joubert, modified by John Stewart. Builds on different versions of Ubuntu, or different distros of Linux will be very similar. Recently, Roy Kyrillos and Jiangxin Hu provided feedback.

Process:

Start a terminal window with the keystrokes
```
ctrl-alt-t
    
```
or use Dash to look for terminal and start one.
start Synaptic Package Manager:
```
sudo synaptic
    
```

Install a bunch of tools/software. Mainly use Synaptic, but the freetype2 needed installing directly from the source web site.

Freetype2...
- from http://download.savannah.gnu.org/releases/freetype/


Unable to find an appropriate javascript engine...
- libmozjs185-1.0  (was installed already)
- libmozjs185-dev  (installed using Synaptic)


Package requirements (xproto x11 xt xmu xaw7) were not met...
- libxaw7-dev  (all with Synaptic)
- libice-dev
- libsm-dev
- libxmu-dev
- libxmu-headers
- libxpm-dev
- libxt-dev


libjpeg headers are required...
- libjpeg8-dev  (all with Synaptic)
- libjpeg-dev
- libjpeg-turbo8-dev

libpng...
- libpng12-dev  (installed using Synaptic)

Package requirements (imlib2) were not met...
- libimlib2
- libimlib2-dev
- libfreetype6-dev
- libgif-dev
- libtiff4-dev
- libtiffxxOc2

sound...
- libopenal1
- libopenal-dev
- libalut0
- libalut-dev

One of the build variants uses Motif for windowing/pull down menus. You may also want to install
```
- libmotif-dev 
- libmotif3
  
```

run autoconf:

cd freewrl/freex3d
autoreconf --force --install

run the configure script - with the Motif window manager:
```
./configure --with-fontsdir=/usr/share/fonts/truetype/ttf-bitstream-vera/ --with-target=motif
```
and, you can put on the HUD display by appending the following to the above line:
```
--with-statusbar=hud
```
Compile the software
```
make
```
install the software, if it compiles correctly
```
sudo make install
```

Setting up Ubuntu 14.04/14.10, Mint 17.1 (ie MATE), Debian 7.8 to compile FreeWRL

Contributors: Chris Willing, Doug Sanden. A slightly different, more automated approach. Warning - experimental, and the experience of a few volunteers with their scenarios - use at your own risk.

Process:

Start a terminal window with the keystrokes
```
ctrl-alt-t
```
or use Dash to look for terminal and start one.
Install a bunch of tools/software. Create the following recipe script using an editor such as vi or gedit: fur.sh (freewrl_ubuntu_recipe.sh):
```
#!/bin/bash

sudo apt-get update
#Optionally you can now upgrade components of your operating system
#   by uncommenting the upgrade line.
#(But do not upgrade if running in 'persistence' mode from a pen/thumb/usb drive. See:
# http://www.linuxliveusb.com/en/help/faq/persistence/68-persistent-do-not-do)
#sudo apt-get upgrade

#The following command is 1 long line. It will pull in other dependencies
# - nearly 100 packages altogether (depending on what packages may already be installed).
  
```
sudo apt-get install build-essential automake autoconf libtool ttf-bitstream-vera zlib1g-dev libfreetype6-dev libfontconfig1-dev libmozjs185-dev firefox-dev libxml2-dev x11proto-core-dev libx11-dev libxt-dev libxmu-dev libxaw7-dev libxxf86vm-dev libgl1-mesa-dev libjpeg-turbo8-dev sox libimlib2-dev imagemagick liblo-dev default-jdk libopenal1 libopenal-dev libalut0 libalut-dev
Note that the apt-get line for Debian is slightly different - use instead:

run fur.sh:
```
bash fur.sh
```
Download the freewrl source code from our git repository, if you haven't already (this will check out master branch after cloning):
```
git clone git://git.code.sf.net/p/freewrl/git freewrl-git
```
Now cd to into the freex3d build directory and run autotools:
```
cd freewrl-git/freex3d
./autogen.sh
```
run the configure script, with options you prefer. Example:
```
./configure --with-statusbar=hud
```
Build (compile and link) the software
```
make
```
install the software, if it built correctly
```
sudo make install
```
after the first time you build successfully, tell the library catalog to update itself (for the new libfreewrl.so)
```
sudo ldconfig
```

Try running freewrl. Example (should show a cone):

freewrl http://dug9.users.sourceforge.net/web3d/tests/1.x3d

Info

From circa 1999 to April 2010, the FreeWRL project was managed by John A. Stewart.

There is absolutely no warranty, express or implied for this software. For details on the conditions of use, see the FreeWRL distribution.

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details.

You should have received a copy of the GNU Library General Public License along with this library; if not, write to the Free Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA