sapi-lite 0.1.1

A simplified wrapper around Microsoft's Speech API (SAPI) library
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

use std::ffi::OsString;
use std::ops::{Deref, DerefMut};

use windows as Windows;
use Windows::Win32::Media::Speech::SPPHRASEPROPERTY;

use super::SemanticValue;

/// A tree of values that forms part of the semantic information for a recognized phrase.
#[derive(Debug, PartialEq, Clone)]
pub struct SemanticTree {
    /// The value at the root of this tree.
    pub value: SemanticValue<OsString>,
    /// The sub-trees that form this tree.
    pub children: Vec<SemanticTree>,
}

impl SemanticTree {
    pub(crate) fn from_sapi(sapi_prop: Option<&SPPHRASEPROPERTY>) -> Vec<Self> {
        let mut result = Vec::new();
        let mut next_prop = sapi_prop;
        while let Some(prop) = next_prop {
            if let Ok(value) = SemanticValue::from_sapi(prop) {
                result.push(SemanticTree {
                    value,
                    children: SemanticTree::from_sapi(unsafe { prop.pFirstChild.as_ref() }),
                });
            }
            next_prop = unsafe { prop.pNextSibling.as_ref() };
        }
        result
    }
}

impl Deref for SemanticTree {
    type Target = Vec<SemanticTree>;

    fn deref(&self) -> &Self::Target {
        &self.children
    }
}

impl DerefMut for SemanticTree {
    fn deref_mut(&mut self) -> &mut Self::Target {
        &mut self.children
    }
}