GraphStream -- Swing Viewer

The GraphStream project is a java library that provides an API to model, analyze and visualize graphs and dynamic graphs.

This module contains a Swing implementation of the GraphStream Viewer.

Check out the Website http://www.graphstream-project.org/ for more information.

UI

This viewer is a rewrite of the old gs-ui Scala-based renderer. gs-ui is now deprecated.

This renderer supports almost all of the CSS properties defined in the GraphStream CSS Reference, however it is still a work in progress. This viewer is intended only at 2D visualization actually.

We are interested in any suggestion to improve this renderer, and your use cases could be of great help for us in developing this project. If you like and use this project, this could be a good contribution.

Install UI

gs-ui-swing is a plugin to the gs-core main project.

The release comes with a pre-packaged jar file named gs-ui-swing.jar that contains the GraphStream viewer classes. It depends on the root project gs-core. To start using GraphStream with a viewer, simply put gs-core.jar and gs-ui-swing.jar in your class path. You can download GraphStream on the github releases pages:

Maven users may include major releases of gs-core and gs-ui-swing as dependencies:

<dependencies>
    <dependency>
        <groupId>org.graphstream</groupId>
        <artifactId>gs-core</artifactId>
        <version>2.0</version>
    </dependency>

    <dependency>
        <groupId>org.graphstream</groupId>
        <artifactId>gs-ui-swing</artifactId>
        <version>2.0</version>
    </dependency>
</dependencies>

Development Versions

Using https://jitpack.io one can also use any development version. Simply add the jitpack repository to the pom.xml of the project:

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

then, add the gs-core and gs-ui-swing to your dependencies:

<dependencies>
    <dependency>
        <groupId>com.github.graphstream</groupId>
        <artifactId>gs-core</artifactId>
        <version>2.0</version>
    </dependency>
    <dependency>
        <groupId>com.github.graphstream</groupId>
        <artifactId>gs-ui-swing</artifactId>
        <version>2.0</version>
    </dependency>
</dependencies>

You can use any version of gs-core and gs-ui-swing you need, provided they are the same. Simply specify the desired version in the <version> tag. The version can be a git tag name (e.g. 2.0), a commit number, or a branch name followed by -SNAPSHOT (e.g. dev-SNAPSHOT). More details on the possible versions on jitpack.

Configure UI

Finally, gs-core needs to be told which UI implementation to use. Simply add a system property to you project:

System.setProperty("org.graphstream.ui", "swing");

Or use the command line :

java -Dorg.graphstream.ui=swing YourClass

Camera and Visualization

GraphStream spring has camera movement build in. Besides being able to move elements around with the mouse following keys have a feature:

left/right/up/down: Move the camera in that direction.
page start: Zoom in
page end: Zoom out
SHIFT + r: Reset camera view.

Further information about usage can be found in our Graph-Visualisation tutorial.

Help

You may check the documentation on the website. You may also share your questions on the mailing list at http://sympa.litislab.fr/sympa/subscribe/graphstream-users

License

See the COPYING file.

barrybecker4 / gs-ui-swing