Add copy as "speech"

Fixes #83

Author: NSoiffer

addon/globalPlugins/MathCAT/MathCAT.py

@@ -203,7 +203,8 @@ def ConvertSSMLTextForNVDA(text: str) -> list:
 
 
 class MathCATInteraction(mathPres.MathInteractionNVDAObject):
-    # Put MathML on the clipboard using the two formats below (defined by MathML spec)
+    # Put MathML or other formats on the clipboard.
+    # MathML is put on the clipboard using the two formats below (defined by MathML spec)
     # We use both formats because some apps may only use one or the other
     # Note: filed https://github.com/nvaccess/nvda/issues/13240 to make this usable outside of MathCAT
     CF_MathML = windll.user32.RegisterClipboardFormatW("MathML")
@@ -352,7 +353,20 @@ def script_rawdataToClip(self, gesture: KeyboardInputGesture):
                     )  # copy will fix up name spacing
                 elif self.init_mathml != "":
                     mathml = self.init_mathml
-                text_to_copy = self._wrapMathMLForClipBoard(mathml)
+                if copy_as == "speech":
+                    # save the old MathML, set the navigation MathML as MathMl, get the speech, then reset the MathML
+                    saved_mathml: str = self.init_mathml
+                    saved_tts = libmathcat.GetPreference("TTS")
+                    if saved_mathml == '':      # shouldn't happen
+                        raise Exception("Internal error -- MathML not set for copy")
+                    libmathcat.SetPreference("TTS", "None")
+                    libmathcat.SetMathML(mathml)
+                    # get the speech text and collapse the whitespace
+                    text_to_copy = ' '.join(libmathcat.GetSpokenText().split())
+                    libmathcat.SetPreference("TTS", saved_tts)
+                    libmathcat.SetMathML(saved_mathml)
+                else:
+                    text_to_copy = self._wrapMathMLForClipBoard(mathml)
 
             self._copyToClipAsMathML(text_to_copy, copy_as == "mathml")
             # Translators: copy to clipboard

addon/globalPlugins/MathCAT/MathCATPreferences.py

@@ -37,7 +37,7 @@
 # Navigation_OverView is boolean
 Navigation_NavVerbosity = ("Terse", "Medium", "Verbose")
 # Navigation_AutoZoomOut is boolean
-Navigation_CopyAs = ("MathML", "LaTeX", "ASCIIMath")
+Navigation_CopyAs = ("MathML", "LaTeX", "ASCIIMath", "Speech")
 Braille_BrailleNavHighlight = ("Off", "FirstChar", "EndPoints", "All")
 
 
@@ -638,8 +638,8 @@ def validate_user_preferences():
         UserInterface.validate("Navigation", "NavVerbosity", ["Terse", "Medium", "Full"], "Medium")
         #  AutoZoomOut: true           # Auto zoom out of 2D exprs (use shift-arrow to force zoom out if unchecked)
         UserInterface.validate("Navigation", "AutoZoomOut", [False, True], True)
-        #  CopyAs: MathML        # MathML, LaTeX, ASCIIMath
-        UserInterface.validate("Navigation", "CopyAs", ["MathML", "LaTeX", "ASCIIMath"], "MathML")
+        #  CopyAs: MathML        # MathML, LaTeX, ASCIIMath, Speech
+        UserInterface.validate("Navigation", "CopyAs", ["MathML", "LaTeX", "ASCIIMath", "Speech"], "MathML")
         # Braille:
         #  BrailleNavHighlight: EndPoints
         # Highlight with dots 7 & 8 the current nav node -- values are Off, FirstChar, EndPoints, All

addon/globalPlugins/MathCAT/MathCATgui.py

@@ -584,6 +584,8 @@ def __init__(self, parent):
             _("LaTeX"),
             # Translators: options for Copy expression to clipboard as -- "ASCIIMath"
             _("ASCIIMath"),
+            # Translators: options for Copy expression to clipboard as -- speech text
+            _("Speech"),
         ]
         self.m_choiceCopyAs = wx.Choice(
             self.m_panelNavigation,