Narrator Device - Revision history

Costel Mincea: Text replacement - "" to ""

2025-01-26T19:18:21Z

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

← Older revision		Revision as of 19:18, 26 January 2025
Line 35:		Line 35:
	The narrator device uses two extended I/O request structures: narrator_rb for write commands (to produce speech output) and mouth_rb for read commands (to receive mouth shape changes and word/syllable synchronization events).		The narrator device uses two extended I/O request structures: narrator_rb for write commands (to produce speech output) and mouth_rb for read commands (to receive mouth shape changes and word/syllable synchronization events).

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	struct narrator_rb		struct narrator_rb
	{		{
Line 92:		Line 92:
	Below is an example of how you would use the translator library to translate a string for the narrator device.		Below is an example of how you would use the translator library to translate a string for the narrator device.

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

Line 132:		Line 132:
	* Open the narrator device. Call OpenDevice() passing the I/O request.		* Open the narrator device. Call OpenDevice() passing the I/O request.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	struct MsgPort *VoiceMP;		struct MsgPort *VoiceMP;
	struct narrator_rb *VoiceIO;		struct narrator_rb *VoiceIO;
Line 157:		Line 157:
	The following code fragment, in conjunction with the OpenDevice() code fragment above, shows how to set up the mouth_rb structure:		The following code fragment, in conjunction with the OpenDevice() code fragment above, shows how to set up the mouth_rb structure:

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	struct MsgPort *MouthMP;		struct MsgPort *MouthMP;
	struct mouth_rb *MouthIO;		struct mouth_rb *MouthIO;
Line 180:		Line 180:
	All I/O requests must have completed before the task can close the device. If any requests are still pending, the user must abort them before closing the device.		All I/O requests must have completed before the task can close the device. If any requests are still pending, the user must abort them before closing the device.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	if ( !IExec->CheckIO(VoiceIO) )		if ( !IExec->CheckIO(VoiceIO) )
	{		{
Line 193:		Line 193:
	You write to the narrator device by passing a narrator_rb I/O request to the device with CMD_WRITE set in io_Command, the number of bytes to be written set in io_Length and the address of the write buffer set in io_Data.		You write to the narrator device by passing a narrator_rb I/O request to the device with CMD_WRITE set in io_Command, the number of bytes to be written set in io_Length and the address of the write buffer set in io_Data.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	VoiceIO->message.io_Command = CMD_WRITE;		VoiceIO->message.io_Command = CMD_WRITE;
	VoiceIO->message.io_Offset = 0;		VoiceIO->message.io_Offset = 0;
Line 283:		Line 283:
	The following example shows how to issue a write request to the narrator device. The first write is done with the default parameter settings. The second write is done after modifying the first and third formant loudness and using the centralization feature.		The following example shows how to issue a write request to the narrator device. The first write is done with the default parameter settings. The second write is done after modifying the first and third formant loudness and using the centralization feature.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	/*		/*
	* Speak_Narrator.c		* Speak_Narrator.c
Line 403:		Line 403:
	The following code fragment shows the basics of how to perform reads from the narrator device. For a more complete example, see the sample program at the end of this article. For this fragment, take the code of the previous write example as a starting point. Then the following code would need to be added:		The following code fragment shows the basics of how to perform reads from the narrator device. For a more complete example, see the sample program at the end of this article. For this fragment, take the code of the previous write example as a starting point. Then the following code would need to be added:

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	struct mouth_rb MouthIO; / Pointer to read IORequest block */		struct mouth_rb MouthIO; / Pointer to read IORequest block */
	struct MsgPort MouthMP; / Pointer to read message port */		struct MsgPort MouthMP; / Pointer to read message port */
Line 763:		Line 763:

	== Example Speech and Mouth Movement Program ==		== Example Speech and Mouth Movement Program ==
	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	/*		/*
	* Full_Narrator.c		* Full_Narrator.c

Janne Peräaho at 15:26, 22 January 2019

2019-01-22T15:26:33Z

← Older revision		Revision as of 15:26, 22 January 2019
Line 308:		Line 308:
	/* Create the message port */		/* Create the message port */
	VoiceMP = IExec->AllocSysObjectTags ( ASOT_PORT, TAG_END );		VoiceMP = IExec->AllocSysObjectTags ( ASOT_PORT, TAG_END );

⚫	/* Create the I/O request */
⚫	VoiceIO = IExec->AllocSysObjectTags (
⚫	ASOT_IOREQUEST,
⚫	ASOIOR_Size, sizeof ( struct narrator_rb ),
⚫	ASOIOR_ReplyPort, VoiceMP,
⚫	TAG_END );

	/* Message port exists */		/* Message port exists */
	if ( VoiceMP ) {		if ( VoiceMP ) {
		⚫	/* Create the I/O request */
		⚫	VoiceIO = IExec->AllocSysObjectTags (
		⚫	ASOT_IOREQUEST,
		⚫	ASOIOR_Size, sizeof ( struct narrator_rb ),
		⚫	ASOIOR_ReplyPort, VoiceMP,
		⚫	TAG_END );

	/* I/O request exists */		/* I/O request exists */
	if ( VoiceIO ) {		if ( VoiceIO ) {

Janne Peräaho at 15:15, 22 January 2019

2019-01-22T15:15:49Z

← Older revision		Revision as of 15:15, 22 January 2019
Line 355:		Line 355:
	IExec->FreeSysObject ( ASOT_IOREQUEST, VoiceIO );		IExec->FreeSysObject ( ASOT_IOREQUEST, VoiceIO );
	}		}
	/* Inform user that the I/O request could be created */		/* Inform user that the I/O request could not be created */
	else {		else {
	IDOS->Printf( "Error: Could not create I/O request\n" );		IDOS->Printf( "Error: Could not create I/O request\n" );

Janne Peräaho: Ported the Speak_Narrator.c example to AmigaOS 4.x

2019-01-22T13:23:29Z

Ported the Speak_Narrator.c example to AmigaOS 4.x

Show changes

Janne Peräaho: Source code contained html entitities. Replaced the entities with the actual characters.

2019-01-16T20:25:22Z

Source code contained html entitities. Replaced the entities with the actual characters.

← Older revision		Revision as of 20:25, 16 January 2019
Line 415:		Line 415:
	* (1) Create a message port for the read request.		* (1) Create a message port for the read request.
	*/		*/
	if (!(MouthMP = CreatePort(~~"~~narrator_read~~"~~, 0L)))		if (!(MouthMP = CreatePort("narrator_read", 0L)))
	BellyUp(~~"~~Read CreatePort failed~~"~~);		BellyUp("Read CreatePort failed");

	/*		/*
Line 422:		Line 422:
	*/		*/
	if (!(MouthIO = (struct mouth_rb *)CreateExtIO(MouthMP, sizeof(struct mouth_rb))))		if (!(MouthIO = (struct mouth_rb *)CreateExtIO(MouthMP, sizeof(struct mouth_rb))))
	BellyUp(~~"~~Read CreateExtIO failed~~"~~);		BellyUp("Read CreateExtIO failed");

	/*		/*
Line 428:		Line 428:
	* We assume that the write IORequest and the OpenDevice have been done		* We assume that the write IORequest and the OpenDevice have been done
	*/		*/
	MouthIO-~~>~~voice = *SpeakIO;		MouthIO->voice = *SpeakIO;
	MouthIO-~~>~~voice.message.io_Message.mn_ReplyPort = ReadMsgPort;		MouthIO->voice.message.io_Message.mn_ReplyPort = ReadMsgPort;
	MouthIO-~~>~~voice.message.io_Command = CMD_READ;		MouthIO->voice.message.io_Command = CMD_READ;

	/*		/*
Line 438:		Line 438:
	*/		*/

	SpeakIO-~~>~~mouths = 1; /* Generate mouth shape changes */		SpeakIO->mouths = 1; /* Generate mouth shape changes */
	SpeakIO-~~>~~flags = NDF_NEWIORB \| /* Indicates V37 style IORequest */		SpeakIO->flags = NDF_NEWIORB \| /* Indicates V37 style IORequest */
	NDF_WORDSYNC \| /* Request start-of-word sync events */		NDF_WORDSYNC \| /* Request start-of-word sync events */
	NDF_SYLSYNC; /* Request start-of-syllable sync events */		NDF_SYLSYNC; /* Request start-of-syllable sync events */
Line 458:		Line 458:
	*/		*/

	for (DoIO(MouthIO);MouthIO-~~>~~voice.message.io_Error != ND_NoWrite;DoIO(MouthIO))		for (DoIO(MouthIO);MouthIO->voice.message.io_Error != ND_NoWrite;DoIO(MouthIO))
	{		{
	if (MouthIO-~~>~~sync &~~amp;~~ 0x01) DoMouthShape();		if (MouthIO->sync & 0x01) DoMouthShape();
	if (MouthIO-~~>~~sync &~~amp;~~ 0x02) DoWordSync();		if (MouthIO->sync & 0x02) DoWordSync();
	if (MouthIO-~~>~~sync &~~amp;~~ 0x04) DoSyllableSync();		if (MouthIO->sync & 0x04) DoSyllableSync();
	}		}

Janne Peräaho: Source code contained html entitities. Replaced the entities with the actual characters.

2019-01-16T20:20:10Z

Source code contained html entitities. Replaced the entities with the actual characters.

← Older revision		Revision as of 20:20, 16 January 2019
Line 295:		Line 295:
	*/		*/

	#include ~~<~~exec/types.h~~>~~		#include <exec/types.h>
	#include ~~<~~exec/exec.h~~>~~		#include <exec/exec.h>
	#include ~~<~~dos/dos.h~~>~~		#include <dos/dos.h>
	#include ~~<~~devices/narrator.h~~>~~		#include <devices/narrator.h>

	#include ~~<~~clib/exec_protos.h~~>~~		#include <clib/exec_protos.h>
	#include ~~<~~clib/alib_protos.h~~>~~		#include <clib/alib_protos.h>
	#include ~~<~~clib/dos_protos.h~~>~~		#include <clib/dos_protos.h>

	#include ~~<~~string.h~~>~~		#include <string.h>
	#include ~~<~~stdio.h~~>~~		#include <stdio.h>

	#ifdef LATTICE		#ifdef LATTICE
Line 316:		Line 316:
	struct MsgPort *VoiceMP;		struct MsgPort *VoiceMP;
	struct narrator_rb *VoiceIO;		struct narrator_rb *VoiceIO;
	UBYTE *PhoneticText = ~~"~~DHIHS IHZ AHMIY5GAH SPIY5KIHNX.~~"~~;		UBYTE *PhoneticText = "DHIHS IHZ AHMIY5GAH SPIY5KIHNX.";
	BYTE audio_chan[4] = {3, 5, 10, 12};		BYTE audio_chan[4] = {3, 5, 10, 12};

Line 326:		Line 326:
	{		{
	/* Set the NEWIORB bit in the flags field to use the new fields */		/* Set the NEWIORB bit in the flags field to use the new fields */
	VoiceIO-~~>~~flags = NDF_NEWIORB;		VoiceIO->flags = NDF_NEWIORB;

	/* Open the narrator device */		/* Open the narrator device */
	if (OpenDevice(~~"~~narrator.device~~"~~,0,(struct IORequest *)VoiceIO,0L))		if (OpenDevice("narrator.device",0,(struct IORequest *)VoiceIO,0L))

	/* Inform user that it could not be opened */		/* Inform user that it could not be opened */
	printf(~~"~~Error: narrator.device did not open\n~~"~~);		printf("Error: narrator.device did not open\n");

	else		else
	{		{
	/* Speak the string using the default parameters */		/* Speak the string using the default parameters */
	VoiceIO-~~>~~ch_masks = &~~amp;~~audio_chan[0];		VoiceIO->ch_masks = &audio_chan[0];
	VoiceIO-~~>~~nm_masks = sizeof(audio_chan);		VoiceIO->nm_masks = sizeof(audio_chan);
	VoiceIO-~~>~~message.io_Command = CMD_WRITE;		VoiceIO->message.io_Command = CMD_WRITE;
	VoiceIO-~~>~~message.io_Data = PhoneticText;		VoiceIO->message.io_Data = PhoneticText;
	VoiceIO-~~>~~message.io_Length = strlen(PhoneticText);		VoiceIO->message.io_Length = strlen(PhoneticText);
	DoIO(VoiceIO);		DoIO(VoiceIO);

Line 350:		Line 350:
	*/		*/

	VoiceIO-~~>~~A1adj = -32; /* Shut off first formant */		VoiceIO->A1adj = -32; /* Shut off first formant */
	VoiceIO-~~>~~A3adj = 11; /* Raise the third formant */		VoiceIO->A3adj = 11; /* Raise the third formant */
	VoiceIO-~~>~~centralize = 50; /* Move 50% of the way */		VoiceIO->centralize = 50; /* Move 50% of the way */
	VoiceIO-~~>~~centphon = ~~"~~AO~~"~~; /* towards AO */		VoiceIO->centphon = "AO"; /* towards AO */
	DoIO(VoiceIO);		DoIO(VoiceIO);

Line 364:		Line 364:
	else		else
	/* Inform user that the I/O request could be created */		/* Inform user that the I/O request could be created */
	printf(~~"~~Error: Could not create I/O request\n~~"~~);		printf("Error: Could not create I/O request\n");

	/* Delete the message port */		/* Delete the message port */
Line 371:		Line 371:
	else		else
	/* Inform user that the message port could not be created */		/* Inform user that the message port could not be created */
	printf(~~"~~Error: Could not create message port\n~~"~~);		printf("Error: Could not create message port\n");
	}		}
	</syntaxhighlight>		</syntaxhighlight>

Janne Peräaho: Corrected source code markings """ and ">". They should have been " and >.

2019-01-16T20:13:24Z

Corrected source code markings """ and ">". They should have been " and >.

← Older revision		Revision as of 20:13, 16 January 2019
Line 136:		Line 136:
	struct narrator_rb *VoiceIO;		struct narrator_rb *VoiceIO;

	if (VoiceMP = CreatePort(~~"~~speech_write~~"~~,0))		if (VoiceMP = CreatePort("speech_write",0))
	if (VoiceIO = (struct narrator_rb *)		if (VoiceIO = (struct narrator_rb *)
	CreateExtIO(VoiceMP,sizeof(struct narrator_rb));		CreateExtIO(VoiceMP,sizeof(struct narrator_rb));
	if (OpenDevice(~~"~~narrator.device~~"~~, 0, VoiceIO, 0))		if (OpenDevice("narrator.device", 0, VoiceIO, 0))
	printf(~~"~~narrator.device did not open\n~~"~~);		printf("narrator.device did not open\n");
	</syntaxhighlight>		</syntaxhighlight>

Line 161:		Line 161:
	struct mouth_rb *MouthIO;		struct mouth_rb *MouthIO;

	if (MouthMP = CreatePort(~~"~~narrator_read~~"~~, 0))		if (MouthMP = CreatePort("narrator_read", 0))
	if (!(MouthIO = (struct mouth_rb *)		if (!(MouthIO = (struct mouth_rb *)
	AllocMem(sizeof(struct mouth_rb),MEMF_PUBLIC\|MEMF_CLEAR)))		AllocMem(sizeof(struct mouth_rb),MEMF_PUBLIC\|MEMF_CLEAR)))
	{		{
	MouthIO-~~>~~voice = VoiceIO; / Copy I/O request used in OpenDevice */		MouthIO->voice = VoiceIO; / Copy I/O request used in OpenDevice */
	MouthIO-~~>~~voice.message.io_Message.mn_ReplyPort = MouthMP; /* Set port */		MouthIO->voice.message.io_Message.mn_ReplyPort = MouthMP; /* Set port */
	}		}
	else		else
	printf(~~"~~AllocMem failed\n~~"~~);		printf("AllocMem failed\n");
	else		else
	printf(~~"~~CreatePort failed\n~~"~~);		printf("CreatePort failed\n");
	</syntaxhighlight>		</syntaxhighlight>

Janne Peräaho: Added phonemes LX and RX

2019-01-05T22:40:54Z

Added phonemes LX and RX

← Older revision		Revision as of 22:40, 5 January 2019
Line 593:		Line 593:
	\|-		\|-
	\| DX \|\| pi'''ty''' \|\| tongue flap		\| DX \|\| pi'''ty''' \|\| tongue flap
			\|-
			\| LX \|\| fa'''ll''' \|\|
			\|-
			\| RX \|\| st'''ar''' \|\|
	\|-		\|-
	\| Q \|\| kitt('''Q''')en \|\| glottal stop		\| Q \|\| kitt('''Q''')en \|\| glottal stop

Janne Peräaho: Source code contained erroneously html entities. Replaced them with the correct characters.

2019-01-03T17:34:21Z

Source code contained erroneously html entities. Replaced them with the correct characters.

Show changes

Janne Peräaho at 17:20, 3 January 2019

2019-01-03T17:20:37Z

← Older revision		Revision as of 17:20, 3 January 2019
Line 764:		Line 764:

	== Example Speech and Mouth Movement Program ==		== Example Speech and Mouth Movement Program ==
			<syntaxhighlight>

	~~<pre>~~/*		/*
	* Full_Narrator.c		* Full_Narrator.c
	*		*
Line 1,330:		Line 1,330:
	Draw(FaceRast, XMouthCenter, YMouthCenter + LipHeight);		Draw(FaceRast, XMouthCenter, YMouthCenter + LipHeight);
	Draw(FaceRast, XMouthCenter - LipWidth, YMouthCenter);		Draw(FaceRast, XMouthCenter - LipWidth, YMouthCenter);
			}
	}</pre>
			</syntaxhighlight>

	== Additional Information on the Narrator Device ==		== Additional Information on the Narrator Device ==