Translator Library - Revision history

Costel Mincea: Text replacement - "" to ""

2025-01-26T19:08:06Z

Text replacement - "<syntaxhighlight>" to "<syntaxhighlight lang="C" line>"

← Older revision		Revision as of 19:08, 26 January 2025
Line 9:		Line 9:
	To use the Translate() function, you must first open the translator library and obtain a pointer to its main interface:		To use the Translate() function, you must first open the translator library and obtain a pointer to its main interface:

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	struct Library *TranslatorBase;		struct Library *TranslatorBase;
	struct TranslatorIFace *ITranslator;		struct TranslatorIFace *ITranslator;
Line 28:		Line 28:
	Once the library is open, you can call the translate function:		Once the library is open, you can call the translate function:

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	#define BUFLEN 500		#define BUFLEN 500

Line 51:		Line 51:
	As with all other libraries of functions, if you have successfully opened the translator library for use, be sure to close it before your program exits. If the system needs memory resources, it can then expunge closed libraries to gain additional memory space:		As with all other libraries of functions, if you have successfully opened the translator library for use, be sure to close it before your program exits. If the system needs memory resources, it can then expunge closed libraries to gain additional memory space:

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	struct Library *TranslatorBase;		struct Library *TranslatorBase;
	struct TranslatorIFace *ITranslator;		struct TranslatorIFace *ITranslator;

Steven Solie: /* Translator Library */

2015-11-09T19:26:28Z

Translator Library

← Older revision		Revision as of 19:26, 9 November 2015
Line 1:		Line 1:
	== Translator Library ==		== Translator Library ==

	This ~~chapter~~ describes the translator library which, together with the narrator device, provides the Amiga's text-to-speech capability. To fully understand how speech is produced on the Amiga, you should also read [[Narrator_Device\|Narrator Device]].		This article describes the translator library which, together with the narrator device, provides the Amiga's text-to-speech capability. To fully understand how speech is produced on the Amiga, you should also read [[Narrator_Device\|Narrator Device]].

	The translator library provides a single function, Translate(), that converts an English language string into a phonetic string. You may then pass this phonetic string to the narrator device which will say the string using the Amiga's audio hardware. The two subsystems may also be used individually. You don't have to use the narrator to say the phonetic strings; you could use them instead for phonetic analysis or some other special purpose.		The translator library provides a single function, Translate(), that converts an English language string into a phonetic string. You may then pass this phonetic string to the narrator device which will say the string using the Amiga's audio hardware. The two subsystems may also be used individually. You don't have to use the narrator to say the phonetic strings; you could use them instead for phonetic analysis or some other special purpose.
Line 63:		Line 63:
	The English language has many words that do not sound the same as they are spelled. The translator library has exception rules that it consults as the translation progresses. It also provides for common abbreviations such as Dr., Prof., LB., etc. Words that are not in the exception table are translated literally. This translation allows unrestricted English text as input, and uses over four hundred and fifty context sensitive rules. It automatically accents content words, and leaves function words (e.g. of, by, the, and at) unaccented. It is possible, however, that certain words will not translate well. You can improve the quality of translation by handling those words on your own.		The English language has many words that do not sound the same as they are spelled. The translator library has exception rules that it consults as the translation progresses. It also provides for common abbreviations such as Dr., Prof., LB., etc. Words that are not in the exception table are translated literally. This translation allows unrestricted English text as input, and uses over four hundred and fifty context sensitive rules. It automatically accents content words, and leaves function words (e.g. of, by, the, and at) unaccented. It is possible, however, that certain words will not translate well. You can improve the quality of translation by handling those words on your own.

	The phoneme table that the narrator uses is listed in the [[Narrator_Device\|Narrator Device]]. You will also find other important information about the Amiga's speech capability in the narrator ~~chapter~~ including a working example which shows how to use the translator library together with the narrator device.		The phoneme table that the narrator uses is listed in the [[Narrator_Device\|Narrator Device]]. You will also find other important information about the Amiga's speech capability in the narrator article including a working example which shows how to use the translator library together with the narrator device.

Steven Solie at 17:46, 26 November 2012

2012-11-26T17:46:44Z

