TweetFollow Us on Twitter

Sound 101
Volume Number:9
Issue Number:3
Column Tag:C Workshop

Related Info: Sound Manager

Sound 101

Evolution of the Mac voice

By Iggi Monahelis, Pleasanton, California

Note: Source code files accompanying article are located on MacTech CD-ROM or source code disks.

About the author

Iggi Monahelis is a programmer who bought his first Mac as soon as he could back in 1984. He is the principal designer and co-author of “Read My Lips”, the sound annotation utility for the Macintosh.

Introduction

This is an introductory article, hence the name Sound 101, dealing with basic recording and playback of sounds on the Macintosh. It explains the required steps to be taken in order to digitize sounds using a microphone, in two different sound formats, and play them back. It is a good stepping stone for someone who has little or no knowledge of how to do these things in a program on the Macintosh. As a matter of fact, one can probably copy the routines given in the article, and use them in their own program without a lot of modifications.

Ancient History

The Macintosh has had the capability of producing sounds since day one. The famous introduction of the Macintosh back in 1984 used sound, in the form of digitized speech, to allow the Mac to introduce itself. Inside Macintosh back then had a chapter on the Sound Driver with just a few routines, literally StartSound, StopSound and SoundDone, that allowed the programmer to control the Sound Driver. The Sound Driver produced sound using three different sound synthesizers:

1) the four-tone synthesizer, used to make simple harmonic tones, with up to four “voices” producing sound simultaneously. Hence the name four-tone.

2) the square-wave synthesizer, used to produce sounds such as beeps.

3) the free-form synthesizer, used to produce complex sounds, music and speech.

You had to “describe” the sound to the Driver as a waveform, basically fill a buffer with a bunch of numbers, and tell the Sound Driver to start producing noise based on these numbers. Very primitive.

Middle Ages

With the introduction of the Macintosh II class of machines, the Sound Driver had graduated to the Sound Manager. It was indeed a graduation because several innovations had taken place:

1) The hardware now included a new sound chip which freed the machine’s processor from doing all the work.

2) The introduction of sound resources. Sound resources can “contain” any sound you can imagine, from a simple beep sound to digital recordings of CD’s. And because they are resources, in the Macintosh sense of the word, you can work with them using standard Resource Manager calls. To play a sound resource all you have to do is load it and pass the handle to the resource to the SndPlay routine.

3) The Sound Manager now has seven routines to allow you to work with sound.

To produce sound, commands are sent to a synthesizer, as was the case with the Sound Driver. The Sound Manager uses a queue to send these commands to a synthesizer, these queues are called channels. To make complex sounds, many sounds may need to be produced simultaneously. For this reason several synthesizers can have multiple channels.

The new Sound Manager uses three synthesizers to produce sound:

1) the wave-table synth, lets you supply a wave table that describes the sound. This lets you produce more complex sounds, also it lets you play multiple sounds simultaneously by opening several channels. It corresponds to the old four-tone synth with four channels open.

2) the note synth, used to produce simple sounds, such as a note. The note synth can produce only one note at a time. It compares to the old square-wave synth from the Sound Driver.

3) the sampled sound synth, used to play digitally recorded sounds. In this case instead of passing the note or a wave table describing the sound you want played, you pass a buffer that contains samples of the sound to be played. This synth compares to the old free-form synth from the Sound Driver.

Despite the innovations that came with the Mac II and the graduation of the Sound Driver to a Manager, it was still difficult to digitize sounds using System software. It was easy once you had a sound resource to play it and several programs, mostly shareware, were created to play sound resources. Farallon came out with the MacRecorder® sound digitizer which allowed you to digitize sounds using the software that came with it, but still you could not do that in your own program without writing a lot of code yourself.

Today

With the introduction of the Macintosh IIsi and Macintosh LC, Apple for the first time included a built-in microphone with the Macintosh. System software versions 6.0.7 and later have a new and improved version of the Sound Manager. The Sound Manager chapter goes from 32 pages to 114 pages. This latest version introduces a whole slew of new features, some of which are:

1) There are now routines to record sounds using the built-in microphones, or any third party microphone with the appropriate driver for Macs that do not come with a microphone.

2) One can record either sound resources (‘snd ‘), or record directly to a file on disk in a format known as: Audio Interchange File Format (AIFF).

3) There are routines that allow for compressing and decompressing of sound data.

4) There are now routines that allow for the playing of sounds directly from disk. So one does not have to load all of the sound in memory in order to play it.

5) Customization galore. Besides the high-level routines for recording and playback there are low-level routines so that one could customize the way recording and playback is done.

Writing the program

