Modul-8

Cart File | Forum Post |

	More cartridges by MoonShine

More Cartridges [View All]

 

Modul-8

by MoonShine

Cart #modul_8-5 | 2024-05-18 | Code ▽ | Embed ▽ | License: CC4-BY-NC-SA

17

Modul-8 allows you to create music in PICO-8 with three channels of 2OP PM synthesis.

Features

With a look based on PICO-8's built-in tracker, Modul-8 was created to be as simple as possible to not only save CPU space but also make it more accessible when it comes to inputs. The tracker uses both standard PICO-8 buttons and mouse input; while the arrow keys are used to move across the grid and the O/X butons (Z/X keys) are used to cycle through notes, the mouse is used to control the instrument and playback options. Pressing both buttons at the exact same time will delete the note the cursor is on. While the PM synthesis Modul-8 uses is very basic, it still allows you to craft some interesting sounds by controling the volume, ADSR and frequency multiplication of both operators. Tunes created with the tracker are always looped, but the overall lenght of the track and the loop point of each pattern are adjustable.

File Format

Despite the confusing nature of Modul-8's text-based file format, tunes can be saved very easily. Pressing ctrl+c after saving is needed on the BBS and pressing ctrl+v beforehand is mandatory if you want to load a track. To keep your saved files, you'll just have to paste them in a word processor, or you could even share them here! For anyone who's curious, the format contains the values for the tune's format header, speed, size, loops, instrument variables and note sequence (including instrument changes) in that order.

Demo

To demonstrate Modul-8's capabilities, here are a couple of short demos:

modul_8,2,6,14,6,16,14,6,16,16,0,5,0,0,1,2,0,5,0,0,3,6,0,5,0,0,1,3,1,5,0,0,3,16,0,5,0,0,1,8,0,5,0,0,1,16,0,5,0,0,1,2,0,2,0,0,3,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,24,1,19,1,22,1,19,1,27,1,22,1,24,1,27,1,22,1,25,1,22,1,30,1,25,1,27,1,-1,1,-1,1,10,1,17,1,22,1,11,1,18,1,23,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,21,1,19,1,28,1,16,1,19,1,21,1,19,4,21,1,19,1,28,1,16,1,19,1,21,1,16,4,19,1,21,1,24,1,19,1,22,1,19,1,27,1,22,1,24,1,27,1,22,1,25,1,22,1,30,1,25,1,27,1,-1,1,-1,1,26,1,21,1,14,1,24,1,19,1,12,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,18,1,21,1,23,1,26,1,30,1,26,1,21,1,28,1,25,1,21,1,26,1,23,1,18,1,25,1,21,1,16,1,16,2,24,2,19,2,22,2,19,2,27,2,22,2,24,2,27,2,22,2,25,2,22,2,30,2,25,2,-1,2,-1,1,27,2,10,2,17,2,22,2,11,2,18,2,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,23,2,21,2,19,2,28,2,16,2,19,2,21,2,19,2,21,2,19,2,28,2,16,2,19,2,21,2,16,2,19,2,21,2,24,2,19,2,22,2,19,2,27,2,22,2,24,2,27,2,22,2,25,2,22,2,30,2,25,2,-1,1,-1,1,27,2,26,2,21,2,14,2,24,2,19,2,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,12,2,18,2,21,2,23,2,26,2,18,2,26,2,21,2,28,2,25,2,21,2,26,2,23,2,18,2,25,2,21,2,12,3,-1,1,-1,1,-1,1,0,3,-1,1,-1,1,3,3,-1,1,-1,1,-1,1,15,3,-1,1,-1,1,-1,1,-1,1,10,3,-1,1,-1,1,11,3,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,9,3,-1,1,-1,1,-1,1,4,3,-1,1,-1,1,7,3,-2,2,7,3,4,3,-1,1,7,3,-1,1,9,3,-1,1,12,3,-1,1,-1,1,-1,1,0,3,-1,1,-1,1,3,3,-1,1,-1,1,-1,1,15,3,-1,1,-1,1,-1,1,-1,1,2,3,-1,1,14,3,12,3,-1,1,-1,3,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,11,3,-1,1,-1,1,-1,1,11,3,-1,1,-1,1,9,3,-1,1,-1,1,6,3,-2,3,4,3,-1,1,6,3,-1,1

