MPF supports playing light shows out of files in your config folder. Those are human readable and can be created by hand. But isn't that a bit cumbersome for larger shows? Especially, if you want to swipe over all (or most) of your LEDs this might take days. Luckily, there is a tool for that.
Video about showcreator:
Shows in MPF are written in YAML and can be used universally to control all kinds of things (such as lights, coils, slides, widgets, sounds and more). Basically, shows are a list of actions combined with a duration after which the next element in the list is played. Here is an example of a light show with three lights which sequentially turn blue over one second:
##! show: my_show #show_version=5 - duration: .25 lights: l_arrow_1: off l_arrow_2: off l_arrow_3: off - duration: .25 lights: l_arrow_1: blue l_arrow_2: off l_arrow_3: off - duration: .25 lights: l_arrow_1: blue l_arrow_2: blue l_arrow_3: off - duration: .25 lights: l_arrow_1: blue l_arrow_2: blue l_arrow_3: blue
In this simple example it totally makes sense to create the show by hand. You could also throw in tokens for the lights and reuse the show all over the machine for different light triples.
However, imagine you want to swipe over all lights in your machine. That would be a lot of text and also hard to get right manually. Luckily, Mark, the maker of the Nightmare before Christmas custom pinball machine, created this awesome MPF Lightshow generator.
The tool allows you to set a shape (i.e. a star in the example), choose a start and an end position and color. Based on that it will create a light show for you which contains one section per step (at a defined frame rate). Neat right? You might ask: How does it know where my lights are located on the playfield?
Luckily, you probably already have them set if you used the
MPF Monitor. It
allows you to use drag and drop to position all your switches and lights
on a playfield image. Those positions are then saved to the
monitor/monitor.yaml file in your machine folder. All you have to do
is point the light show creator to the
monitor/monitor.yaml file on
You set the start and end positions, rotations, scales and colors of that shape anywhere you want over the playfield.
Here we start with a gradient bar at the top of the playfield in a pink color.
We want the final position to be here at the bottom, in a darker red shade.
You can then adjust the length of the animation in milliseconds and hence the number of steps in the final show. In this example, the shape will be moved from the start to finish in 24 steps.
Based on these settings, it will create a light show for you which contains all needed commands per step for each of the lights the shape passes over. Lightshow playback speed can be adjusted in MPF.
You're not restricted to just the included shapes. You can make your own shapes and drop them in the shapes folder.
Once you get the hang of animating a single shape, you can go further by
adding in more shapes. You can add a total of 256 shapes in animation
segments. Each segment can be set to
concurrent (start and end same
time as the previous segment) or
follow (start after previous segment)
This allows for more interesting multipart shows. For example you could
have several color swipes coming from different directions one after the
other or effects like multiple spotlights moving across the playfield
like a hollywood premiere.
Running the showcreator on Windows
- Checkout or download the showcreator repository.
- Double click on led.exe
Running the showcreator on Mac x64
- Checkout or download the showcreator repository.
- Double click on: led mac x64.app (you may not see .app in the name)
Compiling and running the showcreator on Ubuntu
Inside a new install folder:
# inside a new install folder apt install linux-libc-dev:i386 libxft2:i386 g++-multilib gcc-multilib libxpm-dev:i386 libxxf86vm-dev:i386 libgl1-mesa-dev:i386 libglu1-mesa-dev:i386 git clone https://github.com/blitz-research/blitzmax.git cd blitzmax cd _src_/linux ./install.bat # yes its .bat cd ../../../ # back to your src folder git clone https://github.com/missionpinball/showcreator.git cd showcreator ../blitzmax/bin/bmk makeapp led.bmx # run it ./led
Afterwards you can run the showcreator using (from within your install folder):
- A - adjust rotation
- S - adjust x scale
- X - adjust y scale
- C - adjust both x and y scales
- HOLD SHIFT to reverse above functions
- HOLD CTRL to increase functions by 10X
- I - flash between START and FINISH end points
- L - toggle between viewing SHAPES or affected LEDs
- B - toggle between BW and full colour output
- B+SHIFT - change the B/W Threshold (16-240)/256
- SPC - toggle between START and FINISH end points
- U - play segment
- P - play complete set
- M - HOLD for slow motion during segment/set play
- P+SHIFT - play set and create script file
- ESC - quit - Y/N confirm quit
- Left Mouse Button Down over playfield adjusts position of current end (START or FINISH) +SHIFT adjusts both START AND FINISH positions
The tool is handy to render static shows which will not change during runtime. If you want to render shows dynamically (using your GPU) you can also use your lights as display in MC but that will cost much more resources during runtime than offline generated shows.
Something missing or wrong? You can fix it!
This website is edited by people like you! Is something wrong or missing? Is something out of date, or can you explain it better?
Please help us! You can fix it yourself and be an official "open source" contributor!
It's easy! See our Beginner's guide to editing the docs.
Page navigation via the keyboard: < >
You can navigate this site via the keyboard. There are two modes:
General navigation, when search is not focused:
- F , S , / : open search dialog
- P , , : go to previous page
- N , . : go to next page
While using the search function:
- Down , Up : select next / previous result
- Esc , Tab : close search
- Enter : go to highlighted page in the results