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

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576
  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_NOT_FOUND);
  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_ng_Synthesize
  110. void
  111. test_espeak_ng_synthesize()
  112. {
  113. printf("testing espeak_ng_Synthesize\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. const char *test = "One two three.";
  122. assert(espeak_ng_Synthesize(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == ENS_OK);
  123. assert(translator != NULL);
  124. assert(strcmp(translator->dictionary_name, "en") == 0);
  125. assert(p_decoder != NULL);
  126. assert(espeak_Synchronize() == EE_OK);
  127. assert(translator != NULL);
  128. assert(strcmp(translator->dictionary_name, "en") == 0);
  129. assert(p_decoder != NULL);
  130. assert(espeak_Terminate() == EE_OK);
  131. assert(event_list == NULL);
  132. assert(translator == NULL);
  133. assert(p_decoder == NULL);
  134. }
  135. void
  136. test_espeak_ng_synthesize_no_voices(const char *path)
  137. {
  138. printf("testing espeak_ng_Synthesize in path with no voices\n");
  139. assert(event_list == NULL);
  140. assert(translator == NULL);
  141. assert(p_decoder == NULL);
  142. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, path, espeakINITIALIZE_DONT_EXIT) == 22050);
  143. assert(event_list != NULL);
  144. assert(translator == NULL);
  145. assert(p_decoder == NULL);
  146. const char *test = "One two three.";
  147. assert(espeak_ng_Synthesize(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == ENS_VOICE_NOT_FOUND);
  148. assert(translator == NULL);
  149. assert(p_decoder == NULL);
  150. assert(espeak_Synchronize() == EE_OK);
  151. assert(translator == NULL);
  152. assert(p_decoder == NULL);
  153. assert(espeak_Terminate() == EE_OK);
  154. assert(event_list == NULL);
  155. assert(translator == NULL);
  156. assert(p_decoder == NULL);
  157. }
  158. // endregion
  159. // region espeak_SetVoiceByName
  160. void
  161. test_espeak_set_voice_by_name_null_voice()
  162. {
  163. printf("testing espeak_SetVoiceByName(NULL)\n");
  164. assert(event_list == NULL);
  165. assert(translator == NULL);
  166. assert(p_decoder == NULL);
  167. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  168. assert(event_list != NULL);
  169. assert(translator == NULL);
  170. assert(p_decoder == NULL);
  171. assert(espeak_SetVoiceByName("") == EE_NOT_FOUND);
  172. assert(translator == NULL);
  173. assert(p_decoder == NULL);
  174. const char *test = "One two three.";
  175. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  176. assert(translator != NULL);
  177. assert(strcmp(translator->dictionary_name, "en") == 0);
  178. assert(p_decoder != NULL);
  179. assert(espeak_Synchronize() == EE_OK);
  180. assert(translator != NULL);
  181. assert(strcmp(translator->dictionary_name, "en") == 0);
  182. assert(p_decoder != NULL);
  183. assert(espeak_Terminate() == EE_OK);
  184. assert(event_list == NULL);
  185. assert(translator == NULL);
  186. assert(p_decoder == NULL);
  187. }
  188. void
  189. test_espeak_set_voice_by_name_blank_voice()
  190. {
  191. printf("testing espeak_SetVoiceByName(\"\")\n");
  192. assert(event_list == NULL);
  193. assert(translator == NULL);
  194. assert(p_decoder == NULL);
  195. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  196. assert(event_list != NULL);
  197. assert(translator == NULL);
  198. assert(p_decoder == NULL);
  199. assert(espeak_SetVoiceByName("") == EE_NOT_FOUND);
  200. assert(translator == NULL);
  201. assert(p_decoder == NULL);
  202. const char *test = "One two three.";
  203. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  204. assert(translator != NULL);
  205. assert(strcmp(translator->dictionary_name, "en") == 0);
  206. assert(p_decoder != NULL);
  207. assert(espeak_Synchronize() == EE_OK);
  208. assert(translator != NULL);
  209. assert(strcmp(translator->dictionary_name, "en") == 0);
  210. assert(p_decoder != NULL);
  211. assert(espeak_Terminate() == EE_OK);
  212. assert(event_list == NULL);
  213. assert(translator == NULL);
  214. assert(p_decoder == NULL);
  215. }
  216. void
  217. test_espeak_set_voice_by_name_valid_voice()
  218. {
  219. printf("testing espeak_SetVoiceByName(\"de\")\n");
  220. assert(event_list == NULL);
  221. assert(translator == NULL);
  222. assert(p_decoder == NULL);
  223. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  224. assert(event_list != NULL);
  225. assert(translator == NULL);
  226. assert(p_decoder == NULL);
  227. assert(espeak_SetVoiceByName("de") == EE_OK);
  228. assert(translator != NULL);
  229. assert(strcmp(translator->dictionary_name, "de") == 0);
  230. assert(p_decoder == NULL);
  231. const char *test = "One two three.";
  232. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  233. assert(translator != NULL);
  234. assert(strcmp(translator->dictionary_name, "de") == 0);
  235. assert(p_decoder != NULL);
  236. assert(espeak_Synchronize() == EE_OK);
  237. assert(translator != NULL);
  238. assert(strcmp(translator->dictionary_name, "de") == 0);
  239. assert(p_decoder != NULL);
  240. assert(espeak_Terminate() == EE_OK);
  241. assert(event_list == NULL);
  242. assert(translator == NULL);
  243. assert(p_decoder == NULL);
  244. }
  245. void
  246. test_espeak_set_voice_by_name_invalid_voice()
  247. {
  248. printf("testing espeak_SetVoiceByName(\"zzz\")\n");
  249. assert(event_list == NULL);
  250. assert(translator == NULL);
  251. assert(p_decoder == NULL);
  252. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  253. assert(event_list != NULL);
  254. assert(translator == NULL);
  255. assert(p_decoder == NULL);
  256. assert(espeak_SetVoiceByName("zzz") == EE_NOT_FOUND);
  257. assert(translator == NULL);
  258. assert(p_decoder == NULL);
  259. const char *test = "One two three.";
  260. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  261. assert(translator != NULL);
  262. assert(strcmp(translator->dictionary_name, "en") == 0);
  263. assert(p_decoder != NULL);
  264. assert(espeak_Synchronize() == EE_OK);
  265. assert(translator != NULL);
  266. assert(strcmp(translator->dictionary_name, "en") == 0);
  267. assert(p_decoder != NULL);
  268. assert(espeak_Terminate() == EE_OK);
  269. assert(event_list == NULL);
  270. assert(translator == NULL);
  271. assert(p_decoder == NULL);
  272. }
  273. void
  274. test_espeak_set_voice_by_name_language_variant_intonation_parameter()
  275. {
  276. printf("testing espeak_SetVoiceByName(\"!v/Annie\") (language variant; intonation)\n");
  277. assert(event_list == NULL);
  278. assert(translator == NULL);
  279. assert(p_decoder == NULL);
  280. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  281. assert(event_list != NULL);
  282. assert(translator == NULL);
  283. assert(p_decoder == NULL);
  284. assert(espeak_SetVoiceByName("!v/Annie") == EE_OK);
  285. assert(translator != NULL);
  286. assert(strcmp(translator->dictionary_name, "en") == 0);
  287. assert(p_decoder == NULL);
  288. const char *test = "One two three.";
  289. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  290. assert(translator != NULL);
  291. assert(strcmp(translator->dictionary_name, "en") == 0);
  292. assert(p_decoder != NULL);
  293. assert(espeak_Synchronize() == EE_OK);
  294. assert(translator != NULL);
  295. assert(strcmp(translator->dictionary_name, "en") == 0);
  296. assert(p_decoder != NULL);
  297. assert(espeak_Terminate() == EE_OK);
  298. assert(event_list == NULL);
  299. assert(translator == NULL);
  300. assert(p_decoder == NULL);
  301. }
  302. // endregion
  303. // region espeak_SetVoiceByProperties
  304. void
  305. test_espeak_set_voice_by_properties_empty()
  306. {
  307. printf("testing espeak_SetVoiceByProperties: (none)\n");
  308. assert(event_list == NULL);
  309. assert(translator == NULL);
  310. assert(p_decoder == NULL);
  311. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  312. assert(event_list != NULL);
  313. assert(translator == NULL);
  314. assert(p_decoder == NULL);
  315. espeak_VOICE properties;
  316. memset(&properties, 0, sizeof(properties));
  317. assert(espeak_SetVoiceByProperties(&properties) == EE_OK);
  318. assert(translator != NULL);
  319. assert(strcmp(translator->dictionary_name, "en") == 0);
  320. assert(p_decoder == NULL);
  321. const char *test = "One two three.";
  322. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  323. assert(translator != NULL);
  324. assert(strcmp(translator->dictionary_name, "en") == 0);
  325. assert(p_decoder != NULL);
  326. assert(espeak_Synchronize() == EE_OK);
  327. assert(translator != NULL);
  328. assert(strcmp(translator->dictionary_name, "en") == 0);
  329. assert(p_decoder != NULL);
  330. assert(espeak_Terminate() == EE_OK);
  331. assert(event_list == NULL);
  332. assert(translator == NULL);
  333. assert(p_decoder == NULL);
  334. }
  335. void
  336. test_espeak_set_voice_by_properties_blank_language()
  337. {
  338. printf("testing espeak_SetVoiceByProperties: languages=\"\"\n");
  339. assert(event_list == NULL);
  340. assert(translator == NULL);
  341. assert(p_decoder == NULL);
  342. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  343. assert(event_list != NULL);
  344. assert(translator == NULL);
  345. assert(p_decoder == NULL);
  346. espeak_VOICE properties;
  347. memset(&properties, 0, sizeof(properties));
  348. properties.languages = "";
  349. assert(espeak_SetVoiceByProperties(&properties) == EE_OK);
  350. assert(translator != NULL);
  351. assert(strcmp(translator->dictionary_name, "en") == 0);
  352. assert(p_decoder == NULL);
  353. const char *test = "One two three.";
  354. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  355. assert(translator != NULL);
  356. assert(strcmp(translator->dictionary_name, "en") == 0);
  357. assert(p_decoder != NULL);
  358. assert(espeak_Synchronize() == EE_OK);
  359. assert(translator != NULL);
  360. assert(strcmp(translator->dictionary_name, "en") == 0);
  361. assert(p_decoder != NULL);
  362. assert(espeak_Terminate() == EE_OK);
  363. assert(event_list == NULL);
  364. assert(translator == NULL);
  365. assert(p_decoder == NULL);
  366. }
  367. void
  368. test_espeak_set_voice_by_properties_with_valid_language()
  369. {
  370. printf("testing espeak_SetVoiceByProperties: languages=\"mk\" (valid)\n");
  371. assert(event_list == NULL);
  372. assert(translator == NULL);
  373. assert(p_decoder == NULL);
  374. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  375. assert(event_list != NULL);
  376. assert(translator == NULL);
  377. assert(p_decoder == NULL);
  378. espeak_VOICE properties;
  379. memset(&properties, 0, sizeof(properties));
  380. properties.languages = "mk";
  381. assert(espeak_SetVoiceByProperties(&properties) == EE_OK);
  382. assert(translator != NULL);
  383. assert(strcmp(translator->dictionary_name, "mk") == 0);
  384. assert(p_decoder == NULL);
  385. const char *test = "One two three.";
  386. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  387. assert(translator != NULL);
  388. assert(strcmp(translator->dictionary_name, "mk") == 0);
  389. assert(p_decoder != NULL);
  390. assert(espeak_Synchronize() == EE_OK);
  391. assert(translator != NULL);
  392. assert(strcmp(translator->dictionary_name, "mk") == 0);
  393. assert(p_decoder != NULL);
  394. assert(espeak_Terminate() == EE_OK);
  395. assert(event_list == NULL);
  396. assert(translator == NULL);
  397. assert(p_decoder == NULL);
  398. }
  399. void
  400. test_espeak_set_voice_by_properties_with_invalid_language()
  401. {
  402. printf("testing espeak_SetVoiceByProperties: languages=\"zzz\" (invalid)\n");
  403. assert(event_list == NULL);
  404. assert(translator == NULL);
  405. assert(p_decoder == NULL);
  406. assert(espeak_Initialize(AUDIO_OUTPUT_RETRIEVAL, 0, NULL, 0) == 22050);
  407. assert(event_list != NULL);
  408. assert(translator == NULL);
  409. assert(p_decoder == NULL);
  410. espeak_VOICE properties;
  411. memset(&properties, 0, sizeof(properties));
  412. properties.languages = "zzz";
  413. assert(espeak_SetVoiceByProperties(&properties) == EE_NOT_FOUND);
  414. assert(translator == NULL);
  415. assert(p_decoder == NULL);
  416. const char *test = "One two three.";
  417. assert(espeak_Synth(test, strlen(test)+1, 0, POS_CHARACTER, 0, espeakCHARS_AUTO, NULL, NULL) == EE_OK);
  418. assert(translator != NULL);
  419. assert(strcmp(translator->dictionary_name, "en") == 0);
  420. assert(p_decoder != NULL);
  421. assert(espeak_Synchronize() == EE_OK);
  422. assert(translator != NULL);
  423. assert(strcmp(translator->dictionary_name, "en") == 0);
  424. assert(p_decoder != NULL);
  425. assert(espeak_Terminate() == EE_OK);
  426. assert(event_list == NULL);
  427. assert(translator == NULL);
  428. assert(p_decoder == NULL);
  429. }
  430. // endregion
  431. int
  432. main(int argc, char **argv)
  433. {
  434. (void)argc; // unused parameter
  435. char *progdir = strdup(argv[0]);
  436. char *dir = strrchr(progdir, '/');
  437. if (dir != NULL) *dir = 0;
  438. test_espeak_terminate_without_initialize();
  439. test_espeak_initialize();
  440. test_espeak_synth();
  441. test_espeak_synth(); // Check that this does not crash when run a second time.
  442. test_espeak_synth_no_voices(progdir);
  443. test_espeak_synth();
  444. test_espeak_ng_synthesize();
  445. test_espeak_ng_synthesize(); // Check that this does not crash when run a second time.
  446. test_espeak_ng_synthesize_no_voices(progdir);
  447. test_espeak_ng_synthesize();
  448. test_espeak_set_voice_by_name_null_voice();
  449. test_espeak_set_voice_by_name_blank_voice();
  450. test_espeak_set_voice_by_name_valid_voice();
  451. test_espeak_set_voice_by_name_invalid_voice();
  452. test_espeak_set_voice_by_name_language_variant_intonation_parameter();
  453. test_espeak_set_voice_by_properties_empty();
  454. test_espeak_set_voice_by_properties_blank_language();
  455. test_espeak_set_voice_by_properties_with_valid_language();
  456. test_espeak_set_voice_by_properties_with_invalid_language();
  457. free(progdir);
  458. return EXIT_SUCCESS;
  459. }