Difference between revisions of "Speecher Assistive Kit"

From Lazarus wiki
Jump to navigationJump to search
m (Kai Burghardt moved page sak to Speecher Assistive Kit: less cryptic page title)
 
(20 intermediate revisions by 4 users not shown)
Line 1: Line 1:
'''sak''' is the Speecher Assistive Kit who transforms your applications into multi-language speaking assisted applications.
+
==About==
 +
'''sak''' is a Speecher Assistive Kit which transforms your applications into multi-language speaking assisted applications.
 +
Easy and independent, you do not have to change anything in your original code.
 +
Compatible with Lazarus, fpGUI, MSEgui and console.
  
Easy and independent, you do not have to change anything in your original code.
+
For Linux, FreeBSD, macOS and Windows.
  
You do not need external libraries like at-spi, sapi, nor install anything in your system, etc...
+
You do not need external libraries like at-spi, sapi, nor do you need to install anything in your system.
 +
Everything is included in the kit.
  
All is included in the kit (+- 1 mega).
+
sak uses the [http://espeak.sourceforge.net/ eSpeak] and [http://www.portaudio.com/ PortAudio] open source libraries.
Of course the kit can be shared with other applications.
 
  
 +
==Download==
 +
GitHub: https://github.com/fredvs/sak
  
[http://fredvs.github.io/sak/ sak Speecher Assistive Kit]
+
==License==
 +
sak uses eSpeak who is GPL license.
 +
So the license differs if you use eSpeak executable or eSpeak library.
  
 +
* '''sak''': for all types of licenses, included commercial applications without source.  It uses Speak executable and new PortAudio dynamic library.
 +
* '''sak_dll''': for applications with GPL Open Source licences.  It uses eSpeak dynamic library and new PortAudio dynamic library.
  
''How to use it ?''
+
==Usage==
  
 +
Copy the '''sakit/''' (or '''sakit_dll/''') folder into your application-folder (from sak/ or sak_dll/, depend of the license you give...).
  
Copy the '''sakit''' folder into your application-folder.
+
* For '''sak''', add '''sak.pas''' into your application-folder.
 +
* For '''sak_dll''', add '''sak_dll.pas''', '''uos_portaudio.pas''' and '''uos_espeak.pas''' into your application-folder.
  
 +
In the "uses" section of your program add:
  
In your '''uses''' section add:
+
* For '''sak''': "uses sak"
 +
* For '''sak_dll''': "uses sak_dll"
  
'''uses
+
In your main program:
'''sak''',...
+
When you want your application becomes ''assistived'' call:
'''
 
  
 +
SAKLoadLib();
  
In your program :
+
This will seek in program-directory for /sakit/ (if not, in system for eSpeak).
When you want your application becomes assistive call:
 
  
'''SAKLoadLib;'''
+
or
  
To unload it :
+
SAKLoadLib('/path/of/sakit/');
  
'''SAKUnLoadLib;'''
+
This loads some custom path.
  
  
You may change the default gender and language.
+
To unload it :
  
gender : male or female
+
SAKUnLoadLib;
  
language : langage code
 
  
Here example for Portugues/Brasil woman
+
You may change the default gender and language.
  
 +
* gender: male or female
 +
* language: language code
  
'''SAKSetVoice(female,'pt');'''
+
Here example for Portugues/Brasil woman:
  
 +
SAKSetVoice(female,'pt');
  
 
In addition you may add your own speech with :
 
In addition you may add your own speech with :
  
'''SAKSay(Text: string);'''
+
SAKSay(Text: string);
 
 
  
 
When you close your application, call :
 
When you close your application, call :
  
 +
SAKUnLoadLib;
  
'''SAKFreeLib;'''
+
[[Category:Accessibility]]
 +
[[Category:Speech synthesis]]

Latest revision as of 18:33, 6 August 2022

About

sak is a Speecher Assistive Kit which transforms your applications into multi-language speaking assisted applications. Easy and independent, you do not have to change anything in your original code. Compatible with Lazarus, fpGUI, MSEgui and console.

For Linux, FreeBSD, macOS and Windows.

You do not need external libraries like at-spi, sapi, nor do you need to install anything in your system. Everything is included in the kit.

sak uses the eSpeak and PortAudio open source libraries.

Download

GitHub: https://github.com/fredvs/sak

License

sak uses eSpeak who is GPL license. So the license differs if you use eSpeak executable or eSpeak library.

  • sak: for all types of licenses, included commercial applications without source. It uses Speak executable and new PortAudio dynamic library.
  • sak_dll: for applications with GPL Open Source licences. It uses eSpeak dynamic library and new PortAudio dynamic library.

Usage

Copy the sakit/ (or sakit_dll/) folder into your application-folder (from sak/ or sak_dll/, depend of the license you give...).

  • For sak, add sak.pas into your application-folder.
  • For sak_dll, add sak_dll.pas, uos_portaudio.pas and uos_espeak.pas into your application-folder.

In the "uses" section of your program add:

  • For sak: "uses sak"
  • For sak_dll: "uses sak_dll"

In your main program: When you want your application becomes assistived call:

SAKLoadLib();

This will seek in program-directory for /sakit/ (if not, in system for eSpeak).

or

SAKLoadLib('/path/of/sakit/');

This loads some custom path.


To unload it :

SAKUnLoadLib;


You may change the default gender and language.

  • gender: male or female
  • language: language code

Here example for Portugues/Brasil woman:

SAKSetVoice(female,'pt');

In addition you may add your own speech with :

SAKSay(Text: string);

When you close your application, call :

SAKUnLoadLib;