This is my own special 'GS rSound Kit' consisting of just about all you'll need
to create and convert other PC and Mac Wave and WAV files for use as an rSound
file. This 'GS rSound Kit' contains every IIgs resource sound form of program
ever released, that I'm aware of.


About: Wave2rSnd
Status: Freeware
Uploaded on 4/9/2001
by Charles T. 'Dr. Tom' Turley
Email: cturley@mcn.org


Wave2rSnd - supports only 8bit mono wave or wav file conversion

English Notes:  What it does...in short it converts a Windows Wave Sound
and/or QuickTime WAV sound file (Mono only) into an rSound (resource
sound file) (Type $D8 - Aux. 0003) for use with the Apple IIgs - Cool
EH? ;)   Bet you thought such a IIgs program never existed!  Well, it
does and the Wave2rSnd IIgs desktop application contains is the 
program that does it.  

Sure...the rSounder program versions 2 and 3 can also do this...and more! I've
even included the version 3 and version 2 (with no rsounds in the program to
save some space and loading time for it) so you can use it and compare for
yourself - how it works -vs- Wave2rSnd.

I personally think that the Wave2rSnd IIgs desktop application does it faster
and better with more clarity of sound quality.  That's why I included it in this
'My rSnd Kit' I've put together with my favorite 'Windows Wave file to rSnd file
conversion' -  Lighten Up by Big Mountain (converted and used with premission). 
This rSnd is a bit over 4MB's in size (yes, that is ratherlarge - as it consist
of the entire song).

You can create and/or convert any size Windows Wave (or RAW sound file) and/or
any QuickTime WAV sound file to an Apple IIgs rSnd file for such play via your
IIgs desktop needs and application programs that support play of an rSnd file.

You will need an ample amount RAM to load such large rSnd files and play them.
The IIgs can support up to 8MB's of RAM - which should be more than enough to
play any full song saved as an rSnd file from a WAVE or WAV file via the GS/OS
v6.0.1 desktop.

The Wave2rSnd IIgs desktop application pull down menu, options/functions are all
in French as is the program  with all of it's text presented to the user.  But,
you should be able to figure it all out with a little effort.  It's user
friendly and fairly straight forward with its functions and menu options.

(Perhaps somebody can convert/edit and translate the program into English text
to make it easy for us English speaking folks to understand and use it better!)

Matt Ackeret released a IIgs shell program that can convert WAVE or WAV sound
files to an rSnd file.  But, as a shell program it is rather bland in design and
requires a GS shell application system for use with it.  I have included it also
in this archive.  It's in the folder named RAWTORES. I really like using the
Wave2rSnd desktop application much more!!

Please note:  The Wave2rSnd application program DOES NOT load a rSnd file. It
loads either Mac QuickTime WAV files and/or PC (Windows) WAVE files and then
converts and saves them in 8bit mono resource sound files!!!

Anyway...when you have saved the file to disk or hard drive as an rSnd file from
the 'Wave2rSnd' GS/OS 6.0.1 desktop application program - you can simply click
on the rSnd file and it will play in the correct speed - play rate -
frequency... in an automatic mode in mono or as Moc-Stereo, if you have a stereo
card and the program to support such in your IIgs.  The only program that will
do this is Digital Session v1.0.

That IIgs Digital Session program archive is available for download from this
URL.

ftp://ftp.apple.asimov.net/pub/apple_II/incoming/DigialSessionsGS.sdk

Be advised - it's a bit buggy - so, use at your own risk!

I've also included a few smaller (former) Windows Wave files and Mac QuickTime
WAV files that were converted to rSound files using the IIgs rSounder desktop
application programs, so you can listen to them and compare them with the
'Lighten Up' rSnd file that was converted using the Wave2Snd program.

Cheers & Enjoy!
Tom

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

The original French program documentation follows...

Documentation du programme Wave2rSound
======================================

C�est seulement r�cemment que les utilisateurs de p�c� ont d�couvert la
possibilit� de faire sortir des sons de leurs machines, et encore pas
directement, comme cela est le cas pour nos GS depuis pr�s de huit ans
maintenant, mais par l�interm�diaire d�une carte d�extension. La qualit�
de ces sons n�est pas encore au niveau de ce que l�on peut obtenir sur
GS avec une bonne carte st�r�o, mais elle est correcte dans l�ensemble.
Par ailleurs, on ne peut pas encore tout � fait int�grer ces sons aussi
simplement � l�environnement de la machine, m�me sous Windoze, que ce
que nous pouvons faire avec par exemple le tableau de bord �Son� de nos
GS.

