jujuadams/vinyl

Live updating audio system for GameMaker

Vinyl 5.5.6

Modular audio system for GameMaker 2023.8 (and later)

 

• Download the .yymps

• Read the documentation

• You may also like Bard Audio, LineAudio, and Sonus

 

Features

• Live reloading of audio configuration. You can mix whilst the game is running, no need for recompilation
• In-built systems to handle common designs (fade in, callbacks on fade out, audio ducking etc.)
• Multi-inheritance using Vinyl's "labels" (similar to audio groups)
• Integral shuffle, queue, and multi patterns
• Native panning
• Improved natural gain curves
• Pitch randomisation
• Out-of-the-box BPM tracking for audio
• Improved positional audio via region emitters
• Musical transposition per asset and across all assets
• System-wide parameter tweaking using "knobs"

vinyl's Issues

Do patterns need loop points?

Add copyTo "property" to asset config to duplicate settings across assets

Allow knobs to output strings

Allow transposition on a scale

Add per-property knob remapping

Improve knob range handling

Effect chains reset when reloading

Add dev functionality to override __VinylConfig

Add scanner to check if vinyl_lib contains buss definitions

Add stack feature to handle music interrupting other music

Add audio persistence and StopAllNonpersistent

Add validation to effect chains

BPM event emitter / detector

Add validation to non-pattern config data

Does max gain still work?

Check transposition inheritance

Can we remove the asset property from asset pattern initialization method?

Restore knob functionality for pattern gain/pitch/transpose

Transposition values that synchronise with music playback

Can we reload changes to multi instances?

Add feature to hook up an animation curve to a Multi pattern's blend

Ideally, the anim curve can be live updated too

Remove VinylMultiSyncSet

Base64 encode Vinyl data in Included Files, and store hash

Add KnobResetAll()

Runtime labels

Put stack pausing on a parallel pausing system

Can we live update whether a voice is looping?

Add property to queues to customise millisecond delay between sources

Revert to normalised gains and pitch

Also will need to add a macro to handle converting to/from decibel gain.

Knobs

Add per-instance knobs

Can we pre-calculate part of the gain/pitch/transposition equation?

Hook up knobs to blend factor for multi

Remove reliance on __labelDictTemp__

Bug with gain_target being overwritted with gain with buss tick

Hi,
with this code which should make a fade in on music :

bussMusic = vinyl_buss_create("bussMusic"); instMusic = vinyl_play(my_song_asset); bussMusic.gain = 0; bussMusic.gain_target = 1; bussMusic.gain_rate = 0.005;

the fade doesn't occur.

If i comment line 67 in vinyl_buss_create script, everything is working fine :
if (__old_gain != gain) { __old_gain = gain; //gain_target = gain; }

Check what happens if a pattern is deleted in a reloaded config file

Restructure documentation per-feature rather than brain dumping

Add arrays-as-keys to loose JSON parser

Runtime patterns

Flesh out stack feature

• Fade out depth
• Crossfade rate

P.S. Also remove label-based limits and associated machinery

Add knob target/rate

Add tag sensitivity to config file to help with labelling multiple assets

How is stack priority inherited?

Add runtime stacks

Add function to convert from decibels to amplitude and back again

Does the blend property for multi patterns want to be normalised?

Add array-as-key explanation to documentation

Look into decibel gain again + separaring crossfades from local gain

Allow anonymous patterns within queue/multi patterns

Failure to compile on MacOS

/Users/******/Documents/Repos/GMS2/gms2-project-template/gms23x template/extensions/__VinylBuildScripts/pre_run_step.sh 
System.ComponentModel.Win32Exception (13): An error occurred trying to start process '/Users/james/Documents/Repos/GMS2/gms2-project-template/gms23x template/extensions/__VinylBuildScripts/pre_run_step.sh' with working directory '/Applications/GameMaker LTS.app/Contents/MacOS/arm64'. Permission denied
   at System.Diagnostics.Process.ForkAndExecProcess(ProcessStartInfo startInfo, String resolvedFilename, String[] argv, String[] envp, String cwd, Boolean setCredentials, UInt32 userId, UInt32 groupId, UInt32[] groups, Int32& stdinFd, Int32& stdoutFd, Int32& stderrFd, Boolean usesTerminal, Boolean throwOnNoExec)
   at System.Diagnostics.Process.StartCore(ProcessStartInfo startInfo)
   at System.Diagnostics.Process.Start()
   at Igor.Command.ExecuteCommandSync(String _command, String _args, Boolean _fail_on_error, String _cwd, YYDictionary`2 _env, Boolean as_admin, String timingKey, Boolean _fQuiet)
   at Igor.Utils.ExecUserCmdStep(String fileName)
   at Igor.Utils.RunUserCmdStep(String _basename)
   at Igor.BaseTargetBuilder.PreRunStep()
   at Igor.MacBuilder.Run()