Next Previous Contents

2. Installation

For windows, unzip the archive and copy suzumusi.exe to any folder. A folder "sample" is included in the archive. This is sample wav files and sample script to play them. Make sure you have SDL.dll and SDL_mixer.dll with same directry as suzumusi.exe or windows' system directry. You don't need to compile if you don't want to modefy Suzumusi's source code.

For Linux, please follow compilation procedures.

2.1 Un-Installation

For Windows, just delete files. This program doesn't create any files and/or changes in your system.

For Linux, remove suzumusi in binary directry. For my system it is /usr/local/bin/suzumusi

2.2 How to obtain Suzumusi

The archive is available at my HP for both Windows and Linux.

2.3 Requirements

Suzumusi is tested on Windows98 and RedHat Linux 7.3. So those environment or higher are must. Plus following Libraries. Note those runtime environmet, SDL(SDL.dll) and SDL_mixer(SDL_mixer.dll) are come with suzumusi for windows users.

However the latest version is available at

SDL_mixer

Simple DirectMedia Layer

For the Linux, SDL and SDL_mixer are required. Please install them in your system. Don't forget to install the developper's Library also. And Linux needs developper package to compile it.

2.4 Compilation and installation

2.4.1.Linux g++

In order to compile and install Suzumusi on your system, type the following in the base directory of the Suzumusi distribution:


% ./configure

% make

% make install

Since Suzumusi uses


autoconf

2.4.2 Linux KDevelop

This is exactly same way to how I compile this program. Here is a brief explanation of configuration of the KDevelop. Please refer to SDL FAQs and SDL & KDevelop mini-HOWTO for the details

Copy sdl.m4 to acinclude.m4.in right after the preprocessor. Copy following text in configure.in.in. Your SDL_VERSION might be different. To find your SDL version, please check it with excuting "sdl-config --version" in your terminal.


dnl ---------------------------------------------------------------

dnl Check for SDL

SDL_VERSION=1.2.4

AM_PATH_SDL($SDL_VERSION,

            :,

            AC_MSG_ERROR([*** SDL version $SDL_VERSION not found!])

)

CFLAGS="$CFLAGS $SDL_CFLAGS"

LIBS="$LIBS $SDL_LIBS"

dnl ---------------------------------------------------------------

dnl ---------------------------------------------------------------

dnl Checks for libraries.

dnl Replace `main' with a function in -lSDL_mixer:

AC_CHECK_LIB(SDL_mixer,

       main,

       LIBS="$LIBS -lSDL_mixer",

       AC_MSG_ERROR([*** SDL_mixer library not found!])

)

dnl ---------------------------------------------------------------

To add compiler option. Go to Project|Options|Compiler Options|Flags and Warnings Tab|C++ Compiler Flags (CXXFLAGS)| then type in

`sdl-config --cflags`

To add Linker option, go to Project|Options|Compiler Options|Linker Flags|Additional flags:| and type in

`sdl-config --libs`

Then |project|DistClean, |project|autoconf and |project|configure. Them Build it.

2.4.3 Windows Visual C++

Run Time Environment comes with Suzumusi archive. But if you want to get latest version to your system, you can obtain newest version of libraries at the web sites introduced above. And then process following procedure. Plus please refere to VisualC.html which is included development environment SDL-devel-x.x.x-VC6.zip

Set up Run Time Environment 1st. Unzip the archives of SDL ( SDL-devel-x-x-x-win32.zip ) and SDL mixer ( SDL_mixer-devel-x-x-x-VC6.zip ). Then copy SDL.dll and SDL_mixer.dll into c:\windows\system or same folder where suzumusi.exe will be created.

To set up the Libraries, create the C++ project and Set the C runtime to "Multi-threaded DLL" in the menu: Project|Settings|C/C++ tab|Code Generation|Runtime Library.

Copy the SDL.lib and SDLmain.lib and SDL_mixer.lib to the directry where you want to have these libraries. Then include those libraries.

To set up the header files, copy bunch of header files comes with archive to any directry you want.

To let Visual C++ know the location of the header files and libraries, go to Project|Settings|C/C++ tab|Preprocessor|Additional include directories and type right directry of header files.

You should have not trouble with compiling it. Should you run into problems please report them to the the author at Nobuhiro Kuroiwa


Next Previous Contents