Class MidiFileGenerator

packages/alphatab/src/midi/MidiFileGenerator.ts:94–2470

 * @public
 */
export class MidiFileGenerator {
    private static readonly _defaultDurationDead: number = 30;
    private static readonly _defaultDurationPalmMute: number = 80;

    private readonly _score: Score;
    private _settings: Settings;
    private _handler: IMidiFileHandler;
    private _programsPerChannel: Map<number, number> = new Map<number, number>();

    private _currentTime: number = 0;
    private _calculatedBeatTimers: Set<number> = new Set<number>();

    /**
     * Gets a lookup object which can be used to quickly find beats and bars
     * at a given midi tick position.
     */
    public readonly tickLookup: MidiTickLookup = new MidiTickLookup();

    /**
     * Gets or sets whether transposition pitches should be applied to the individual midi events or not.
     */
    public applyTranspositionPitches: boolean = true;

    /**
     * The computed sync points for synchronizing the midi file with an external backing track.
     */
    public syncPoints: BackingTrackSyncPoint[] = [];

    /**
     * Gets the transposition pitches for the individual midi channels.
     */
    public readonly transpositionPitches: Map<number, number> = new Map<number, number>();

    /**
     * Initializes a new instance of the {@link MidiFileGenerator} class.
     * @param score The score for which the midi file should be generated.
     * @param settings The settings ot use for generation.
     * @param handler The handler that should be used for generating midi events.
     */
    public constructor(score: Score, settings: Settings | null, handler: IMidiFileHandler) {
        this._score = score;
        this._settings = !settings ? new Settings() : settings;
        this._handler = handler;
    }

    /**
     * Starts the generation of the midi file.
     */
    public generate(): void {
        this.transpositionPitches.clear();
        this._calculatedBeatTimers.clear();
        this._currentTime = 0;

        // initialize tracks
        for (const track of this._score.tracks) {
            this._generateTrack(track);
        }