Click here to Skip to main content
15,114,302 members
Articles / Desktop Programming / MFC
Posted 12 Nov 2001


77 bookmarked

Simple Program for Text to Speech Using SAPI (English Version)

Rate me:
Please Sign up or sign in to vote.
3.61/5 (31 votes)
12 Nov 20012 min read
Make a program for Text to Speech conversion using SAPI


In this project I made an application program for Text-to-Speech Conversion. To build this application, we must install the SDK speech from Microsoft on our computer. You can download Speech SDK (it's free) from

The SAPI API provides a high-level interface between an application and speech engines. SAPI implements all the low-level details needed to control and manage the real-time operations of various speech engines.

Applications can control text-to-speech (TTS) using the ISpVoice Component Object Model (COM) interface. Once an application has created an ISpVoice object, the application only needs to call ISpVoice::Speak to generate speech output from some text data. In addition, the IspVoice interface also provides several methods for changing voice and synthesis properties such as speaking rate ISpVoice::SetRate, output volume ISpVoice::SetVolume and changing the current speaking voice ISpVoice::SetVoice

The project devided into five steps :

  1. Creating New Project
  2. Setting Project
  3. Building GUI 
  4. Coding

1. Creating New Project

First you will create the initial ATL project using the MFC AppWizard.

  1. In the Visual C++ environment, click New on the File menu, then choose the Projects tab.

  2. Select the MFC AppWizard (exe).

  3. Type TxtToSpeech as the project name.

Your dialog box should look like this:

Image 1

Figure 1: New Project

Click OK and the MFC AppWizard presents a dialog box offering several choices to configure the type of MFC project (figure 2), choose Dialog based. After that, click Finish button

Image 2

Figure 2: MFC AppWizard Step 1, choose Dialog based

2. Setting Project

To use SAPI (Speech Application Interface) in our application, we must set our project. In file StdAfx.h, Add code like this (after "

" but before the "#endif" statement) :

#include <atlbase.h>
extern CComModule _Module;
#include <atlcom.h>

Change the project settings to reflect the paths. Using the Project->Settings. menu item, set the SAPI.h path. Click the C/C++ tab and select Preprocessor from the Category drop-down list. Enter the following in the "Additional include directories": with directory that Speech SDK available , such as D:\Program Files\Microsoft Speech SDK 5.1\Include. (see figure 3)

Image 3

Figure 3: Setting path

To set the SAPI.lib path (see figure 4):

  1. Select the Link tab from the Same Settings dialog box.
  2. Choose Input from the Category drop-down list.
  3. Add the following path to the "Additional library path" (directory that Speech SDK available), example :
    D:\Program Files\Microsoft Speech SDK 5.1\Lib\i386.
  4. Also add "sapi.lib" to the "Object/library modules" line. 

Image 4

Figure 4: Add library module Sapi.lib and set path

3. Building GUI

Model of GUI in this project like figure 5 :

Image 5

Figure 5: GUI project

4. Coding

In GUI, double click Button, type OnSpeak as name of method. This code:

ISpVoice * pVoice = NULL;

if (FAILED(CoInitialize(NULL)))
    AfxMessageBox("Error to intiliaze COM");

HRESULT hr = CoCreateInstance(CLSID_SpVoice, NULL,
    CLSCTX_ALL, IID_ISpVoice, (void **)&pVoice);
if( SUCCEEDED( hr ) )
    hr = pVoice->Speak(m_sText.AllocSysString(), 0, NULL);
    pVoice = NULL;


Note: m_sText is variable of Edit Box

After that, you can compile and run this project.


Speech SDK 5.1


This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


About the Author

Agus Kurniawan
Founder PE College
Indonesia Indonesia
He gradueted from Sepuluh Nopember Institute of Technology (ITS) in Department of Electrical Engineering, Indonesia. His programming interest is VC++, C#, VB, VB.NET, .NET, VBScript, Delphi, C++ Builder, Assembly,and ASP/ASP.NET. He's founder for PE College(, free video tutorial about programming, infrastructure, and computer science. He's currently based in Depok, Indonesia. His blog is and

Comments and Discussions

GeneralMy vote of 5 Pin
osirisgothra18-Jan-12 16:31
Memberosirisgothra18-Jan-12 16:31 
GeneralMy vote of 5 Pin
bealey28-Jun-11 1:40
Memberbealey28-Jun-11 1:40 
Dennis Ray3-May-11 5:53
MemberDennis Ray3-May-11 5:53 
GeneralYes,Very Good! Pin
chinesedragon11-May-10 4:17
Memberchinesedragon11-May-10 4:17 
Generalis it possibl to viceversa of this program ie speech to text Pin
eswar pothula26-Nov-09 22:56
Membereswar pothula26-Nov-09 22:56 
GeneralRe: is it possibl to viceversa of this program ie speech to text Pin
alawy875-Oct-10 14:39
Memberalawy875-Oct-10 14:39 
GeneralRe: is it possibl to viceversa of this program ie speech to text Pin
HuangQihua26-Feb-11 21:46
MemberHuangQihua26-Feb-11 21:46 
GeneralText to Speech -Audio File German Version Pin
smilechill21-Sep-09 5:25
Membersmilechill21-Sep-09 5:25 
GeneralGetTranscript Pin
Danilo Queiroz13-Apr-09 16:30
MemberDanilo Queiroz13-Apr-09 16:30 
Generalcreating wav file in TTS Pin
Member 282845213-Apr-09 0:21
MemberMember 282845213-Apr-09 0:21 
Generalproblem getting software for speech to text recognition Pin 8:07 8:07 
QuestionSAPI text to speech looping problem! Pin
cesarpachon9-Apr-08 16:31
Membercesarpachon9-Apr-08 16:31 
I had been working for a while in a activex plugin for IExplorer, but recently we see the need to port it to Mozilla Firefox. this plugin uses SAPI 4.0 basic text to speach features
(directly using a few COM interfaces.. we use 4.0 because we need free spanish voices).
my problem is that the same code that I used in the activex plugin version for IExplorer, which works fine, has a strange behavior in firefox: each time I call gpITTSCentral->TextData(...) to speak some word, SAPI keeps looping, saying the same sentence again and again..
I had been searching the internet for many days but I had not found
any valuable information about that.
GeneralSTDAfx.h HELP! Pin
Sebcity5-Feb-07 7:30
MemberSebcity5-Feb-07 7:30 
GeneralRe: STDAfx.h HELP! Pin
cristitomi23-Sep-07 6:27
Membercristitomi23-Sep-07 6:27 
QuestionHow to generate music from text characters? Pin
akks_38-Nov-06 9:11
Memberakks_38-Nov-06 9:11 
Generalurgent : automation of engine Pin
nehasingh20-Jan-06 8:50
Membernehasingh20-Jan-06 8:50 
Generalspeech recognition Pin
manikandanek29-Oct-05 1:55
Membermanikandanek29-Oct-05 1:55 
GeneralText To Speech Convertor Pin
manikandanek29-Oct-05 1:49
Membermanikandanek29-Oct-05 1:49 
GeneralRe: Text To Speech Convertor Pin
sen_raj2230-Jan-06 18:53
Membersen_raj2230-Jan-06 18:53 
GeneralChanging voice ! Pin
spirit19836-Aug-05 14:43
Memberspirit19836-Aug-05 14:43 
GeneralGerman Output?! Pin
Hansa4Ever24-Jun-05 3:23
MemberHansa4Ever24-Jun-05 3:23 
Generalis it possible not to use sdk Pin
kaamsha8-Apr-05 11:41
Memberkaamsha8-Apr-05 11:41 
GeneralIntergrating TTS with direct sound Pin
wtatters5-Apr-05 12:48
Memberwtatters5-Apr-05 12:48 
Generalnice but too simple. Pin
Anonymous30-Mar-05 4:18
MemberAnonymous30-Mar-05 4:18 
GeneralRe: nice but too simple. Pin
cristitomi23-Sep-07 6:33
Membercristitomi23-Sep-07 6:33 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.