modul_8,1,7,16,16,6,14,14,14,14,16,0,1,0,0,1,16,0,1,0,0,16,16,0,4,0,0,1,10,0,2,0,0,1,16,0,1,0,0,1,3,0,2,0,0,3,5,0,1,0,0,1,5,0,1,0,0,3,16,0,2,0,0,1,5,0,2,0,0,2,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,0,2,-1,1,-1,1,-1,1,37,1,0,2,3,2,-1,1,-1,1,-1,1,3,2,-1,1,37,1,3,2,-1,1,-1,1,6,2,-1,1,-1,1,-1,1,37,1,6,2,9,2,-1,2,-1,1,-1,1,9,2,-1,2,37,1,9,2,-1,1,-1,1,19,5,10,2,12,2,21,5,0,2,2,2,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,7,2,7,2,21,5,7,2,37,1,21,5,7,2,7,2,21,5,7,2,37,1,17,5,5,2,2,2,-1,1,-1,1,0,2,0,2,19,5,0,2,37,1,19,5,0,2,0,2,17,5,0,2,37,1,14,5,12,2,11,2,-1,1,-1,1,10,2,10,2,17,5,10,2,37,1,17,5,10,2,10,2,17,5,10,2,37,1,17,5,10,2,9,2,-1,1,-1,1,8,2,8,2,18,5,8,2,37,1,18,5,8,2,8,2,18,5,8,2,37,1,18,5,6,2,8,2,-1,1,-1,1,-1,3,19,3,24,3,26,3,31,3,19,3,25,3,15,3,24,3,15,3,22,3,15,3,20,3,15,3,20,3,22,3,-1,1,20,3,21,3,28,3,33,3,21,3,28,3,21,3,26,3,21,3,24,3,21,3,23,3,21,3,23,3,24,3,22,5,-1,1,-1,1,24,5,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,26,5,-1,1,-1,1,26,5,-1,1,-1,1,24,5,-1,1,-1,1,22,5,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,22,5,-1,1,-1,1,22,5,-1,1,-1,1,22,5,-1,1,-1,1,17,5,-1,5,-1,1,-1,1,-1,1,-1,1,-1,1,20,5,-1,1,-1,1,20,5,-1,1,-1,1,20,5,-1,1,-1,1,20,5,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,23,5,-1,1,-1,1,23,5,-1,1,-1,1,22,5,-1,1,-1,1,23,5,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,19,4,24,4,26,4,31,4,19,4,25,4,15,4,24,4,15,4,22,4,15,4,20,4,15,4,20,4,-1,1,-1,1,20,4,21,4,28,4,33,4,21,4,28,4,21,4,26,4,21,4,24,4,21,4,23,4,21,4,23,4,27,5,-1,1,-1,1,29,5,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,29,5,-1,1,-1,1,29,5,-1,1,-1,1,28,5,-1,1,-1,1,26,5,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,27,5,-1,1,-1,1,27,5,-1,1,-1,1,26,5,-1,1,-1,1,22,5,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,25,5,-1,1,-1,1,25,5,-1,1,-1,1,24,5,-1,1,-1,1,25,5,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,27,5,-1,1,-1,1,27,5,-1,1,-1,1,25,5,-1,1,-1,1,27,5,-1,1,-1,1,-1,1,-1,1

Code by MegaSparky.
Released by MoonShine's PICO-Crew subgroup.
Thanks to Bikibird and Luchak for helping with and providing code for PCM playback in the PICO-8 server! (also used in Moonshine's PICO-Patch)
Special thanks to other members of MoonShine and the PICO-8 server!

> At least at the moment, for some weird reason, Modul-8 seems to suffer a lot of lag on both the BBS and PICO-8 Education Edition.

I've always had issues with PCM audio in PICO-8 carts on the web, never been able to fix it.

@luchak It does work on the web now, though.

here's a song I made:
modul_8,8,1,16,16,0,1,0,0,1,0,0,0,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,16,0,5,0,0,1,33,1,40,1,33,1,47,1,28,1,40,1,28,1,43,1,31,1,40,1,31,1,47,1,24,1,40,1,24,1,43,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1,-1,1

Track name: Settled On Night Mountaintops
Modul-8 Original Demo Song by SkylarZYX
Released by MoonShine/Pico-Crew (MS)
Date: 2023/10/21

https://cdn.discordapp.com/attachments/992533965116284928/1166228554070102078/sketch-1.txt

I think there's a problem with the sample scheduling? Using Control-P the CPU varies from like 90% to 10% each frame. (I'm actually not sure what the other numbers on that are, but stat(1) the main loop gives 80%-0% too). So it would seem like you're doing too much work half the time and not enough the next time.

My code has

local len=min(94,1536-stat(108))
local addr_end=0x4300+len-1
for addr=0x4300,addr_end do

I don't know how to properly port your code to this, but hacking it in give 45% as expected. (audio still plays)
But any method that doesn't schedule the max amount will leave some work for the next frame. AFAIK this should help :)

Oh and, I had some trouble importing. It seems triple clicking the snippets fails. https://evercoder.github.io/clipboard-inspector/ seems to show it picks up tabs at the front, so select the text carefully friends

I'm not figuring out how to load stuff, tried both with the embedded pico8 and the downloaded version.

@DigitalMarisa It's quite simple: copy the snippet, press ctrl+v inside of Modul-8, click the "load" button and enjoy the tune! :)

There has been a new feature added to delete your notes by pressing X and O at the same time!
Thanks MegaSparky for adding it!