sub Element (Microsoft.Speech)

Microsoft Speech Platform SDK 11

Collapse image Expand Image Copy image CopyHover image

Specifies a string of text to speak in place of the text contained in the element.

Syntax

XML Copy imageCopy Code
<sub alias="string"> </sub>

Attributes

Attribute

Description

alias

Required. Specifies the substitute text.

Remarks

Before synthesizing a phrase, the text-to-speech (TTS) engine normalizes it. The normalization process converts symbols, numbers, and other non-orthographic entities into text representing the spoken value of these entities. For example, normalization converts "$1.99" into "one dollar and ninety-nine cents."

Use a sub element to create a custom text value for any text element. Because the TTS engine processes sub elements before normalizing the phrase, the substitute text is normalized before being synthesized.

Example

XML Copy imageCopy Code
<?xml version="1.0" encoding="ISO-8859-1"?>
<speak version="1.0"
 xmlns ="http://www.w3.org/2001/10/synthesis"
 xml:lang="en-US">

  <!--Instruct the text-to-speech engine to pronounce
  the string "SAPI" as "Speech Application Programming Interface"-->

  <sub alias="Speech Application Programming Interface"> SAPI </sub>

</speak>