https://github.com/patrickroocks/lsystem

An interactive simulator for Lindenmayer systems
https://github.com/patrickroocks/lsystem

Last synced: 9 days ago
JSON representation

An interactive simulator for Lindenmayer systems

• Host: GitHub
• URL: https://github.com/patrickroocks/lsystem
• Owner: patrickroocks
• License: mit
• Created: 2021-04-17T17:48:46.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-09-16T11:44:43.000Z (3 months ago)
• Last Synced: 2024-09-16T22:15:42.619Z (3 months ago)
• Language: C++
• Size: 736 KB
• Stars: 6
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGES.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# lsystem

The **lsystem** application is an interactive fractal generator for Lindenmayer systems (also called ["L-systems", Wikipedia](https://en.wikipedia.org/wiki/L-system)). 

It supports Lindenmayer systems with arbitrary many literals (including helper literals which do not result in painted segments), different angles for left/right rotations and scaling down drawings within the recursive call.

The user interface is written in Qt6/QML. It supports sliders for all relevant parameters, such that the fractal is repainted after every parameter change. Multiple fractals can be placed, dragged and scaled on the canvas. The UI also contains a player/animator which shows the stepwise development of the fractal.

The expansion and rendering of the L-system is done in different threads, such that the UI stays responsive during the computations.

## Download binaries

**Screenshots and prebuild binaries (Ubuntu and Windows):** https://www.p-roocks.de/wordpress2/lsystem-simulator

## Prerequisites to build

To build lsystem on Ubuntu, you will first need to [install Qt >= 6.5](https://www.qt.io/download-open-source). Moreover you will need to install:

        sudo apt install libxkbcommon-dev libxcb-xinerama0 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-randr0 libxcb-render-util0 libxcb-shape0 libxkbcommon-x11-0 libxcb-cursor0 libglew-dev

## Build and run (Ubuntu)

 To build and start lystem, run (assuming that Qt was installed to `/opt/Qt/6.5`):

    git clone https://github.com/patrickroocks/lsystem lsystem

    cd lsystem

    /opt/Qt/6.5/gcc_64/bin/qmake CONFIG+=qtquickcompiler

    make qmake_all

    make -j8

    ./lsystemapp/lsystemapp

Your user-defined configs will be stored in a `config.json` file located in the working directory. Additionally there are some unit tests which can be run by `./test/test`.

## Developing within Qt Creator and Qt Design Studio

* The lystem project in Qt Creator:

	- First configure the project (`lystem.pro`) using Qt 6.5 or higher.

	- Add the following custom build step in order to get the newest QML files from the Qt Design Studio project:

		- Command: `bash`

		- Arguments: `lsystemapp/util/qml/LsystemQml/copy_qml.sh`

		- Working Directory: `%{sourceDir}`

* The QML project in Qt Design Studio:

	- Run design studio, typically installed in `/opt/Qt/Tools/QtDesignStudio/bin/qtdesignstudio`.

	- Open `lsystemapp/util/qml/LsystemQml/LsystemQml.qmlproject`.

## Build and run (Windows)

Have a look at the PowerShell scripts in the `build` directory.

## License

lsystem is licensed under the MIT Licence, see `LICENSE` file for details.

## Bugs, comments, suggestions?

Please open an issue here or [write a mail to me](mailto:[email protected]).