It is always easier to start with a basic program, understand it, and then expand on it. The Sound 101 program is just such a program for learning the basics about recording and playing sounds. The program can record and play 'snd ' and AIFF sound files. It also allows for the selection of sound quality.

Here goes the code with explanations...

Sound101_main.c
/***********************************************************
© 1992 Praxitel, Inc. and Iggi Monahelis

This is the “main” for the Sound 101 project.  It has the minimum stuff 
to get a mac
program going.  Basically, it does all the required mac initializations, 
sets up the menu
bar, and then gets and processes events.

***********************************************************/
#include “Sound101.h”


extern int  gDestroyChannel;
extern SndChannelPtr gSndChan;
extern short     gFRefNum;
extern long gQuality;

/***********************************************************

main

This is the main routine for the Sound 101 application, it does all the 
Mac initializations.
Then calls the EventLoop procedure to get and process events.

***********************************************************/
void main(void)
{
 InitGraf((Ptr) &thePort );
 InitFonts();
 InitWindows();
 InitMenus();
 TEInit();
 InitDialogs(0L);
 InitCursor();
 
 MaxApplZone();
 SetUpMenus();

 EventLoop();    /* Do event processing until user quits */

}

/***********************************************************

SetUpMenus

Set up the menu bar for the Sound 101 application
 
***********************************************************/
void SetUpMenus(void)
{
 MenuHandle myMenu;
 
 myMenu = GetMenu(mApple);
 
 AddResMenu( myMenu, ‘DRVR’ );
 InsertMenu( myMenu, 0 );
 InsertMenu(GetMenu(mFile), 0) ;
 DrawMenuBar();
}

/***********************************************************

EventLoop

Event handling for the Sound 101 application.
Get events forever, and handle them by calling DoEvent.
 
***********************************************************/
void EventLoop(void)
{
 BooleangotEvent;
 EventRecordevent;

 do {
 gotEvent = WaitNextEvent(everyEvent, &event, 50, 0);
 if ( gotEvent ) {
 DoEvent(&event);
 }
 /* if we are done with the sound, dispose the sound 
    channel and close the sound file. */     
 if ( gDestroyChannel ) { 
 OSErr  myErr;
 
 InitCursor();
 if (gSndChan)
 myErr = SndDisposeChannel( gSndChan, TRUE);
 if (gFRefNum)
 myErr = FSClose(gFRefNum);
 /* make sure we do it only once! */
 gDestroyChannel = FALSE;
 gSndChan = 0;
 gFRefNum = 0;
 } 
 } while ( true ); /* loop forever */
} /*EventLoop*/

/***********************************************************

DoEvent

Determine the event type and dispatch accordingly
 
***********************************************************/
void DoEvent(EventRecord *event)
{
 short  part, err;
 WindowPtrwindow;
 char   key;

 switch ( event->what ) {
 case nullEvent:
 break;
 case mouseDown:
 part = FindWindow(event->where, &window);
 switch ( part ) {
 case inMenuBar:
 /* process a mouse menu command */
 DoMenuCommand(MenuSelect(event->where));
 break;
 case inSysWindow:
 /* let the system handle the mouseDown */
 SystemClick(event, window);
 break;
 case inContent:
 break;
 case inDrag:                
 break;
 case inGoAway:
 break;
 case inGrow:
 break;
 case inZoomIn:
 case inZoomOut:
 break;
 }
 break;
 case keyDown:
 case autoKey:
 /* check for menukey equivalents */
 key = event->message & charCodeMask;
 if ( event->modifiers & cmdKey ) {
 /* Command key down */
 /* if command-period was pressed, set our global
    to clean up the sound channel and close the
    open sound file. */
 if ( key == ‘.’ )
 /* command period was pressed */
 gDestroyChannel = TRUE;
 }
 break;
 case activateEvt:
 break;
 case updateEvt:
 break;
 }
} /*DoEvent*/

