ActiveX Control

Allgemeines

Das ActiveX Control stellt für Applikationen eine Verbindung zum Logox 4 Server her.

Die Applikationen schicken Aufträge an das ActiveX Control, welche asynchron durch den Logox 4 Server bearbeitet werden. Mit dem Benachrichtigunsmechanismus können die Applikationen synchron zu einer Sprachausgabe reagieren.

Benutzung des ActiveX Controls

Über die Eigenschaften des ActiveX Controls können Lautstärke, Tonhöhe etc. voreingestellt werden. Durch Aufrufe entsprechender Funktionen werden diese jedoch überschrieben. Auch die Nachrichtennummern für NotifyAction, NotifySentence, NotifyWord etc. können über die Eigenschaften oder durch die entsprechende Funktionen vergeben werden.

Nachrichtenbehandlungsmethoden können hinzugefügt und ausgewertet werden. Sie müssen dafür dann eine entsprechende Nachrichtennummer vergeben.

Funktionen des ActiveX Controls

Anbindung von Applikationen mit dem ActiveX Control.

DLLVersion

LONG DLLVersion(VOID )

Abfrage der Logox 4 DLL Versionsnummer.

Rückgabewert

DLL Versionsnummer als 32 Bit Wert. Das höchstwertige Byte enthält die Hauptversionsnummer.

Parameter

: keine

Kommentar

Sie können die einzelnen Bestandteile mit den Makrofunktionen in der Datei Lgx4.h extrahieren:

#define LOGOX_LONGBYTE3(v) ((unsigned char)((v)>>24))
#define LOGOX_LONGBYTE2(v) ((unsigned char)((v)>>16))
#define LOGOX_LONGBYTE1(v) ((unsigned char)((v)>>8))
#define LOGOX_LONGBYTE0(v) ((unsigned char)(v))

Beispiel

unsigned long nVersion=Logox.DLLVersion();

if( nVersion>=0x04000000 )
{
	char szVersion[16];

	sprintf( szVersion,"%d.%d.%d.%d",
			( nVersion>>24 )&0xFF,
			( nVersion>>16 )&0xFF,
			( nVersion>> 8 )&0xFF,
			  nVersion      &0xFF );

	// Versionsstring 'szVersion' enthält die Logox DLL Versionsnummer.
}

Siehe Auch

ServerVersion

LONG ServerVersion(VOID )

Abfrage der Logox 4 Server Versionsnummer.

Rückgabewert

Versionsnummer des Logox Servers als 32 Bit Wert. Das höchstwertige Byte enthält die Hauptversionsnummer.

Parameter

: keine

Kommentar

Beispiel

unsigned long nVersion=Logox.ServerVersion();

if( nVersion>=0x04000000 )
{
	char szVersion[16];

	sprintf( szVersion,"%d.%d.%d.%d",
			( nVersion>>24 )&0xFF,
			( nVersion>>16 )&0xFF,
			( nVersion>> 8 )&0xFF,
			  nVersion      &0xFF );

	// Versionsstring 'szVersion' enthält die Server Versionsnummer.
}

Siehe Auch

DLLVersion

License

BOOL License(LPCSTR License)

Angabe der Lizenzierungsinformation.

Rückgabewert

Ergebnis der Lizenzierung:

TRUE: Die Lizenzangaben wurden korrekt übergeben.
FALSE: Es ist ein Fehler aufgetreten.

Parameter

License: Lizenzierungsstring

Kommentar

Sie müssen erst die Lizenzierung vornehmen, bevor Sie vollen Zugriff auf den Logox Server erhalten.

Beispiel

if( Logox.License( "MeineLizenzierungsangaben" ) )
{
	// Lizenzierungsangaben wurden übergeben

	Logox.Initialize();
}

Siehe Auch

Initialize

BOOL Initialize(VOID )

Initialisiert den Logox 4 Server. Ein bereits aktiver Logox 4 Server wird gesucht und mit der Applikation verbunden. Wurde kein aktiver Logox 4 Server gefunden, wird dieser automatisch gestartet.

Rückgabewert

Ergebnis der Initialisierung:

TRUE: Initialisierung war erfolgreich.
FALSE: Es ist ein Fehler bei der Initialisierung aufgetreten.

Parameter

: keine

Kommentar

Sie sollten vor dem Aufruf dieser Funktion die Anwendung mit License für den vollen Funktionsumfang lizenzieren.

Beispiel

if( Logox.License( "MeineLizenzierungsangaben" ) )
{
	if( Logox.Initialize() )
	{
		// ...
	}
}

Siehe Auch

License IsConnected Disconnect

IsConnected

BOOL IsConnected(VOID )

Überprüft die Verbindung zum Logox 4 Server.

Rückgabewert

Zustand der Verbindung:

TRUE: Die Applikation ist mit dem Server verbunden.
FALSE: Die Verbindung ist getrennt.

Parameter

: keine

Beispiel

if( Logox.IsConnected() )
{
	// Die Verbindung zum Logox 4 Server besteht.
}

Siehe Auch

Initialize Release

Disconnect

VOID Disconnect(VOID )

Trennt die Verbindung zum Logox 4 Server.

Parameter

: keine

Kommentar

Die Verbindung wird automatisch beim Beenden der Applikation getrennt.

Beispiel

if( Logox.IsConnected() )
{
	Logox.Disconnect();	// Verbindung zum Server beenden
}

Siehe Auch

Initialize IsConnected

Speak

BOOL Speak(LPCSTR Text, LONG ActionID)

Übergibt einen Text an den Logox 4 Server zum Sprechen.

Rückgabewert

Zustand der Textübergabe:

TRUE: Der Text wurde korrekt dem Server übergeben.
FALSE: Fehler beim Ausführen des Befehls.

Parameter