En revanche, les possesseurs de brouettes ont un avantage �norme sur
nous : ils sont nettement plus nombreux. Du coup, le nombre de fichiers
sons disponible sur p�c� est infiniment plus grand que ce dont nous
disposons sur GS, notamment depuis l�av�nement du CD-ROM amen� par le
multim�dia, puisque ce support permet de stocker de nombreux sons de
dur�e assez cons�quente, ce qui n�est gu�re possible avec des
disquettes.

Pour pouvoir continuer � b�n�ficier des derniers trucs � la mode sur nos
GS, il nous faut donc regarder ce qui se passe dans les autres mondes,
et � chaque fois que c�est possible, essayer de leur piquer ce qu�ils
ont de plus int�ressant. Cela n�est en g�n�ral pas trop compliqu�, �tant
donn� la facilit� du GS � acc�der aux donn�es provenant des autres
environnements, en particulier gr�ce � GS/OS et � ses FST.

Dans la pratique, la r�cup�ration d�un fichier provenant d�une autre
machine n�cessite deux choses :

 d�une part que le fichier soit physiquement lisible sur le GS; c�est
en fait l�aspect qui pose le moins de probl�mes puisque le GS sait lire
les disquettes HFS provenant du Mac, les disquettes MS-DOS provenant du
PC d�s lors que vous avez un lecteur compatible (ce peut �tre un lecteur
Apple connect� � la carte PC Transporter, un lecteur de disquettes PC
connect� � la carte BlueDisk de SHH Systeme, ou un lecteur de Floptical
connect� � une carte SCSI, soit RamFAST, soit la carte SCSI Apple avec
le driver appropri�; il en existe une version en freeware que vous
trouverez sur votre disquette GS Infos) et les CD-ROM au format ISO 9660
(c�est le standard de stokage sur CD) ou High Sierra (c�est la version
pr�c�dente du standard) ou encore HFS (si le CD a �t� con�u pour le Mac)
� partir du moment ou vous avez branch� un lecteur de CD-ROM derri�re
votre carte SCSI (RamFAST ou Apple);

 d�autre part, il faut pouvoir interpr�ter le contenu du fichier, soit
directement, soit apr�s une conversion dans un format reconnu par les
programmes disponibles sur le GS.

Dans le cas qui nous pr�occupe, c�est-�-dire la r�cup�ration des
fichiers sons, soit le son est directement exploitable par le GS (c�est
par exemple le cas des musiques MOD qui peuvent �tre utilis�es telles
quelles avec des programmes comme ModZap, soniqTracker ou NoiseTracker,
tous en freeware), soit il doit �tre converti par un programme
sp�cialis�; c�est notamment le cas des fichiers MIDI qui doivent �tre
traduits au format synthLab/MidiSynth; plusieurs programmes permettent
d�y parvenir : Musix de notre Babar national (voyez votre catalogue du
GS Club favori), MidiSurgeon paru dans le num�ro 3 de cette ann�e du
magazine GS+ et MusicComposer, un programme en shareware inscrit au
catalogue du GS Club. Ces fichiers sont plus des musiques que des sons �
proprement parler.

Dans le monde p�c�, les sons sont stock�s principalement dans deux
formats : le format VOC d�fini par les cartes son SoundBlaster et
d�riv�es, et le format WAVE d�fini par Microsoft dans le cadre de
Windoze.

Le format WAVE (identifi� par le suffixe .WAV) est � la fois le plus
r�pandu et le plus simple � r�cup�rer, car il s�agit d�un son brut
(c�est-�-dire qu�il contient le son tel qu�il a �t� enregistr�, sans
compression, ni autre recodage), quasiment directement exploitable par
le GS. Vous pouvez d�ailleurs le v�rifier par vous-m�mes en chargeant un
tel son dans un programme tel que �SoundShop� accompagnant HyperStudio
et en l��coutant. Il vous faudra juste t�tonner un peu pour trouver la
bonne fr�quence (en g�n�ral c�est 11025 ou 22050 Hertz, c�est-�-dire des
fr�quences standards).

