How to Use

Usage in ZGameEditor project

1. Create ZGE project or use existing one.
2. Include ZExternalLibrary component for ZgeBox2D library to the OnLoaded section of ZApplication.
3. Initialize the simulation world with zb2InitWorld(). This call is usually placed to the OnLoaded section of ZApplication or OnStart section of AppState component.
4. Regularly step the simulation with zb2Step() function. To achieve real-time simulation, the first parameter is usually set to App.DeltaTime. This is usually placed to OnUpdate section of ZApplication or AppState components.
5. Create 2D bodies, change their properties or request their simulation properties (position, rotation, contact points) in your code as needed. Usually, a body is represented by a model instance. In this case, creation of body is done in the OnSpawn section, updating position, rotation and querying in the OnUpdate section, and destroying 2D body in the OnRemove section of the Model or ModelState.
6. On application exit, sestroy the simulation world with zb2DestroyWorld() function. This call is usually placed to OnClose section of ZApplication component or OnLeave section of AppState.

For examples of usage, see the ZgeBox2D Testbed application at the download page.

Compiling Android application

1. Compile your Android application, e.g., use Project / Android: Build APK (debug) menu item.
2. Place libZGEBox2D.so file to the libs/armeabi folder.
3. Compile the APK again as in step 1.
4. Deploy the APK file to your Android device and install it in standard way.

Note 1: The 1st and 2nd steps are required only when the application is built the first time. After that, a single compilation produces correct APK.

Note 2: Use the step 2 also in the case when updating to a newer version of the ZgeBox2D library.