toxiclibs 0.4.0 → 0.8.0

data/src/toxi/physics3d/constraints/BoxConstraint.java

@@ -0,0 +1,121 @@
+/*
+ *   __               .__       .__  ._____.           
+ * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
+ * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
+ *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
+ *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
+ *                   \/       \/             \/     \/ 
+ *
+ * Copyright (c) 2006-2011 Karsten Schmidt
+ * 
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ * 
+ * http://creativecommons.org/licenses/LGPL/2.1/
+ * 
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ * 
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
+ */
+
+package toxi.physics3d.constraints;
+
+import toxi.geom.AABB;
+import toxi.geom.Ray3D;
+import toxi.geom.Vec3D;
+import toxi.physics3d.VerletParticle3D;
+
+/**
+ *
+ * @author tux
+ */
+public class BoxConstraint implements ParticleConstraint3D {
+
+    /**
+     *
+     */
+    protected AABB box;
+
+    /**
+     *
+     */
+    protected Ray3D intersectRay;
+    private float restitution = 1;
+
+    /**
+     *
+     * @param box
+     */
+    public BoxConstraint(AABB box) {
+        this.box = box.copy();
+        this.intersectRay = new Ray3D(box, new Vec3D());
+    }
+
+    /**
+     *
+     * @param min
+     * @param max
+     */
+    public BoxConstraint(Vec3D min, Vec3D max) {
+        this(AABB.fromMinMax(min, max));
+    }
+
+    @Override
+    public void apply(VerletParticle3D p) {
+        if (p.isInAABB(box)) {
+            Vec3D dir = p.getVelocity();
+            Vec3D prev = p.getPreviousPosition();
+            if (prev.isInAABB(box)) {
+                dir.invert();
+            }
+            intersectRay.set(prev);
+            intersectRay.setDirection(dir);
+            Vec3D isec = box.intersectsRay(intersectRay, 0, Float.MAX_VALUE);
+            if (isec != null) {
+                isec.addSelf(box.getNormalForPoint(isec).scaleSelf(0.01f));
+                p.setPreviousPosition(isec);
+                p.set(isec.sub(dir.scaleSelf(restitution)));
+            }
+        }
+    }
+
+    /**
+     *
+     * @return
+     */
+    public AABB getBox() {
+        return box.copy();
+    }
+
+    /**
+     *
+     * @return
+     */
+    public float getRestitution() {
+        return restitution;
+    }
+
+    /**
+     *
+     * @param box
+     */
+    public void setBox(AABB box) {
+        this.box = box.copy();
+        intersectRay.set(box);
+    }
+
+    /**
+     *
+     * @param restitution
+     */
+    public void setRestitution(float restitution) {
+        this.restitution = restitution;
+    }
+}

data/src/toxi/physics3d/constraints/CylinderConstraint.java

@@ -0,0 +1,87 @@
+/*
+ *   __               .__       .__  ._____.           
+ * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
+ * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
+ *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
+ *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
+ *                   \/       \/             \/     \/ 
+ *
+ * Copyright (c) 2006-2011 Karsten Schmidt
+ * 
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ * 
+ * http://creativecommons.org/licenses/LGPL/2.1/
+ * 
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ * 
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
+ */
+
+package toxi.physics3d.constraints;
+
+import toxi.geom.AxisAlignedCylinder;
+import toxi.geom.Vec3D;
+import toxi.physics3d.VerletParticle3D;
+
+/**
+ *
+ * @author tux
+ */
+public class CylinderConstraint implements ParticleConstraint3D {
+
+    /**
+     *
+     */
+    protected AxisAlignedCylinder cylinder;
+
+    /**
+     *
+     */
+    protected Vec3D centroid = new Vec3D();
+
+    /**
+     *
+     */
+    protected Vec3D.Axis axis;
+
+    /**
+     *
+     * @param cylinder
+     */
+    public CylinderConstraint(AxisAlignedCylinder cylinder) {
+        setCylinder(cylinder);
+    }
+
+    public void apply(VerletParticle3D p) {
+        if (cylinder.containsPoint(p)) {
+            centroid.setComponent(axis, p.getComponent(axis));
+            p.set(centroid.add(p.sub(centroid)
+                    .normalizeTo(cylinder.getRadius())));
+        }
+    }
+
+    /**
+     * @return the cylinder
+     */
+    public AxisAlignedCylinder getCylinder() {
+        return cylinder;
+    }
+
+    /**
+     * @param cylinder
+     *            the cylinder to set
+     */
+    public void setCylinder(AxisAlignedCylinder cylinder) {
+        this.cylinder = cylinder;
+        centroid.set(cylinder.getPosition());
+        axis = cylinder.getMajorAxis();
+    }
+}

data/src/toxi/physics3d/constraints/MaxConstraint.java