Text: Text für die Sprachausgabe.
ActionID: AktionsID für Benachrichtigungen (0 = keine Benachrichtigung)

Kommentar

Die einzelnen Texte werden der Reihe nach im Server abgelegt und gesprochen. Die Applikation kann sich benachrichtigen lassen, wann die Ausgabe eines (jeden) Textes beginnt und wann sie abgeschlossen ist.

Es werden die zuvor gesetzten Einstellungen für die Sprachausgabe benutzt.

Beispiel

Logox.Speak( "Guten Tag, dieses ist ein einfacher Text!", 0 );

Siehe Auch

Pause Resume Stop Record SetNotifyAction

Pause

BOOL Pause(VOID )

Eine aktuelle Sprachausgabe wird angehalten.

Rückgabewert

Funktionsrückgabewert:

TRUE: Die Sprachausgabe wird angehalten.
FALSE: Die Sprachausgabe konnte nicht angehalten werden.

Parameter

: keine

Kommentar

Mit dieser Funktion wird der aktuell gesprochene Text angehalten. Diese Funktion wirkt global, d.h. es ist unerheblich, welche Applikationen die Sprachausgabe aktiviert haben.

Beispiel

// Für die Implementierung einer Pause-Taste bietet sich folgendes Vorgehen an:

if( Logox.IsPaused() )
{
	Logox.Resume();
}
else
{
	Logox.Pause();
}

Siehe Auch

Speak Resume Stop

Resume

BOOL Resume(VOID )

Eine angehaltene Sprachausgabe wird fortgesetzt.

Rückgabewert

Funktionsrückgabewert

TRUE: Die Sprachausgabe wird fortgesetzt.
FALSE: Es ist ein Fehler aufgetreten.

Parameter

: keine

Kommentar

Diese Funktion arbeitet wie Pause global, d.h. es ist unerheblich, welche Applikation die Sprachausgabe angehalten hat, bzw. welche Applikation gerade spricht.

Siehe Auch

Speak Pause Stop

Stop

BOOL Stop(VOID )

Die Sprachausgabe wird abgebrochen.

Rückgabewert

Funktionsrückgabewert:

TRUE: Die Sprachausgabe wird abgebrochen, vorhandene Aufträge werden gelöscht.
FALSE: Es ist ein Fehler aufgetreten.

Parameter

: keine

Kommentar

Alle weiteren zu sprechenden Texte werden ebenfalls im Server gelöscht. Es ist unerheblich, welche Applikationen die Sprachausgabe aktiviert haben.

Siehe Auch

Speak Pause Resume

Record

BOOL Record(LPCSTR FileName, LPCSTR Text, LONG ActionID)

Wandelt einen Text in eine Wave Datei um.

Rückgabewert

Status der Textübergabe:

TRUE: Der Text wurde korrekt dem Server übergeben.
FALSE: Fehler beim Ausführen des Befehls.

Parameter

FileName: Name der Wave Datei.
Text: Umzuwandelnder Text.
ActionID: AktionsID (Angabe einer Zahl zwischen 1 und 65535 für Benachrichtigungen)

Kommentar

Der Text wird dem Server übergeben und anschließend in die angegebene Wave Datei umgewandelt.

Siehe Auch

SetAudioFormat GetAudioFormat SetNotifyAction

IsBusy

BOOL IsBusy(VOID )

Fragt ab, ob gerade Sprache ausgegeben wird.

Rückgabewert

Status der Sprachausgabe

TRUE: Es wird gerade Sprache ausgegeben.
FALSE: Es findet keine Sprachausgabe statt.

Parameter

: keine

Siehe Auch

Speak Pause Resume Stop Record

IsPaused

BOOL IsPaused(VOID )

Fragt ab, ob eine Sprachausgabe angehalten wurde.

Rückgabewert

Status der Sprachausgabe

TRUE: Die Sprachausgabe wurde angehalten.
FALSE: Die Sprachausgabe wurde nicht angehalten.

Parameter

: keine

Kommentar

Diese Funktion arbeitet global, d.h. es ist unerheblich, welche Applikation die Sprachausgabe angehalten hat.

Siehe Auch

Pause Resume

GetNumberOfFonts

LONG GetNumberOfFonts(VOID )

Ermittelt die derzeit im Logox 4 Server verfügbaren SpeechFonts^® .

Rückgabewert

Anzahl der verfügbaren SpeechFonts^® .

Parameter

: keine

Beispiel

// Alle im Server verfügbaren SpeechFonts abfragen

LONG nNumber = Logox.GetNumberOfFonts();
LONG nth;

for( nth=0; nth<nNumber; nth++ )
{
	CString Name;
	CString Alias;
	CString Uuid;
	SHORT   Day, Month, Year;
	SHORT	Hour, Minute;
	LONG    Version;
	LONG    Flags;

	Name    = Logox.GetFontName   ( nth );
	Alias   = Logox.GetFontAlias  ( nth );
	Uuid    = Logox.GetFontUUID   ( nth );
	Version = Logox.GetFontVersion( nth );
	Flags   = Logox.GetFontFlags  ( nth );
	Logox.GetFontDate( nth, &Day, &Month, &Year, &Hour, &Minute );
}

Siehe Auch

GetFontName GetFontAlias GetFontUUID GetFontVersion GetFontFlags GetFontDate

FindFontAlias

LONG FindFontAlias(LPCTSTR szAlias)

Sucht die Kurzbezeichnung (den Alias) in den SpeechFonts^® .

Rückgabewert

Index des SpeechFonts^® mit der Kurzbezeichnung, 0xFFFFFFFF = nicht gefunden.

Parameter

szAlias: Kurzbezeichnung des SpeechFonts^® (Alias).

Beispiel

// Sucht den SpeechFont mit dem Alias LGX.DE.SILKE und setzt diesen anschließend.

