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 14KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506
  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. void
  224. test_espeak_set_voice_by_name_language_variant_intonation_parameter()
  225. {
  226. printf("testing espeak_SetVoiceByName(\"!v/Annie\") (language variant; intonation)\n");
  227. assert(event_list == NULL);
  228. assert(translator == NULL);
  229. assert(p_decoder == NULL);
  230. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  231. assert(event_list != NULL);
  232. assert(translator == NULL);
  233. assert(p_decoder == NULL);
  234. assert(espeak_SetVoiceByName("!v/Annie") == EE_OK);
  235. assert(translator != NULL);
  236. assert(strcmp(translator->dictionary_name, "en") == 0);
  237. assert(p_decoder == NULL);
  238. const char *test = "One two three.";
  239. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  240. assert(translator != NULL);
  241. assert(strcmp(translator->dictionary_name, "en") == 0);
  242. assert(p_decoder != NULL);
  243. assert(espeak_Synchronize() == EE_OK);
  244. assert(translator != NULL);
  245. assert(strcmp(translator->dictionary_name, "en") == 0);
  246. assert(p_decoder != NULL);
  247. assert(espeak_Terminate() == EE_OK);
  248. assert(event_list == NULL);
  249. assert(translator == NULL);
  250. assert(p_decoder == NULL);
  251. }
  252. // endregion
  253. // region espeak_SetVoiceByProperties
  254. void
  255. test_espeak_set_voice_by_properties_empty()
  256. {
  257. printf("testing espeak_SetVoiceByProperties: (none)\n");
  258. assert(event_list == NULL);
  259. assert(translator == NULL);
  260. assert(p_decoder == NULL);
  261. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  262. assert(event_list != NULL);
  263. assert(translator == NULL);
  264. assert(p_decoder == NULL);
  265. espeak_VOICE properties;
  266. memset(&properties, 0, sizeof(properties));
  267. assert(espeak_SetVoiceByProperties(&properties) == EE_OK);
  268. assert(translator != NULL);
  269. assert(strcmp(translator->dictionary_name, "en") == 0);
  270. assert(p_decoder == NULL);
  271. const char *test = "One two three.";
  272. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  273. assert(translator != NULL);
  274. assert(strcmp(translator->dictionary_name, "en") == 0);
  275. assert(p_decoder != NULL);
  276. assert(espeak_Synchronize() == EE_OK);
  277. assert(translator != NULL);
  278. assert(strcmp(translator->dictionary_name, "en") == 0);
  279. assert(p_decoder != NULL);
  280. assert(espeak_Terminate() == EE_OK);
  281. assert(event_list == NULL);
  282. assert(translator == NULL);
  283. assert(p_decoder == NULL);
  284. }
  285. void
  286. test_espeak_set_voice_by_properties_blank_language()
  287. {
  288. printf("testing espeak_SetVoiceByProperties: languages=\"\"\n");
  289. assert(event_list == NULL);
  290. assert(translator == NULL);
  291. assert(p_decoder == NULL);
  292. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  293. assert(event_list != NULL);
  294. assert(translator == NULL);
  295. assert(p_decoder == NULL);
  296. espeak_VOICE properties;
  297. memset(&properties, 0, sizeof(properties));
  298. properties.languages = "";
  299. assert(espeak_SetVoiceByProperties(&properties) == EE_OK);
  300. assert(translator != NULL);
  301. assert(strcmp(translator->dictionary_name, "en") == 0);
  302. assert(p_decoder == NULL);
  303. const char *test = "One two three.";
  304. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  305. assert(translator != NULL);
  306. assert(strcmp(translator->dictionary_name, "en") == 0);
  307. assert(p_decoder != NULL);
  308. assert(espeak_Synchronize() == EE_OK);
  309. assert(translator != NULL);
  310. assert(strcmp(translator->dictionary_name, "en") == 0);
  311. assert(p_decoder != NULL);
  312. assert(espeak_Terminate() == EE_OK);
  313. assert(event_list == NULL);
  314. assert(translator == NULL);
  315. assert(p_decoder == NULL);
  316. }
  317. void
  318. test_espeak_set_voice_by_properties_with_valid_language()
  319. {
  320. printf("testing espeak_SetVoiceByProperties: languages=\"mk\" (valid)\n");
  321. assert(event_list == NULL);
  322. assert(translator == NULL);
  323. assert(p_decoder == NULL);
  324. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  325. assert(event_list != NULL);
  326. assert(translator == NULL);
  327. assert(p_decoder == NULL);
  328. espeak_VOICE properties;
  329. memset(&properties, 0, sizeof(properties));
  330. properties.languages = "mk";
  331. assert(espeak_SetVoiceByProperties(&properties) == EE_OK);
  332. assert(translator != NULL);
  333. assert(strcmp(translator->dictionary_name, "mk") == 0);
  334. assert(p_decoder == NULL);
  335. const char *test = "One two three.";
  336. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  337. assert(translator != NULL);
  338. assert(strcmp(translator->dictionary_name, "mk") == 0);
  339. assert(p_decoder != NULL);
  340. assert(espeak_Synchronize() == EE_OK);
  341. assert(translator != NULL);
  342. assert(strcmp(translator->dictionary_name, "mk") == 0);
  343. assert(p_decoder != NULL);
  344. assert(espeak_Terminate() == EE_OK);
  345. assert(event_list == NULL);
  346. assert(translator == NULL);
  347. assert(p_decoder == NULL);
  348. }
  349. void
  350. test_espeak_set_voice_by_properties_with_invalid_language()
  351. {
  352. printf("testing espeak_SetVoiceByProperties: languages=\"zzz\" (invalid)\n");
  353. assert(event_list == NULL);
  354. assert(translator == NULL);
  355. assert(p_decoder == NULL);
  356. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  357. assert(event_list != NULL);
  358. assert(translator == NULL);
  359. assert(p_decoder == NULL);
  360. espeak_VOICE properties;
  361. memset(&properties, 0, sizeof(properties));
  362. properties.languages = "zzz";
  363. assert(espeak_SetVoiceByProperties(&properties) == EE_NOT_FOUND);
  364. assert(translator == NULL);
  365. assert(p_decoder == NULL);
  366. const char *test = "One two three.";
  367. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  368. assert(translator != NULL);
  369. assert(strcmp(translator->dictionary_name, "en") == 0);
  370. assert(p_decoder != NULL);
  371. assert(espeak_Synchronize() == EE_OK);
  372. assert(translator != NULL);
  373. assert(strcmp(translator->dictionary_name, "en") == 0);
  374. assert(p_decoder != NULL);
  375. assert(espeak_Terminate() == EE_OK);
  376. assert(event_list == NULL);
  377. assert(translator == NULL);
  378. assert(p_decoder == NULL);
  379. }
  380. // endregion
  381. int
  382. main(int argc, char **argv)
  383. {
  384. char *progdir = strdup(argv[0]);
  385. char *dir = strrchr(progdir, '/');
  386. if (dir != NULL) *dir = 0;
  387. test_espeak_terminate_without_initialize();
  388. test_espeak_initialize();
  389. test_espeak_synth();
  390. test_espeak_synth(); // Check that this does not crash when run a second time.
  391. test_espeak_synth_no_voices(progdir);
  392. test_espeak_synth();
  393. test_espeak_set_voice_by_name_null_voice();
  394. test_espeak_set_voice_by_name_blank_voice();
  395. test_espeak_set_voice_by_name_valid_voice();
  396. test_espeak_set_voice_by_name_invalid_voice();
  397. test_espeak_set_voice_by_name_language_variant_intonation_parameter();
  398. test_espeak_set_voice_by_properties_empty();
  399. test_espeak_set_voice_by_properties_blank_language();
  400. test_espeak_set_voice_by_properties_with_valid_language();
  401. test_espeak_set_voice_by_properties_with_invalid_language();
  402. free(progdir);
  403. return EXIT_SUCCESS;
  404. }