@@ -0,0 +1,65 @@
+/*
+ *   __               .__       .__  ._____.           
+ * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
+ * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
+ *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
+ *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
+ *                   \/       \/             \/     \/ 
+ *
+ * Copyright (c) 2006-2011 Karsten Schmidt
+ * 
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ * 
+ * http://creativecommons.org/licenses/LGPL/2.1/
+ * 
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ * 
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
+ */
+
+package toxi.physics3d.constraints;
+
+import toxi.geom.Vec3D.Axis;
+import toxi.physics3d.VerletParticle3D;
+
+/**
+ *
+ * @author tux
+ */
+public class MaxConstraint implements ParticleConstraint3D {
+
+    /**
+     *
+     */
+    public Axis axis;
+
+    /**
+     *
+     */
+    public float threshold;
+
+    /**
+     *
+     * @param axis
+     * @param threshold
+     */
+    public MaxConstraint(Axis axis, float threshold) {
+        this.axis = axis;
+        this.threshold = threshold;
+    }
+
+    public void apply(VerletParticle3D p) {
+        if (p.getComponent(axis) > threshold) {
+            p.setComponent(axis, threshold);
+        }
+    }
+
+}

data/src/toxi/physics3d/constraints/MinConstraint.java

@@ -0,0 +1,65 @@
+/*
+ *   __               .__       .__  ._____.           
+ * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
+ * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
+ *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
+ *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
+ *                   \/       \/             \/     \/ 
+ *
+ * Copyright (c) 2006-2011 Karsten Schmidt
+ * 
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ * 
+ * http://creativecommons.org/licenses/LGPL/2.1/
+ * 
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ * 
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
+ */
+
+package toxi.physics3d.constraints;
+
+import toxi.geom.Vec3D.Axis;
+import toxi.physics3d.VerletParticle3D;
+
+/**
+ *
+ * @author tux
+ */
+public class MinConstraint implements ParticleConstraint3D {
+
+    /**
+     *
+     */
+    public Axis axis;
+
+    /**
+     *
+     */
+    public float threshold;
+
+    /**
+     *
+     * @param axis
+     * @param threshold
+     */
+    public MinConstraint(Axis axis, float threshold) {
+        this.axis = axis;
+        this.threshold = threshold;
+    }
+
+    public void apply(VerletParticle3D p) {
+        if (p.getComponent(axis) < threshold) {
+            p.setComponent(axis, threshold);
+        }
+    }
+
+}

data/src/toxi/physics3d/constraints/ParticleConstraint3D.java

@@ -0,0 +1,49 @@
+/*
+ *   __               .__       .__  ._____.           
+ * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
+ * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
+ *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
+ *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
+ *                   \/       \/             \/     \/ 
+ *
+ * Copyright (c) 2006-2011 Karsten Schmidt
+ * 
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ * 
+ * http://creativecommons.org/licenses/LGPL/2.1/
+ * 
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ * 
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
+ */
+
+package toxi.physics3d.constraints;
+
+import toxi.physics3d.VerletParticle3D;
+
+/**
+ * Defines an interface used to constrain VerletParticles based on a custom
+ * criteria (e.g. only allowed to move along an axis or shape etc.). The
+ * constraints will be applied directly after each spring update. Constraints
+ * are only applied to particles they've been assigned to and which are not
+ * locked.
+ */
+public interface ParticleConstraint3D {
+
+    /**
+     * Applies the constraint to the passed in particle. The method is assumed
+     * to manipulate the given instance directly.
+     * 
+     * @param p
+     *            particle
+     */
+    public void apply(VerletParticle3D p);
+}

data/src/toxi/physics3d/constraints/PlaneConstraint.java

@@ -0,0 +1,78 @@
+/*
+ *   __               .__       .__  ._____.           
+ * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
+ * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
+ *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
+ *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
+ *                   \/       \/             \/     \/ 
+ *
+ * Copyright (c) 2006-2011 Karsten Schmidt
+ * 
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ * 
+ * http://creativecommons.org/licenses/LGPL/2.1/
+ * 
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ * 
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
+ */
+
+package toxi.physics3d.constraints;
+
+import toxi.geom.Vec3D;
+import toxi.geom.Vec3D.Axis;
+import toxi.physics3d.VerletParticle3D;
+
+/**
+ * Constrains a particle's movement by locking it to a fixed axis aligned plane.
+ */
+public class PlaneConstraint implements ParticleConstraint3D {
+
+    /**
+     *
+     */
+    public Vec3D constraint;
+    public Axis axis1,
+
+    /**
+     *
+     */
+
+    /**
+     *
+     */
+    axis2;
+
+    /**
+     * @param axis
+     *            1st axis to lock
+     * @param axis2
+     *            2d axis to lock
+     * @param constraint
+     *            point on the desired constraint plane
+     */
+    public PlaneConstraint(Axis axis, Axis axis2, Vec3D constraint) {
+        this.axis1 = axis;
+        this.axis2 = axis2;
+        this.constraint = constraint;
+    }
+
+    /*
+     * (non-Javadoc)
+     * 
+     * @see toxi.physics.IParticleConstraint#apply(toxi.physics.VerletParticle)
+     */
+    public void apply(VerletParticle3D p) {
+        p.setComponent(axis1, constraint.getComponent(axis1));
+        p.setComponent(axis2, constraint.getComponent(axis2));
+    }
+
+}