ravenField-access/ScreenReader.cs at main · blindpro/ravenField-access · GitHub

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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
using System;
using System.Runtime.InteropServices;

namespace RavenfieldAccessibility
{
    /// <summary>
    /// Tolk screen reader abstraction wrapper.
    /// Requires Tolk.dll (native) in the game directory alongside screen reader vendor DLLs.
    /// </summary>
    public static class ScreenReader
    {
        [DllImport("Tolk.dll", CharSet = CharSet.Unicode, CallingConvention = CallingConvention.Cdecl)]
        private static extern void Tolk_Load();

        [DllImport("Tolk.dll", CharSet = CharSet.Unicode, CallingConvention = CallingConvention.Cdecl)]
        [return: MarshalAs(UnmanagedType.I1)]
        private static extern bool Tolk_IsLoaded();

        [DllImport("Tolk.dll", CharSet = CharSet.Unicode, CallingConvention = CallingConvention.Cdecl)]
        private static extern void Tolk_Unload();

        [DllImport("Tolk.dll", CharSet = CharSet.Unicode, CallingConvention = CallingConvention.Cdecl)]
        private static extern void Tolk_TrySAPI([MarshalAs(UnmanagedType.I1)] bool trySAPI);

        [DllImport("Tolk.dll", CharSet = CharSet.Unicode, CallingConvention = CallingConvention.Cdecl)]
        private static extern void Tolk_PreferSAPI([MarshalAs(UnmanagedType.I1)] bool preferSAPI);

        [DllImport("Tolk.dll", CharSet = CharSet.Unicode, CallingConvention = CallingConvention.Cdecl)]
        private static extern IntPtr Tolk_DetectScreenReader();

        [DllImport("Tolk.dll", CharSet = CharSet.Unicode, CallingConvention = CallingConvention.Cdecl)]
        [return: MarshalAs(UnmanagedType.I1)]
        private static extern bool Tolk_HasSpeech();

        [DllImport("Tolk.dll", CharSet = CharSet.Unicode, CallingConvention = CallingConvention.Cdecl)]
        [return: MarshalAs(UnmanagedType.I1)]
        private static extern bool Tolk_HasBraille();

        [DllImport("Tolk.dll", CharSet = CharSet.Unicode, CallingConvention = CallingConvention.Cdecl)]
        [return: MarshalAs(UnmanagedType.I1)]
        private static extern bool Tolk_Output(
            [MarshalAs(UnmanagedType.LPWStr)] string str,
            [MarshalAs(UnmanagedType.I1)] bool interrupt);

        [DllImport("Tolk.dll", CharSet = CharSet.Unicode, CallingConvention = CallingConvention.Cdecl)]
        [return: MarshalAs(UnmanagedType.I1)]
        private static extern bool Tolk_Speak(
            [MarshalAs(UnmanagedType.LPWStr)] string str,
            [MarshalAs(UnmanagedType.I1)] bool interrupt);

        [DllImport("Tolk.dll", CharSet = CharSet.Unicode, CallingConvention = CallingConvention.Cdecl)]
        [return: MarshalAs(UnmanagedType.I1)]
        private static extern bool Tolk_Braille(
            [MarshalAs(UnmanagedType.LPWStr)] string str);

        [DllImport("Tolk.dll", CharSet = CharSet.Unicode, CallingConvention = CallingConvention.Cdecl)]
        [return: MarshalAs(UnmanagedType.I1)]
        private static extern bool Tolk_IsSpeaking();

        [DllImport("Tolk.dll", CharSet = CharSet.Unicode, CallingConvention = CallingConvention.Cdecl)]
        [return: MarshalAs(UnmanagedType.I1)]
        private static extern bool Tolk_Silence();

        private static bool _initialized;

        public static void Load()
        {
            Tolk_TrySAPI(true);
            Tolk_Load();
            _initialized = Tolk_IsLoaded();
        }

        public static bool IsLoaded() => _initialized && Tolk_IsLoaded();

        public static void Unload()
        {
            if (_initialized)
            {
                Tolk_Unload();
                _initialized = false;
            }
        }

        public static string DetectScreenReader()
        {
            return Marshal.PtrToStringUni(Tolk_DetectScreenReader());
        }

        public static bool HasSpeech() => Tolk_HasSpeech();
        public static bool HasBraille() => Tolk_HasBraille();

        /// <summary>
        /// Send text to screen reader (speech + braille).
        /// </summary>
        public static bool Output(string text, bool interrupt = false)
        {
            if (!_initialized || string.IsNullOrEmpty(text)) return false;
            return Tolk_Output(text, interrupt);
        }

        /// <summary>
        /// Speech-only output.
        /// </summary>
        public static bool Speak(string text, bool interrupt = false)
        {
            if (!_initialized || string.IsNullOrEmpty(text)) return false;
            return Tolk_Speak(text, interrupt);
        }

        /// <summary>
        /// Braille-only output.
        /// </summary>
        public static bool Braille(string text)
        {
            if (!_initialized || string.IsNullOrEmpty(text)) return false;
            return Tolk_Braille(text);
        }

        public static bool IsSpeaking() => _initialized && Tolk_IsSpeaking();

        public static bool Silence()
        {
            if (!_initialized) return false;
            return Tolk_Silence();
        }
    }
}