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-