https://github.com/lambdacasserole/bach
Compose components using a generic designer.
https://github.com/lambdacasserole/bach
designer drag-and-drop gui visualization
Last synced: 11 months ago
JSON representation
Compose components using a generic designer.
- Host: GitHub
- URL: https://github.com/lambdacasserole/bach
- Owner: lambdacasserole
- License: mit
- Created: 2019-03-11T18:19:26.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-10-02T18:22:23.000Z (over 6 years ago)
- Last Synced: 2025-02-12T20:19:34.705Z (over 1 year ago)
- Topics: designer, drag-and-drop, gui, visualization
- Language: Java
- Size: 301 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Bach
Compose components using a generic designer.
## Overview
Sometimes you need a relatively simple, low-level, generic designer library that's open to extension. Bach is designed to enable you to build interconnected diagrams of *bricks* (some sort of image representing an attached object) with a simple mechanism for defining rules about which sorts of brick can connect to which other sorts etc. This code was extracted from the [Denobo](https://github.com/lambdacasserole/Denobo) network designer utility and made as generic as possible.
## Prerequisites
Bach is written in Java, and makes use of Swing. Batteries are definitely not included whatsoever, it's entirely up to you to define your own bricks (by subclassing the abstract `Brick` class), handle image loading, and define your object model. Context menus are supported, but once again you'll have to define your own. Images are not included, those used in the preview are from the [Tango Icon Library](http://tango.freedesktop.org/Tango_Icon_Library).
## Use Case
The library is designed to be very general-purpose. If you need a starting point for simply modelling the relationships between objects, with some constraints, Bach might be for you.
## Installation
You can pull this package into your Maven project straight from here using JitPack. Add JitPack as a repository first:
```
jitpack.io
https://jitpack.io
```
Then add a dependency on Bach:
```
com.github.lambdacasserole
bach
v1.0
```
## Quickstart
See below for some code that'll get you started quite quickly. Remember you have to define `MyCustomBrick1` and `MyCustomBrick2` yourself by subclassing `Brick`.
```java
import javax.swing.*;
import com.sauljohnson.bach.*;
public class QuickBachTest {
/**
* The application entry point.
*
* @param args the command-line arguments to the application
*/
public static void main(String[] args) {
JFrame mainFrame = new JFrame();
Designer designer = new Designer(null); // New designer, no context menu.
// Add designer to form.
mainFrame.add(designer);
mainFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
mainFrame.show();
// Initialise a new brick (you have to define this yourself by subclassing Brick).
MyCustomBrick1 b1 = new MyCustomBrick1(null, 0, 0);
// Initialise a new brick of a different type.
MyCustomBrick2 b2 = new MyCustomBrick2(null, 0, 0);
// Add bricks to designer.
designer.addBrick(b1);
designer.addBrick(b2);
}
}
```
## Acknowledgements
Credit to my original co-creators of [Denobo](https://github.com/lambdacasserole/Denobo), [Alex Mullen](https://github.com/alexmullen) and [Lee Oliver](https://github.com/Lee34723) for their part in building the original software.
The [Tango Icon Library](http://tango.freedesktop.org/Tango_Icon_Library) (used in the preview GIF) is an excellent free icon pack that I recommend checking out.