[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

2.4.5 MacOS/9

Written by K. Robert Bate, rbate@mac.com. Last updated 8 December 1999.

The MacOS/9 port of Crystal Space is maintained by K. Robert Bate. If you have any questions or problems, contact him at rbate@mac.com.

This port of Crystal Space is based upon the pre-Carbon Macintosh Toolbox API. Because it utilizes the classic Macintosh API it is suitable for MacOS/9 as well as possibly earlier releases. This port of Crystal Space will not work on MacOS/X since it is not Carbon-compatible.

You will need the following to compile Crystal Space:

  1. Compiler: Metrowerks CodeWarrior Pro 4 or later.
  2. Include Files: Universal Includes 3.2 from Apple

Getting Ready To Develop

If you are going to build the Open GL Renderer you need to download the OpenGL SDK from Apple:

ftp://ftp.apple.com/developer/opengl/opengl_sdk.hqx

This will download a self mounting disk image. Double click on it. Create a folder in the `Metrowerks CodeWarrior:MacOS Support' folder called `OpenGL SDK'. Copy the folders `Headers', `Libraries' and `Resources' from the `OpenGL SDK' disk and place them into the `OpenGL SDK' folder you just created.

Working with the Crystal Space Projects

There are 22 Crystal Space projects in the `mwcw' folder:

Three projects that build static libraries:

CSpace.mcp
Generates the static linked library, which includes the majority of the code for Crystal Space.
CSWS.mcp
Generates the static linked library, which includes the code for the Crystal Space Windowing System.
impexp.mcp
Generates the static linked library, which includes the code for the import and export code.

Seven projects that build shared libraries:

Driver2D.mcp
Generates the 2D Graphics shared library.
SftRndr.mcp
Generates the SoftwareRender shared library, which includes the 3D graphics driver for software rasterization.
OpenGLRndr.mcp
Generates the OpenGL Render shared library.
Sound.mcp
Generates the mac sound driver shared library and software sound render shared library.

Ten projects that generate applications

Blocks.mcp
A Tetris type game.
scfreg.mcp
The application which registers the shared libraries.
CSWSTest.mcp
The application which tests the Crystal Space Windowing System.
MazeD.mcp
The Crystal Space Editor.
MetaDemo.mcp
A meta-balls demo application.
Simple.mcp
Simple Crystal Space application.
Squawk.mcp
A Crystal Space application.
Walktest.mcp
Another Simple Crystal Space application.

Two project that builds other projects

MakeShared.mcp
Makes sure all of the shared libraries and scfreg are up to date.
MakeApps.mcp
Makes sure all of the applications are up to date.

Generally you will just build an application and all of the other pieces will be built for you. All of the resulting libraries and applications will be placed in the src directory.

  1. Open MakeShared.mcp in CodeWarrior and make it.
  2. This step is optional. If you find that a plugin module is not properly registered with SCF, then you may try registering it with the scfreg application. To do this, switch back to the finder, select all of the files that end in `.shlb' in the src folder and drop them on the scfreg application.
  3. Choose an application to build. I generally start with walktest. Make it.
  4. Make sure the map file `flarge.zip' is in the data folder.

You're all set to run the application.

Frequently Asked Questions (FAQ)


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

This document was generated using texi2html