dyn4j / Dyn4j
Programming Languages
Projects that are alternatives of or similar to Dyn4j
Java Collision Detection and Physics Engine
A 100% Java 2D collision detection and physics engine. Designed to be fast, stable, extensible, and easy to use. dyn4j is free for use in commercial and non-commercial applications.
The project is comprised of the main project and tests managed here and two others:
- dyn4j-samples A collection of samples to help get started
- dyn4j-sandbox A non-trivial desktop application that allows users to build scenes, run, save, and load them - all built with dyn4j as the simulation engine.
Requirements
- Java 1.6+
Getting Started
dyn4j comes with a lot of features and extensibility, but getting started is easy. If you are looking for a quick start, take a look at the following video.
Step 1: Add dyn4j to Your Project
Add dyn4j to your classpath by adding a Maven dependency from Maven Central or GitHub Packages
<dependency>
<groupId>org.dyn4j</groupId>
<artifactId>dyn4j</artifactId>
<version>4.1.4</version>
</dependency>
If you are not using Maven you can download the jar from either of the links above.
NOTE: Releases are no longer being created as of 3.4.0.
Step 2: Create a World
World<Body> world = new World<Body>();
This creates a new simulation environment with default settings. The default settings use the meter-kilogram-seconds system and include the default pipeline classes.
Step 3: Add Some Bodies
Body body = new Body();
body.addFixture(Geometry.createCircle(1.0));
body.translate(1.0, 0.0);
body.setMass(MassType.Normal);
world.addBody(body);
A body is the primary unit of simulation and completely rigid. A body is comprised of many fixtures or shapes. While the shapes of dyn4j are all convex (and must be), a collection of these shapes can be used to create a body that is not. A body can be initially placed in a scene by translating or rotating it. Once the shape(s) of a body is defined, it must be given a mass by calling a setMass method. The mass type is typically MassType.NORMAL or MassType.INFINITE. When set to NORMAL, the mass will be calculated based on the shapes. An INFINITE mass body might represent a floor, ground, or something unmovable.
Step 4: Add Some Joints
PinJoint<Body> joint = new PinJoint<Body>(body, new Vector2(0, 0), 4, 0.7, 1000);
world.addJoint(joint);
A joint is a constraint on the motion of one or more bodies. There are many joint types that serve different purposes. Generally, joints are used to link bodies together in a specified way. Bodies can have multiple joints attached to them making for some interesting combinations.
Step 5: Run the Simulation
for (int i = 0; i < 100; i++) {
world.step(1);
}
Unlike this example, a GUI based application you would call the World.update(elapsedTime) method in it's render loop. Either way, each time the world is advanced forward in time (which may or may not occur when using the World.update(elapsedTime) methods) the bodies added to it will be moved based on the world gravity (if any) and will interact with other bodies placed in the world.
Next Steps
From here you should take a look at the dyn4j-samples sub project to get a jump start with a simple Java2D framework. You can also check out the documentation here.
Links
- www.dyn4j.org
- Latest Release Notes
- Latest Javadocs
- Forum - disabled but still a good resource
- Blog
Building
- Maven build goals: clean package
- Check artifact class version:
- javap -verbose -classpath /path/to/jar/dyn4j.jar org.dyn4j.Version 50
- javap -verbose -classpath /path/to/jar/dyn4j.jar module-info 53+