org.jbox2d.collision.broadphase.BroadPhase Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jbox2d-library Show documentation
Show all versions of jbox2d-library Show documentation
A 2D java physics engine, a port of the C++ Box2d engine. This is the core physics engine.
/*******************************************************************************
* Copyright (c) 2011, Daniel Murphy
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
* * Neither the name of the nor the
* names of its contributors may be used to endorse or promote products
* derived from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL DANIEL MURPHY BE LIABLE FOR ANY
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
******************************************************************************/
package org.jbox2d.collision.broadphase;
import java.util.Arrays;
import org.jbox2d.callbacks.DebugDraw;
import org.jbox2d.callbacks.PairCallback;
import org.jbox2d.callbacks.TreeCallback;
import org.jbox2d.callbacks.TreeRayCastCallback;
import org.jbox2d.collision.AABB;
import org.jbox2d.collision.RayCastInput;
import org.jbox2d.common.Settings;
import org.jbox2d.common.Vec2;
// updated to rev 100
/**
* The broad-phase is used for computing pairs and performing volume queries and ray
* casts.
* This broad-phase does not persist pairs. Instead, this reports potentially new pairs.
* It is up to the client to consume the new pairs and to track subsequent overlap.
*
* @author Daniel Murphy
*/
public class BroadPhase implements TreeCallback {
public static final int NULL_PROXY = -1;
private final DynamicTree m_tree;
private int m_proxyCount;
private DynamicTreeNode[] m_moveBuffer;
private int m_moveCapacity;
private int m_moveCount;
private Pair[] m_pairBuffer;
private int m_pairCapacity;
private int m_pairCount;
private DynamicTreeNode m_queryProxy;
public BroadPhase() {
m_proxyCount = 0;
m_pairCapacity = 16;
m_pairCount = 0;
m_pairBuffer = new Pair[m_pairCapacity];
for (int i = 0; i < m_pairCapacity; i++) {
m_pairBuffer[i] = new Pair();
}
m_moveCapacity = 16;
m_moveCount = 0;
m_moveBuffer = new DynamicTreeNode[m_moveCapacity];
m_tree = new DynamicTree();
m_queryProxy = null;
}
/**
* Create a proxy with an initial AABB. Pairs are not reported until
* updatePairs is called.
*
* @param aabb
* @param userData
* @return
*/
public final DynamicTreeNode createProxy(final AABB aabb, Object userData) {
DynamicTreeNode node = m_tree.createProxy(aabb, userData);
++m_proxyCount;
bufferMove(node);
return node;
}
/**
* Destroy a proxy. It is up to the client to remove any pairs.
*
* @param proxyId
*/
public final void destroyProxy(DynamicTreeNode proxy) {
unbufferMove(proxy);
--m_proxyCount;
m_tree.destroyProxy(proxy);
}
/**
* Call MoveProxy as many times as you like, then when you are done
* call UpdatePairs to finalized the proxy pairs (for your time step).
*/
public final void moveProxy(DynamicTreeNode proxy, final AABB aabb, final Vec2 displacement) {
boolean buffer = m_tree.moveProxy(proxy, aabb, displacement);
if (buffer) {
bufferMove(proxy);
}
}
public boolean testOverlap(DynamicTreeNode proxyA, DynamicTreeNode proxyB) {
// return AABB.testOverlap(proxyA.aabb, proxyB.aabb);
AABB a = proxyA.aabb;
AABB b = proxyB.aabb;
if (b.lowerBound.x - a.upperBound.x > 0.0f || b.lowerBound.y - a.upperBound.y > 0.0f) {
return false;
}
if (a.lowerBound.x - b.upperBound.x > 0.0f || a.lowerBound.y - b.upperBound.y > 0.0f) {
return false;
}
return true;
}
/**
* Get the number of proxies.
*
* @return
*/
public final int getProxyCount() {
return m_proxyCount;
}
public void drawTree(DebugDraw argDraw) {
m_tree.drawTree(argDraw);
}
/**
* Update the pairs. This results in pair callbacks. This can only add pairs.
*
* @param callback
*/
public final void updatePairs(PairCallback callback) {
// log.debug("beginning to update pairs");
// Reset pair buffer
m_pairCount = 0;
// Perform tree queries for all moving proxies.
for (int i = 0; i < m_moveCount; ++i) {
m_queryProxy = m_moveBuffer[i];
if (m_queryProxy == null) {
continue;
}
// We have to query the tree with the fat AABB so that
// we don't fail to create a pair that may touch later.
// final AABB fatAABB = m_tree.getFatAABB(m_queryProxy);
// Query tree, create pairs and add them pair buffer.
// log.debug("quering aabb: "+m_queryProxy.aabb);
m_tree.query(this, m_queryProxy.aabb);
}
// log.debug("Number of pairs found: "+m_pairCount);
// Reset move buffer
m_moveCount = 0;
// Sort the pair buffer to expose duplicates.
Arrays.sort(m_pairBuffer, 0, m_pairCount);
// Send the pairs back to the client.
int i = 0;
while (i < m_pairCount) {
Pair primaryPair = m_pairBuffer[i];
Object userDataA = primaryPair.proxyA.userData;
Object userDataB = primaryPair.proxyB.userData;
// log.debug("returning pair: "+userDataA+", "+userDataB);
callback.addPair(userDataA, userDataB);
++i;
// Skip any duplicate pairs.
while (i < m_pairCount) {
Pair pair = m_pairBuffer[i];
if (pair.proxyA != primaryPair.proxyA || pair.proxyB != primaryPair.proxyB) {
break;
}
// log.debug("skipping duplicate");
++i;
}
}
// Try to keep the tree balanced.
m_tree.rebalance(Settings.TREE_REBALANCE_STEPS);
}
/**
* Query an AABB for overlapping proxies. The callback class
* is called for each proxy that overlaps the supplied AABB.
*
* @param callback
* @param aabb
*/
public final void query(final TreeCallback callback, final AABB aabb) {
m_tree.query(callback, aabb);
}
/**
* Ray-cast against the proxies in the tree. This relies on the callback
* to perform a exact ray-cast in the case were the proxy contains a shape.
* The callback also performs the any collision filtering. This has performance
* roughly equal to k * log(n), where k is the number of collisions and n is the
* number of proxies in the tree.
*
* @param input
* the ray-cast input data. The ray extends from p1 to p1 + maxFraction *
* (p2 - p1).
* @param callback
* a callback class that is called for each proxy that is hit by the ray.
*/
public final void raycast(final TreeRayCastCallback callback, final RayCastInput input) {
m_tree.raycast(callback, input);
}
/**
* Compute the height of the embedded tree.
*
* @return
*/
public final int computeHeight() {
return m_tree.computeHeight();
}
protected final void bufferMove(DynamicTreeNode node) {
if (m_moveCount == m_moveCapacity) {
DynamicTreeNode[] old = m_moveBuffer;
m_moveCapacity *= 2;
m_moveBuffer = new DynamicTreeNode[m_moveCapacity];
for (int i = 0; i < old.length; i++) {
m_moveBuffer[i] = old[i];
}
}
m_moveBuffer[m_moveCount] = node;
++m_moveCount;
}
protected final void unbufferMove(DynamicTreeNode proxy) {
for (int i = 0; i < m_moveCount; i++) {
if (m_moveBuffer[i] == proxy) {
m_moveBuffer[i] = null;
return;
}
}
}
// private final PairStack pairStack = new PairStack();
/**
* This is called from DynamicTree::query when we are gathering pairs.
*/
public final boolean treeCallback(DynamicTreeNode proxy) {
// log.debug("Got a proxy back");
// A proxy cannot form a pair with itself.
if (proxy == m_queryProxy) {
// log.debug("It was us...");
return true;
}
// Grow the pair buffer as needed.
if (m_pairCount == m_pairCapacity) {
Pair[] oldBuffer = m_pairBuffer;
m_pairCapacity *= 2;
m_pairBuffer = new Pair[m_pairCapacity];
for (int i = 0; i < oldBuffer.length; i++) {
m_pairBuffer[i] = oldBuffer[i];
}
for (int i = oldBuffer.length; i < m_pairCapacity; i++) {
m_pairBuffer[i] = new Pair();
}
}
// m_pairBuffer[m_pairCount]proxyIdA = b2Min(proxyId, m_queryProxyId);
// m_pairBuffer[m_pairCount].proxyIdB = b2Max(proxyId, m_queryProxyId);
if (proxy.key < m_queryProxy.key) {
// log.debug("new proxy is first");
m_pairBuffer[m_pairCount].proxyA = proxy;
m_pairBuffer[m_pairCount].proxyB = m_queryProxy;
}
else {
// log.debug("new proxy is second");
m_pairBuffer[m_pairCount].proxyA = m_queryProxy;
m_pairBuffer[m_pairCount].proxyB = proxy;
}
++m_pairCount;
return true;
}
}