| 1 | >> BUILD INSTRUCTIONS FOR libmikmod FOR MACINTOSH
|
|---|
| 2 | -------------------------------------------------
|
|---|
| 3 |
|
|---|
| 4 | Requirements (to run):
|
|---|
| 5 | - 68020 or PowerPC Macintosh
|
|---|
| 6 | - Sound Manager 2.0 or above
|
|---|
| 7 | - CFM68K for 680X0 shared library
|
|---|
| 8 |
|
|---|
| 9 | Requirements (to compile):
|
|---|
| 10 | - Metrowerks CodeWarrior Pro
|
|---|
| 11 | - Apple MPW
|
|---|
| 12 |
|
|---|
| 13 | Platforms (either one of):
|
|---|
| 14 | - System 7
|
|---|
| 15 | - Mac OS 9
|
|---|
| 16 | - Mac OS X (10.1 and up)
|
|---|
| 17 |
|
|---|
| 18 |
|
|---|
| 19 | >> COMPILING
|
|---|
| 20 | ------------
|
|---|
| 21 |
|
|---|
| 22 | To fix the file type and creators:
|
|---|
| 23 |
|
|---|
| 24 | If you downloaded this library from the main site, there is a good chance
|
|---|
| 25 | that the types and creators of the various files are messed up and it won't
|
|---|
| 26 | build because of that. There is an AppleScript supplied, that will fix this.
|
|---|
| 27 |
|
|---|
| 28 | On Mac OS X, you should be able to open the text file "FixTypeAndCreators.applescript"
|
|---|
| 29 | Run this script, choosing the top "libmikmod" folder - and all should then be fixed.
|
|---|
| 30 | On Mac OS 9, if you have trouble opening the AppleScript because it *too* lacks the
|
|---|
| 31 | type and creator - there is a BinHex version in "FixTypeAndCreators.hqx". Use that.
|
|---|
| 32 |
|
|---|
| 33 | The script sets the creator to CodeWarrior, but is needed for the MPW builds as well.
|
|---|
| 34 | Note that all the files use UNIX line breaks (\n), and not the regular Mac ones (\r).
|
|---|
| 35 |
|
|---|
| 36 |
|
|---|
| 37 | To compile and build :
|
|---|
| 38 |
|
|---|
| 39 | A) Using CodeWarrior
|
|---|
| 40 | --------------------
|
|---|
| 41 |
|
|---|
| 42 | 1) Open "libmikmod-cw#.mcp" with CodeWarrior IDE
|
|---|
| 43 | 2) Set Current Target : "¥ All Libraries"
|
|---|
| 44 | 3) Make, or "Bring Up To Date"
|
|---|
| 45 |
|
|---|
| 46 | Temporary stuff (can be deleted afterwards)
|
|---|
| 47 | - "libmikmod-cw# Data" folder
|
|---|
| 48 |
|
|---|
| 49 | CodeWarrior version Pro 5 or Pro 6 is needed to open the supplied projects.
|
|---|
| 50 | If you have an older or newer version of CodeWarrior, you should be able to
|
|---|
| 51 | convert the project by opening it and choosing OK when it asks to convert.
|
|---|
| 52 |
|
|---|
| 53 | The Pro 5 version builds 68K and PPC targets for regular Macintosh (System 7),
|
|---|
| 54 | and the Pro 6 version builds Classic (Mac OS 9) and Carbon (Mac OS X) targets.
|
|---|
| 55 |
|
|---|
| 56 | At the moment there is no support for Mach-O linkage or the CoreAudio driver
|
|---|
| 57 | when using Metrowerks CodeWarrior, it would require updating to CodeWarrior 8.
|
|---|
| 58 | It might come in the future, but for now it is CFM and the Carbon driver only.
|
|---|
| 59 |
|
|---|
| 60 |
|
|---|
| 61 | B) Using MPW
|
|---|
| 62 | ------------
|
|---|
| 63 |
|
|---|
| 64 | 1) Open MPW Shell
|
|---|
| 65 | 2) Run the Script : "BuildLibmikmod"
|
|---|
| 66 |
|
|---|
| 67 | Temporary stuff (can be deleted afterwards)
|
|---|
| 68 | - "libmikmod.makeout" textfile
|
|---|
| 69 | - "obj","objppc" folders
|
|---|
| 70 |
|
|---|
| 71 | Currently the 68K build doesn't work because the default Symantec compiler
|
|---|
| 72 | lacks "long long" (64-bit) int support and also support for prefix headers.
|
|---|
| 73 |
|
|---|
| 74 | MPW can be downloaded for free from http://developer.apple.com/tools/mpw-tools/
|
|---|
| 75 | Updating your Universal Interfaces to the latest version (3.4) is recommended.
|
|---|
| 76 |
|
|---|
| 77 | The MPW makefile does not build any Carbon or Mac OS X targets.
|
|---|
| 78 | Use Apple's new freely available Developer Tools for that instead.
|
|---|
| 79 |
|
|---|
| 80 |
|
|---|
| 81 | >> TARGETS
|
|---|
| 82 | ----------
|
|---|
| 83 |
|
|---|
| 84 | SYSTEM 7
|
|---|
| 85 |
|
|---|
| 86 | Builds the following files:
|
|---|
| 87 | - libmikmod # Fat (680X0+PowerPC) Shared Library ['shlb']
|
|---|
| 88 | - libmikmodStub # Fat Stub Link Library (no code/data) ['stub']
|
|---|
| 89 |
|
|---|
| 90 | The various parts that are mixed into the above fat libraries:
|
|---|
| 91 | - libmikmod68k.lib # 680X0 stub library
|
|---|
| 92 | - libmikmodPPC.lib # PowerPC stub library
|
|---|
| 93 | - libmikmod68k.dll # 680X0 shared library
|
|---|
| 94 | - libmikmodPPC.dll # PowerPC shared library
|
|---|
| 95 | (these 4 files can be deleted, since they are also present in the fat libs)
|
|---|
| 96 |
|
|---|
| 97 | MAC OS 9 / MAC OS X
|
|---|
| 98 |
|
|---|
| 99 | - libmikmod.lib # PowerPC stub library, for both Classic/Carbon
|
|---|
| 100 | - libmikmodClassic.dll # PowerPC shared library, links to InterfaceLib
|
|---|
| 101 | - libmikmodCarbon.dll # PowerPC shared library, links to CarbonLib
|
|---|
| 102 |
|
|---|
| 103 | STATIC LIBRARIES
|
|---|
| 104 |
|
|---|
| 105 | - libmikmod.o # 680X0 Static Library for MPW
|
|---|
| 106 | - libmikmod.x # PowerPC Static Library for MPW
|
|---|
| 107 | - libmikmod 68k # 680X0 Static Library for CodeWarrior
|
|---|
| 108 | - libmikmod PPC # PowerPC Static Library for CodeWarrior
|
|---|
| 109 |
|
|---|
| 110 | - libmikmod Classic # Static Library for CodeWarrior (TARGET_API_MACOS8)
|
|---|
| 111 | - libmikmod Carbon # Static Library for CodeWarrior (TARGET_API_CARBON)
|
|---|
| 112 |
|
|---|
| 113 |
|
|---|
| 114 | >> INSTALLING
|
|---|
| 115 | -------------
|
|---|
| 116 |
|
|---|
| 117 | Mac OS:
|
|---|
| 118 | Move "libmikmod" to the Extensions folder of your System Folder.
|
|---|
| 119 | Move "libmikmodStub" and "mikmod.h" to your Compiler Folder, for instance
|
|---|
| 120 | (just somewhere along your libmikmod-using project's search path)
|
|---|
| 121 |
|
|---|
| 122 | These three files (libmikmod,libmikmodStub, mikmod.h) with installer
|
|---|
| 123 | can also be downloaded directly from my web page (see URL below).
|
|---|
| 124 | If you have troubles compiling them yourself, that is.
|
|---|
| 125 |
|
|---|
| 126 | Mac OS X:
|
|---|
| 127 | There is no official place to put them, since it only uses frameworks now.
|
|---|
| 128 | You can bundle the shared libraries next to your app, or link statically.
|
|---|
| 129 | (frameworks and other such nextisms are located in the "macosx" folder)
|
|---|
| 130 |
|
|---|
| 131 | Future Mac OS X support will take place using gcc and the Xcode IDE.
|
|---|
| 132 | (unless someone donates a copy of Metrowerks CodeWarrior 8 or 9 ;) )
|
|---|
| 133 |
|
|---|
| 134 |
|
|---|
| 135 | Enjoy!
|
|---|
| 136 |
|
|---|
| 137 | Anders F Bjrklund <afb@algonet.se>
|
|---|
| 138 | http://www.algonet.se/~afb/mikmod
|
|---|
