/src/FreeImage/README.solaris

 1Release Notes
 2--------------
 3Hey folks, 
 4
 5I just went through the process of building and using the freeimage library
 6on Solaris 9.  Things don't work out of the box so I thought I would share my
 7experiences in case someone else wants to do the same.
 8
 9I'm using Solaris 9, and I have installed all the development libraries, make,
10and the gcc 3.3.2 found on sunfreeware.com.
11
12You have to use the make from sunfreeware because the Solaris 9 make program
13chokes hard on FreeImages makefiles.
14
15First thing I had to do was modify the main FreeImage makefile:
16
171. go to the $(SHAREDLIB): line and replace the $(CC) line with the following.
18(there are 2 corrections)
19
20$(CC) -s -G -Wl,-soname=$(LIBNAME) -o $@ $(MODULES) $(LIBRARIES)
21
22The two changes are -G instead of -shared, and the = sign instead of a comma
23after the -soname.
24
252. change INSTALLDIR = /usr/lib to INSTALLDIR = /usr/local/lib
26
27This is because the sunfreeware tools assume the libs being built will reside
28in /usr/local/lib and thus set the default linker search paths to that.  Another
29solution for this would be to use the -R and -L linker options, but I chose
30the easy way :)
31
32That's it!  You can now use freeimage.   
33
34Also, if you have an autoconf/automake project that links against FreeImage,
35you can use the following in your configure.in, it works rather well for me:
36
37AC_CHECK_LIB(freeimage-3.5.0, FreeImage_Initialise, [],
38                                 [AC_MSG_ERROR([libfreeimage-3.5.0.so required and missing. See
39http://freeimage.sourceforge.net.]) ])
40
41the AC_CHECK_LIB macro will not only find the library, it will automatically
42link against it as well so you dont have to add it to your Makefile.am.
43
44I hope this helps someone!
45
46---
47ogtharox at users.sourceforge.net
48
49
50Installation
51------------
52Note: You will need to have root privileges in order to install the library in the /usr/local/lib directory.
53The installation process is as simple as this : 
541) Enter the FreeImage directory
552) Build the distribution : 
56make -f Makefile.solaris
57make -f Makefile.solaris install
583) Clean all files produced during the build process
59make -f Makefile.solaris clean
60
61Release Notes for Solaris/Sparc
62--------------------------------
63Under Solaris/Sparc, you will need to modify the following line : 
64COMPILERFLAGS = -O3
65modified into
66COMPILERFLAGS = -O3 -DBYTE_ORDER=BIG_ENDIAN -D__BIG_ENDIAN__
67