eSpeak NG is an open source speech synthesizer that supports more than hundred languages and accents.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

api.c 13KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469
  1. /*
  2. * Copyright (C) 2017 Reece H. Dunn
  3. *
  4. * This program is free software; you can redistribute it and/or modify
  5. * it under the terms of the GNU General Public License as published by
  6. * the Free Software Foundation; either version 3 of the License, or
  7. * (at your option) any later version.
  8. *
  9. * This program is distributed in the hope that it will be useful,
  10. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  12. * GNU General Public License for more details.
  13. *
  14. * You should have received a copy of the GNU General Public License
  15. * along with this program; if not, write see:
  16. * <http://www.gnu.org/licenses/>.
  17. */
  18. #include "config.h"
  19. #include <assert.h>
  20. #include <stdlib.h>
  21. #include <string.h>
  22. #include <espeak-ng/espeak_ng.h>
  23. #include <espeak-ng/speak_lib.h>
  24. #include <espeak-ng/encoding.h>
  25. #include "speech.h"
  26. #include "phoneme.h"
  27. #include "synthesize.h"
  28. #include "translate.h"
  29. // region espeak_Initialize
  30. void
  31. test_espeak_terminate_without_initialize()
  32. {
  33. printf("testing espeak_Terminate without espeak_Initialize\n");
  34. assert(event_list == NULL);
  35. assert(translator == NULL);
  36. assert(p_decoder == NULL);
  37. assert(espeak_Terminate() == EE_OK);
  38. assert(event_list == NULL);
  39. assert(translator == NULL);
  40. assert(p_decoder == NULL);
  41. }
  42. void
  43. test_espeak_initialize()
  44. {
  45. printf("testing espeak_Initialize\n");
  46. assert(event_list == NULL);
  47. assert(translator == NULL);
  48. assert(p_decoder == NULL);
  49. assert(espeak_Initialize(AUDIO_OUTPUT_PLAYBACK, 0, NULL, 0) == 22050);
  50. assert(event_list != NULL);
  51. assert(translator == NULL);
  52. assert(p_decoder == NULL);
  53. assert(espeak_Terminate() == EE_OK);
  54. assert(event_list == NULL);
  55. assert(translator == NULL);
  56. assert(p_decoder == NULL);
  57. }
  58. // endregion
  59. // region espeak_Synth
  60. void
  61. test_espeak_synth()
  62. {
  63. printf("testing espeak_Synth\n");
  64. assert(event_list == NULL);
  65. assert(translator == NULL);
  66. assert(p_decoder == NULL);
  67. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  68. assert(event_list != NULL);
  69. assert(translator == NULL);
  70. assert(p_decoder == NULL);
  71. const char *test = "One two three.";
  72. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  73. assert(translator != NULL);
  74. assert(strcmp(translator->dictionary_name, "en") == 0);
  75. assert(p_decoder != NULL);
  76. assert(espeak_Synchronize() == EE_OK);
  77. assert(translator != NULL);
  78. assert(strcmp(translator->dictionary_name, "en") == 0);
  79. assert(p_decoder != NULL);
  80. assert(espeak_Terminate() == EE_OK);
  81. assert(event_list == NULL);
  82. assert(translator == NULL);
  83. assert(p_decoder == NULL);
  84. }
  85. void
  86. test_espeak_synth_no_voices(const char *path)
  87. {
  88. printf("testing espeak_Synth in path with no voices\n");
  89. assert(event_list == NULL);
  90. assert(translator == NULL);
  91. assert(p_decoder == NULL);
  92. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, path, espeakINITIALIZE_DONT_EXIT) == 22050);
  93. assert(event_list != NULL);
  94. assert(translator == NULL);
  95. assert(p_decoder == NULL);
  96. const char *test = "One two three.";
  97. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_INTERNAL_ERROR);
  98. assert(translator == NULL);
  99. assert(p_decoder == NULL);
  100. assert(espeak_Synchronize() == EE_OK);
  101. assert(translator == NULL);
  102. assert(p_decoder == NULL);
  103. assert(espeak_Terminate() == EE_OK);
  104. assert(event_list == NULL);
  105. assert(translator == NULL);
  106. assert(p_decoder == NULL);
  107. }
  108. // endregion
  109. // region espeak_SetVoiceByName
  110. void
  111. test_espeak_set_voice_by_name_null_voice()
  112. {
  113. printf("testing espeak_SetVoiceByName(NULL)\n");
  114. assert(event_list == NULL);
  115. assert(translator == NULL);
  116. assert(p_decoder == NULL);
  117. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  118. assert(event_list != NULL);
  119. assert(translator == NULL);
  120. assert(p_decoder == NULL);
  121. assert(espeak_SetVoiceByName("") == EE_NOT_FOUND);
  122. assert(translator == NULL);
  123. assert(p_decoder == NULL);
  124. const char *test = "One two three.";
  125. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  126. assert(translator != NULL);
  127. assert(strcmp(translator->dictionary_name, "en") == 0);
  128. assert(p_decoder != NULL);
  129. assert(espeak_Synchronize() == EE_OK);
  130. assert(translator != NULL);
  131. assert(strcmp(translator->dictionary_name, "en") == 0);
  132. assert(p_decoder != NULL);
  133. assert(espeak_Terminate() == EE_OK);
  134. assert(event_list == NULL);
  135. assert(translator == NULL);
  136. assert(p_decoder == NULL);
  137. }
  138. void
  139. test_espeak_set_voice_by_name_blank_voice()
  140. {
  141. printf("testing espeak_SetVoiceByName(\"\")\n");
  142. assert(event_list == NULL);
  143. assert(translator == NULL);
  144. assert(p_decoder == NULL);
  145. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  146. assert(event_list != NULL);
  147. assert(translator == NULL);
  148. assert(p_decoder == NULL);
  149. assert(espeak_SetVoiceByName("") == EE_NOT_FOUND);
  150. assert(translator == NULL);
  151. assert(p_decoder == NULL);
  152. const char *test = "One two three.";
  153. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  154. assert(translator != NULL);
  155. assert(strcmp(translator->dictionary_name, "en") == 0);
  156. assert(p_decoder != NULL);
  157. assert(espeak_Synchronize() == EE_OK);
  158. assert(translator != NULL);
  159. assert(strcmp(translator->dictionary_name, "en") == 0);
  160. assert(p_decoder != NULL);
  161. assert(espeak_Terminate() == EE_OK);
  162. assert(event_list == NULL);
  163. assert(translator == NULL);
  164. assert(p_decoder == NULL);
  165. }
  166. void
  167. test_espeak_set_voice_by_name_valid_voice()
  168. {
  169. printf("testing espeak_SetVoiceByName(\"de\")\n");
  170. assert(event_list == NULL);
  171. assert(translator == NULL);
  172. assert(p_decoder == NULL);
  173. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  174. assert(event_list != NULL);
  175. assert(translator == NULL);
  176. assert(p_decoder == NULL);
  177. assert(espeak_SetVoiceByName("de") == EE_OK);
  178. assert(translator != NULL);
  179. assert(strcmp(translator->dictionary_name, "de") == 0);
  180. assert(p_decoder == NULL);
  181. const char *test = "One two three.";
  182. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  183. assert(translator != NULL);
  184. assert(strcmp(translator->dictionary_name, "de") == 0);
  185. assert(p_decoder != NULL);
  186. assert(espeak_Synchronize() == EE_OK);
  187. assert(translator != NULL);
  188. assert(strcmp(translator->dictionary_name, "de") == 0);
  189. assert(p_decoder != NULL);
  190. assert(espeak_Terminate() == EE_OK);
  191. assert(event_list == NULL);
  192. assert(translator == NULL);
  193. assert(p_decoder == NULL);
  194. }
  195. void
  196. test_espeak_set_voice_by_name_invalid_voice()
  197. {
  198. printf("testing espeak_SetVoiceByName(\"zzz\")\n");
  199. assert(event_list == NULL);
  200. assert(translator == NULL);
  201. assert(p_decoder == NULL);
  202. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  203. assert(event_list != NULL);
  204. assert(translator == NULL);
  205. assert(p_decoder == NULL);
  206. assert(espeak_SetVoiceByName("zzz") == EE_NOT_FOUND);
  207. assert(translator == NULL);
  208. assert(p_decoder == NULL);
  209. const char *test = "One two three.";
  210. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  211. assert(translator != NULL);
  212. assert(strcmp(translator->dictionary_name, "en") == 0);
  213. assert(p_decoder != NULL);
  214. assert(espeak_Synchronize() == EE_OK);
  215. assert(translator != NULL);
  216. assert(strcmp(translator->dictionary_name, "en") == 0);
  217. assert(p_decoder != NULL);
  218. assert(espeak_Terminate() == EE_OK);
  219. assert(event_list == NULL);
  220. assert(translator == NULL);
  221. assert(p_decoder == NULL);
  222. }
  223. // endregion
  224. // region espeak_SetVoiceByProperties
  225. void
  226. test_espeak_set_voice_by_properties_empty()
  227. {
  228. printf("testing espeak_SetVoiceByProperties: (none)\n");
  229. assert(event_list == NULL);
  230. assert(translator == NULL);
  231. assert(p_decoder == NULL);
  232. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  233. assert(event_list != NULL);
  234. assert(translator == NULL);
  235. assert(p_decoder == NULL);
  236. espeak_VOICE properties;
  237. memset(&properties, 0, sizeof(properties));
  238. assert(espeak_SetVoiceByProperties(&properties) == EE_OK);
  239. assert(translator != NULL);
  240. assert(strcmp(translator->dictionary_name, "af") == 0);
  241. assert(p_decoder == NULL);
  242. const char *test = "One two three.";
  243. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  244. assert(translator != NULL);
  245. assert(strcmp(translator->dictionary_name, "af") == 0);
  246. assert(p_decoder != NULL);
  247. assert(espeak_Synchronize() == EE_OK);
  248. assert(translator != NULL);
  249. assert(strcmp(translator->dictionary_name, "af") == 0);
  250. assert(p_decoder != NULL);
  251. assert(espeak_Terminate() == EE_OK);
  252. assert(event_list == NULL);
  253. assert(translator == NULL);
  254. assert(p_decoder == NULL);
  255. }
  256. void
  257. test_espeak_set_voice_by_properties_blank_language()
  258. {
  259. printf("testing espeak_SetVoiceByProperties: languages=\"\"\n");
  260. assert(event_list == NULL);
  261. assert(translator == NULL);
  262. assert(p_decoder == NULL);
  263. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  264. assert(event_list != NULL);
  265. assert(translator == NULL);
  266. assert(p_decoder == NULL);
  267. espeak_VOICE properties;
  268. memset(&properties, 0, sizeof(properties));
  269. properties.languages = "";
  270. assert(espeak_SetVoiceByProperties(&properties) == EE_OK);
  271. assert(translator != NULL);
  272. assert(strcmp(translator->dictionary_name, "af") == 0);
  273. assert(p_decoder == NULL);
  274. const char *test = "One two three.";
  275. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  276. assert(translator != NULL);
  277. assert(strcmp(translator->dictionary_name, "af") == 0);
  278. assert(p_decoder != NULL);
  279. assert(espeak_Synchronize() == EE_OK);
  280. assert(translator != NULL);
  281. assert(strcmp(translator->dictionary_name, "af") == 0);
  282. assert(p_decoder != NULL);
  283. assert(espeak_Terminate() == EE_OK);
  284. assert(event_list == NULL);
  285. assert(translator == NULL);
  286. assert(p_decoder == NULL);
  287. }
  288. void
  289. test_espeak_set_voice_by_properties_with_valid_language()
  290. {
  291. printf("testing espeak_SetVoiceByProperties: languages=\"mk\" (valid)\n");
  292. assert(event_list == NULL);
  293. assert(translator == NULL);
  294. assert(p_decoder == NULL);
  295. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  296. assert(event_list != NULL);
  297. assert(translator == NULL);
  298. assert(p_decoder == NULL);
  299. espeak_VOICE properties;
  300. memset(&properties, 0, sizeof(properties));
  301. properties.languages = "mk";
  302. assert(espeak_SetVoiceByProperties(&properties) == EE_OK);
  303. assert(translator != NULL);
  304. assert(strcmp(translator->dictionary_name, "mk") == 0);
  305. assert(p_decoder == NULL);
  306. const char *test = "One two three.";
  307. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  308. assert(translator != NULL);
  309. assert(strcmp(translator->dictionary_name, "mk") == 0);
  310. assert(p_decoder != NULL);
  311. assert(espeak_Synchronize() == EE_OK);
  312. assert(translator != NULL);
  313. assert(strcmp(translator->dictionary_name, "mk") == 0);
  314. assert(p_decoder != NULL);
  315. assert(espeak_Terminate() == EE_OK);
  316. assert(event_list == NULL);
  317. assert(translator == NULL);
  318. assert(p_decoder == NULL);
  319. }
  320. void
  321. test_espeak_set_voice_by_properties_with_invalid_language()
  322. {
  323. printf("testing espeak_SetVoiceByProperties: languages=\"zzz\" (invalid)\n");
  324. assert(event_list == NULL);
  325. assert(translator == NULL);
  326. assert(p_decoder == NULL);
  327. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  328. assert(event_list != NULL);
  329. assert(translator == NULL);
  330. assert(p_decoder == NULL);
  331. espeak_VOICE properties;
  332. memset(&properties, 0, sizeof(properties));
  333. properties.languages = "zzz";
  334. assert(espeak_SetVoiceByProperties(&properties) == EE_NOT_FOUND);
  335. assert(translator == NULL);
  336. assert(p_decoder == NULL);
  337. const char *test = "One two three.";
  338. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  339. assert(translator != NULL);
  340. assert(strcmp(translator->dictionary_name, "en") == 0);
  341. assert(p_decoder != NULL);
  342. assert(espeak_Synchronize() == EE_OK);
  343. assert(translator != NULL);
  344. assert(strcmp(translator->dictionary_name, "en") == 0);
  345. assert(p_decoder != NULL);
  346. assert(espeak_Terminate() == EE_OK);
  347. assert(event_list == NULL);
  348. assert(translator == NULL);
  349. assert(p_decoder == NULL);
  350. }
  351. // endregion
  352. int
  353. main(int argc, char **argv)
  354. {
  355. char *progdir = strdup(argv[0]);
  356. char *dir = strrchr(progdir, '/');
  357. if (dir != NULL) *dir = 0;
  358. test_espeak_terminate_without_initialize();
  359. test_espeak_initialize();
  360. test_espeak_synth();
  361. test_espeak_synth(); // Check that this does not crash when run a second time.
  362. test_espeak_synth_no_voices(progdir);
  363. test_espeak_synth();
  364. test_espeak_set_voice_by_name_null_voice();
  365. test_espeak_set_voice_by_name_blank_voice();
  366. test_espeak_set_voice_by_name_valid_voice();
  367. test_espeak_set_voice_by_name_invalid_voice();
  368. test_espeak_set_voice_by_properties_empty();
  369. test_espeak_set_voice_by_properties_blank_language();
  370. test_espeak_set_voice_by_properties_with_valid_language();
  371. test_espeak_set_voice_by_properties_with_invalid_language();
  372. free(progdir);
  373. return EXIT_SUCCESS;
  374. }