TweetFollow Us on Twitter

Speech Library
Volume Number:7
Issue Number:3
Column Tag:Basic School

Adding Speech to QuickBasic

By William H. Ball, Braintree, MA

Adding Speech to QuickBASIC

After reading Dave Kelly’s review of QuickBASIC, I knew that the time was right to buy a Microsoft BASIC for my Mac. I wanted to create clickable apps, but I also wanted the convenience of an interpreter. Now I have both.

So far I am pleased with QuickBASIC. But I was surprised to find that Microsoft did not include Macintalk support in the compiler. Macintalk is a small resource on disk (about 30K) that can add a nice touch to your programs.

Clear Lake Research has an ad on a back page of the QB manual and offers libraries for speech, 3D graphics, and sorting, mathematical, and statistical functions. I’m sure their libraries are professionally done, well-designed and extremely useful, but I didn’t want to wait; after buying the compiler I wanted to add speech to my programs that afternoon!

Pure-Code Resource Libraries

Anyway, this article presents one way to write what Microsoft calls a “pure-code resource” (as opposed to an “impure-code resource”) for QB. Luckily, LightspeedC users can generate these resources through the Set Project menu item. The details on building your own libraries for QB are in the manual. Basically, you

• create a project to build a code resource of type MBPC

• add your libraries and QB’s BasicLib.lib

• write the code

• compile to a code resource

• use ResEdit to

• set the file creator type to MSBB or MSBD

• set the file type to MSBL

You can add more resources with ResEdit as long as you give each resource a different name and ID. Voila! Your own libraries for BASIC! You can then use the LIBRARY statement in QB to use your collection of routines. Microsoft provides 20 library support routines in BasicLib.lib, which comes with QB, to help you write your own libraries.

A Speech Library

The source for SAY() shows how you can make your Mac talk from QB. The QB program, “test speech,” tests the SAY() routine. Building additional routines for QB looks pretty easy, even for a non-programmer like me. Microsoft made the job a lot easier by providing oodles of technical information in the manual and over 50 example programs on a disk which comes with the compiler. MDS, MPWC, MPWP, and LightspeedC examples are included.

Note that the LightspeedC example on pp. 447-448 in the QB manual will not work if you try to compile it. Why? Because the function prototypes in “BasicLSC.h” as supplied on QB’s examples disk were redefined after the manual went to print. Each argument type in the header now has a leading underscore. You will also have to change some of the casts.

I thought about writing a number of separate speech routines, but instead included the speech rate and pitch in SAY()’s syntax. You may choose to write your own. I wanted to keep things simple, so right now my library “Speech.lib” only contains SAY(). How many routines make a library? Two?

BasicError() Problem?

I also wanted to include more error-checking in the program, but ran across a problem with QB. The QuickBASIC library support routine BasicError(), as documented on page 459 of the manual, does not seem to work correctly. The casual reader (me) would assume that calling BasicError(n), with n representing one of the error codes listed on pp 557-559, would return a QuickBASIC error dialog with the representative error message. This is not the case; instead, an “Unprintable error” dialog is shown on the screen when a syntax error is encountered by a pure-code resource. This happened even with an example LightspeedC program, “AddStrings.c” included on the Microsoft disk, which was intended to demonstrate a pure-code resource with error-trapping. Maybe I’m doing something wrong? I tried trapping the error, but couldn’t correctly identify it. I’d welcome corrections, additions or enlightenments.

The code follows Microsoft’s suggestions, saves some registers for BASIC, and gets three arguments; two integer values for the speech rate and pitch, and a string to speak. Most of the work is done by GetNextLibArg(), a support routine that also tells you what type of argument was read. IntegerArg() converts the argument to an integer, and LoadStringDesc() returns a string with its length.

The general syntax for SAY() is

SAY(rate,pitch,string)

Where rate is an integer or integer variable from 0 to

425, and determines how fast string is spoken

pitch is an integer or integer variable from 0 to

500, and determines how high or low to speak

string is a string variable or string enclosed in

quotes

Make sure MacinTalk is somewhere on the volume, or SAY() will return a “Syntax Error.” If you pass the wrong number or type of arguments -- La Bomba! In fact, if you think that QB is the same, tame BASIC environment you grew up with on your first home computer, forget it. Because you now have full access to the Mac’s ROMs, there are a lot more opportunities to cause those sizzling, screen-splitting system crashes.

Factory Typo?