LONG Font = Logox.FindFontAlias( "LGX.DE.SILKE" );

Logox.SetLocalFont( Font );
Logox.Speak( "Text soll mit Silke gesprochen werden.", 0 );

// wenn der SpeechFont nicht gefunden wurde, wird der Standard Sprecher gewählt.

Siehe Auch

GetNumberOfFonts GetFontName GetFontAlias GetFontUUID GetFontDate GetFontVersion GetFontFlags

GetFontName

CString GetFontName(LONG nth)

Den Namen eines SpeechFonts^® abfragen.

Rückgabewert

Name des SpeechFonts^® .

Parameter

nth: Index des SpeechFonts^® .

Siehe Auch

GetNumberOfFonts GetFontAlias GetFontUUID GetFontDate GetFontVersion GetFontFlags

GetFontAlias

CString GetFontAlias(LONG nth)

Die Kurzbezeichnung (den Alias) des SpeechFonts^® abfragen.

Rückgabewert

Alias des SpeechFonts^® .

Parameter

nth: Index des SpeechFonts^® .

Siehe Auch

GetNumberOfFonts GetFontName GetFontUUID GetFontDate GetFontVersion GetFontFlags

GetFontUUID

CString GetFontUUID(LONG nth)

Die Identifizierungsnummer (UUID) des SpeechFonts^® abfragen.

Rückgabewert

UUID des SpeechFonts^® .

Parameter

nth: Index des SpeechFonts^® .

Siehe Auch

GetNumberOfFonts GetFontName GetFontAlias GetFontDate GetFontVersion GetFontFlags

GetFontDate

BOOL GetFontDate(LONG nth, SHORT * pDay, SHORT * pMonth, SHORT * pYear, SHORT * pHour, SHORT * pMinute)

Das Erstellungsdatum eines SpeechFonts^® abfragen.

Rückgabewert

Status der Abfrage:

TRUE: Das Datum konnte ermittelt werden.
FALSE: Fehler beim Ausführen des Befehls.

Parameter

nth: Index des SpeechFonts^® .
pDay: Tag der Erstellung.
pMonth: Monat der Erstellung.
pYear: Jahr der Erstellung.
pHour: Stunde der Erstellung.
pMinute: Minute der Erstellung.

Siehe Auch

GetNumberOfFonts GetFontName GetFontAlias GetFontUUID GetFontVersion GetFontFlags

GetFontVersion

LONG GetFontVersion(LONG nth)

Die Versionsnummer des SpeechFonts^® abfragen.

Rückgabewert

Versionsnummer.

Parameter

nth: Index des SpeechFonts^® .

Siehe Auch

GetNumberOfFonts GetFontName GetFontAlias GetFontUUID GetFontDate GetFontFlags

GetFontFlags

LONG GetFontFlags(LONG nth)

Weitere Flags des SpeechFonts^® abfragen.

Rückgabewert

Flags.

Parameter

nth: Index des SpeechFonts^® .

Siehe Auch

GetNumberOfFonts GetFontName GetFontAlias GetFontUUID GetFontDate GetFontVersion GetFontFlags

LoadSettings

BOOL LoadSettings(LPCTSTR ApplicationName)

Lädt die Sprechereinstellungen.

Rückgabewert

Ergebnis des Ladevorgangs:

TRUE: Die Sprechereinstellungen wurden für die Applikation eingeladen.
FALSE: Die Sprechereinstellungen konnten nicht geladen werden.

Parameter

ApplicationName: Name der Applikation.

Kommentar

Die Sprechereinstellungen umfassen: SpeechFont^® , Volume, Pitch, Speed, Intonation und Roughness. Benutzen Sie bitte immer eindeutige Applikationsbezeichnungen, um Konflikte zu vermeiden.

Siehe Auch

SaveSettings

BOOL SaveSettings(LPCTSTR ApplicationName)

Speichert die Sprechereinstellungen.

Rückgabewert

Ergebnis des Speichervorgangs.

TRUE: Die Sprechereinstellungen dieser Applikation wurden gespeichert.
FALSE: Die Sprechereinstellungen konnten nicht gespeichert werden.

Parameter

ApplicationName: Name der Applikation.

Kommentar

Die Sprechereinstellungen umfassen: SpeechFont^® , Volume, Pitch, Speed, Intonation und Roughness. Benutzen Sie bitte immer eindeutige Applikationsbezeichnungen, um Konflikte zu vermeiden.

Siehe Auch

LoadSettings

ResetLocal

BOOL ResetLocal(VOID )

Die Sprechereinstellungen werden auf Standardwerte gesetzt, der gewählte SpeechFont^® bleibt erhalten.

Rückgabewert

Status des Zurücksetzens

TRUE: Die Sprechereinstellungen wurden zurückgesetzt.
FALSE: Die Sprechereinstellungen konnten nicht zurückgesetzt werden.

Parameter

: keine

Kommentar

Folgende Sprechereinstellungen werden zurückgesetzt: AudioFormat, Volume, Pitch, Speed, Intonation und Roughness.

Siehe Auch

ResetGlobal

BOOL ResetGlobal(VOID )

Die globalen Sprechereinstellungen werden zurückgesetzt.

Rückgabewert

Status des Zurücksetzens.

TRUE: Die Sprechereinstellungen wurden zurückgesetzt.
FALSE: Die Sprechereinstellungen konnten nicht zurückgesetzt werden.

Parameter

: keine

Kommentar

Folgende Sprechereinstellungen werden zurückgesetzt: Volume, Pitch, Speed, Intonation und Roughness.

Siehe Auch

ResetLocal

SetAudioFormat

BOOL SetAudioFormat(LONG SamplesPerSec, SHORT BitsPerSample, SHORT Channels)

