FAQ/Installing On OSX

From PixieWiki

< FAQ
Jump to: navigation, search

[edit] Requirements

currently Pixie is compiled against libtiff from fink. Under OSX 10.2 or earlier, it will also require you to use fink's dlcompat and dlcompat-shlibs libraries.

Please install fink ( http://fink.sourceforge.net ) to get a hold of the required libraries. I can recommend fink commander ( http://finkcommander.sourceforge.net ) to help ease installation of fink projects, but you'll still need to install fink. Follow the instructions over at fink for how to set it up.

Install libtiff from fink. Also, especially for 10.2 or earlier, ensure you installl up to date dlcompat and dlcompat-shlib packages.

Get the binary distribution of Pixie and unpack it at /Applications/Graphics. There should be now a folder in /Applications/Graphics called Pixie. You may have issues unpacking with some of the gui apps. Ensure you've got the latest stuffit, or use the command line:

(Assuming package is on your desktop)
cd /Applications/Graphics/
gunzip ~/Desktop/Pixie-osx-1.3.xx.tgz
tar -xvf ~/Desktop/Pixie-osx-1.3.xx.tar

[edit] OSX 10.2 Stuff

Now, for the last part, which is required for 10.2 ONLY. DO NOT PERFORM THE NEXT STEP ON PANTHER (10.3) or TIGER (10.4)

Pixie requires dlcompat. When installed via fink, these are in /sw/lib/libdl.0.dylib. Pixie binaries are compiled against Panther which had /usr/lib/libdl.dylib. The solution is to create a symbolic link from where the library is expected to be, to where it is. One final warning. Don't do this on Panther or Tiger - you've been warned.

sudo ln -s /sw/lib/libdl.0.dylib /usr/lib/libdl.dylib

If you don't want to do this, or can't, there's a work arround, which is to set

for tcsh

setenv DYLD_INSERT_LIBARARIES /sw/lib/libdl.0.dylib

for bash

export DYLD_INSERT_LIBARARIES=/sw/lib/libdl.0.dylib

before running pixie. Please see the notes at the end of this page...

[edit] For all OSX Versions

You should be ready to roll with renders now. Remember to set up the environment variable PIXIEHOME:

for tcsh

setenv PIXIEHOME /Applications/Graphics/Pixie

for bash

export PIXIEHOME=/Applications/Graphics/Pixie

Finally, you'll probably want to put pixie binaries in your path, which you do with

for tcsh

set path=($path /Applications/Graphics/Pixie/bin)

for bash

export PATH=$PATH:/Applications/Graphics/Pixie/bin

That's about it. I've put these commands in my login files. There are quite a few different oppinions/preferences on how to do this.

See also FAQ/Why Wont Pixie Run for more tips on diagnosing a problem.


Notes:

I believe there to be an issue running Pixie under 10.2.x with the fink dlcompat library. From Beque's email, here's what he did to get things to compile under 10.2.x. I'm hopfully going to fix up the binary distribution so the method above works correctly. It might not right now (Pixie 1.4.1).

export CFLAGS="$CFLAGS -Ddlsym=dlsym_prepend_underscore"
export CXXFLAGS=$CFLAGS
export CPPFLAGS=$CFLAGS

Then I reconfigured, cleaned, rebuilt and installed Pixie:

./configure --prefix=/Applications/Graphics/Pixie
make clean
make
make install

Then it worked!

To summarize how I got Pixie to work under OSX 10.2.8:

  • Download and unpack the source tarball
  • Make sure fink is installed with libtiff and dlcompat
  • export environment variables to point to fink's include and library

directories

  • Define _BSD_SOCKLEN_T_ before including sys/socket.h in src/common/os.h
  • export c and c++ flags to define dlsym=dlsym_prepend_underscore
  • configure and make as normal

I am sure some of the c and c++ flags I defined were redundant, but better safe than sorry. I'm just glad I got it to work and hope that this might help someone else.

Personal tools