I was unable to generate a library icon of the speech library for the decimal version of QuickBASIC until I did some poking around with ResEdit. According to the manual on p. 451, you should use ResEdit to set the library’s file creator type to MSBB (for binary) or MSBD (for decimal). Well, everything’s fine if you set the type for MSBB, but not for MSBD! All you get when you return to the desktop is a plain document icon, and not a library icon. If I called the library from a program, the decimal version wouldn’t even show the filename on a GetFile dialog. Microsoft does not provide screenshots of the different icons generated by QB, so you can’t tell the difference between a document, application or library on the desktop until you get familiar with the program.

ResEdit showed me the solution to the problem. If you Get-Info the decimal version, you’ll see that the creator type is MSBA, not MSBD! Is this a ResEdit typo from the factory? Anyway, I figured it was safer to change the library’s creator type to MSBA rather than change the decimal version’s creator type. Once I did that, the decimal version was able to recognize the speech library, and the library had a library icon (which is a different icon from the binary version. Why?).

Drove me crazy for a while.

Printer Hangup

A further problem you might run across in QB is that printer errors are not trapped well by the QB environment. If your printer is off-line, QB will hang if you ask it to print the current file. Putting your printer back on-line gets you going again. Most Mac programs seem to catch this one.

Altogether, it’s great to have an interpreter and compiler in the same environment. One thing I’d like to see in a future version is the ability to edit multiple files. Also, the compiler seems to be a bit untidy, as it can leave a bunch of temporary files on your disk if your compile is aborted. I also ran out of room on my hard disk after a file called “QuickBasic Settings” grew to over six megabytes in the System Folder. This happened after a crash or two, and after I trashed the file QuickBasic came up damaged but with a graceful exit.

Despite the fact that you can now go into La-La Land just as easily as in C or Pascal, if you look back at the capabilities of the early BASICs on mainframes and micros you’ll see that the present QB environment is very nice indeed -- and now talks to you!

Have a happy! And remember, practice safe computing! After November’s virus scare, you never know what you can catch after connecting with another computer.

THINK C Project and Code Type

/* Speech.c -- QB code resource for access to MacinTalk routines 
   Copyright (C)1988 by William H. Ball for MacTutor™ magazine
    
   Usage: SAY(rate,pitch,string) 
   where  [rate] is an integer or integer variable 
     [pitch] is an integer or integer variable 
     [string] is a string variable or string enclosed by quotes. 
   for example,
    hefty% = 100 : wimpy% = 300 : fast% = 200 : slow% = 100
          m$ = “Hello there”
          CALL SAY(slow%,hefty%,m$)
          CALL SAY(fast%,wimpy%,m$)         
          or              
          CALL SAY(100,100,”Hello there”)
          CALL SAY(200,300,”Hello there”)
          
 Caveats: Can cause bombs of ID 2 or ID 10 if you fail to pass the correct 
number or type of arguments.
*/

#include “Macintalk.h”    /* LSC’s header          */
#include “BasicLSC.h”/* supplied with QB     */
 
PUBLIC VOID main() /* see QB manual p. 448*/
{
SpeechErr err;   /* error code*/
SpeechHandle theSpeech;   /* pointer to speech*/
Handle spOut;    /* speech handle  */

INT16   TempFlag,len,type,rate,pitch;
 /* INT16 == short */
StringPtr message; 
LIBARGPTR valptr;

 SAVEREGS();/* Save BASIC’s A4 and A5 registers*/
 
 if ((err = SpeechOn(“”, &theSpeech)) != noErr) { return; }
 
 if ((type = GetNextLibArg(&valptr,&TempFlag)) != _INTARG) rate = 150;
 else rate = IntegerArg();
 SpeechRate(theSpeech,(int)rate);
  
 if ((type = GetNextLibArg(&valptr,&TempFlag)) != _INTARG) pitch = 95;
 else pitch = IntegerArg();
 SpeechPitch(theSpeech,(int)pitch,Natural);
 
 type = GetNextLibArg(&valptr,&TempFlag);
 if (type != _NULLARG) {
 if (type == _STRGARG) {
 if (TempFlag)
 FreeTempDesc((SDRECPTR)valptr);
 LoadStringDesc((SDRECPTR)valptr,&message,&len);
 spOut = NewHandle(0L);   /* allocate handle */
 Reader(theSpeech,message,(long)len,spOut);
 MacinTalk(theSpeech, spOut);
 SpeechOff(theSpeech);
 DisposHandle(spOut);
 } 
 }
 RESTREGS();/* Restore BASIC’s A4 and A5 registers*/
}

‘ QuickBASIC program tests SAY() pure-code resource routine.
‘ Copyright (C)1988 by William H. Ball for MacTutor™ magazine.

‘ Usage: SAY(rate,pitch,string-expression)

