1. Introduction | 5 |
1.1. Overview | 5 |
1.2. Acapela’s Text-To-Speech product range | 5 |
1.3. HD and HQ voices | 5 |
1.4. Differences between operating systems | 5 |
1.5. Package content | 6 |
2. Getting Started | 8 |
2.1. Directory Structure | 8 |
2.1.1. Microsoft Windows | 8 |
2.1.2. Apple Mac OS X | 8 |
2.2. Integrating the TTS in applications | 9 |
2.2.1. Proprietary API | 9 |
2.2.2. NSCAPI | 10 |
2.2.3. SAPI 4.0a | 10 |
2.2.4. SAPI 5.1 | 10 |
2.2.5. ActiveX | 10 |
2.2.6. .NET Applications | 10 |
2.2.7. Apple Speech Synthesis Manager | 10 |
3. Creating your first Application with the BabTts API | 11 |
3.1. Dynamic loading of the library | 11 |
3.2. Initializing the library | 11 |
3.3. Enumerating the installed voices | 11 |
3.4. Opening a voice | 11 |
3.5. Adapting parameters | 11 |
3.6. Speaking the text | 11 |
3.7. Closing the voice | 12 |
3.8. Closing and unloading the Library | 12 |
4. Using the Callbacks Mechanism | 13 |
4.1. Purpose | 13 |
4.2. Using callbacks | 13 |
4.3. Messages | 14 |
5. Changing Settings | 15 |
5.1. Using the Property Box | 15 |
5.2. Using BabTTS_SetSettings/BabTTS_GetSettings | 16 |
5.2.1. Callback Instance Value | 16 |
5.2.2. Callback Message Mask | 16 |
5.2.3. Coding Scheme | 16 |
5.2.4. Equalizer | 17 |
5.2.5. Leading Silence | 17 |
5.2.6. Pauses | 17 |
5.2.7. Pitch (HD voices ONLY) | 19 |
5.2.8. Pitch – Maximum (HD voices ONLY) | 19 |
5.2.9. Pitch – Minimum (HD voices ONLY) | 19 |
5.2.10. Reading Mode | 20 |
5.2.11. Sampling Rate | 20 |
5.2.12. Speed Rate | 20 |
5.2.13. Volume | 21 |
6. Reference Guide | 22 |
6.1. Function list by topic | 22 |
6.2. Functions | 23 |
6.2.1. BabTTS_Close | 24 |
6.2.2. BabTTS_Create | 25 |
6.2.3. BabTTS_Dialog | 26 |
6.2.4. BabTTS_DictAddWord | 27 |
6.2.5. BabTTS_DictDisable | 32 |
6.2.6. BabTTS_DictEnable | 33 |
6.2.7. BabTTS_DictEnum | 36 |
6.2.8. BabTTS_DictGetDefList | 39 |
6.2.9. BabTTS_DictGetEntry | 40 |
6.2.10. BabTTS_DictGetInfo | 43 |
6.2.11. BabTTS_DictGetInfoFromFile | 45 |
6.2.12. BabTTS_DictGetMax | 48 |
6.2.13. BabTTS_DictGetNumEntries | 49 |
6.2.14. BabTTS_DictGetNumLoaded | 50 |
6.2.15. BabTTS_DictGetWordTrans | 51 |
6.2.16. BabTTS_DictIsModified | 53 |
6.2.17. BabTTS_DictLoad | 54 |
6.2.18. BabTTS_DictRemoveWord | 57 |
6.2.19. BabTTS_DictSave | 59 |
6.2.20. BabTTS_DictSaveAll | 61 |
6.2.21. BabTTS_DictSetDefList | 62 |
6.2.22. BabTTS_DictSetInfo | 63 |
6.2.23. BabTTS_DictSetPassword | 66 |
6.2.24. BabTTS_DictUnload | 71 |
6.2.25. BabTTS_DictUnloadAll | 72 |
6.2.26. BabTTS_EnumVoices | 73 |
6.2.27. BabTTS_GetCallback | 74 |
6.2.28. BabTTS_GetFilterPreset | 75 |
6.2.29. BabTTS_GetInstanceInfo | 76 |
6.2.30. BabTTS_GetNumVoices | 78 |
6.2.31. BabTTS_GetSettings | 79 |
6.2.32. BabTTS_GetVoiceInfo | 80 |
6.2.33. BabTTS_Init | 82 |
6.2.34. BabTtsInitDll | 83 |
6.2.35. BabTtsInitDllEx | 84 |
6.2.36. BabTTS_InsertText | 85 |
6.2.37. BabTTS_Open | 87 |
6.2.38. BabTTS_Pause | 89 |
6.2.39. BabTTS_PhoGetDuration | 90 |
6.2.40. BabTTS_PhoGetMouth | 91 |
6.2.41. BabTTS_ReadBuffer | 92 |
6.2.42. BabTTS_Reset | 94 |
6.2.43. BabTTS_Resume | 95 |
6.2.44. BabTTS_SetCallback | 96 |
6.2.45. BabTTS_SetFilterPreset | 98 |
6.2.46. BabTTS_SetSettings | 99 |
6.2.47. BabTTS_Speak | 100 |
6.2.48. BabTTS_Uninit | 103 |
6.2.49. BabTtsUninitDll | 104 |
6.2.50. BabTTS_Write | 105 |
6.3. Structure definitions | 109 |
6.3.1. BABTTSDICTINFO | 109 |
6.3.2. BABTTSINFO | 109 |
6.3.3. BABTTSMOUTH | 111 |
6.3.4. BABTTSUNITINFO | 112 |