Setzt das AudioFormat für die Wave Datei Erstellung.

Rückgabewert

Ergebnis der Formatänderung:

TRUE: Das neue AudioFormat wurde gesetzt.
FALSE: Das AudioFormat konnte nicht geändert werden.

Parameter

SamplesPerSec: Samples pro Sekunde ( 8000, 11025, 12000, 16000, 22050, 24000, 32000, 44100, 48000 ).
BitsPerSample: Bits pro Sample ( 8, 16 ).
Channels: Anzahl der Kanäle ( 1, 2 )

Siehe Auch

Record GetAudioFormat

GetAudioFormat

BOOL GetAudioFormat(LONG * SamplesPerSec, SHORT * BitsPerSample, SHORT * Channels)

Abfrage des Audio Formats für die Wave Datei Erstellung.

Rückgabewert

Ergebnis der Abfrage:

TRUE: Das Aktuelle Audioformat konnte ermittelt werden.
FALSE: Es ist ein Fehler aufgetreten.

Parameter

SamplesPerSec: Samples pro Sekunde.
BitsPerSample: Bits pro Sample.
Channels: Anzahl der Kanäle

Siehe Auch

Record SetAudioFormat

SetLocalFont

BOOL SetLocalFont(LONG nth)

Setzt den SpeechFont^® für die Applikation.

Rückgabewert

Zustand der Auswahl:

TRUE: Der angegebene SpeechFont^® wurde gewählt.
FALSE: Fehler beim Ausführen des Befehls.

Parameter

nth: Index auf den SpeechFont^® .

Kommentar

Der SpeechFont^® wird in Form einer Indexnummer übergeben. Es gibt keine feste Reihenfolge für die im System befindlichen SpeechFonts^® . Die Indexnummer sollte z.B. über die Funktion FindFontAlias ermittelt werden.
Wählen Sie als SpeechFont^® die Nummer 0xFFFFFFFF (-1) dann wird jeweils der Standardsprecher für die Sprachausgaben gewählt. Dieser kann mit dem Logox 4 Server eingestellt werden.

Beispiel

// SpeechFont Silke setzen

LONG Font = Logox.FindFontAlias( "LGX.DE.SILKE" );

Logox.SetLocalFont( Font );
Logox.Speak( "Jetzt spreche ich mal mit Silke!" );

Logox.SetLocalFont( 0xFFFFFFFF );
Logox.Speak( "Jetzt wieder mit dem Standard SpeechFont!" );

Siehe Auch

GetLocalFont SetGlobalFont GetGlobalFont

GetLocalFont

LONG GetLocalFont(VOID )

Abfrage des eingestellten SpeechFonts^® .

Rückgabewert

Nummer des eingestellten SpeechFonts^® .

Parameter

: keine

Kommentar

Weitere Informationen über diesen SpeechFont^® erhält man mit den Font Funktionen (siehe GetFontName GetFontAlias GetFontUUID GetFontDate GetFontVersion GetFontFlags FindFontAlias).

Siehe Auch

SetLocalFont SetGlobalFont GetGlobalFont

SetGlobalFont

BOOL SetGlobalFont(LONG nth)

Setzt den SpeechFont^® global.

Rückgabewert

Zustand der Auswahl:

TRUE: Der angegebene SpeechFont^® wurde global gesetzt.
FALSE: Der SpeechFont^® konnte nicht gesetzt werden.

Parameter

nth: Index auf den SpeechFont^® .

Kommentar

Siehe Auch

SetLocalFont GetLocalFont GetGlobalFont

GetGlobalFont

LONG GetGlobalFont(VOID )

Fragt den globalen SpeechFont^® ab.

Rückgabewert

Nummer des eingestellten SpeechFonts^® .

Parameter

: keine

Kommentar

Weitere Informationen über diesen SpeechFont^® erhält man mit den Font Funktionen (siehe GetFontName GetFontAlias GetFontUUID GetFontDate GetFontVersion GetFontFlags FindFontAlias).

Siehe Auch

SetLocalFont SetGlobalFont GetGlobalFont

SetLocalVolume

BOOL SetLocalVolume(LONG Value)

Setzt die Lautstärke für diese Applikation.

Rückgabewert

Status der Lautstärkeänderung:

TRUE: Die angegebene Lautstärke wurde gesetzt.
FALSE: Die Lautstärke konnte nicht gesetzt werden.

Parameter

Value: Lautstärke in 1/10 dB.

Kommentar

Die Lautstärke wird in 1/10 dB angegeben. Ein möglicher Wertebereich liegt z.B. zwischen -980 und 120. Dies entspricht einer Lautstärke von -98dB bis 12dB.

Siehe Auch

GetLocalVolume SetGlobalVolume GetGlobalVolume

GetLocalVolume

LONG GetLocalVolume(VOID )

Abfrage der Lautstärke für diese Applikation.

Rückgabewert

Lokale Lautstärke in 1/10 dB.

Parameter

: keine

Siehe Auch

SetLocalVolume SetGlobalVolume GetGlobalVolume

SetGlobalVolume

BOOL SetGlobalVolume(LONG Value)

Setzt die globale Lautstärke.

Rückgabewert

Status der Lautstärkeänderung.

TRUE: Die angegebene Lautstärke wurde gesetzt.
FALSE: Die Laustärke konnte nicht gesetzt werden.

Parameter

Value: Lautstärke in 1/10 dB.

Kommentar

Die Lautstärke wird in 1/10 dB angegeben. Ein möglicher Wertebereich liegt z.B. zwischen -980 und 120. Dies entspricht einer Lautstärke von -98dB bis 12dB.

Siehe Auch

SetLocalVolume GetLocalVolume GetGlobalVolume

GetGlobalVolume

LONG GetGlobalVolume(VOID )

Abfrage der globalen Lautstärke.

