Module libmathcat::interface

The interface module provides functionality both for calling from an API and also running the code from main.

Constants

• MATHML_INSTANCE
  The current node being navigated (also spoken and brailled) is stored in MATHML_INSTANCE.

Functions

• do_navigate_command
  Given a navigation command, the current node is moved accordingly. This is a higher level interface than do_navigate_keypress for applications that want to interpret the keys themselves. The valid commands are:
• do_navigate_keypress
  Given a key code along with the modifier keys, the current node is moved accordingly (or value reported in some cases). key is the keycode for the key (in JavaScript, ev.key_code) The spoken text for the new current node is returned.
• errors_to_string
  Convert the returned error from set_mathml, etc., to a useful string for display
• get_braille
  Get the braille associated with the MathML that was set by set_mathml. The braille returned depends upon the preference for the code preference (default Nemeth).
• get_element
• get_navigation_mathml
  Return the MathML associated with the current (navigation) node. The returned result is the id of the node and the offset (0-based) from that node (not yet implemented) The offset is needed for token elements that have multiple characters.
• get_navigation_mathml_id
  Return the id and offset (0-based) associated with the current (navigation) node. offset (not yet implemented) The offset is needed for token elements that have multiple characters.
• get_overview_text
  Get the spoken text for an overview of the MathML that was set. The speech takes into account any AT or user preferences. Note: this implementation for is currently minimal and should not be used.
• get_preference
  Get the value of the named preference. None is returned if name is not a known preference.
• get_spoken_text
  Get the spoken text of the MathML that was set. The speech takes into account any AT or user preferences.
• get_version
  Returns the version number (from Cargo.toml) of the build
• is_same_element
  returns Ok() if two Documents are equal or some info where they differ in the Err
• set_mathml
  This will override any previous MathML that was set. This returns canonical MathML with ’id’s set on any node that doesn’t have an id. The ids can be used for sync highlighting if the Bookmark API preference is true.
• set_preference
  Set a MathCAT preference. The preference name should be a known preference name. The value should either be a string or a number (depending upon the preference being set) The list of known user preferences is in the MathCAT user documentation. Here are common preferences set by programs (not settable by the user):
• set_rules_dir
  Set the Rules directory IMPORTANT: this should be the very first call to MathCAT unless the environment var MathCATRulesDir is set
• trim_element
  Not really meant to be public – used by tests in some packages