MathCATForPython/Example/test.py at GUIHandleLanguageVariants · daisy/MathCATForPython

Repository navigation

# MathCAT add-on: generates speech, braille, and allows exploration of expressions written in MathML

# The goal of this add-on is to replicate/improve on the functionality of MathPlayer which has been discontinued.

# Author: Neil Soiffer

# Copyright: this file uses whatever GNU copyright that is required for NVDA addons

# The code additionally makes use of the MathCAT library (written in Rust) which is covered by the MIT license

# and also (obviously) requires external speech engines and braille drivers.

import os

# import shutil

# if os.path.exists("libmathcat_py.pyd"):

# os.remove("libmathcat_py.pyd")

# shutil.copy("..\\target\\i686-pc-windows-msvc\\release\\libmathcat_py.dll", "libmathcat.pyd")

import libmathcat

def SetMathCATPreferences():

try:

libmathcat.SetRulesDir(

# this assumes the Rules dir is in the same dir a the library. Modify as needed

os.path.join( os.path.dirname(os.path.abspath(__file__)), "Rules")

)

except Exception as e:

print("problem with finding the MathCAT rules")

try:

libmathcat.SetPreference("TTS", "none")

libmathcat.SetPreference("Language", "en") # Also "id" and "vi"

libmathcat.SetPreference("SpeechStyle", "SimpleSpeak") # Also "ClearSpeak"

libmathcat.SetPreference("Verbosity", "Verbose") # also terse "Terse"/"Medium"

libmathcat.SetPreference("CapitalLetters_UseWord", "true") # if "true", X => "cap x"

except Exception as e:

print("problem with setting a preference")

def SetMathMLForMathCAT(mathml: str):

try:

libmathcat.SetMathML(mathml)

except Exception as e:

print("problem with SetMathML")

def GetSpeech():

try:

return libmathcat.GetSpokenText()

except Exception as e:

return "problem with getting speech for MathML"

SetMathCATPreferences() # you only need to this once

print("Using MathCAT version '{}'".format(libmathcat.GetVersion()))

mathml = "<math><mfrac> <mn>1</mn> <mi>X</mi> </mfrac> </math>"

SetMathMLForMathCAT(mathml)