Rückgabewert

Globale Lautstärke in 1/10 dB.

Parameter

: keine

Siehe Auch

SetLocalVolume GetLocalVolume SetGlobalVolume

SetLocalPitch

BOOL SetLocalPitch(LONG Value)

Setzt die Tonhöhe für diese Applikation.

Rückgabewert

Status der Tonhöhenänderung.

TRUE: Die angegebene Tonhöhe wurde gesetzt.
FALSE: Die Tonhöhe konnte nicht verändert werden.

Parameter

Value: Tonhöhe in 1/10 Hz.

Kommentar

Die Tonhöhe wird in 1/10 Hz angegeben. Ein möglicher Wertebereich liegt z.B. zwischen -1000 und 1000. Dies entspricht einer Tonhöhe von -100Hz bis 100Hz.

Siehe Auch

GetLocalPitch SetGlobalPitch GetGlobalPitch

GetLocalPitch

LONG GetLocalPitch(VOID )

Abfrage der Tonhöhe für diese Applikation.

Rückgabewert

Tonhöhe in 1/10 Hz.

Parameter

: keine

Siehe Auch

SetLocalPitch SetGlobalPitch GetGlobalPitch

SetGlobalPitch

BOOL SetGlobalPitch(LONG Value)

Setzt die globale Tonhöhe.

Rückgabewert

Status der Tonhöhenänderung:

TRUE: Die angegebene Tonhöhe wurde gesetzt.
FALSE: Die Tonhöhe konnte nicht verändert werden.

Parameter

Value: Tonhöhe in 1/10 Hz.

Kommentar

Die Tonhöhe wird in 1/10 Hz angegeben. Ein möglicher Wertebereich liegt z.B. zwischen -1000 und 1000. Dies entspricht einer Tonhöhe von -100Hz bis 100Hz.

Siehe Auch

SetLocalPitch GetLocalPitch GetGlobalPitch

GetGlobalPitch

LONG GetGlobalPitch(VOID )

Abfrage der globalen Tonhöhe.

Rückgabewert

Globale Tonhöhe in 1/10 Hz.

Parameter

: keine

Siehe Auch

SetLocalPitch GetLocalPitch SetGlobalPitch

SetLocalSpeed

BOOL SetLocalSpeed(LONG Value)

Setzt die Sprechgeschwindigkeit für diese Applikation.

Rückgabewert

Status der Sprechgeschwindigkeitsänderung:

TRUE: Die angegebene Sprechgeschwindigkeit wurde gesetzt.
FALSE: Die Sprechgeschwindigkeit konnte nicht verändert werden.

Parameter

Value: Sprechgeschwindigkeit in %.

Kommentar

Die Sprechgeschwindigkeit wird in % angegeben. Ein möglicher Wertebereich liegt z.B. zwischen 10 und 300. Dies entspricht einer Sprechgeschwindigkeit von 10% bis 300%.

Siehe Auch

GetLocalSpeed SetGlobalSpeed GetGlobalSpeed

GetLocalSpeed

LONG GetLocalSpeed(VOID )

Abfrage der Sprechgeschwindigkeit für diese Applikation.

Rückgabewert

Sprechgeschwindigkeit in %.

Parameter

: keine

Siehe Auch

SetLocalSpeed SetGlobalSpeed GetGlobalSpeed

SetGlobalSpeed

BOOL SetGlobalSpeed(LONG Value)

Setzt die globale Sprechgeschwindigkeit.

Rückgabewert

Status der Sprechgeschwindigkeitsänderung:

TRUE: Die angegebene Sprechgeschwindigkeit wurde gesetzt.
FALSE: Die Sprechgeschwindigkeit konnte nicht verändert werden.

Parameter

Value: Sprechgeschwindigkeit in %.

Kommentar

Die Sprechgeschwindigkeit wird in % angegeben. Ein möglicher Wertebereich liegt z.B. zwischen 10 und 300. Dies entspricht einer Sprechgeschwindigkeit von 10% bis 300%.

Siehe Auch

SetLocalSpeed GetLocalSpeed GetGlobalSpeed

GetGlobalSpeed

LONG GetGlobalSpeed(VOID )

Abfrage der globalen Sprechgeschwindigkeit.

Rückgabewert

Globale Sprechgeschwindigkeit in %.

Parameter

: keine

Siehe Auch

SetLocalSpeed GetLocalSpeed SetGlobalSpeed

SetLocalIntonation

BOOL SetLocalIntonation(LONG Value)

Setzt den Tonverlauf für diese Applikation.

Rückgabewert

Status der Änderung.

TRUE: Der angegebene Tonverlauf wurde gesetzt.
FALSE: Der Tonverlauf konnte nicht verändert werden.

Parameter

Value: Tonverlauf in %.

Kommentar

Der Tonverlauf wird in % angegeben. Ein möglicher Wertebereich liegt z.B. zwischen 0 und 300. Dies entspricht einem Tonverlauf von 0% bis 300%.

Siehe Auch

GetLocalIntonation SetGlobalIntonation GetGlobalIntonation

GetLocalIntonation

LONG GetLocalIntonation(VOID )

Abfrage des Tonverlaufs für diese Applikation.

Rückgabewert

Tonverlauf in %.

Parameter

: keine

Siehe Auch

SetLocalIntonation SetGlobalIntonation GetGlobalIntonation

SetGlobalIntonation

BOOL SetGlobalIntonation(LONG Value)

Setzt den globale Tonverlauf.

Rückgabewert

Status der Änderung.

TRUE: Der angegebene Tonverlauf wurde gesetzt.
FALSE: Der Tonverlauf konnte nicht verändert werden.

Parameter

Value: Tonverlauf in %.

Kommentar

