LV_SRE_CreateParseTree

Returns a handle to a speech parse tree, representing the sentence structure of what was decoded by the Speech Engine, according to the active grammars. When done with the parse tree handle, it must be released with LVParseTree_Release.

Function

• H_PARSE_TREE LV_SRE_CreateParseTree(HPORT hport, int voicechannel, int index)

Parameters

hport

A handle to the speech port.

voicechannel

The audio channel containing the input audio

index

It is possible to have more than one parse tree for an utterance (for instance if the grammar is ambiguous); this is the index of the tree

Return Value

The return type is a handle to a parse tree object. If an error occurs, NULL is returned.

Remarks

A parse tree and the parse string returned are logically the same. However, a speech parse tree makes it easy to search for useful information.

The H_PARSE_TREE handle can be manipulated using the functions in the LVParseTree C API.

See Also

• LV_SRE_GetNumberOfParses
• LV_SRE_GetParseTreeString
• Introduction to Parse Trees
• LVSpeechPort::GetParseTree (C++ API)