org.daisy.pipeline.tts.Voice Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of tts-common Show documentation
Common API for TTS functionality
There is a newer version: 7.2.0
package org.daisy.pipeline.tts;

import java.util.Arrays;
import java.util.Collection;
import java.util.Collections;
import java.util.List;
import java.util.Locale;
import java.util.Optional;

import com.google.common.collect.Collections2;

import org.daisy.pipeline.tts.VoiceInfo.Gender;
import org.daisy.pipeline.tts.VoiceInfo.LanguageRange;

/**
 * Voice instances are expected to be created only by TTSEngine/TTSService implementations
 */
public class Voice {

	// the upper-case versions need to be kept because some TTS Processors like SAPI
	// are case-sensitive. Lower-case versions are only used for comparison.
	private final String engine;
	private final String name;
	private final MarkSupport markSupport;
	private final Collection locale;
	private final Optional gender;

	public enum MarkSupport {
		DEFAULT,
		MARK_SUPPORTED,
		MARK_NOT_SUPPORTED
	}

	public Voice(String engine, String name) {
		this(engine, name, Collections.emptyList(), null, MarkSupport.DEFAULT);
	}

	/**
	 * @throws IllegalArgumentException if language or gender can not be parsed.
	 */
	public Voice(String engine, String name, Locale locale, Gender gender) throws IllegalArgumentException {
		this(engine,
		     name,
		     locale != null ? new LanguageRange(locale) : null,
		     gender);
	}

	public Voice(String engine, String name, LanguageRange locale, Gender gender) throws IllegalArgumentException {
		this(engine,
		     name,
		     Optional.ofNullable(locale).map(x -> listOf(x)).orElseGet(Collections::emptyList),
		     gender,
		     MarkSupport.DEFAULT);
	}

	public Voice(String engine, String name, Collection locale, Gender gender) throws IllegalArgumentException {
		this(engine, name, Collections2.transform(locale, LanguageRange::new), gender, MarkSupport.DEFAULT);
	}

	public Voice(String engine, String name, Collection locale, Gender gender, MarkSupport markSupport)
			throws IllegalArgumentException {
		// we keep the strings in their full case form because some engines might be case sensitive
		this.engine = engine == null ? "" : engine;
		this.name = name == null ? "" : name;
		this.locale = Collections.unmodifiableCollection(locale);
		this.gender = Optional.ofNullable(gender);
		this.markSupport = markSupport;
	}

	// see List.of() method in Java 9
	private static  List listOf(E element) {
		if (element == null)
			throw new NullPointerException();
		return Collections.unmodifiableList(Arrays.asList(element));
	}

	public String getName() {
		return name;
	}

	public String getEngine() {
		return engine;
	}

	public MarkSupport getMarkSupport() {
		return markSupport;
	}

	/**
	 * The language range(s) of this voice, or empty if it is not known.
	 */
	public Collection getLocale() {
		return locale;
	}

	/**
	 * The gender of this voice, or absent if it is not known.
	 */
	public Optional getGender() {
		return gender;
	}

	public int hashCode() {
		return engine.toLowerCase().hashCode() ^ name.toLowerCase().hashCode();
	}

	public boolean equals(Object other) {
		if (other == null)
			return false;
		Voice v2 = (Voice)other;
		return engine.equalsIgnoreCase(v2.engine) && name.equalsIgnoreCase(v2.name);
	}

	public String toString() {
		StringBuilder s = new StringBuilder();
		boolean first = true;
		s.append("{");
		if (!engine.isEmpty()) {
			s.append("engine: ").append(engine);
			first = false;
		}
		if (!name.isEmpty()) {
			if (!first) s.append(", ");
			s.append("name: ").append(name);
			first = false;
		}
		if (!locale.isEmpty()) {
			if (!first) s.append(", ");
			s.append("locale: ");
			if (locale.size() > 1) s.append("\"");
			s.append(LanguageRange.toString(locale));
			if (locale.size() > 1) s.append("\"");
			first = false;
		}
		if (gender.isPresent()) {
			if (!first) s.append(", ");
			s.append("gender:").append(gender.get());
		}
		s.append("}");
		return s.toString();
	}
}