Added usage examples in C; Added asm include file with track info to sointu-compile.

examples/code/C/CMakeLists.txt

@@ -0,0 +1,34 @@
+add_custom_command(
+    COMMAND
+        ${compilecmd} -arch=${arch} -o physics_girl_st.asm "${PROJECT_SOURCE_DIR}/examples/patches/physics_girl_st.yml"
+    WORKING_DIRECTORY
+        ${CMAKE_CURRENT_BINARY_DIR}
+    DEPENDS
+        "${PROJECT_SOURCE_DIR}/examples/patches/physics_girl_st.yml"
+    OUTPUT
+        physics_girl_st.asm
+        physics_girl_st.h
+        physics_girl_st.inc
+    COMMENT
+        "Compiling ${PROJECT_SOURCE_DIR}/examples/patches/physics-girl-st.yml..."
+)
+
+add_library(physics_girl_st physics_girl_st.asm)
+add_dependencies(physics_girl_st sointu-compiler)
+
+if(WIN32)
+    add_executable(cplay
+        cplay.windows.c
+        physics_girl_st.h
+    )
+    target_link_libraries(cplay PRIVATE winmm)
+elseif(UNIX)
+    add_executable(cplay
+        cplay.unix.c
+        physics_girl_st.h
+    )
+    target_link_libraries(cplay PRIVATE asound pthread)
+    target_link_options(cplay PRIVATE -z noexecstack -no-pie)
+endif()
+target_link_libraries(cplay PRIVATE physics_girl_st)
+target_include_directories(cplay PRIVATE ${CMAKE_CURRENT_BINARY_DIR})

examples/code/C/cplay.unix.c

@@ -0,0 +1,27 @@
+#include <alsa/asoundlib.h>
+#include <pthread.h>
+#include <stdio.h>
+#include <stdint.h>
+#include "physics_girl_st.h"
+
+static SUsample sound_buffer[SU_LENGTH_IN_SAMPLES * SU_CHANNEL_COUNT];
+static snd_pcm_t *pcm_handle;
+static pthread_t render_thread;
+static uint32_t render_thread_handle;
+
+int main(int argc, char **args) {
+	// Unix does not have gm.dls, no need to ifdef and setup here.
+
+	// We render in the background while playing already.
+	render_thread_handle = pthread_create(&render_thread, 0, (void * (*)(void *))su_render_song, sound_buffer);
+
+	// We can't start playing too early or the missing samples will be audible.
+	sleep(2.);
+
+	// Play the track.
+	snd_pcm_open(&pcm_handle, "default", SND_PCM_STREAM_PLAYBACK, 0);
+	snd_pcm_set_params(pcm_handle, SND_PCM_FORMAT_FLOAT, SND_PCM_ACCESS_RW_INTERLEAVED, SU_CHANNEL_COUNT, SU_SAMPLE_RATE, 0, SU_LENGTH_IN_SAMPLES);
+	snd_pcm_writei(pcm_handle, sound_buffer, SU_LENGTH_IN_SAMPLES);
+
+	return 0;
+}

examples/code/C/cplay.windows.c

@@ -0,0 +1,63 @@
+#include <stdio.h>
+#include <stdint.h>
+#include "physics_girl_st.h"
+#define WIN32_LEAN_AND_MEAN
+#define WIN32_EXTRA_LEAN
+#include <Windows.h>
+#include "mmsystem.h"
+#include "mmreg.h"
+
+SUsample sound_buffer[SU_LENGTH_IN_SAMPLES * SU_CHANNEL_COUNT];
+HWAVEOUT	wave_out_handle;
+WAVEFORMATEX WaveFMT = {
+#ifdef SU_SAMPLE_FLOAT
+	WAVE_FORMAT_IEEE_FLOAT,
+#else
+	WAVE_FORMAT_PCM,
+#endif
+	SU_CHANNEL_COUNT,
+	SU_SAMPLE_RATE,
+	SU_SAMPLE_RATE * SU_SAMPLE_SIZE * SU_CHANNEL_COUNT,
+	SU_SAMPLE_SIZE * SU_CHANNEL_COUNT,
+	SU_SAMPLE_SIZE*8,
+	0
+};
+WAVEHDR WaveHDR = {
+	(LPSTR)sound_buffer, 
+	SU_LENGTH_IN_SAMPLES * SU_SAMPLE_SIZE * SU_CHANNEL_COUNT,
+	0,
+	0,
+	WHDR_PREPARED,
+	0,
+	0,
+	0
+};
+MMTIME MMTime = {
+	TIME_SAMPLES,
+	0
+};
+
+int main(int argc, char **args) {
+	// Load gm.dls if necessary.
+#ifdef SU_LOAD_GMDLS
+	su_load_gmdls();
+#endif // SU_LOAD_GMDLS
+
+	CreateThread(0, 0, (LPTHREAD_START_ROUTINE)su_render_song, sound_buffer, 0, 0);
+
+	// We render in the background while playing already. Fortunately,
+	// Windows is slow with the calls below, so we're not worried that
+	// we don't have enough samples ready before the track starts.
+	waveOutOpen(&wave_out_handle, WAVE_MAPPER, &WaveFMT, 0, 0, CALLBACK_NULL);
+	waveOutWrite(wave_out_handle, &WaveHDR, sizeof(WaveHDR));
+
+	// We need to handle windows messages properly while playing, as waveOutWrite is async.
+	for(MSG msg = {0}; MMTime.u.sample != SU_LENGTH_IN_SAMPLES; waveOutGetPosition(wave_out_handle, &MMTime, sizeof(MMTIME))) {
+		while (PeekMessageA(&msg, NULL, 0, 0, PM_REMOVE)) {
+			TranslateMessage(&msg);
+			DispatchMessageA(&msg);
+		}
+	}
+
+	return 0;
+}

examples/code/CMakeLists.txt

@@ -0,0 +1 @@
+add_subdirectory(C)