/***********************************************************

DoMenuCommand

Handles menu selections for the Sound 101 application
   
***********************************************************/
void DoMenuCommand(long menuResult)
{
 short  menuID, menuItem;
 short  itemHit, daRefNum;
 Str255 daName;

 menuID = HiWord(menuResult);
 menuItem = LoWord(menuResult);
 switch ( menuID ) {
 case mApple:
 switch ( menuItem ) {
 case iAbout: {  /* bring up the About box */
 OSErr  err;
 GrafPtroldPort;
 Rect   tempRect;
 DialogPtraboutDlg;
 
 GetPort(&oldPort);
 
 aboutDlg = GetNewDialog(128, nil, (WindowPtr) -1);
 if ( aboutDlg ) {
 /* Open a dialog box */
 ShowWindow(aboutDlg);    
 SelectWindow(aboutDlg);  /* Lets see it */
 SetPort(aboutDlg);
 while (TRUE) {
 ModalDialog(NULL, &itemHit);
 if ( itemHit == 1 )
 break;
 }
 DisposDialog(aboutDlg);
 SetPort(oldPort);
 }
 }
 break;

 default:
 /* all non-About items in this menu are DAs */
 GetItem(GetMHandle(mApple), menuItem, daName);
 daRefNum = OpenDeskAcc(daName);
 break;
 }
 break;
 
 case mFile:
 switch ( menuItem ) {
 case iPlaySound:
 PlayASound();
 break;
 case iRecordsndSound:
 Record_snd_resource(gQuality);
 break;
 case iRecordAIFFSound:
 Record_AIFF_sound(gQuality);
 break;
 case iQuality:
 GetQuality();
 break;
 case iQuit:
 Terminate();
 break;
 }
 break;
 } 
 
 /* unhighlight what MenuSelect (or MenuKey) hilited */
 HiliteMenu(0);  
}

/***********************************************************

Terminate

Quit the app
   
***********************************************************/
void Terminate(void)
{
 /* exit if no cancellation */
 ExitToShell();  
} /*Terminate*/
 
AAPL
$101.37
Apple Inc.
+0.79
MSFT
$45.24
Microsoft Corpora
+0.02
GOOG
$582.72
Google Inc.
-0.65

MacTech Search:
Community Search:

Software Updates via MacUpdate

calibre 2.0.0 - Complete e-library manag...
Calibre is a complete e-book library manager. Organize your collection, convert your books to multiple formats, and sync with all of your devices. Let Calibre be your multi-tasking digital... Read more
OpenOffice 4.1.1 - Free and open-source...
OpenOffice.org is both an Open Source product and a project. The product is a multi-platform office productivity suite. It includes the key desktop applications, such as a word processor,... Read more
Pages 5.2.2 - Apple's word processo...
Apple Pages is a powerful word processor that gives you everything you need to create documents that look beautiful. And read beautifully. It lets you work seamlessly between Mac and iOS devices. And... Read more
Quicken 2015 2.0.1 - Complete personal f...
The new Quicken 2015 helps you manage all your personal finances in one place, so you can see where you're spending and where you can save. Quicken automatically categorizes your financial... Read more
CleanMyMac 2.2.7 - Delete files that was...
CleanMyMac makes space for the things you love. Sporting a range of ingenious new features, CleanMyMac 2 lets you safely and intelligently scan and clean your entire system, delete large, unused... Read more
MacFamilyTree 7.2.4 - Create and explore...
MacFamilyTree gives genealogy a facelift: it's modern, interactive, incredibly fast, and easy to use. We're convinced that generations of chroniclers would have loved to trade in their genealogy... Read more
Videobox 4.1.1 - Download Flash video th...
Videobox allows you to quickly and easily download Flash video from most all of the popular video sites on the internet. Videobox will convert the video into a native Quicktime format so it's ready... Read more
Web Snapper 3.3.5 - Capture entire Web p...
Web Snapper lets you capture Web pages exactly as they appear in your browser. You can send them to a file as images or vector-based, multi-page PDFs. It captures the whole Web page - eliminating... Read more
Picasa 3.9.138 - Organize, edit, and sha...
Picasa and Picasa Web Albums allows you to organize, edit, and upload your photos to the Web from your computer in quick, simple steps. Arrange your photos into folders and albums and erase their... Read more
Tidy Up 3.0.15.0 - Find duplicate files...
Tidy Up is a complete duplicate finder and disk-tidiness utility. With Tidy Up you can search for duplicate files and packages by the owner application, content, type, creator, extension, time... Read more

Latest Forum Discussions

See All

