Changed the OSX config file so that it compiles on OSX 10.2
[blender-staging.git] / readme.txt
1 Welcome to the fun world of open-source.
2
3 To help you get started do the following before starting:
4
5 You will want to download the following external packages:
6
7 openssl:  http://www.openssl.org
8 python:  http://www.python.org
9 nspr:  ftp://ftp.mozilla.org/pub/nspr/releases
10 libjpeg:  http://www.ijg.org/
11 libpng:  http://www.libpng.org/pub/png/
12 zlib:   http://www.gzip.org/zlib/
13 openal:  http://www.openal.org/home/
14 (may be needed for openal)sdl: http://www.libsdl.org/index.php
15 smpeg: http://www.lokigames.com/development/smpeg.php3
16
17 If you do not have GL you will also need mesa:
18 http://www.mesa3d.org
19
20 --------------UNIX TIPS---------------------------------------
21 Assuming you are using tcsh/csh do the following before compiling.
22 #Set this to wherever you have extracted the source.
23 setenv NANBLENDERHOME `pwd`
24 setenv MAKEFLAGS "-w -I$NANBLENDERHOME/source"
25
26 set NANBLENDERHOME=`pwd`
27 export NANBLENDERHOME
28 set MAKEFLAGS="-w -I$NANBLENDERHOME/source"
29 export MAKEFLAGS
30
31 Then edit source/nan_definitions.mk to fit you're environment.
32 (You'll want to change things like NAN_OPENSSL,NAN_JPEG, NAN_PNG etc.. 
33 to point to where you have it installed)
34
35 After that cd $NANBLENDERHOME/intern 
36 make
37 make install
38 Then cd $NANBLENDERHOME/intern/python and follow the instructions in README
39 Then cd $NANBLENDERHOME/source
40 make
41
42 If you have any problems with the above post a message to the Forums on
43 www.blender.org
44 ----------------------WINDOWS TIPS--------------------------------------
45 If you have any problems with the above post a message to the Forums on
46 www.blender.org
47
48
49 ----------------------Mac OSX TIPS--------------------------------------
50
51 Build the intern libraries according to the description above. Instead of going
52 to the $NANBLENDERHOME/intern/python directory and reading the instructions, 
53 you can better directly go to the $NANBLENDERHOME/intern/python/freeze 
54 directory and make there. You can of course read the README.NaN but it should
55 not be necessary (unless you want to know about the process of "freezing" 
56 Python code).
57
58 Now before you go to the source directory, make sure you have installed the
59 external libraries that Blender depends upon. Here is a description of the 
60 things you need.
61
62 FINK:
63 Use fink (http://fink.sourceforge.net/) to install the following libraries that
64 Blender depends on:
65 1. openssl (fink install openssl)
66 2. jpeg    (fink install jpeg)
67 3. png     (fink install png)
68
69 PYTHON:
70 Mac OSX 10.2 (Jaguar) now comes with Python (2.2.1) pre-installed. This is fine
71 for producing the "frozen" Python code found in the intern directory. However,
72 the installation does not contain the python library to link against (at least
73 I could not find it). You could use fink to install Python but that Python 
74 installation depends on X being installed and that is a large installation.
75
76 If you prefer the easy way: download Python 2.2.2 from http://www.python.org.
77 Follow the instructions to in the documentation to install it on you're box. If
78 you run OSX 10.2 it should install just fine. Basically a configure and a 
79 "make" will do the job. The result is a Python library that should be copied to
80 the library tree together with the associated header files.
81
82 Create the following  directories:
83 $NANBLENDERHOME/lib/darwin-6.1-powerpc/python/include/python2.2
84 $NANBLENDERHOME/lib/darwin-6.1-powerpc/python/lib/python2.2/config
85 Now copy the include files and the libpython2.2.a library to those locations.
86
87 FMOD:
88 Will be added later.
89
90 RANLIB:
91 Although the make files run ranlib on the libraries built, the gcc linker 
92 complains about ranlib not being run. Until there is a solution, you will need
93 to run ranlib by hand once in a while when the make breaks. Luckily, the error
94 message lists the full path of the file to run ranlib on... Anybody out there 
95 with a real solution?
96
97 Success!