Der Tonverlauf wird in % angegeben. Ein möglicher Wertebereich liegt z.B. zwischen 0 und 300. Dies entspricht einem Tonverlauf von 0% bis 300%.

Siehe Auch

SetLocalIntonation GetLocalIntonation GetGlobalIntonation

GetGlobalIntonation

LONG GetGlobalIntonation(VOID )

Abfrage des globalen Tonverlaufs.

Rückgabewert

Globaler Tonverlauf in %.

Parameter

: keine

Siehe Auch

SetLocalIntonation GetLocalIntonation SetGlobalIntonation

SetLocalRoughness

BOOL SetLocalRoughness(LONG Value)

Setzt die Rauheit für diese Applikation.

Rückgabewert

Status der Änderung:

TRUE: Die angegebene Rauheit wurde gesetzt.
FALSE: Die Rauheit konnte nicht verändert werden.

Parameter

Value: Rauheit in 1/10 Hz.

Kommentar

Die Rauheit wird in 1/10 Hz angegeben. Ein möglicher Wertebereich liegt z.B. zwischen 0 und 1000. Dies etspricht einer Rauheit von 0Hz bis 100Hz.

Siehe Auch

GetLocalRoughness SetGlobalRoughness GetGlobalRoughness

GetLocalRoughness

LONG GetLocalRoughness(VOID )

Abfrage der Rauheit für diese Applikation.

Rückgabewert

Rauheit in 1/10 Hz.

Parameter

: keine

Siehe Auch

SetLocalRoughness SetGlobalRoughness GetGlobalRoughness

SetGlobalRoughness

BOOL SetGlobalRoughness(LONG Value)

Setzt die globale Rauheit.

Rückgabewert

Status der Änderung:

TRUE: Die angegebene Rauheit wurde gesetzt.
FALSE: Die Rauheit konnte nicht verändert werden.

Parameter

Value: Rauheit in 1/10 Hz.

Kommentar

Die Rauheit wird in 1/10 Hz angegeben. Ein möglicher Wertebereich liegt z.B. zwischen 0 und 1000. Dies entspricht einer Rauheit von 0Hz bis 100Hz.

Siehe Auch

SetLocalRoughness GetLocalRoughness GetGlobalRoughness

GetGlobalRoughness

LONG GetGlobalRoughness(VOID )

Abfrage der globalen Rauheit.

Rückgabewert

Rauheit in 1/10 Hz.

Parameter

: keine

Siehe Auch

SetLocalRoughness GetLocalRoughness SetGlobalRoughness

NotifyModeLocal

BOOL NotifyModeLocal(VOID )

Stellt den Benachrichtigungsmodus auf lokal. Dieser Modus wird standardmäßig gesetzt: Die Applikation erhält die Nachrichten, die direkt die Applikation betreffen oder von dieser ausgelöst wurden.

Rückgabewert

Status des Moduswechsels:

TRUE: Der Benachrichtigungsmodus wurde auf lokal gesetzt.
FALSE: Der Benachrichtigungsmodus wurde nicht verändert.

Parameter

: keine

Beispiel

if( Logox.NotifyModeLocal() )
{
	// ab jetzt werden lokale Nachrichten an die Applikation geschickt.
}

Siehe Auch

NotifyModeGlobal SetNotifyAction SetNotifyMark SetNotifyChunk SetNotifyParam SetNotifySentence SetNotifyWord SetNotifyMouth SetNotifyViseme

NotifyModeGlobal

BOOL NotifyModeGlobal(VOID )

Stellt den Benachrichtigungsmodus auf global. Alle Nachrichten, also auch Nachrichten für andere Applikationen, werden an die Applikation geschickt.

Rückgabewert

Status des Moduswechsels:

TRUE: Der Benachrichtigunsmodus wurde auf global gesetzt.
FALSE: Der Benachrichtigungsmodus wurde nicht verändert.

Parameter

: keine

Beispiel

if( LogoxNotifyModeGlobal() )
{
	// ab jetzt werden alle Nachrichten an die Applikation geschickt.
}

Siehe Auch

NotifyModeLocal SetNotifyAction SetNotifyMark SetNotifyChunk SetNotifyParam SetNotifySentence SetNotifyWord SetNotifyMouth SetNotifyViseme

SetNotifyAction

BOOL SetNotifyAction(LONG Msg, LONG Handle)

Übergibt das Ziel für die Action-Nachrichten (ausgelöst durch die Angabe einer AktionsID bei Sprachausgaben).

Rückgabewert

Änderung des Benachrichtigungsziels:

TRUE: Das neue Ziel für die Benachrichtigung wurde gesetzt.
FALSE: Das Benachrichtigungsziel konnte nicht gesetzt werden.

Parameter

Msg: Message für die Nachricht.
Handle: Event Handle.

Kommentar

Die Benachrichtigungen in dem entsprechenden Benachrichtigungsmodus (siehe NotifyModeLocal NotifyModeGlobal) werden erst abgeschickt, wenn ein gültiges Ziel angeben wurde.

Ein gültiges Ziel besteht aus einer Nachrichtennummer, optional auch einem Eventhandle. Wenn die Nachrichtennummer auf 0 gesetzt wird, erhält die Applikation keine Nachrichten mehr von diesem Typ.

Beispiel

// Definition der Benutzernachricht

#define WM_LOGOX_ACTION	WM_USER + 0

// Bei der Initialisierung setzen Sie die Nachrichtennummer.

Logox.SetNotifyAction( WM_LOGOX_ACTION, NULL );

// Dann reagieren Sie auf die Nachricht WM_LOGOX_ACTION z.B. mit folgender Methode:

void CMyApp::OnNotifyAction( long ActionID, long Value )
{
	// ActionID enthält die Aktionsnummer
	// Value enthält 1 (Beginn der Aktion) oder 0 (Ende der Aktion)
}

Siehe Auch

NotifyModeLocal NotifyModeGlobal SetNotifyAction SetNotifyMark SetNotifyParam SetNotifySentence SetNotifyWord SetNotifyMouth SetNotifyViseme

SetNotifyMark

BOOL SetNotifyMark(LONG Msg, LONG Handle)

Übergabe des Ziels für die Mark-Nachrichten (diese werden durch Lesezeichen ausgelöst).

Rückgabewert

Änderung des Benachrichtigungsziels:

TRUE: Das neue Ziel für die Benachrichtigung wurde gesetzt.
FALSE: Das Benachrichtigungsziel konnte nicht gesetzt werden.

Parameter

Msg: Message für die Nachricht.
Handle: Event Handle.

Kommentar

Beispiel

// Definition der Benutzernachricht

#define WM_LOGOX_MARK	WM_USER + 1

// Bei der Initialisierung setzen Sie die Nachrichtennummer.

Logox.SetNotifyMark( WM_LOGOX_MARK, NULL );

// Dann reagieren Sie auf die Nachricht WM_LOGOX_MARK z.B. mit folgender Methode:

void CMyApp::OnNotifyMark( long Number )
{
	// Number enthält die BookMark Nummer
}

Siehe Auch

NotifyModeLocal NotifyModeGlobal SetNotifyAction SetNotifyMark SetNotifyParam SetNotifySentence SetNotifyWord SetNotifyMouth SetNotifyViseme

SetNotifyChunk

BOOL SetNotifyChunk(LONG Msg, LONG Handle)

Übergabe des Ziels für die Chunk-Nachrichten (diese werden bei Änderungen an den SpeechFonts^® ausgelöst, z.B. bei Sprecherwechsel, etc.).

Rückgabewert

Änderung des Benachrichtigungsziels:

TRUE: Das neue Ziel für die Benachrichtigung wurde gesetzt.
FALSE: Das Benachrichtigungsziel konnte nicht gesetzt werden.

Parameter

Msg: Message für die Nachricht.
Handle: Event Handle.

Kommentar

Beispiel

// Definition der Benutzernachricht

#define WM_LOGOX_CHUNK	WM_USER + 2

// Bei der Initialisierung setzen Sie die Nachrichtennummer.

Logox.SetNotifyChunk( WM_LOGOX_CHUNK, NULL );

// Dann reagieren Sie auf die Nachricht WM_LOGOX_CHUNK z.B. mit folgender Methode:

void CMyApp::OnNotifyChunk( long Fonts, long Chunks )
{
	// Fonts enthält die Anzahl der im Server verwalteten SpeechFonts
	// Chunks enthält die Anzahl der im Server verwalteten SpeechChunks
}

Siehe Auch

NotifyModeLocal NotifyModeGlobal SetNotifyAction SetNotifyMark SetNotifyParam SetNotifySentence SetNotifyWord SetNotifyMouth SetNotifyViseme

SetNotifyParam

BOOL SetNotifyParam(LONG Msg, LONG Handle)

Übergabe des Ziels für die Parameter-Nachrichten (diese werden bei Änderungen an den Einstellungen ausgelöst).

Rückgabewert

Änderung des Benachrichtigungsziels:

TRUE: Das neue Ziel für die Benachrichtigung wurde gesetzt.
FALSE: Das Benachrichtigungsziel konnte nicht gesetzt werden.

Parameter

Msg: Message für die Nachricht.
Handle: Event Handle.

Kommentar

Beispiel

// Definition der Benutzernachricht

#define WM_LOGOX_PARAM	WM_USER + 3

// Bei der Initialisierung setzen Sie die Nachrichtennummer.

Logox.SetNotifyParam( WM_LOGOX_PARAM, NULL );

// Dann reagieren Sie auf die Nachricht WM_LOGOX_PARAM z.B. mit folgender Methode:

void CMyApp::OnNotifyParam( long ParamID, long Value )
{
	// ParamID enthält die Parameter ID
	// Value enthält den Parameter Wert
}

Siehe Auch

NotifyModeLocal NotifyModeGlobal SetNotifyAction SetNotifyMark SetNotifyParam SetNotifySentence SetNotifyWord SetNotifyMouth SetNotifyViseme

SetNotifySentence

BOOL SetNotifySentence(LONG Msg, LONG Handle)

Übergabe des Ziels für die Satz-Nachrichten (diese werden bei der Sprachausgabe erzeugt).

Rückgabewert

Änderung des Benachrichtigungsziels:

TRUE: Das neue Ziel für die Benachrichtigung wurde gesetzt.
FALSE: Das Benachrichtigungsziel konnte nicht gesetzt werden.

Parameter

Msg: Message für die Nachricht.
Handle: Event Handle.

Kommentar

Beispiel

// Definition der Benutzernachricht

#define WM_LOGOX_SENTENCE	WM_USER + 4

// Bei der Initialisierung setzen Sie die Nachrichtennummer.

Logox.SetNotifySentence( WM_LOGOX_SENTENCE, NULL );

// Dann reagieren Sie auf die Nachricht WM_LOGOX_SENTENCE z.B. mit folgender Methode:

void CMyApp::OnNotifySentence( long Offset, long Length )
{
	// Offset enthält den Offset auf das erste Zeichen im aktuellen Satze.
	// Length enthält die Länge des aktuellen Satzes.
}

Siehe Auch

NotifyModeLocal NotifyModeGlobal SetNotifyAction SetNotifyMark SetNotifyParam SetNotifySentence SetNotifyWord SetNotifyMouth SetNotifyViseme

SetNotifyWord

BOOL SetNotifyWord(LONG Msg, LONG Handle)

Übergabe des Ziels für die Wort-Nachrichten (diese werden bei der Sprachausgabe erzeugt).

Rückgabewert