Brain+ Review
Brain+ Review By Nadia Oxford on August 22nd, 2014 Our Rating: :: DIM BULBUniversal App - Designed for iPhone and iPad Brain+ is just another entry in an over-saturated brain-training marketplace – and not a particularly fun entry... | Read more »
The Witcher Battle Arena – New Gameplay...
The Witcher Battle Arena – New Gameplay Trailer Revealed Posted by Jessica Fisher on August 22nd, 2014 [ permalink ] Based in the Witcher universe, | Read more »
Max Gentlemen Review
Max Gentlemen Review By Jennifer Allen on August 22nd, 2014 Our Rating: :: OUTSTAYING ITS WELCOMEiPhone App - Designed for the iPhone, compatible with the iPad Max Gentlemen seems pretty quirky initially but that appeal wears thin... | Read more »
Club Penguin Gets Frozen All Over in Lat...
Club Penguin Gets Frozen All Over in Latest Takeover Event Posted by Ellis Spice on August 22nd, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Doctor Who: Legacy Review
Doctor Who: Legacy Review By Jennifer Allen on August 22nd, 2014 Our Rating: :: RUN OF THE MILLUniversal App - Designed for iPhone and iPad Doctor Who: Legacy is an ok match-3 puzzle game, but it lacks some much needed personality... | Read more »
Pentumble (Games)
Pentumble 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: *** Special Launch Price! 33% Off! *** Pentumble combines the joy of a free-flowing platformer with beautiful graphics and levels... | Read more »
DotEmu Summer Sale Cuts Several Games’ P...
DotEmu Summer Sale Cuts Several Games’ Prices to $0.99 Posted by Ellis Spice on August 21st, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
King Announces its Newest “Saga” – Diamo...
King Announces its Newest “Saga” – Diamond Digger Saga Posted by Jessica Fisher on August 21st, 2014 [ permalink ] Diamond Digger Saga, by King Digital Entertainment, promises to be another addictive, adorable game in the “Saga” | Read more »
Spacetime Studios’ Greg Mueller Tells Al...
| Read more »
TourStar Review
TourStar Review By Rob Thomas on August 21st, 2014 Our Rating: :: BORING TOURINGUniversal App - Designed for iPhone and iPad When The Ramones sang “Touring, touring/It’s never boring,” they clearly weren’t referring to TourStar.... | Read more »

Price Scanner via MacPrices.net

Leftover 15-inch 2.0GHz Retina MacBook Pros a...
B&H Photo has leftover previous-generation 15″ 2.0GHz Retina MacBook Pros now available for $1599 including free shipping plus NY sales tax only. Their price is $400 off original MSRP. B&H... Read more
Pro.Calendar – New Productivity App for iPad...
Austin, Texas based mobile business and productivity app developer LightArrow, Inc. has announced Pro.Calendar, a powerful and intuitive calendar app with eight versatile calendar options including... Read more
SanDisk Ultra II SSD — Supercharge Your Syste...
SanDisk Corporation has announced the new SanDisk Ultra II SSD with enhanced SSD Dashboard. The new drive is designed to deliver a cost-effective and easy upgrade solution for PC owners looking to... Read more
Samsung and Barnes & Noble Introduce New...
Samsung Electronics America and NOOK Media, a subsidiary of Barnes & Noble, Inc. have announced the introduction of the new Samsung Galaxy Tab 4 NOOK, a 7-inch tablet combining Samsung’s leading... Read more
21-inch iMacs on sale for up to $150 off MSRP
B&H Photo has 21″ iMacs on sale for up to $150 off MSRP including free shipping plus NY sales tax only. B&H will also include a free copy of Parallels Desktop software: - 21″ 2.7GHz iMac: $... Read more
27-inch 3.2GHz iMac on sale for $1698, save $...
Abt has the 27″ 3.2GHz iMac on sale for $1698 including free shipping. Their price is $101 off MSRP. Read more
Mac Backup Guru 2.0 Drive Backup/Cloneing Uti...
Mac Backup Guru developer MacDaddy has released Mac Backup Guru 2.0, offering new and enhanced advanced features, such as bootable backups, synchronised volumes and folders, and a Snapshot mode that... Read more
Operate GE’s New Free-Standing KItchen Range...
Think you accidentally left the oven on? Switch it off while on the go. The new free-standing Profile™ Series gas and electric ranges are GE’s second cooking appliances, following their wall oven, to... Read more
Parallels Announces Parallels Desktop 10 for...
The no. 1-selling software for running Windows applications on a Mac becomes an even easier choice for millions of consumers and IT professionals worldwide with the launch of the most powerful... Read more
Apple now offering certified refurbished 2014...
 The Apple Store is now offering Apple Certified Refurbished 2014 MacBook Airs for up to $180 off the cost of new models. An Apple one-year warranty is included with each MacBook, and shipping is... Read more

Jobs Board

*Apple* Retail - Multiple Positions (US) - A...
Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
Position Opening at *Apple* - Apple (United...
**Job Summary** As more and more people discover Apple , they visit our stores seeking ways to incorporate our products into their lives. It's your job, as a Store Read more
Position Opening at *Apple* - Apple (United...
…Summary** As a Specialist, you help create the energy and excitement around Apple products, providing the right solutions and getting products into customers' hands. You Read more
Project Manager, *Apple* Financial Services...
**Job Summary** Apple Financial Services (AFS) offers consumers, businesses and educational institutions ways to finance Apple purchases. We work with national and Read more
*Apple* Solutions Consultant (ASC)- Retail S...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.