001/**
002 * Portions Copyright 2001 Sun Microsystems, Inc.
003 * Portions Copyright 1999-2001 Language Technologies Institute, 
004 * Carnegie Mellon University.
005 * All Rights Reserved.  Use is subject to license terms.
006 * 
007 * See the file "license.terms" for information on usage and
008 * redistribution of this file, and for a DISCLAIMER OF ALL 
009 * WARRANTIES.
010 */
011package com.sun.speech.freetts.lexicon;
012
013/**
014 * Provides the phone list for words using letter-to-sound rules.  The
015 * phone list is implementation dependent.
016 */
017public interface LetterToSound {
018    /**
019     * Calculate the phone list for a given word.  If a phone list
020     * cannot be determined, <code>null</code> is returned.  The phone
021     * list is implementation dependent.  The format of the
022     * <code>partOfSpeech</code> is also implementation.  If the
023     * <code>partOfSpeech</code> does not matter, pass in <code>null</code>.
024     *
025     * @param word the word to get the phone list for
026     * @param partOfSpeech the part of speech or <code>null</code>
027     *
028     * @return the list of phones for word or <code>null</code>
029     */
030    String[] getPhones(String word, String partOfSpeech);
031}
032
033
034