Änderung des Benachrichtigungsziels:

TRUE: Das neue Ziel für die Benachrichtigung wurde gesetzt.
FALSE: Das Benachrichtigungsziel konnte nicht gesetzt werden.

Parameter

Msg: Message für die Nachricht.
Handle: Event Handle.

Kommentar

Beispiel

// Definition der Benutzernachricht

#define WM_LOGOX_WORD	WM_USER + 5

// Bei der Initialisierung setzen Sie die Nachrichtennummer.

Logox.SetNotifyWord( WM_LOGOX_WORD, NULL );

// Dann reagieren Sie auf die Nachricht WM_LOGOX_WORD z.B. mit folgender Methode:

void CMyApp::OnNotifyWord( long Offset, long Length )
{
	// Offset enthält den Offset auf das erste Zeichen im aktuellen Wort.
	// Length enthält die Länge des aktuellen Wortes.
}

Siehe Auch

NotifyModeLocal NotifyModeGlobal SetNotifyAction SetNotifyMark SetNotifyParam SetNotifySentence SetNotifyWord SetNotifyMouth SetNotifyViseme

SetNotifyMouth

BOOL SetNotifyMouth(LONG Msg, LONG Handle)

Übergabe des Ziels für die Mund-Nachrichten (diese werden bei der Sprachausgabe erzeugt).

Rückgabewert

Änderung des Benachrichtigungsziels:

TRUE: Das neue Ziel für die Benachrichtigung wurde gesetzt.
FALSE: Das Benachrichtigungsziel konnte nicht gesetzt werden.

Parameter

Msg: Message für die Nachricht.
Handle: Event Handle.

Kommentar

Beispiel

// Definition der Benutzernachricht

#define WM_LOGOX_MOUTH	WM_USER + 6

// Bei der Initialisierung setzen Sie die Nachrichtennummer.

Logox.SetNotifyMouth( WM_LOGOX_MOUTH, NULL );

// Dann reagieren Sie auf die Nachricht WM_LOGOX_MOUTH z.B. mit folgender Methode:

void CMyApp::OnNotifyMouth( long Param1, long Param2 )
{
	unsigned char Mouth[ 8 ];

	memcpy( Mouth,     &Param1, 4 );
	memcpy( Mouth + 4, &Param2, 4 );

	// Mouth[0]	Höhe des Mundes
	// Mouth[1]	Breite des Mundes
	// Mouth[2] Wert für die Anhebung der Mundwinkel
	// Mouth[3] Wert für die Mundöffnung
	// Mouth[4] Angabe, wie weit die oberen Zähne zu sehen sind
	// Mouth[5] Angabe, wie weit die unteren Zähne zu sehen sind
	// Mouth[6] Wert für die Zungenposition
	// Mouth[7] Wert für die Spannung der Lippen
}

Siehe Auch

NotifyModeLocal NotifyModeGlobal SetNotifyAction SetNotifyMark SetNotifyParam SetNotifySentence SetNotifyWord SetNotifyMouth SetNotifyViseme

SetNotifyViseme

BOOL SetNotifyViseme(LONG Msg, LONG Handle)

Übergabe des Ziels für die Viseme-Nachrichten (diese werden bei der Sprachausgabe erzeugt).

Rückgabewert

Änderung des Benachrichtigungsziels:

TRUE: Das neue Ziel für die Benachrichtigung wurde gesetzt.
FALSE: Das Benachrichtigungsziel konnte nicht gesetzt werden.

Parameter

Msg: Message für die Nachricht.
Handle: Event Handle.

Kommentar

Beispiel

// Definition der Benutzernachricht

#define WM_LOGOX_VISEME	WM_USER + 7

// Bei der Initialisierung setzen Sie die Nachrichtennummer.

Logox.SetNotifyViseme( WM_LOGOX_VISEME, NULL );

// Dann reagieren Sie auf die Nachricht WM_LOGOX_VISEME z.B. mit folgender Methode:

void CMyApp::OnNotifyViseme( long Value )
{
	Value enthält das aktuelle Viseme (siehe SAPI 5 Viseme)
}

Siehe Auch

NotifyModeLocal NotifyModeGlobal SetNotifyAction SetNotifyMark SetNotifyParam SetNotifySentence SetNotifyWord SetNotifyMouth SetNotifyViseme

ActiveX Control

Allgemeines

Benutzung des ActiveX Controls

Funktionen des ActiveX Controls

Allgemeine Systemfunktionen (Anmelden, Abmelden, etc.)

Funktionen zur Sprachausgabe

Funktionen zur Sprecherverwaltung

Funktionen zum Einstellen des Sprechers

Funktionen für Benachrichtigungen

DLLVersion

Rückgabewert

Parameter

Kommentar

Beispiel

Siehe Auch

ServerVersion

Rückgabewert

Parameter

Kommentar

Beispiel

Siehe Auch

License

Rückgabewert

Parameter

Kommentar

Beispiel

Siehe Auch

Initialize

Rückgabewert

Parameter

Kommentar

Beispiel

Siehe Auch

IsConnected

Rückgabewert

Parameter

Beispiel

Siehe Auch

Disconnect

Parameter

Kommentar

Beispiel

Siehe Auch

Speak

Rückgabewert

Parameter

Kommentar

Beispiel

Siehe Auch

Pause

Rückgabewert

Parameter

Kommentar

Beispiel

Siehe Auch

Resume

Rückgabewert

Parameter

Kommentar

Siehe Auch

Stop

Rückgabewert

Parameter

Kommentar

Siehe Auch

Record

Rückgabewert

Parameter

Kommentar

Siehe Auch

IsBusy

Rückgabewert

Parameter

Siehe Auch

IsPaused

Rückgabewert

Parameter

Kommentar

Siehe Auch

GetNumberOfFonts