Mac OS X updates: Fontconfig configuration files (fonts.conf, fonts.dtd) are now installed upon first launch. Added dialog box requesting user to wait while font cache is being built. Improved "About Tux Paint" dialog box. Added experimental speech synthesis support. Updated developer Read Me.
This commit is contained in:
Martin Fuhrer
parent
4e3d46bf74
commit
12e3dcaf7f
15 changed files with 1254 additions and 30 deletions
|
|
@ -1,10 +1,9 @@
|
|||
Tux Paint Xcode 2.4 Project
|
||||
notes by Martin Fuhrer <mfuhrer@alumni.ucalgary.ca>
|
||||
|
||||
This Tux Paint project file is located in a folder titled "macosx", which should in turn be placed in the root folder of the Tux Paint source code distribution. The project will then be able to access all the source code files. You will require Mac OS X 10.4 and XCode 2.4 or later to build this project.
|
||||
|
||||
This XCode project has been configured under the assumption that you have certain libraries and files installed in particular locations under Mac OS X. This file indicates what you must install, and where these items go. Some of the libraries are installed via the Fink package manager, which can be downloaded from <fink.sourceforge.net>
|
||||
This Tux Paint project file is located in a folder titled "macosx", which should in turn be placed in the root folder of the Tux Paint source code distribution. The project will then be able to access all the source code files. You will require at least Mac OS X 10.4 and XCode 2.4 to build this project.
|
||||
|
||||
This XCode project has been configured under the assumption that you have certain libraries and files installed in particular locations under Mac OS X. This documentation indicates what you must install, and where these items go. Some of the libraries can be installed via the MacPorts <www.macports.org> or Fink <fink.sourceforge.net> package managers. At the time of writing, MacPorts can install one additional required library (SDL Pango) that is not available in Fink, so I have written this document with MacPorts in mind. Several libraries are either misconfigured (with regards to building Tux Paint) or unavailable in MacPorts and Fink, and need to be configured, compiled, and installed manually. You will also need to create the following "sandbox" directory where you will build and store these libraries: /Users/Shared/tuxpaint
|
||||
|
||||
-- SDL --
|
||||
|
||||
|
|
@ -18,14 +17,112 @@ SDL_ttf.framework
|
|||
You can obtain the frameworks from the SDL website <www.libsdl.org> These frameworks contain both header files and libraries, and are copied into the Frameworks directory of the Tux Paint application bundle.
|
||||
|
||||
|
||||
-- PNG, Internationalization, and Character Set Conversion Libraries --
|
||||
-- Installing Libraries via MacPorts --
|
||||
|
||||
Install the PNG (libpng.a), GNU internationalization (libintl.a), and character set conversion (libiconv.dylib) libraries via Fink. By default, Fink will place the libraries in /sw/lib. These libraries will be statically linked into the Tux Paint binary.
|
||||
The following libraries can be installed via MacPorts.
|
||||
|
||||
Library Install location
|
||||
|
||||
GNU Internationalization: /opt/local/lib/libintl.a
|
||||
PNG: /opt/local/lib/libpng.a
|
||||
XML Parser: /opt/local/lib/libexpat.a
|
||||
Freetype: /opt/local/lib/libfreetype.a
|
||||
Cairo Vector Graphics: /opt/local/lib/libcairo.a
|
||||
SDL Pango: /opt/local/lib/libSDL_Pango.o
|
||||
|
||||
The following MacPorts command will install all these libraries in one shot:
|
||||
% sudo port install libsdl_pango
|
||||
|
||||
Copy all the static libraries listed above into the /Users/Shared/tuxpaint/lib directory, where the XCode project will find them. By keeping the static libraries in a separate directory, we will ensure that Tux Paint will not link against other dynamic libraries in /opt/local/lib (a problematic scenario if you wish to distribute your compiled version of Tux Paint to friends who most likely don't have these dynamic libraries installed). These libraries will be statically linked into the Tux Paint binary.
|
||||
|
||||
|
||||
-- Installing Libraries Manually --
|
||||
|
||||
The following libraries require manual compilation and installation.
|
||||
|
||||
Library Install location
|
||||
|
||||
XML Font Configuration: /Users/Shared/tuxpaint/lib/libfontconfig.a
|
||||
GLib: /Users/Shared/tuxpaint/lib/libglib-2.0.a
|
||||
/Users/Shared/tuxpaint/lib/libgobject-2.0.a
|
||||
/Users/Shared/tuxpaint/lib/libgmodule-2.0.a
|
||||
Pango: /Users/Shared/tuxpaint/lib/libpango-1.0.a
|
||||
/Users/Shared/tuxpaint/lib/libpangoft2-1.0.a
|
||||
SVG Scalable Vector Graphics: /Users/Shared/tuxpaint/lib/libsvg.a
|
||||
SVG Cairo: /Users/Shared/tuxpaint/lib/libsvg-cairo.a
|
||||
|
||||
We will compile our libraries inside the "src" directory: /Users/Shared/tuxpaint/src
|
||||
and install the libraries in the "lib" directory: /Users/Shared/tuxpaint/lib
|
||||
|
||||
XML Font Configuration:
|
||||
|
||||
This library will already have been built and installed by MacPorts, but will not have been properly configured for Tux Paint. We need to reconfigure and build Fontconfig as follows:
|
||||
|
||||
% cd /Users/Shared/tuxpaint/src
|
||||
% cp /opt/local/var/macports/distfiles/fontconfig/fontconfig*.tar.gz .
|
||||
% tar xzf fontconfig*.tar.gz
|
||||
% cd fontconfig*
|
||||
% sudo port deactivte fontconfig
|
||||
% ./configure --prefix=/Users/Shared/tuxpaint --enable-static --disable-shared --disable-docs --with-confdir=/Library/Application Support/TuxPaint/fontconfig/fonts --with-cache-dir=/Library/Application Support/TuxPaint/fontconfig/cache CPPFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib
|
||||
% make install
|
||||
% sudo port activate fontconfig
|
||||
|
||||
GLib:
|
||||
|
||||
MacPorts only installs the dynamic libraries for GLib. We need to reconfigure and build GLib with static libraries enabled as follows:
|
||||
|
||||
% cd /Users/Shared/tuxpaint/src
|
||||
% cp /opt/local/var/macports/distfiles/fontconfig/fontconfig*.tar.gz .
|
||||
% tar xzf fontconfig*.tar.gz
|
||||
% cd fontconfig*
|
||||
% sudo port deactivate glib
|
||||
% ./configure --prefix=/Users/Shared/tuxpaint --enable-static CPPFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib
|
||||
% make install
|
||||
% sudo port activate glib
|
||||
|
||||
Pango:
|
||||
|
||||
MacPorts only installs the dynamic libraries for Pango. We need to reconfigure and build Pango with static libraries enabled as follows:
|
||||
|
||||
% cd /Users/Shared/tuxpaint/src
|
||||
% cp /opt/local/var/macports/distfiles/pango/pango*.tar.bz2 .
|
||||
% bunzip2 pango*.tar.bz2
|
||||
% tar xf pango*.tar
|
||||
% cd pango*
|
||||
% sudo port deactivate pango
|
||||
% ./configure --prefix=/Users/Shared/tuxpaint --enable-static CPPFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib --with-included-modules=yes --with-dynamic-modules=no --disable-shared
|
||||
% make install
|
||||
% find . -name "*.a" -exec cp {} /Users/Shared/tuxpaint/lib/ \;
|
||||
% sudo port activate pango
|
||||
|
||||
SVG Scalable Vector Graphics:
|
||||
|
||||
Neither MacPorts nor Fink build and install the SVG library. You can retrieve sources from CVS via:
|
||||
http://webcvs.cairographics.org/libsvg/
|
||||
|
||||
Assuming you place the sources in /Users/Shared/tuxpaint/src/libsvg, you can configure and build SVG as follows:
|
||||
|
||||
% cd /Users/Shared/tuxpaint/src/libsvg
|
||||
% ./autogen.sh
|
||||
% ./configure --prefix=/Users/Shared/tuxpaint LIBSVG_CFLAGS=-I/usr/include LIBSVG_LIBS=-L/usr/lib --disable-shared
|
||||
% make install
|
||||
|
||||
SVG Cairo:
|
||||
|
||||
Neither MacPorts nor Fink build and install the SVG Cairo library. You can retrieve sources from CVS via:
|
||||
http://webcvs.cairographics.org/libsvg-cairo/
|
||||
|
||||
Assuming you place the sources in /Users/Shared/tuxpaint/src/libsvg-cairo, you can configure and build SVG Cairo as follows:
|
||||
|
||||
% cd /Users/Shared/tuxpaint/src/libsvg-cairo
|
||||
% ./autogen.sh
|
||||
% ./configure --prefix=/Users/Shared/tuxpaint LIBSVG_CAIRO_CFLAGS=-I/Users/Shared/tuxpaint/include LIBSVG_CAIRO_LIBS=-L/Users/Shared/tuxpaint/lib --disable-shared
|
||||
% make install
|
||||
|
||||
|
||||
-- Universal and Cross Development --
|
||||
|
||||
Tux Paint can be built for PowerPC, Intel, or both (as a universal binary). Since Tux Paint depends on a number of libraries, these libraries must also be built for the same platform(s) for which you wish to build Tux Paint. The latest versions of the SDL frameworks are universal binary and work fine regardless what platform(s) you want to build for. On the other hand, when Fink installs the PNG, internationalization, and character set conversion libraries, they are built only for the platform you are currently using. If you want to build a universal binary of Tux Paint, you will need to manually compile these libraries as universal binaries (see http://developer.apple.com/documentation/Porting/Conceptual/PortingUnix/compiling/chapter_4_section_3.html for further information) and update the library paths (click on a library in Archives and choose File > Get Info).
|
||||
Tux Paint can be built for PowerPC, Intel, or both (as a universal binary). Since Tux Paint depends on a number of libraries, these libraries must also be built for the same platform(s) for which you wish to build Tux Paint. The latest versions of the SDL frameworks are universal binary and work fine regardless what platform(s) you want to build for. On the other hand, the libraries installed via MacPorts are built only for the platform you are currently using (MacPorts offers a universal build option, but in practise this fails for most libraries). If you want to build a universal binary of Tux Paint, you will need to manually compile these libraries as universal binaries (see http://developer.apple.com/documentation/Porting/Conceptual/PortingUnix/compiling/chapter_4_section_3.html for further information) and update the library paths (click on a library in Archives and choose File > Get Info).
|
||||
|
||||
To set the target platform for your build:
|
||||
1) Choose Project > Edit Active Target 'Tux Paint'
|
||||
|
|
@ -34,7 +131,7 @@ To set the target platform for your build:
|
|||
4) Select the "Architectures" setting and click the Edit button.
|
||||
5) Select PowerPC, Intel, or both.
|
||||
|
||||
In order to allow the Tux Paint application to run on older versions of Mac OS X, it is necessary to compile and link against an older version of the Mac OS X SDK (eg. Mac OS X 10.2.8) using an older version of gcc (eg. gcc 3.3). Various versions of the Mac OS X SDKs and gcc can be installed from the XCode Installation DVD or disk image. Note that any libraries Tux Paint links against (eg. libraries installed by Fink) should also be compiled and linked against the same SDK, using the same version of gcc. Universal binary and Intel applications must be compiled using gcc 4.0 and the Mac OS X 10.4u SDK.
|
||||
In order to allow the Tux Paint application to run on older versions of Mac OS X, it is necessary to compile and link against an older version of the Mac OS X SDK (eg. Mac OS X 10.2.8) using an older version of gcc (eg. gcc 3.3). Various versions of the Mac OS X SDKs and gcc can be installed from the XCode Installation DVD or disk image. Note that any libraries Tux Paint links against (eg. libraries installed by MacPorts) should also be compiled and linked against the same SDK, using the same version of gcc. Universal binary and Intel applications must be compiled using at least gcc 4.0 and the Mac OS X 10.4(u) SDK.
|
||||
|
||||
To set the desired Mac OS X SDK:
|
||||
1) Choose Project > Edit Project Settings
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue