/// ------------------------------------------------------------------------------------
        /// <summary>
        /// Translates a SAMA music transcription and writes it to a MusicXML file.
        /// </summary>
        /// ------------------------------------------------------------------------------------
        public void ExportMusicXML(string SAMAString, string fileName)
        {
            if (SAMAString == string.Empty)
            {
                File.Delete(fileName);
                return;
            }

            MusicXML musicXML = new MusicXML(SAMAString);

            //
            musicXML.Save(fileName);
        }
        /// ------------------------------------------------------------------------------------
        /// <summary>
        /// Reads the MusicXML transcription from the XML database and translates it to SAMA.
        /// </summary>
        /// ------------------------------------------------------------------------------------
        public string ReadAsMusicXML()
        {
            MusicXML musicXML   = new MusicXML();
            string   samaString = string.Empty;
            bool     bReturn    = false;

            if (File.Exists(m_doc.MusicXMLFile))
            {
                if (musicXML.Load(m_doc.MusicXMLFile))
                {
                    samaString = musicXML.ToSAMA_String(ref bReturn);

                    if (bReturn == false)
                    {
                        MessageBox.Show("Error: Problem converting MusicXML to SAMA.");
                    }
                }
            }

            return(samaString);
        }
        /// ------------------------------------------------------------------------------------
        /// <summary>
        /// Imports a MusicXML file and translates it to SAMA.
        /// </summary>
        /// ------------------------------------------------------------------------------------
        public string ImportMusicXML(string fileName)
        {
            MusicXML musicXML   = new MusicXML();
            string   samaString = "";

            //
            if (!musicXML.Load(fileName))
            {
                MessageBox.Show("Error loading MusicXML file.");
            }
            else
            {
                bool bReturn = false;
                samaString = musicXML.ToSAMA_String(ref bReturn);
                if (bReturn == false)
                {
                    MessageBox.Show("Error: Problem comverting MusicXML to SAMA.");
                }
            }

            return(samaString);
        }