matthiasm@8: %
matthiasm@8: %CHORD2NOTES Convert chord symbol to list of constituent notes
matthiasm@8: % 
matthiasm@8: % [chordnotes, bassnote, success, errormessage] = chord2notes(chordsymbol, {verbose})
matthiasm@8: % 
matthiasm@8: % Converts a chord symbol to a cell array of note strings and a bassnote string.
matthiasm@8: %
matthiasm@8: % In the case of the 'no chord' symbol 'N' function returns an empty array
matthiasm@8: %
matthiasm@8: % Success = 1 if notes extracted from chordsymbol correctly, 0 otherwise.
matthiasm@8: % 
matthiasm@8: % If optional argument 'verbose' is 1, function prints any errormessage to 
matthiasm@8: % the screen.
matthiasm@8: % 
matthiasm@8: % calls:    getnoteinfo
matthiasm@8: %           parsenote
matthiasm@8: %           addshort2list
matthiasm@8: %           degree2note
matthiasm@8: % 
matthiasm@8: % returns:  chordnotes  (cell array of note strings)
matthiasm@8: %           bassnote (string)           
matthiasm@8: %           success (boolean)
matthiasm@8: %           errormessage (string)
matthiasm@8: %
matthiasm@8: %
matthiasm@8: % Author: Christopher Harte,  August 2005
matthiasm@8: % 
matthiasm@8: % Copyright: Centre for Digital Music, Queen Mary University of London 2005 
matthiasm@8: %
matthiasm@8: % This file is part of the C4DM Chord Toolkit.  
matthiasm@8: %
matthiasm@8: % The C4DM Chord Toolkit is free software; you can redistribute it and/or 
matthiasm@8: % modify it under the terms of the GNU General Public License as published 
matthiasm@8: % by the Free Software Foundation; either version 2 of the License, or
matthiasm@8: % (at your option) any later version.
matthiasm@8: %
matthiasm@8: % The C4DM Chord Toolkit is distributed in the hope that it will be useful,
matthiasm@8: % but WITHOUT ANY WARRANTY; without even the implied warranty of
matthiasm@8: % MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
matthiasm@8: % GNU General Public License for more details.
matthiasm@8: %
matthiasm@8: % You should have received a copy of the GNU General Public License
matthiasm@8: % along with the C4DM Toolkit; if not, write to the Free Software
matthiasm@8: % Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
matthiasm@8: 
matthiasm@8: %             
matthiasm@8: function [chordnotes, bassnote, success, errormessage] = chord2notes(chordsymbol, verbose)
matthiasm@8: 
matthiasm@8: % set verbose default to 0
matthiasm@8: if nargin < 2
matthiasm@8:     verbose = 0;
matthiasm@8: end
matthiasm@8: 
matthiasm@8: errormessage = '';
matthiasm@8: mainlist = '';
matthiasm@8: success = 1;
matthiasm@8: chordnotes = [];
matthiasm@8: bassnote = '';
matthiasm@8: 
matthiasm@8: % parse the chordsymbol
matthiasm@8: [rootnote,shorthand,degreelist,bass, success, errormessage] = getchordinfo(chordsymbol);
matthiasm@8: 
matthiasm@8: 
matthiasm@8: 
matthiasm@8: 
matthiasm@8: %if 'no chord' then return N
matthiasm@8: if (success == 1)
matthiasm@8:     
matthiasm@8: 
matthiasm@8:     
matthiasm@8:     if rootnote == 'N'
matthiasm@8:         
matthiasm@8:         chordnotes = [];
matthiasm@8:     else
matthiasm@8: 
matthiasm@8: 
matthiasm@8:         % combine shorthand and degreelist and obtain note names for each
matthiasm@8:         % degree
matthiasm@8:         if success
matthiasm@8: 
matthiasm@8:             [mainlist, success, errormessage] = addshort2list(shorthand, degreelist);
matthiasm@8: 
matthiasm@8:             if success
matthiasm@8: 
matthiasm@8:                 % convert list of degrees to list of notes 
matthiasm@8:                 [chordnotes,success,errormessage] = degrees2notes(mainlist,rootnote);
matthiasm@8:                  
matthiasm@8:             end
matthiasm@8: 
matthiasm@8:         end
matthiasm@8: 
matthiasm@8:         % Now find the bass note
matthiasm@8: 
matthiasm@8:         if success
matthiasm@8: 
matthiasm@8:             if ~isempty(bass)
matthiasm@8: 
matthiasm@8:                 [bassnote,success,errormessage] = degree2note(bass, rootnote);
matthiasm@8: 
matthiasm@8:                 if success
matthiasm@8:                     
matthiasm@8:                     ilength = length(chordnotes);
matthiasm@8:                     index = 1;
matthiasm@8:                     while index<=ilength
matthiasm@8:                         if char(bassnote) == char(chordnotes(index))
matthiasm@8:                             index = ilength +1;
matthiasm@8:                             contains = 1;
matthiasm@8:                         else
matthiasm@8:                             contains = 0;
matthiasm@8:                             index = index +1;
matthiasm@8:                         end
matthiasm@8:                     end
matthiasm@8:                     
matthiasm@8:                     if contains == 0
matthiasm@8:                         
matthiasm@8:                         chordnotes = [bassnote; chordnotes];
matthiasm@8:                     end
matthiasm@8:                 end
matthiasm@8:             else
matthiasm@8:                 bassnote = rootnote;
matthiasm@8:             end
matthiasm@8: 
matthiasm@8: 
matthiasm@8:         end
matthiasm@8:     end
matthiasm@8: end
matthiasm@8: 
matthiasm@8: if success == 0
matthiasm@8:     errormessage = [errormessage sprintf(['Error in chord2notes: Couldn''t convert chord"' chordsymbol '"\n'])];   
matthiasm@8:     if verbose ==1
matthiasm@8:        fprintf(1,errormessage);
matthiasm@8:     end
matthiasm@8:        
matthiasm@8:        
matthiasm@8: end  
matthiasm@8:     
matthiasm@8:     
matthiasm@8: