Track

The notes written for one channel of the chip, in the order they start. A track with a loop repeats that stretch for as long as the song plays.

Import

import { Track } from '@halleyfante/chiptune';

A track that loops

<button type="button" id="play">Play</button>
<button type="button" id="stop">Stop</button>

<script type="module">
  import { Chip, Note, Player, Pulse, Song, Track } from '@halleyfante/chiptune';

const settings = { duty: 25, volume: 12, envelope: 2 };
  const track = new Track({
    notes: [
      new Note({ frequency: 330, start: 0, length: 15, settings }),
      new Note({ frequency: 440, start: 30, length: 15, settings }),
      new Note({ frequency: 554.37, start: 45, length: 15, settings }),
      new Note({ frequency: 659.25, start: 60, length: 15, settings }),
      new Note({ frequency: 554.37, start: 75, length: 15, settings }),
    ],
    loop: { start: 30, end: 90 },
  });
  const song = new Song({ tracks: [track], ticksPerSecond: 60 });
  let player;

document.querySelector('#play').addEventListener('click', () => {
    if (player === undefined) {
      const chip = new Chip({ context: new AudioContext(), channels: [new Pulse()] });
      chip.volume = 0.2;
      player = new Player({ chip });
    }

player.stop();
    player.play(song);
  });

document.querySelector('#stop').addEventListener('click', () => {
    if (player !== undefined) {
      player.stop();
    }
  });
</script>

Constructor

new Track({ notes: readonly Note<Settings>[], loop?: Loop })

Option	Description
`notes`	In the order they start.
`loop`	Left out for a track that plays once.

Properties

Name	Type	Description
`notes`	readonly Note<Settings>[]
`loop`	Loop \| undefined
`length`	number	In ticks: up to the end of the loop when the track loops, and up to the end of its last note otherwise.