‘ Beware!  Will bomb with wrong number or type of arguments! 
‘ Make sure MacinTalk is on same volume, or SAY() won’t talk.

DEFINT a-z
LIBRARY “Speechd.lib”                        
    ON ERROR GOTO 9
    PRINT “Let’s test the SAY() routine:”
    GOSUB talk
9  LIBRARY CLOSE
END

talk:
    rate = 0            ‘ declare integer and string variables
    pitch = 0
    message$ = “”

    INPUT “Enter something to say: “;message$
    INPUT “Enter a rate of speech between 0 and 425”;rate
    INPUT “Enter a pitch of speech between 0 and 500”;pitch

    ‘ Just hit Return? Use a default value
    IF rate = 0 THEN rate = 100
    IF pitch = 0 THEN pitch = 100

    CALL SAY(rate,pitch,message$) 
    
    PRINT  “another?”
    message$=INPUT$(1)
    IF LEFT$(message$,1) = “y” THEN 
        GOSUB talk
    END IF
RETURN

 
AAPL
$101.06
Apple Inc.
+0.10
MSFT
$47.06
Microsoft Corpora
-0.46
GOOG
$587.37
Google Inc.
-8.71

MacTech Search:
Community Search:

Software Updates via MacUpdate

Monosnap 2.2.2 - Versatile screenshot ut...
Monosnap allows you to save screenshots easily, conveniently, and quickly, sharing them with friends and colleagues at once. It's the ideal choice for anyone who is looking for a smart and fast... Read more
Tunnelblick 3.4beta36 - GUI for OpenVPN...
Tunnelblick is a free, open source graphic user interface for OpenVPN on OS X. It provides easy control of OpenVPN client and/or server connections. It comes as a ready-to-use application with all... Read more
SoftRAID 5.0.4 - High-quality RAID manag...
SoftRAID allows you to create and manage disk arrays to increase performance and reliability. SoftRAID's intuitive interface and powerful feature set makes this utility a must have for any Mac OS X... Read more
Audio Hijack Pro 2.11.3 - Record and enh...
Audio Hijack Pro drastically changes the way you use audio on your computer, giving you the freedom to listen to audio when you want and how you want. Record and enhance any audio with Audio Hijack... Read more
Airfoil 4.8.9 - Send audio from any app...
Airfoil allows you to send any audio to AirPort Express units, Apple TVs, and even other Macs and PCs, all in sync! It's your audio - everywhere. With Airfoil you can take audio from any... Read more
WhatRoute 1.13.0 - Geographically trace...
WhatRoute is designed to find the names of all the routers an IP packet passes through on its way from your Mac to a destination host. It also measures the round-trip time from your Mac to the... Read more
Chromium 37.0.2062.122 - Fast and stable...
Chromium is an open-source browser project that aims to build a safer, faster, and more stable way for all Internet users to experience the web. FreeSMUG-Free OpenSource Mac User Group build is... Read more
Attachment Tamer 3.1.14b9 - Take control...
Attachment Tamer gives you control over attachment handling in Apple Mail. It fixes the most annoying Apple Mail flaws, ensures compatibility with other email software, and allows you to set up how... Read more
Duplicate Annihilator 5.0 - Find and del...
Duplicate Annihilator takes on the time-consuming task of comparing the images in your iPhoto library using effective algorithms to make sure that no duplicate escapes. Duplicate Annihilator detects... Read more
jAlbum Pro 12.2 - Organize your digital...
jAlbum Pro has all the features you love in jAlbum, but comes with a commercial license. With jAlbum, you can create gorgeous custom photo galleries for the Web without writing a line of code!... Read more

Latest Forum Discussions

See All

This Week at 148Apps: September 15-19, 2...
Expert App Reviewers   So little time and so very many apps. What’s a poor iPhone/iPad lover to do? Fortunately, 148Apps is here to give you the rundown on the latest and greatest releases. And we even have a tremendous back catalog of reviews; just... | Read more »
Kitty Powers’ Matchmaker – Tips, Tricks,...
Hey There, Kittens: | Read more »
Goblin Sword Review
Goblin Sword Review By Andrew Fisher on September 22nd, 2014 Our Rating: :: RETRO GOODNESSUniversal App - Designed for iPhone and iPad Fun visuals, good music, engaging level design, and lots of content make Goblin Sword an... | Read more »
Major New Update for CSR Racing Adds Fer...
Major New Update for CSR Racing Adds Ferrari and Multiplaye​r Posted by Jessica Fisher on September 22nd, 2014 [ permalink ] | Read more »
Veditor Review
Veditor Review By Jennifer Allen on September 22nd, 2014 Our Rating: :: PIMP YOUR VIDEOUniversal App - Designed for iPhone and iPad Want to add stickers and music to your videos? Veditor can do that easily.   | Read more »
1849′s Nevada Silver DLC is Still Search...
A few months ago, I took a look at 1849 from SomaSim. This Gold Rush-themed city builder for iPad had a fair bit going for it, but lacked in a few crucial areas to make it a true stand-out on the App Store. SomaSim has since added in a sandbox mode... | Read more »
Fruit Ninja Will be Reborn With a Massiv...
Fruit Ninja Will be Reborn With a Massive Update and Origins Animation Series Posted by Jessica Fisher on September 22nd, 2014 [ permalink ] Halfbrick Studios is rebuilding | Read more »
Daniel Tiger’s Grr-ific Feelings Review
Daniel Tiger’s Grr-ific Feelings Review By Amy Solomon on September 22nd, 2014 Our Rating: iPad Only App - Designed for the iPad Daniel Tiger’s Grr-ific Feelings includes activities that allow young children explore different... | Read more »
CloudMagic Updated for iOS 8 – Adds Inte...
CloudMagic Updated for iOS 8 – Adds Interactive Notifications, Share Extension, and More Posted by Jessica Fisher on September 22nd, 2014 [ | Read more »
Starbase Annex (Games)
Starbase Annex 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: "it’s really very clever... a little bit of Hearthstone and a dash of Eclipse" - PocketTactics.com From the creator of Starbase... | Read more »

Price Scanner via MacPrices.net

Apple restocks some refurbished 2014 MacBook...
The Apple Store has restocked some Apple Certified Refurbished 2014 MacBook Airs, with prices starting at $769. An Apple one-year warranty is included with each MacBook, and shipping is free. These... Read more
13-inch 128GB MacBook Air on sale for $949, s...
B&H Photo has the new 2014 13″ 1.4GHz/128GB MacBook Air on sale for $949.99 including free shipping plus NY tax only. Their price is $50 off MSRP. B&H will also include free copies of... Read more
Apple offering free $25 iTunes Gift Card with...
The Apple Store is offering a free $25 iTunes Gift Card with the purchase of a $99 Apple TV for a limited time. Shipping is free. Read more
Apple refurbished iPod touch available for up...
The Apple Store has Apple Certified Refurbished 5th generation iPod touches available starting at $149. Apple’s one-year warranty is included with each model, and shipping is free. Most colors are... Read more
iFixIt Tears Down iPhone 6; Awards Respectabl...
iFixit notes that even the smaller 4.7″ iPhone 6 is a giant among iPhones; so big that Apple couldn’t fit it into the familiar iPhone form factor. In a welcome reversal of a recent trend to more or... Read more
Phone 6 Guide – Tips Book For Both iPhone 6...
iOS Guides has announced its latest eBook: iPhone 6 Guide. Brought to you by the expert team at iOS Guides, and written by best-selling technology author Tom Rudderham, iPhone 6 Guide is packed with... Read more
How to Upgrade iPhone iPad to iOS 8 without D...
PhoneClean, a iPhone cleaner utility offered by iMobie Inc., reveals a solution for upgrading iPhone and iPad to iOS 8 without deleting photos, apps, the new U2 album or anything. Thanks to more than... Read more
Inpaint 6 – Photo Retouching Tool Gets Faster...
TeoreX has announced Inpaint 6, a simple retouching tool for end users that helps remove scratches, watermarks, and timestamps as well as more complex objects like strangers, unwanted elements and... Read more
Worldwide PC Monitor Market Sees Growth in To...
Worldwide PC monitor shipments totaled 32.5 million units in the second quarter of 2014 (2Q14), a year-over-year decline of -2.9%, according to the International Data Corporation (IDC) Worldwide... Read more
Updated Price Trackers
We’ve updated our Mac Price Trackers with the latest information on prices, bundles, and availability on systems from Apple’s authorized internet/catalog resellers: - 15″ MacBook Pros - 13″ MacBook... Read more

Jobs Board

*Apple* Retail - Multiple Positions (US) - A...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
Position Opening at *Apple* - Apple (United...
…customers purchase our products, you're the one who helps them get more out of their new Apple technology. Your day in the Apple Store is filled with a range of Read more
*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** At the Apple Store, you connect business professionals and entrepreneurs with the tools they need in order to put Apple solutions to work in their Read more
Position Opening at *Apple* - Apple (United...
**Job Summary** The Apple Store is a retail environment like no other - uniquely focused on delivering amazing customer experiences. As an Expert, you introduce people Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.