← Older revision		Revision as of 17:46, 26 November 2012
Line 1:		Line 1:
	{{CodeReview}}
	== Translator Library ==		== Translator Library ==

Line 8:		Line 7:
	=== Opening the Translator Library ===		=== Opening the Translator Library ===

	To use the Translate() function, you must first open the translator library. ~~Setting~~ a ~~global variable, TranslatorBase,~~ to ~~the value returned from the call to OpenLibrary() enables the Amiga linker to correctly locate the~~ ~~translator~~ ~~library~~:		To use the Translate() function, you must first open the translator library and obtain a pointer to its main interface:

			<syntaxhighlight>
	<pre>
	struct Library *TranslatorBase;		struct Library *TranslatorBase;
			struct TranslatorIFace *ITranslator;

	TranslatorBase = OpenLibrary(~~"~~translator.library~~"~~,REVISION);		TranslatorBase = IExec->OpenLibrary("translator.library", REVISION);
	if(TranslatorBase != NULL)		if(TranslatorBase != NULL)
			{
⚫	{
			ITranslator = (struct TranslatorIFace*)IExec->GetInterface(TranslatorBase, "main", 1, NULL);
⚫	/* use translator here ~~-- library open~~ */
			if(ITranslator != NULL)
⚫	}
		⚫	{
	</pre>
		⚫	/* use translator here */

		⚫	}
	{\| class="wikitable"
		⚫	}
	\|"LIBS:" must contain "translator.library". Since translator is a disk-based library, the call to OpenLibrary() will work only if the "LIBS:" directory contains "translator.library".
			</syntaxhighlight>
⚫	\|}

	=== Using the Translate Function ===		=== Using the Translate Function ===
Line 28:		Line 28:
	Once the library is open, you can call the translate function:		Once the library is open, you can call the translate function:

			<syntaxhighlight>
	<pre>
	#define BUFLEN 500		#define BUFLEN 500

Line 36:		Line 36:
	LONG rtnCode; /* return code from function */		LONG rtnCode; /* return code from function */

	EnglStr = ~~"~~This is Amiga speaking.~~"~~; /* a test string */		EnglStr = "This is Amiga speaking."; /* a test string */
	EnglLen = strlen(EnglStr);		EnglLen = strlen(EnglStr);
	rtnCode = Translate(EnglStr, EnglLen, (STRPTR)~~&~~PhonBuffer~~[0]~~, BUFLEN);		rtnCode = ITranslator->Translate(EnglStr, EnglLen, (STRPTR)PhonBuffer, BUFLEN);
			</syntaxhighlight>
	</pre>

	The input string will be translated into its phonetic equivalent and can be used to feed the narrator device. If you receive a non-zero return code, you ~~haven‚Äôt~~ provided enough output buffer space to hold the entire translation.		The input string will be translated into its phonetic equivalent and can be used to feed the narrator device. If you receive a non-zero return code, you haven't provided enough output buffer space to hold the entire translation.

	In this case, the Translate() function breaks the translation at the end of a word in the input stream and returns the position in the input stream at which the translation ended. You can use the output buffer, then call the Translate() function again, starting at this original ending position, to continue the translation where you left off. This method will sound smoothest if the ending position ends on sentence boundaries.		In this case, the Translate() function breaks the translation at the end of a word in the input stream and returns the position in the input stream at which the translation ended. You can use the output buffer, then call the Translate() function again, starting at this original ending position, to continue the translation where you left off. This method will sound smoothest if the ending position ends on sentence boundaries.

		⚫	{{Note\|title=Translate() returns negative values\|text=To get the proper character offset, you must use -(rtnCode) as the starting point for a new translation.}}
	{\| class="wikitable"
⚫	\| ''Translate() returns negative values~~''.~~ To get the proper character offset, you must use -(rtnCode) as the starting point for a new translation.
	\|}

	=== Closing the Translator Library ===		=== Closing the Translator Library ===
