This cartridge is intended for PICO-8 newcomers to learn how SSPR() works.
Up and down arrows: Selects the parameter to change.
Left and right arrows: Modifies number-parameter values (the two sets of X, Y, W, and H values).
Z/C/N (or the right face-button on mobile touchscreens): Changes number-parameter values by 8 instead of 1. This also modifies the flip settings.
Src. X: The X-coordinate of the spritesheet to draw from, relative to the left. Pixels outside of the 0..127 range will be treated as black.
Src. Y: The Y-coordinate of the spritesheet to draw from, relative to the top. Pixels outside of the 0..127 range will be treated as black.
Src. W: The width of the sprite's image, in pixels. Negative values are treated as 0, of which results in no sprite drawn. The image is stretched to the 'Draw W' width.
Src. H: The height of the sprite's image, in pixels. Negative values are treated as 0, of which results in no sprite drawn. The image is stretched to the 'Draw H' height.
Draw X: The X-coordinate of the screen to draw to, relative to the left. Pixels outside of the 0..127 range are invisible, so that the sprite can be pushed into the left or right edge of the screen.
Draw Y: The Y-coordinate of the screen to draw to, relative to the top. Pixels outside of the 0..127 range are invisible, so that the sprite can be pushed into the top or bottom edge of the screen.
Draw W: The width of the sprite itself, in pixels. Negative values allow a horizontally-flipped image, with the 'Draw X' coordinate representing the right side of the sprite instead of the left.
Draw H: The height of the sprite itself, in pixels. Negative values allow a vertically-flipped image, with the 'Draw Y' coordinate representing the bottom of the sprite instead of the top.
H-Flip: If TRUE, the sprite's image is flipped horizontally. Combining this with a negative 'Draw W' value results in a cancel-out, drawing the image without flipping it.
V-Flip: If TRUE, the sprite's image is flipped vertically. Combining this with a negative 'Draw H' value results in a cancel-out, drawing the image without flipping it.
The spritesheet used here is the one from Zep's Jelpi Test!
This cartridge is intended for PICO-8 newcomers to learn how each mode works.
Use the arrows to change the video mode. Valid modes are 0~7.
It writes to the address 0x5F2C in Draw State RAM to set the video mode (display resolution or reflection).
The sprites used here are Jelpi sprites!
How do I communicate between 2 or more PICO-8 instances on the desktop? Maybe you could make virtual GPIO pins that communicate with other PICO-8 instances on the host OS? What do you think, @zep?
This cartridge's source code is a modded variant of "Music Visualizer Bars" by iaoth:
Thanks to him for his visualizer code base!
What I've changed (first version):
- Corrected the octave numbers to match the PICO-8 SFX editor.
- Fixed the waveform colors of the bars being wrong. The PICO-8 palette index it was referring to was 1 less than what the SFX editor references to.
- Changed the beige text color to white. Prevents blending with bars with the PHASER waveform (SFX editor value 7).
- Implemented displays for custom instruments (SFX 0~7) and effects (slide/vibrato/drop/fade/arp).
- The colors of the bars and displays now change accordingly if the instrument is either a fixed waveform or a custom instrument.
- Implemented the DROP and FADE IN effects (SFX editor values 3 and 4, respectively) to the volume bars' handling code. The code I added may not be 100% accurate, but if you have any changes to make to it, please let me know in the comments!
- Added a function to disable all loop/stop control flags in the music RAM, found at 0x3100~0x31FF in the PICO-8 memory map. This can be disabled by commenting out lines 9~11 in code tab 0.
Update March 27th, 2019:
- Changed the DROP and FADEOUT effects' speed in their respective handler code. It should be more accurate now.
- The position of the effect displays' texts are now pseudo-centered.
- The dark-gray color of the displays for custom instruments is now changed to brown, if it blends with the black background of the visualization.
Update April 3rd, 2019:
- Fixed custom instrument displays from showing "SFX -1".
- When the note volume is zero, the wave is set to -8 to make the bar black.
- Custom instrument bars are now changed to a darker gray. The note/effect displays are changed to white, to be like the fixed waveforms.
- Effect names now make use of PICO-8's own text string emojis.
- If PICO-8 plays note indexes beyond 31, they're now treated as being a zero-volume note. Fixes the bars playing inaudible pattern data, especially noted with Marballs 2 while I was making this update.
- Added displays at the top for showing which patterns and notes the channels are playing.
- Added another display for identifying what frames repeat or stop the track, by reading the music control flags of each of those 64 frames on the cartridge.
- Added a simple main menu to select a track the user wishes to play, rather than playing all tracks in one go.
Update April 5th, 2019:
- Made the loop and stop shapes brighter, as a result of preventing bars for displaying on the top 16 pixel rows.
- Frames with all three flags disabled will now be displayed with a dark-gray dot/pixel.
- Arp displays now show the exact note-cycle frequency division for the ~120Hz SFX clock.
- Tracks in the TRACK.DATA table now have support for loading from an external cartridge. If this is unspecified, track data from the visualizer cartridge itself will be used instead.
- Minor changes to the menu, including fixing a mistake where I didn't mention the left and right arrows would also select the track, which was already a thing in the previous update.
- Added the ability to stop a track during playback. When stopping, a 333ms fade-out is applied. However, you can still pause the track by pausing the cartridge.
- Removed the 3-line time code in the DRAW_VISUALIZER() routine that existed there and did nothing at all.
Update 2 (April 5th, 2019):
- Fixed bars 2~4 from drawing in front of the top displays.
- Fixed note nn indexes beyond 31 from showing on the "Rnn" displays.
- SFX speed is now more accurate to the PICO-8 SFX engine.
- Bars will no longer display beyond the limit (MUSIC_EVENTS.VOLUME[I]>7), improving max-volume FADE IN effects.
- More minor changes to the interfaces.
Update April 14th, 2019:
- Added support for the undocumented "half-clock" audio flags in the RAM. Even when they're disabled (which they always were in all previous versions), the drop/fade speed is now fixed in regards to that TIME() change in PICO-8 0.1.12.
- The 333ms fade-out is now more like an actual third-of-a-second fade.
- Added a screen-saver! I don't know if it's any good, but please tell me your thoughts about it in the comments!
- Removed more unnecessary parts of the code, including a blank MUSIC_EVENTS.LIST table that wasn't used.
Update April 15th, 2019:
- Fixed the FADE-IN movement from heaping over the top of the bar height position that represents the current note volume.
- The screen-saver color-changer now refers to the lowest-indexed active channel, instead of only the first channel.
- Changed the PEEK4() into the recently-added PEEK2(). Notes are 16 bits long, so NOTEDAT doesn't need to be 32-bit.
- When a track stops, it now automatically goes back to the main menu.
- Changed a few text label strings.
- Removed one more unnecessary code line that I forgot to remove.
Update April 16th, 2019:
- Text labels and code editor comments now feature lowercase letters. Since PICO-8 0.1.12 doesn't convert to lowercase letters when 0.1.11g did, this change was made.
- Fix to prevent the first frame of track playback from being drawn. This first frame had info from the previously-played track that shouldn't be drawn.
- Minor change to the code that gets rid of one FOR loop.
- Allow playlists to be configured for native exports (Windows, Linux x64, MacOSX) from PICO-8. This could probably allow custom playlists of other cartridges to be created without having to buy the fantasy console. When there's a way to get this fully working, there's a will to release binaries to the public. For now until then, if you want to see other songs with my visualizer, post some suggestions in the comments, and I'll reply with a cartridge!
To test my new changes to his visualizer, I thought I'd use something new that really got my attention the other day. That is "PICO-8 Tunes Vol. 2", released by Gruber, which is a cartridge featuring 10 amazing tunes! You can find it here:
The sound and music editor data that's generated is 100% randomized! Music starts at a random position from 0 to 63.
Update May 10th, 2019:
The minimum requirement for Windows is to make it support 32-bit versions, unless 4+ GB of RAM or other x64-only features may be needed.
You've read me correctly, that IS the minimum requirement.
I already know that I have a x64-capable system, enjoying a bit of Riko4 on it, and I actually received a gifted copy of PICO-8 last year.
Update August 20th, 2018: Slight change to show 15 color rectangles instead of only 7. This is not a song-related change.
Credit to Zep for the code base.
I really want to play with these fantasy consoles on my 32-bit PC, but the only problem is that they only have official binaries for 64-bit Windows. I have no idea as to what compiler I should use to create one myself.
Please note that this thread has nothing to do with PICO-8.