Un son dans le format WAVE est pr�c�d� d�un ent�te de taille variable
indiquant que le fichier est bien dans le format WAVE ainsi que les
caract�ristiques du son, � savoir essentiellement s�il est en mono ou en
st�r�o, la fr�quence de l��chantillonage, et la taille des �chantillons
qui peut �tre de 8 ou de 16 bits. Ce sont ces informations qui
provoquent le clic que l�on peut entendre en �contant le son avec
�SoundShop�. A part cet ent�te, il existe un l�ger probl�me avec ces
sons, comme d�ailleurs avec pratiquement tous les sons disponibles sur
les autres plateformes : les �chantillons peuvent avoir une valeur
allant de 0 � 255 (si la taille de l��chantillon est de un octet), alors
que pour l�Ensoniq du GS, un �chantillon doit commencer � 1, la valeur 0
indiquant la fin du son. Ceci implique que le son sera probablement
tronqu� si vous l��coutez tel quel. Il faut donc remplacer les 0 que
l�on trouvera dans ces fichiers par une autre valeur. Il y a en fait
deux possibilit�s :

 soit on les remplace par des 1, en partant du principe qu�une
diff�rence aussi petite ne changera pas grand chose au son;

 soit on consid�re que ces 0 sont des erreurs d�enregistrement, auquel
cas on les remplace par la valeur m�diane des deux (ou plus)
�chantillons avant et apr�s ce 0.

Pour les sons import�s d�une autre machine, la premi�re solution est
tout � fait ad�quate.


Si je vous ai racont� tout ceci, c�est pour vous parler maintenant du
programme �Wave2rSound� dont le but est d�effectuer la conversion d�un
son en format WAVE dans un format plus facilement utilisable sur le GS,
� savoir en ressource �rSoundSample� directement exploitable avec le
tableau de bord �Son� ainsi qu�avec HyperCard GS et un grand nombre
d�autres applications (par exemple des extensions au Finder).

Ce programme, que vous trouverez sur votre disquette GS Infos, est en
freeware. Vous pouvez donc l�utilisez librement sans rien avoir � me
devoir. Je serai toutefois ravi de recevoir vos commentaires (en
particulier si vous trouvez des anomalies), d�autant que j�ai
l�intention de l�am�liorer pour pouvoir r�cup�rer des sons stock�s dans
d�autres formats, notamment le format VOC que j�ai �voqu� plus haut,
mais aussi des sons provenant du Mac ou de l�Amiga (il s�agit de sons,
pas de musiques); d�ailleurs si vous avez des sons pour ces deux
machines, vous pouvez me les envoyer sur une disquette lisible sur GS
afin que j�ai suffisamment d�exemples pour pouvoir tester le programme.
Au cas o� cela soit encore n�cessaire, je vous rappelle mes coordonn�es
:

Philippe Manet 40 rue Victor Hugo 94700 Maisons Alfort

La conversion effectu�e par �Wave2rSound� consiste � remplacer les 0 par
des 1, comme je viens de l�expliquer, mais aussi � traduire les
informations d�finies dans l�ent�te du fichier WAVE dans le format des
ressources �rSoundSample� d�fini par Apple. Cette conversion est
enti�rement automatique, c�est-�-dire qu�il vous suffit d�ouvrir un
fichier WAVE; le programme le charge alors en m�moire en r�alisant les
modifications n�cessaires. Vous pouvez ensuite le sauver soit dans un
nouveau fichier, soit ajouter la ressource � un fichier existant qui
peut �tre aussi bien un fichier de sons qu�une pile HyperCard ou tout
autre fichier � votre convenance.

Avant de sauver le son converti, le programme vous donne la possibilit�
d��couter le son et de le purger sans le sauver s�il ne vous int�resse
pas. La seule contrainte pour pouvoir �couter le son est que vous devez
avoir install� le tableau de bord �Son� dans votre syst�me, ce qui
implique d�ailleurs que �Wave2rSound� requiert au moins le syst�me 6.0.
En fait, il utilise certaines des nouvelles possibilit�s du syst�me
6.0.1, et ne peut donc fonctionner qu�avec la derni�re version du
syst�me (mais vous l�avez tous obtenu aupr�s du GS Club, n�est-ce-pas ?)