Line 53:		Line 51:
	As with all other libraries of functions, if you have successfully opened the translator library for use, be sure to close it before your program exits. If the system needs memory resources, it can then expunge closed libraries to gain additional memory space:		As with all other libraries of functions, if you have successfully opened the translator library for use, be sure to close it before your program exits. If the system needs memory resources, it can then expunge closed libraries to gain additional memory space:

			<syntaxhighlight>
	<pre>
	struct Library *TranslatorBase;		struct Library *TranslatorBase;
			struct TranslatorIFace *ITranslator;

			IExec->DropInterface((struct Interface*)ITranslator);
	~~if(TranslatorBase)~~ CloseLibrary(TranslatorBase);		IExec->CloseLibrary(TranslatorBase);
	</pre>
			</syntaxhighlight>

	=== Additional Notes About Translate ===		=== Additional Notes About Translate ===

Steven Solie at 16:24, 2 May 2012

2012-05-02T16:24:41Z

← Older revision		Revision as of 16:24, 2 May 2012
Line 1:		Line 1:
			{{CodeReview}}
	== Translator Library ==		== Translator Library ==

Steven Solie: /* Additional Notes About Translate */

2012-05-01T23:04:59Z

Additional Notes About Translate

← Older revision		Revision as of 23:04, 1 May 2012
Line 62:		Line 62:
	The English language has many words that do not sound the same as they are spelled. The translator library has exception rules that it consults as the translation progresses. It also provides for common abbreviations such as Dr., Prof., LB., etc. Words that are not in the exception table are translated literally. This translation allows unrestricted English text as input, and uses over four hundred and fifty context sensitive rules. It automatically accents content words, and leaves function words (e.g. of, by, the, and at) unaccented. It is possible, however, that certain words will not translate well. You can improve the quality of translation by handling those words on your own.		The English language has many words that do not sound the same as they are spelled. The translator library has exception rules that it consults as the translation progresses. It also provides for common abbreviations such as Dr., Prof., LB., etc. Words that are not in the exception table are translated literally. This translation allows unrestricted English text as input, and uses over four hundred and fifty context sensitive rules. It automatically accents content words, and leaves function words (e.g. of, by, the, and at) unaccented. It is possible, however, that certain words will not translate well. You can improve the quality of translation by handling those words on your own.

	The phoneme table that the narrator uses is listed in the ""Narrator Device~~" chapter of the ''Amiga ROM Kernel Reference Manual: Devices''~~. You will also find other important information about the Amiga's speech capability in the narrator chapter including a working example which shows how to use the translator library together with the narrator device.		The phoneme table that the narrator uses is listed in the [[Narrator_Device\|Narrator Device]]. You will also find other important information about the Amiga's speech capability in the narrator chapter including a working example which shows how to use the translator library together with the narrator device.

Steven Solie: /* Translator Library */

2012-05-01T23:04:36Z

Translator Library

← Older revision		Revision as of 23:04, 1 May 2012
Line 1:		Line 1:
	== Translator Library ==		== Translator Library ==

	This chapter describes the translator library which, together with the narrator device, provides the Amiga's text-to-speech capability. To fully understand how speech is produced on the Amiga, you should also read ~~the "~~Narrator Device~~" chapter of the ''Amiga ROM Kernel Reference Manual: Devices''~~.		This chapter describes the translator library which, together with the narrator device, provides the Amiga's text-to-speech capability. To fully understand how speech is produced on the Amiga, you should also read [[Narrator_Device\|Narrator Device]].

	The translator library provides a single function, Translate(), that converts an English language string into a phonetic string. You may then pass this phonetic string to the narrator device which will say the string using the Amiga's audio hardware. The two subsystems may also be used individually. You don't have to use the narrator to say the phonetic strings; you could use them instead for phonetic analysis or some other special purpose.		The translator library provides a single function, Translate(), that converts an English language string into a phonetic string. You may then pass this phonetic string to the narrator device which will say the string using the Amiga's audio hardware. The two subsystems may also be used individually. You don't have to use the narrator to say the phonetic strings; you could use them instead for phonetic analysis or some other special purpose.

Steven Solie: /* Translator Library */

2012-04-09T20:33:53Z

Translator Library

