marytts.features

Class FeatureRegistry

java.lang.Object

marytts.features.FeatureRegistry

public class FeatureRegistry
extends Object

Author:

marc

Method Summary

Methods

Modifier and Type	Method and Description
static FeatureProcessorManager	determineBestFeatureProcessorManager(Locale locale) For the given locale, return the best feature manager.
static FeatureProcessorManager	determineBestFeatureProcessorManager(Voice voice) For the given voice, return the best feature manager.
static FeatureProcessorManager	getFallbackFeatureProcessorManager() Get the fallback feature processor manager which should be used if there is no voice- or locale-specific feature processor manager.
static FeatureProcessorManager	getFeatureProcessorManager(Locale locale) Get the feature processor manager associated with the given locale, if any.
static FeatureProcessorManager	getFeatureProcessorManager(Voice voice) Get the feature processor manager associated with the given voice, if any.
static Collection<Locale>	getSupportedLocales()
static TargetFeatureComputer	getTargetFeatureComputer(FeatureProcessorManager mgr, String features) Obtain a TargetFeatureComputer that knows how to compute features for a Target using the given set of feature processor names.
static TargetFeatureComputer	getTargetFeatureComputer(Locale locale, String features) Convenience method for getting a suitable target feature computer for the given locale and list of features.
static TargetFeatureComputer	getTargetFeatureComputer(Voice voice, String features) Convenience method for getting a suitable target feature computer for the given voice and list of features.
static void	setFallbackFeatureProcessorManager(FeatureProcessorManager mgr) Set the given feature processor manager as the one to use when no voice- or locale-specific feature processor manager can be found.
static void	setFeatureProcessorManager(Locale locale, FeatureProcessorManager mgr) Set the given feature processor manager as the one to use for the given locale.
static void	setFeatureProcessorManager(Voice voice, FeatureProcessorManager mgr) Set the given feature processor manager as the one to use for the given voice.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

setFeatureProcessorManager

public static void setFeatureProcessorManager(Locale locale,
                              FeatureProcessorManager mgr)

Set the given feature processor manager as the one to use for the given locale.

Parameters:

locale - locale

mgr - mgr

setFallbackFeatureProcessorManager

public static void setFallbackFeatureProcessorManager(FeatureProcessorManager mgr)

Set the given feature processor manager as the one to use when no voice- or locale-specific feature processor manager can be found.

Parameters:

mgr - mgr

setFeatureProcessorManager

public static void setFeatureProcessorManager(Voice voice,
                              FeatureProcessorManager mgr)

Set the given feature processor manager as the one to use for the given voice.

Parameters:

voice - voice

mgr - mgr

getFeatureProcessorManager

public static FeatureProcessorManager getFeatureProcessorManager(Voice voice)

Get the feature processor manager associated with the given voice, if any.

Parameters:

voice - voice

Returns:

the feature processor manager, or null if there is no voice-specific feature processor manager.

getFeatureProcessorManager

public static FeatureProcessorManager getFeatureProcessorManager(Locale locale)

Get the feature processor manager associated with the given locale, if any.

Parameters:

locale - locale

Returns:

the feature processor manager, or null if there is no locale-specific feature processor manager.

getFallbackFeatureProcessorManager

public static FeatureProcessorManager getFallbackFeatureProcessorManager()

Get the fallback feature processor manager which should be used if there is no voice- or locale-specific feature processor manager.

Returns:

fallbackManager

determineBestFeatureProcessorManager

public static FeatureProcessorManager determineBestFeatureProcessorManager(Voice voice)

For the given voice, return the best feature manager. That is either the voice-specific feature manager, if any, or the locale-specific feature manager, if any, or the language-specific feature manager, if any, or the fallback feature manager.

Parameters:

voice - voice

Returns:

a feature processor manager object. If this returns null, something is broken.

determineBestFeatureProcessorManager

public static FeatureProcessorManager determineBestFeatureProcessorManager(Locale locale)

For the given locale, return the best feature manager. That is either the locale-specific feature manager, if any, or the language-specific feature manager, if any, or the fallback feature manager.

Parameters:

locale - locale

Returns:

a feature processor manager object. If this returns null, something is broken.

getSupportedLocales

public static Collection<Locale> getSupportedLocales()

getTargetFeatureComputer

public static TargetFeatureComputer getTargetFeatureComputer(FeatureProcessorManager mgr,
                                             String features)

Obtain a TargetFeatureComputer that knows how to compute features for a Target using the given set of feature processor names. These names must be known to the given Feature processor manager.

Parameters:

mgr - mgr

features - a String containing the names of the feature processors to use, separated by white space, and in the right order (byte-valued discrete feature processors first, then short-valued, then continuous). If features is null, use all available features processors.

Returns:

a target feature computer

Throws:

IllegalArgumentException - if one of the features is not known to the manager

getTargetFeatureComputer

public static TargetFeatureComputer getTargetFeatureComputer(Locale locale,
                                             String features)

Convenience method for getting a suitable target feature computer for the given locale and list of features. A feature processor for the given locale is looked up using getFeatureProcessorManager(Locale) or, if that fails, using getFallbackFeatureProcessorManager().

Parameters:

locale - locale

features - a String containing the names of the feature processors to use, separated by white space, and in the right order (byte-valued discrete feature processors first, then short-valued, then continuous)

Returns:

a target feature computer

See Also:

getTargetFeatureComputer(FeatureProcessorManager, String)

getTargetFeatureComputer

public static TargetFeatureComputer getTargetFeatureComputer(Voice voice,
                                             String features)

Convenience method for getting a suitable target feature computer for the given voice and list of features. A feature processor for the given voice is looked up using getFeatureProcessorManager(Voice) or, if that fails, using getFeatureProcessorManager(Locale) using the voice locale or, if that also fails, using getFallbackFeatureProcessorManager().

Parameters:

voice - voice

features - a String containing the names of the feature processors to use, separated by white space, and in the right order (byte-valued discrete feature processors first, then short-valued, then continuous)

Returns:

a target feature computer

See Also:

getTargetFeatureComputer(FeatureProcessorManager, String)