jm.music.rt.RTPhrase Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jmusic Show documentation
JMusic - Java Music Library
The newest version!
/*
 
 
 Copyright (C) 2000 Andrew Sorensen & Andrew Brown
 
 This program is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation; either version 2 of the License, or any
 later version.
 
 This program is distributed in the hope that it will be useful, but
 WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 GNU General Public License for more details.
 
 You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. 
 */

/**
 * This class used to parse a Phrase note by note to real time playback.
 * @author Andrew R. Brown
 */

package jm.music.rt;

import jm.JMC;
import jm.audio.Instrument;
import jm.music.data.Note;
import jm.music.data.Phrase;

public class RTPhrase extends RTLine implements JMC {
    private Phrase phrase;
    private int noteCounter = 0;
    private boolean waitForStartTime = true;
    private Note aRest = new Note(REST, 1.0);

    /**
     * constructor that takes a phrase and a single instrument as arguments.
     *
     * @param phrase The Phrase to stream
     * @param inst   The instrument to render the notes with.
     */
    public RTPhrase(final Phrase phrase, final Instrument inst) {
        this(phrase, new Instrument[]{inst});
    }

    /**
     * Constructor that takes a phrase and an instrument array as arguments.
     * Normally the array conatins multiple instances of the same instrument
     * which are used as required when there are overlapping notes.
     *
     * @param phrase    The Phrase to stream
     * @param instArray The instruments to render the notes with.
     */

    public RTPhrase(final Phrase phrase, final Instrument[] instArray) {
        super(instArray);
        this.phrase = phrase;
        if (phrase.getTempo() != Phrase.DEFAULT_TEMPO) this.setTempo(phrase.getTempo());
        if (phrase.getStartTime() == 0.0) waitForStartTime = false;
    }

    /**
     * Generate the next note when requested.
     */
    public synchronized Note getNextNote() {
        // default value for slience
        aRest.setRhythmValue(1.0);
        // wait for start time
        if (waitForStartTime) {
            //System.out.println("RTPhrase padded rest");
            waitForStartTime = false;
            aRest.setRhythmValue(phrase.getStartTime());
            return aRest;
        }
        // stream notes
        if (noteCounter < phrase.getSize()) {
            //System.out.println("RTPhrase note " + noteCounter + " Phrase size:" + phrase.getSize());
            return phrase.getNote(noteCounter++);
        } else return aRest;
    }

}