← Older revision		Revision as of 20:33, 9 April 2012
Line 1:		Line 1:
	== Translator Library ==		== Translator Library ==

	This chapter describes the translator library which, together with the narrator device, provides the ~~Amiga‚Äôs~~ text-to-speech capability. To fully understand how speech is produced on the Amiga, you should also read the "Narrator Device" chapter of the ''Amiga ROM Kernel Reference Manual: Devices''.		This chapter describes the translator library which, together with the narrator device, provides the Amiga's text-to-speech capability. To fully understand how speech is produced on the Amiga, you should also read the "Narrator Device" chapter of the ''Amiga ROM Kernel Reference Manual: Devices''.

	The translator library provides a single function, Translate(), that converts an English language string into a phonetic string. You may then pass this phonetic string to the narrator device which will say the string using the ~~Amiga‚Äôs~~ audio hardware. The two subsystems may also be used individually. You don't have to use the narrator to say the phonetic strings; you could use them instead for phonetic analysis or some other special purpose.		The translator library provides a single function, Translate(), that converts an English language string into a phonetic string. You may then pass this phonetic string to the narrator device which will say the string using the Amiga's audio hardware. The two subsystems may also be used individually. You don't have to use the narrator to say the phonetic strings; you could use them instead for phonetic analysis or some other special purpose.

	=== Opening the Translator Library ===		=== Opening the Translator Library ===
Line 9:		Line 9:
	To use the Translate() function, you must first open the translator library. Setting a global variable, TranslatorBase, to the value returned from the call to OpenLibrary() enables the Amiga linker to correctly locate the translator library:		To use the Translate() function, you must first open the translator library. Setting a global variable, TranslatorBase, to the value returned from the call to OpenLibrary() enables the Amiga linker to correctly locate the translator library:

			<pre>
	~~<pre>~~struct Library *TranslatorBase;		struct Library *TranslatorBase;

	TranslatorBase = OpenLibrary("translator.library",REVISION);		TranslatorBase = OpenLibrary("translator.library",REVISION);
Line 15:		Line 16:
	{		{
	/* use translator here -- library open */		/* use translator here -- library open */
	}~~</pre>~~		}
			</pre>

	{\| class="wikitable"		{\| class="wikitable"
Line 25:		Line 27:
	Once the library is open, you can call the translate function:		Once the library is open, you can call the translate function:

	<pre>~~#define BUFLEN 500~~		<pre>
			#define BUFLEN 500

	STRPTR EnglStr; /* pointer to sample input string */		STRPTR EnglStr; /* pointer to sample input string */
Line 34:		Line 37:
	EnglStr = "This is Amiga speaking."; /* a test string */		EnglStr = "This is Amiga speaking."; /* a test string */
	EnglLen = strlen(EnglStr);		EnglLen = strlen(EnglStr);
	rtnCode = Translate(EnglStr, EnglLen, (STRPTR)&PhonBuffer[0], BUFLEN);~~</pre>~~		rtnCode = Translate(EnglStr, EnglLen, (STRPTR)&PhonBuffer[0], BUFLEN);
			</pre>

	The input string will be translated into its phonetic equivalent and can be used to feed the narrator device. If you receive a non-zero return code, you haven‚Äôt provided enough output buffer space to hold the entire translation.		The input string will be translated into its phonetic equivalent and can be used to feed the narrator device. If you receive a non-zero return code, you haven‚Äôt provided enough output buffer space to hold the entire translation.

	In this case, the Translate() function breaks the translation at the end of a word in the input stream and returns the position in the input stream at which the translation ended. You can use the output buffer, then call the Translate() function again, starting at this original ending position, to continue the translation where you left off. This method will sound smoothest if the ending position ends on sentence boundaries.		In this case, the Translate() function breaks the translation at the end of a word in the input stream and returns the position in the input stream at which the translation ended. You can use the output buffer, then call the Translate() function again, starting at this original ending position, to continue the translation where you left off. This method will sound smoothest if the ending position ends on sentence boundaries.

			{\| class="wikitable"
	~~<sub>b</sub>oxTranslate~~() returns negative values.To get the proper character offset, you must use -(rtnCode) as the starting point for a new translation.		\| ''Translate() returns negative values''. To get the proper character offset, you must use -(rtnCode) as the starting point for a new translation.
			\|}

	=== Closing the Translator Library ===		=== Closing the Translator Library ===
Line 45:		Line 52:
	As with all other libraries of functions, if you have successfully opened the translator library for use, be sure to close it before your program exits. If the system needs memory resources, it can then expunge closed libraries to gain additional memory space:		As with all other libraries of functions, if you have successfully opened the translator library for use, be sure to close it before your program exits. If the system needs memory resources, it can then expunge closed libraries to gain additional memory space:

			<pre>
	~~<pre>~~struct Library *TranslatorBase;		struct Library *TranslatorBase;

		⚫	if(TranslatorBase) CloseLibrary(TranslatorBase);
			</pre>

⚫	if(TranslatorBase) CloseLibrary(TranslatorBase);~~</pre>~~
	=== Additional Notes About Translate ===		=== Additional Notes About Translate ===

	The English language has many words that do not sound the same as they are spelled. The translator library has exception rules that it consults as the translation progresses. It also provides for common abbreviations such as Dr., Prof., LB., etc. Words that are not in the exception table are translated literally. This translation allows unrestricted English text as input, and uses over four hundred and fifty context sensitive rules. It automatically accents content words, and leaves function words (e.g. of, by, the, and at) unaccented. It is possible, however, that certain words will not translate well. You can improve the quality of translation by handling those words on your own.		The English language has many words that do not sound the same as they are spelled. The translator library has exception rules that it consults as the translation progresses. It also provides for common abbreviations such as Dr., Prof., LB., etc. Words that are not in the exception table are translated literally. This translation allows unrestricted English text as input, and uses over four hundred and fifty context sensitive rules. It automatically accents content words, and leaves function words (e.g. of, by, the, and at) unaccented. It is possible, however, that certain words will not translate well. You can improve the quality of translation by handling those words on your own.

	The phoneme table that the narrator uses is listed in the ~~‚ÄúNarrator~~ ~~Device‚Äù~~ chapter of the ''Amiga ROM Kernel Reference Manual: Devices''. You will also find other important information about the ~~Amiga‚Äôs~~ speech capability in the narrator chapter including a working example which shows how to use the translator library together with the narrator device.		The phoneme table that the narrator uses is listed in the ""Narrator Device" chapter of the ''Amiga ROM Kernel Reference Manual: Devices''. You will also find other important information about the Amiga's speech capability in the narrator chapter including a working example which shows how to use the translator library together with the narrator device.

Steven Solie: /* Translator Library */

2012-03-30T18:33:28Z

Translator Library

← Older revision		Revision as of 18:33, 30 March 2012
Line 1:		Line 1:
	= Translator Library =		== Translator Library ==

	This chapter describes the translator library which, together with the narrator device, provides the Amiga‚Äôs text-to-speech capability. To fully understand how speech is produced on the Amiga, you should also read the ~~‚ÄúNarrator~~ ~~Device‚Äù~~ chapter of the ''Amiga ROM Kernel Reference Manual: Devices''.		This chapter describes the translator library which, together with the narrator device, provides the Amiga‚Äôs text-to-speech capability. To fully understand how speech is produced on the Amiga, you should also read the "Narrator Device" chapter of the ''Amiga ROM Kernel Reference Manual: Devices''.

		⚫	The translator library provides a single function, Translate(), that converts an English language string into a phonetic string. You may then pass this phonetic string to the narrator device which will say the string using the Amiga‚Äôs audio hardware. The two subsystems may also be used individually. You don't have to use the narrator to say the phonetic strings; you could use them instead for phonetic analysis or some other special purpose.


⚫	The translator library provides a single function, Translate(), that converts an English language string into a phonetic string. You may then pass this phonetic string to the narrator device which will say the string using the Amiga‚Äôs audio hardware. The two subsystems may also be used individually. You ~~don‚Äôt~~ have to use the narrator to say the phonetic strings; you could use them instead for phonetic analysis or some other special purpose.

	=== Opening the Translator Library ===		=== Opening the Translator Library ===
Line 18:		Line 16:
	/* use translator here -- library open */		/* use translator here -- library open */
	}</pre>		}</pre>

⚫	~~<sub>b</sub>ox‚ÄúLIBS~~:~~‚Äù~~ must contain ~~‚Äútranslator~~.~~library‚Äù~~.Since translator is a disk-based library, the call to OpenLibrary() will work only if the ~~‚ÄúLIBS~~:~~‚Äù~~ directory contains ~~‚Äútranslator~~.~~library‚Äù~~.
			{\| class="wikitable"
		⚫	\|"LIBS:" must contain "translator.library". Since translator is a disk-based library, the call to OpenLibrary() will work only if the "LIBS:" directory contains "translator.library".
			\|}

	=== Using the Translate Function ===		=== Using the Translate Function ===

