This project contains the Stage components that are used by the MelodyMatrix application to visualize music. It's a JavaFX/Kotlin/Maven project as that is also what is used for the MelodyMatrix application itself. More information and a video are available on https://melodymatrix.rocks/sources.

What this project contains:

• Views
• Simple simulator to send MidiData

What this project doesn't contain:

• MIDI communication
• Loading, saving and storing recordings
• All the other tools (to be) included in MelodyMatrix

• JDK 22 or newer
• Maven

• Clone the repository
• Open the cloned directory in IntelliJIDEA
• Import as Maven project
• In your IDE create a run configuration for javafx:run

• Once the application has started, select one of the included music patterns
• You can adjust the speed of the "played" notes
• Select one or more of the views to see the effect

• Create a directory in 'stage' for the new view
• Add a class in that new directory YourViewStage.kt
• Make sure it implements VisualizerStage()
• Look at one of the existing views how to add components
• The handling of the notes that are played, needs to be implemented in an override:

override fun onMidiDataReceived(midiData:MidiData) {
    val note = midiData.note
    // Add your logic here
}

• Add a button to open the new view in test.TestViewButtons.kt
• Run the application and test your new view

Default step-by-step to run this project on a Linux / Raspberry Pi system:

# Install SDKMAN 
$ curl -s "https://get.sdkman.io" | bash

# Open new terminal or 
$ source "$HOME/.sdkman/bin/sdkman-init.sh"

# Instal JDK with JFX 
$ sdk install java 22.0.1.fx-zulu
# When needed, set as default
$ sdk default java 22.0.1.fx-zulu

# Install Maven
$ sdk install maven

# Check versions
$ mvn -version
Apache Maven 3.9.7 (8b094c9513efc1b9ce2d952b3b9c8eaedaf8cbf0)
Maven home: /home/frank/.sdkman/candidates/maven/current
Java version: 22.0.1, vendor: Azul Systems, Inc., runtime: /home/frank/.sdkman/candidates/java/22.0.1.fx-zulu
Default locale: en_GB, platform encoding: UTF-8
OS name: "linux", version: "6.6.31+rpt-rpi-2712", arch: "aarch64", family: "unix"

$ java -version
openjdk version "22.0.1" 2024-04-16
OpenJDK Runtime Environment Zulu22.30+13-CA (build 22.0.1+8)
OpenJDK 64-Bit Server VM Zulu22.30+13-CA (build 22.0.1+8, mixed mode, sharing)

# Get the sources
$ git clone https://github.com/codewriterbv/melodymatrix-app-views.git
$ cd melodymatrix-app-views

# Start as JavaFX application
$ mvn javafx:run

# Build without compiling and running the tests
$ mvn package -Dmaven.test.skip=true