SoundWord
A program designed by Giuseppina Mancuso and
implemented by Paola Magillo
(C) Worldwide Copyright - All rights reserved
Instructions for installation of SoundWord
Introduction
SoundWord has been written in the Java language, version 1.2.
Thanks to this feature, SoundWord can run on any platform
(e.g., Windows of Linux systems) indifferently.
Before installing SoundWord, you need to:
-
(Mandatory) Get the Java run-time environment, version 1.2.
(or higher), if not yet present.
This is necessary in order to execute the SoundWord program.
-
(Optional) Have an audio board installed.
This is not necessary to execute the SoundWord program, but it
is necessary in order to listen to the produced music.
Without it, you can still execute
SoundWord, visualize the music and save it to a
Midi file. Those files could be played on another computer.
Before listing the instructions for installing SoundWord,
we report some information about Java.
Among them, we also report some internet addresses: we remark
that the addresses we report are neither all, nor the best
resources available in the network on this subject.
We disclaim any responsability for what concerns the content of the
sites (managed by other people) we mention!
Java run-time environment
Java is a programming language that has been especially designed
for the distribution of programs through the network with the maximum
compatibility between machines with different operating systems.
A program written in Java (i.e., SoundWord) exist in only one
version, which can be executed on any machine with any operating system
(various versions of Windows, Linux, Solaris...).
In order to execute a Java program, you need to have
the Java run-time environment installed.
The Java run-time environment contains, among other things, the Java
interpreter (invoked through the command java), that is needed
to execute any program written in Java.
Such environment exists in various versions for the various operating
systems.
Many of these versions are available for free on the network.
For instance:
Installing Java is very simple and it is explained in the instructions
for installation that are distributed together with the product.
Typically, you just have to uncompress the package you have downloaded,
place it in a directory (under Windows you simply have to run an
executable file), and then notify the system such directory in such a way
that the system will look there for the java command.
Installing SoundWord
SoundWord is given as a compresses archive
(SOUNDWRD.ZIP) with a related instruction file
(readme.txt).
Follow the instructions contained in readme.txt to uncompress the
archive SOUNDWRD.ZIP under a directory of your choice
(i.e., C:\SoundWord for Windows users).
This will create two subdirectories:
-
DOC:
contains this documentation in HTML format (text files
characterized by the .html extension, and images),
which can be viewed with any internet browser
(netscape, internet explorer...)
-
BIN:
contains the SoundWord program, consisting of Java classes
(files characterized by the .class extension),
configuration files (in the CONFIG directory)
and decorative images for the graphic interface
(in the IMAGE directory)
In order to execute SoundWord, it is sufficient to switch
to the command line (the MS-DOS prompt for Windows users) and type:
- cd XXX
where XXX is the name of the
directory where the program is
(i.e., C:\SoundWord\BIN in the above example).
With this command you move to the directory containing the
SoundWord files.
-
java SoundWord
Technically, this command runs the Java interpreter (the java
command) on file SoundWord.class, which is the root of the
file hierarchy forming the SoundWord program.
The first time the program will ask to choose a language.
Back to main page.