Steven Solie: Created page with "= Translator Library = This chapter describes the translator library which, together with the narrator device, provides the Amiga‚Äôs text-to-speech capability. To fully ..."

2012-03-18T06:09:44Z

Created page with "= Translator Library = This chapter describes the translator library which, together with the narrator device, provides the Amiga‚Äôs text-to-speech capability. To fully ..."

New page

= Translator Library =

This chapter describes the translator library which, together with the narrator device, provides the Amiga‚Äôs text-to-speech capability. To fully understand how speech is produced on the Amiga, you should also read the ‚ÄúNarrator Device‚Äù chapter of the ''Amiga ROM Kernel Reference Manual: Devices''.

The translator library provides a single function, Translate(), that converts an English language string into a phonetic string. You may then pass this phonetic string to the narrator device which will say the string using the Amiga‚Äôs audio hardware. The two subsystems may also be used individually. You don‚Äôt have to use the narrator to say the phonetic strings; you could use them instead for phonetic analysis or some other special purpose.

=== Opening the Translator Library ===

To use the Translate() function, you must first open the translator library. Setting a global variable, TranslatorBase, to the value returned from the call to OpenLibrary() enables the Amiga linker to correctly locate the translator library:

<pre>struct Library *TranslatorBase;

TranslatorBase = OpenLibrary("translator.library",REVISION);
if(TranslatorBase != NULL)
{
/* use translator here -- library open */
}</pre>
<sub>b</sub>ox‚ÄúLIBS:‚Äù must contain ‚Äútranslator.library‚Äù.Since translator is a disk-based library, the call to OpenLibrary() will work only if the ‚ÄúLIBS:‚Äù directory contains ‚Äútranslator.library‚Äù.

=== Using the Translate Function ===

Once the library is open, you can call the translate function:

<pre>#define BUFLEN 500

STRPTR EnglStr; /* pointer to sample input string */
LONG EnglLen; /* input length */
UBYTE PhonBuffer[BUFLEN]; /* place to put the translation */
LONG rtnCode; /* return code from function */

EnglStr = "This is Amiga speaking."; /* a test string */
EnglLen = strlen(EnglStr);
rtnCode = Translate(EnglStr, EnglLen, (STRPTR)&PhonBuffer[0], BUFLEN);</pre>
The input string will be translated into its phonetic equivalent and can be used to feed the narrator device. If you receive a non-zero return code, you haven‚Äôt provided enough output buffer space to hold the entire translation.

In this case, the Translate() function breaks the translation at the end of a word in the input stream and returns the position in the input stream at which the translation ended. You can use the output buffer, then call the Translate() function again, starting at this original ending position, to continue the translation where you left off. This method will sound smoothest if the ending position ends on sentence boundaries.

<sub>b</sub>oxTranslate() returns negative values.To get the proper character offset, you must use -(rtnCode) as the starting point for a new translation.

=== Closing the Translator Library ===

As with all other libraries of functions, if you have successfully opened the translator library for use, be sure to close it before your program exits. If the system needs memory resources, it can then expunge closed libraries to gain additional memory space:

<pre>struct Library *TranslatorBase;

if(TranslatorBase) CloseLibrary(TranslatorBase);</pre>
=== Additional Notes About Translate ===

The English language has many words that do not sound the same as they are spelled. The translator library has exception rules that it consults as the translation progresses. It also provides for common abbreviations such as Dr., Prof., LB., etc. Words that are not in the exception table are translated literally. This translation allows unrestricted English text as input, and uses over four hundred and fifty context sensitive rules. It automatically accents content words, and leaves function words (e.g. of, by, the, and at) unaccented. It is possible, however, that certain words will not translate well. You can improve the quality of translation by handling those words on your own.

The phoneme table that the narrator uses is listed in the ‚ÄúNarrator Device‚Äù chapter of the ''Amiga ROM Kernel Reference Manual: Devices''. You will also find other important information about the Amiga‚Äôs speech capability in the narrator chapter including a working example which shows how to use the translator library together with the narrator device.