Added timing jitter option to song player

Author: RaphiMC

src/main/java/net/raphimc/noteblocktool/frames/SongPlayerFrame.java

@@ -41,19 +41,22 @@ public class SongPlayerFrame extends JFrame {
     private static SongPlayerFrame instance;
     private static Point lastPosition;
     private static int lastVolume = 50;
+    private static boolean lastTimingJitter = false;
     private static int lastMaxSounds = 4096;
 
     public static void open(final Song song) {
         if (instance != null && instance.isVisible()) {
             lastPosition = instance.getLocation();
             lastVolume = instance.volumeSlider.getValue();
+            lastTimingJitter = instance.timingJitter.isSelected();
             lastMaxSounds = (int) instance.maxSoundsSpinner.getValue();
             instance.dispose();
         }
         SwingUtilities.invokeLater(() -> {
             instance = new SongPlayerFrame(song);
             if (lastPosition != null) instance.setLocation(lastPosition);
             instance.volumeSlider.setValue(lastVolume);
+            instance.timingJitter.setSelected(lastTimingJitter);
             instance.maxSoundsSpinner.setValue(lastMaxSounds);
             instance.playStopButton.doClick(0);
             instance.setVisible(true);
@@ -65,6 +68,7 @@ public static void open(final Song song) {
     private final Timer updateTimer;
     private final JSlider volumeSlider = new JSlider(0, 100, lastVolume);
     private final JSpinner maxSoundsSpinner = new JSpinner(new SpinnerNumberModel(lastMaxSounds, 64, 131_070, 64));
+    private final JCheckBox timingJitter = new JCheckBox("Artificial Timing Jitter", lastTimingJitter);
     private final JButton playStopButton = new JButton("Play");
     private final JButton pauseResumeButton = new JButton("Pause");
     private final JButton openVisualizerButton = new JButton("Open Visualizer");
@@ -116,6 +120,16 @@ private void initComponents() {
                 });
             });
 
+            GBC.create(northPanel).grid(1, gridy++).insets(5, 0, 0, 5).anchor(GBC.LINE_START).add(this.timingJitter, () -> {
+                this.timingJitter.setToolTipText("Adds slight timing jitter (±1ms) to make the song sound more natural and less artificial.\nThis emulates the behaviour of playing the song in Note Block Studio.");
+                this.timingJitter.addChangeListener(e -> {
+                    if (this.songRenderer != null) {
+                        this.songRenderer.setTimingJitter(this.timingJitter.isSelected());
+                    }
+                    lastTimingJitter = this.timingJitter.isSelected();
+                });
+            });
+
             GBC.create(northPanel).grid(0, gridy).insets(5, 5, 0, 5).anchor(GBC.LINE_START).add(new JLabel("Max Sounds:"));
             GBC.create(northPanel).grid(1, gridy++).insets(5, 0, 0, 5).weightx(1).fill(GBC.HORIZONTAL).add(this.maxSoundsSpinner, () -> {
                 this.maxSoundsSpinner.addChangeListener(e -> lastMaxSounds = (int) this.maxSoundsSpinner.getValue());
@@ -237,6 +251,7 @@ private void initSongPlayer() {
             this.closeSongPlayerAndVisualizer();
             this.songRenderer = new RealtimeSongRenderer(this.song, maxSounds, true, false, PLAYBACK_AUDIO_FORMAT);
             this.songRenderer.setMasterVolume(this.volumeSlider.getValue() / 100F);
+            this.songRenderer.setTimingJitter(this.timingJitter.isSelected());
         }
     }