�Wave2rSound� ne prend en compte que les sons en mono ayant une taille
d��chantillon de 8 bits. Ces restrictions sont impos�es par le format
des ressources �rSoundSample�. Elles sont toutefois peu g�nantes dans la
pratique, car la majorit� des sons WAVE sont dans ce cas : plus de 90%
de ceux que j�ai essay� (et j�en ai essay� plus de 200 !) ont pu �tre
converti sans difficult�. Pour ceux qui sont rejet�s par le programme,
une fen�tre d�alerte vous informe de la raison de ce rejet.

Pour ceux qui n�ont pas � leur disposition de sons WAVE, j�ai inclus un
certain nombre de sons que j�ai converti avec �Wave2rSound�. Au moment
o� j��cris ces lignes, je ne peux pas vous dire exactement lesquels, car
cela d�pendra de la place disponible sur la disquette lors de
l�assemblage. L�inconv�nient de ces sons est qu�ils sont volumineux !

Voici maintenant le d�tail des diff�rents articles pr�sents dans les
menus :

Menu Pomme ----------

 A propos de Wave2rSound� : cet article vous informe sur la version du
programme et donne les habituelles informations de Copyright. Il y a
aussi une belle ic�ne � admirer (une fois) �

 vous trouverez ensuite vos accessoires de bureau

Menu Fichier -----------

Le menu Fichier compte 6 articles :

 Ouvrir� : cet article vous permet de charger un fichier WAVE. La bo�te
de dialogue de s�lection du fichier est on ne peut plus classique, sauf
qu�elle dispose de deux boutons radio permettant de ne visualiser que
les fichiers ayant une extension .WAV (cas standard des fichiers WAVE)
ou tous les fichiers. Si il y a d�j� un son charg� en m�moire, mais non
sauv�, vous devrez d�abord indiquer s�il doit �tre purg� ou sauv�, ou si
vous avez chang� d�avis et d�cid� d�annuler l�ouverture d�un nouveau
fichier.

 Fermer : cet article n�est disponible que si vous avez ouvert un
accessoire de bureau.

 Purger le son en m�moire : cet article permet de supprimer le son
charg� sans le sauver. Vous devrez toutefois confirmer votre choix, car
vous avez la possibilit� de sauver le son avant de le purger.

 Sauver sous� : cet article est � utiliser pour cr�er un nouveau
fichier de ressources �rSoundSample�. Les ressources son sont nomm�es;
par d�faut, ce nom est celui du fichier WAVE d�origine, sans son
extension .WAV et converti en minuscules (les noms des fichiers DOS sont
tous en majuscules), mais vous pouvez �diter ce nom, comme nous allons
le voir plus loin. Les sons restent en m�moire apr�s avoir �t� sauv�s,
vous pouvez donc en faire plusieurs copies, ou les r��couter.

 Ajouter ressource� : cet article permet d�ajouter le son en tant que
ressource � un fichier existant. Si ce fichier poss�de d�j� une
ressource son ayant le m�me nom que celle que vous essayez d�ajouter,
vous devrez soit remplacer cette ancienne ressource, soit renommer le
nouveau son, soit abandonner l�ajout de la ressource � ce fichier.

 Quitter : pour quand vous avez converti tous vos sons !

Menu Edition -----------

Le menu Edition est on ne peut plus standard, mais il n�est pas utilis�
par �Wave2rSound�. Il est pr�sent � l�intention de vos accessoires de
bureau. Ce menu inclut un article permettant de voir le contenu du
presse-papiers.

Menu Sons ---------

Ce menu compte 3 articles :

 Ecouter le son : comme son nom l�indique, c�est gr�ce � cet article
que vous pourrez �couter le son converti avant de d�cider si cela vaut
le coup de le sauver ou pas. Cette option requiert que le tableau de
bord soit correctement install� pour pouvoir fonctionner. Dans le cas
contraire, vous n�entendrez rien, mais le programme continuera de
fonctionner normalement.

 Informations : cet article vous permet de conna�tre la fr�quence en
Hertz et la taille en octets du son, ainsi que le nom actuel du son
(soit le nom original, soit le nom que vous lui avez donn�) et le nom du
fichier dans lequel vous l�avez sauv� si tel est le cas; dans le cas
contraire, vous serez inform�s de la non-sauvegarde du son.

 Editer le nom� : une bo�te de dialogue vous permet de donner un
nouveau nom au son avant de l�enregistrer. Ce nom est limit� � 30
caract�res.



 Will somebody -- PLEASE -- convert this into English? 




-END OF FILE-