Setting up Ubuntu (currently 12.04.2) to compile FreeWRL

http://freewrl.sourceforge.net/ubuntu_src.html

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 slightlydifferent, 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:

        sudo apt-get install build-essential automake autoconf libtool ttf-bitstream-vera zlib1g-dev libfreetype6-dev libfontconfig1-dev libmozjs185-dev iceweasel-dev libxml2-dev x11proto-core-dev libx11-dev libxt-dev libxmu-dev libxaw7-dev libxxf86vm-dev libgl1-mesa-dev libjpeg-dev sox libimlib2-dev imagemagick liblo-dev default-jdk libopenal1 libopenal-dev libalut0 libalut-dev

• 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