Skip to content
Wolfgang Friebel edited this page Mar 25, 2025 · 18 revisions

Display and Store Marble Run Tracks using a compact notation

A small video of a marble track using the lift extension demonstrates what can be done with GraviTrax®. New balls emerge from the lift in the lower left corner whenever the lift button is pressed.

A compact notation that can be written down, stored in a text file and saved in a (sqlite) database has been designed to reproduce built marble runs at a later time (among other things). A detailed description in German and an English description of this notation for marble tracks is available.

From the notation saved in the database a human readable description can be generated using the program gravi contained in the perl package Game-MarbleRun (release 1.18 as of March 2025). The program can also produce simple graphics like for the lift example showing the complete animated track (stop after 9 marbles have been released). In the second picture only the elements on the ground plane have been drawn (see pictures below).

run_lift run_lift_0

As an example the file wf_lift can be inspected to get an idea of how the notation of a marble track looks like. Using this file (and a slightly modified program) the pictures above were generated.

A quick reference card in English and in German completes the documentation. A list of Changes shows the development history of this package.

For Windows users that do not want to install perl on their computers a precompiled binary is available. It does not respect the installed language. To output text in german you have to use the -l de switch. Please use the program at your own risk.

Clone this wiki locally