Installation procedure for <GMT> software development

1.Create following directories on your C: drive

C:\b\pb\bin

here we will put the binaries for the compilers PBDLL, PBCC, PBRES, RC and editors PBEDIT, CCEDIT .... We do NOT distribute nor publish these files. You have to get (read buy) them from Powerbasic. (cfr. http://www.powerbasic.com) . Its a small enterprise trully deserving our support and their compilers are not only great, they are also very reasonably priced.

C:\b\pb\Cc

this directory is optional and will hold only source code to be compiled to EXE with the CC compiler (PowerBasic Console compiler)
It is a good repository for code experiments.

C:\b\pb\dll

this directory is optional and will hold only source code to be compiled to EXE or DLL with the DLL compiler

C:\b\pb\gmt

this will be the working directory for all GMT code
This will be the destination for the files you get on unzipping gmt_source.zip (available from the logos website at http://www.logosfoundation.org/gmt/gmt_source.zip Specific application/composition code may be placed in directories below this one.

C:\b\pb\winapi

This directory should include all declarations and include files that allow you to make use off the procedures contained in the Microsoft Windows kernel.
Do not use the version delivered and installed by Power Basic, since it contains some bugs. You can obtain the complete contents for this directory by
unzipping the file gmt_includes.zip. This file can also be downloaded from the logos website at: http://www.logosfoundation.org/gmt/gmt_includes.zip.
Essential files are:

• Win32api.inc
• Wsock32.inc
• Toolhelp.inc
• Richedit.inc
• Resource.h
• mdi32.inc
• ddt.inc
• commctrl.inc
• comdlg32.inc
• g_win.inc: only the declares effectively used in gmt. This one can replace all of the above windows api declarations.

If you want to run or to develop software using the optional National Instruments NiDAQ library -this only makes sense if you also have their hardware
(data acquisition cards)- you will also need the following files:

• nidaq32-pb.inc
• nidaqcns-pb.inc
• nidaqerr-pb.inc
• regdefs-pb.inc

These have been adapted to Power Basic by us and they are not available from National Instruments.
Including these files assumes you also have installed the NiDAQ software that comes with National Instruments boards and hardware.

In order to use our support for the MarschallSoft ftp libraries, you also need:

• fce32.bi
• fce32.dll installed under your windows directory

C:\b\pb\doc

Optional directory you may want to create, for putting all references and user manuals for GMT. The can be downloaded from the logos site and you should
regularly update your files, since we are continuously adding and improving our documentation.

2. Start PBEDIT.EXE (now at version 7.02)

The editor opens and you can now load gmt.bas. This module should always be the main module. Although nothing prevents you to add your own code to this module, it is highly advisable never to do so. Each system upgrade would bring you in risk of loosing your own work... So you should choose a new file and write your own application in one or more separate files. You can include your code either by adding a single include statement in the header of gmt.bas, or (better) in the module studentsxx.bas.

If you want your finished application to be included in the opening menu, you can contact the author in order to obtain a series of specific constants for identification.

Installation procedure for <GMT> runtimes and applications

Create following directories on your C: drive:

C:\b\pb\gmt

The files required in this directory are:

• gmt.exe or, another *.exe file if the author compiled his program under a different name...
• g_lib.dll this is the essential library used by GMT
• g_glib.dll a library only used by some pieces by myself.
• gmt.ini an initialization/configuration file for GMT. (ASCII file)
• test.wav a dummy WAV file used for initializing the wave devices, required only if you work under windows 95.
  
  GMT does not change nor use the Windows registry. So, removing this software completely can be done simply by deleting all above mentioned directories and their contents.

Often applications will need extra files (mostly data files) in order to run and initialize properly. Read the instructions for the application as provided by the author.

Specific applications and their file requirements:

<SHIFTS>

• C:\b\pb\gmt\shifts\shifts.cfg

<Cohiba>

• C:\b\pb\gmt\cohiba\cobiba.dat
• C:\b\pb\gmt\cohiba\cohiba1.wav etcetera up to C:\b\pb\gmt\cohiba11.wav These must be in 16 bit , 44.1kS/s stereo format.

<OboTek>

• C:\b\pb\gmt\obotek\obotek.dat
• C:\b\pb\gmt\obotek\OboTek1.wav etcetera up to C:\b\pb\gmt\obotek\obotek7.wav. These must be in 16 bit, 44.1kS/s stereo format.

<Due Cose...>

• C:\b\pb\gmt\duecose\duecose.dat

<A Book of Moves> , <Songbook>

• C:\b\pb\gmt\bom\bom.cfg
• These compositions require National Instruments hardware as well as driver software! Version 8.21 preferred.
• The authors <Invisible Instrument> is required.

<CelloPi>

• C:\b\pb\gmt\cellopi\cellopi.dat
• C:\b\pb\gmt\cellopi\cel1.wav etceteras up to C:\b\pb\gmt\cellopi\cel16.wav

<Fall'95>

• C:\b\pb\gmt\fall95\fall95.dat
• This composition requires both a player piano and the authors polymetronomes.

<TechnoFaustus>

• C:\b\pb\gmt\faust\faust.ini
• This opera composition requires National Instruments hardware as well as driver software! It requires the authors complete robot orchestra, radar devices, the invisible instrument en a 8 port midi interface.

<Gorgonio>

• C:\b\pb\gmt\gorgonio\gorgonio.dat
• This composition requires the authors barrelorgans as well as the player piano.

<LickStick>

• C:\b\pb\gmt\lickstick\lickstick.dat
• C:\b\pb\gmt\lickstick\ls_00.wav etceteras up to C:\b\pb\gmt\lickstick\ls_79.wav (cfr, cd rom distribution for GMT)

<Toverfluit>

• C:\b\pb\gmt\toverfluit.dat
• This composition requires the authors <Piperola> as well as the <Vox Humanola>

<Processing #4>

• C:\b\pb\gmt\gmt_p4.exe
• C:\b\pb\gmt\kristof\P4_Setup.bat only used for setup and creating of required directories
• C:\b\pb\gmt\kristof\P4_SysEx.hex
• C:\b\pb\gmt\kristof\Process4.ini
• This composition requires 3 external analog ringmodulators.

<Panatella>

• C:\b\pb\gmt\cohiba\panatella.dat
• C:\b\pb\gmt\cohiba\cohiba1.wav etceteras up to C:\b\pb\gmt\cohiba11.wav These must be in 16 bit , 44.1kS/s stereo format.