Installation

Overview

The following section describes the steps necessary to install the CPLAT framework.

The CPLAT II release has been divided into 2 archives. The first one is the source code for the framework and demos. The second one is for the projects. This division means that you only need to download a small archive containing only the projects you will be using.

Once you download the projects archive, you simply copy the contents into the empty Projects folder that is part of the source release.

In this screen shot, you see the unarchived CPLAT II release.

Next, we see the projects folder with projects for both Codewarrior Pro9 and Apples XCode.

IDE / build environment setup

This next section describes the steps necesary to setup each build environment for building CPLAT applications.

Metrowerks Codewarrior Pro 8.x and 9.x

The only step needed to be done before building the CPLAT demos, tools and libraries is to setup some global source trees, since the paths are relative to these source trees.

The 3 source trees are (only the CPLAT entry is mandatory): CPLAT - this should point to the outter most folder. In the case of the above setup, the source tree should point to the CPLAT_II_Release folder. OpenGL - if you are going to build the CFM versions of the OpenGL demo, then you need to point to the Apple OpenGL SDK (which you need to download from Apples developer site). Windows and Mach use the headers and libraries provided by the OS, so you don't need this entry, unless building for CFM. QT_SDK - you need this one if you are going to build the QuickTime classes under Windows.

Apples XCode

Like Codewarrior, the XCode projects are built with all entries relative to a CPLAT source tree, which you setup, using the preferences of XCode.

After installing you will need to build the CPLAT libraries unless you are using XCode 2.x, in this order. Files in the third party folder, main framework lib in the Lib folder. Then you can build any of the demos.

Beginning with XCode2.x, the demos include subprojects to build the framework, which will also build the third party libs.

Microsofts Visual .Net

Neither of these environments require anything special. All files are setup to be relative to the project.

After installing you will need to build the CPLAT libraries, in this order. Files in the third party folder, main framework lib in the Lib folder. Then you can build any of the demos.

UserPrefixFlags.h

The UserPrefFile is included in all precompiled / prefix files, and is designed for the user to be able to customize how they want CPLAT to be built, such as overriding any of the default defines in CPLAT.

MacOS APIs

Beginning with CPLAT_II 2.0 you can set the flag CP_UseDepreciated_10_4_APIs to 0 to prevent APIs that are being disabled by Apple for 10.4 and above from being used. CPLAT attempts to provide more current and / or recommended approaches to the APIs being depreciated. This includes using HIShapes for Regions, Quartz for QuickDraw, etc.

Universal Binaries

Beginning with CPLAT_II 2.0 support for building Universal Binaries is supported. The CPLAT framework will produce a Universal Binary using the supplied XCode 2.1 projects. However, CPLAT has not yet been fully tested under OSX for Intel using the Developer Transition kit.

Generated on Sat Sep 17 20:02:36 2005 for CPLAT by

1.4.0