toxiclibs 0.4.0 → 0.8.0

data/src/toxi/physics2d/constraints/AngularConstraint.java

@@ -0,0 +1,83 @@
+/*
+ *   __               .__       .__  ._____.           
+ * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
+ * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
+ *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
+ *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
+ *                   \/       \/             \/     \/ 
+ *
+ * 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.physics2d.constraints;
+
+import toxi.geom.Vec2D;
+import toxi.math.MathUtils;
+import toxi.physics2d.VerletParticle2D;
+
+/**
+ *
+ * @author tux
+ */
+public class AngularConstraint implements ParticleConstraint2D {
+
+    /**
+     *
+     */
+    public Vec2D rootPos;
+
+    /**
+     *
+     */
+    public float theta;
+
+    /**
+     *
+     * @param theta
+     */
+    public AngularConstraint(float theta) {
+        this.theta = theta;
+    }
+
+    /**
+     *
+     * @param theta
+     */
+    public AngularConstraint(int theta) {
+        this.theta = MathUtils.radians(theta);
+    }
+
+    /**
+     *
+     * @param p
+     * @param theta
+     */
+    public AngularConstraint(Vec2D p, int theta) {
+        rootPos = new Vec2D(p);
+        this.theta = MathUtils.radians(theta);
+    }
+
+    @Override
+    public void apply(VerletParticle2D p) {
+        Vec2D delta = p.sub(rootPos);
+        float heading = MathUtils.floor(delta.heading() / theta) * theta;
+        p.set(rootPos.add(Vec2D.fromTheta(heading).scaleSelf(delta.magnitude())));
+    }
+
+}

data/src/toxi/physics2d/constraints/AxisConstraint.java

@@ -0,0 +1,71 @@
+/*
+ *   __               .__       .__  ._____.           
+ * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
+ * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
+ *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
+ *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
+ *                   \/       \/             \/     \/ 
+ *
+ * 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.physics2d.constraints;
+
+import toxi.geom.Vec2D;
+import toxi.geom.Vec2D.Axis;
+import toxi.physics2d.VerletParticle2D;
+
+/**
+ * Constrains a particle's movement by locking a given axis to a fixed value.
+ */
+public class AxisConstraint implements ParticleConstraint2D {
+
+    /**
+     *
+     */
+    public float constraint;
+
+    /**
+     *
+     */
+    public Axis axis;
+
+    /**
+     * @param axis
+     *            axis to lock
+     * @param constraint
+     *            constrain the axis to this value
+     */
+    public AxisConstraint(Vec2D.Axis axis, float constraint) {
+        this.axis = axis;
+        this.constraint = constraint;
+    }
+
+    /*
+     * (non-Javadoc)
+     * 
+     * @see
+     * toxi.physics.IParticleConstraint#apply(toxi.physics.VerletParticle2D)
+     */
+    @Override
+    public void apply(VerletParticle2D p) {
+        p.setComponent(axis, constraint);
+    }
+
+}

data/src/toxi/physics2d/constraints/CircularConstraint.java

@@ -0,0 +1,69 @@
+/*
+ *   __               .__       .__  ._____.           
+ * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
+ * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
+ *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
+ *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
+ *                   \/       \/             \/     \/ 
+ *
+ * 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.physics2d.constraints;
+
+import toxi.geom.Circle;
+import toxi.geom.Vec2D;
+import toxi.physics2d.VerletParticle2D;
+
+/**
+ *
+ * @author tux
+ */
+public class CircularConstraint implements ParticleConstraint2D {
+
+    /**
+     *
+     */
+    public Circle circle;
+
+    /**
+     *
+     * @param circle
+     */
+    public CircularConstraint(Circle circle) {
+        this.circle = circle;
+    }
+
+    /**
+     *
+     * @param origin
+     * @param radius
+     */
+    public CircularConstraint(Vec2D origin, float radius) {
+        this.circle = new Circle(origin, radius);
+    }
+
+    @Override
+    public void apply(VerletParticle2D p) {
+        if (circle.containsPoint(p)) {
+            p.set(circle.add(p.sub(circle).normalizeTo(circle.getRadius())));
+        }
+    }
+
+}

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

@@ -0,0 +1,66 @@
+/*
+ *   __               .__       .__  ._____.           
+ * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
+ * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
+ *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
+ *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
+ *                   \/       \/             \/     \/ 
+ *
+ * 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.physics2d.constraints;
+
+import toxi.geom.Vec2D.Axis;
+import toxi.physics2d.VerletParticle2D;
+
+/**
+ *
+ * @author tux
+ */
+public class MaxConstraint implements ParticleConstraint2D {
+
+    /**
+     *
+     */
+    public Axis axis;
+
+    /**
+     *
+     */
+    public float threshold;
+
+    /**
+     *
+     * @param axis
+     * @param threshold
+     */
+    public MaxConstraint(Axis axis, float threshold) {
+        this.axis = axis;
+        this.threshold = threshold;
+    }
+
+    @Override
+    public void apply(VerletParticle2D p) {
+        if (p.getComponent(axis) > threshold) {
+            p.setComponent(axis, threshold);
+        }
+    }
+
+}

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

@@ -0,0 +1,66 @@
+/*
+ *   __               .__       .__  ._____.           
+ * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
+ * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
+ *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
+ *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
+ *                   \/       \/             \/     \/ 
+ *
+ * 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.physics2d.constraints;
+
+import toxi.geom.Vec2D.Axis;
+import toxi.physics2d.VerletParticle2D;
+
+/**
+ *
+ * @author tux
+ */
+public class MinConstraint implements ParticleConstraint2D {
+
+    /**
+     *
+     */
+    public Axis axis;
+
+    /**
+     *
+     */
+    public float threshold;
+
+    /**
+     *
+     * @param axis
+     * @param threshold
+     */
+    public MinConstraint(Axis axis, float threshold) {
+        this.axis = axis;
+        this.threshold = threshold;
+    }
+
+    @Override
+    public void apply(VerletParticle2D p) {
+        if (p.getComponent(axis) < threshold) {
+            p.setComponent(axis, threshold);
+        }
+    }
+
+}

data/src/toxi/physics2d/constraints/ParticleConstraint2D.java

@@ -0,0 +1,47 @@
+/*
+ *   __               .__       .__  ._____.           
+ * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
+ * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
+ *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
+ *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
+ *                   \/       \/             \/     \/ 
+ *
+ * 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.physics2d.constraints;
+
+import toxi.physics2d.VerletParticle2D;
+
+/**
+ * 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.
+ */
+public interface ParticleConstraint2D {
+
+    /**
+     * Applies the constraint to the passed in particle. The method is assumed
+     * to manipulate the given instance directly.
+     * 
+     * @param p
+     *            particle
+     */
+    public void apply(VerletParticle2D p);
+}

data/src/toxi/physics2d/constraints/PolygonConstraint.java

@@ -0,0 +1,93 @@
+/*
+ *   __               .__       .__  ._____.           
+ * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
+ * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
+ *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
+ *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
+ *                   \/       \/             \/     \/ 
+ *
+ * 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.physics2d.constraints;
+
+import toxi.geom.Polygon2D;
+import toxi.physics2d.VerletParticle2D;
+
+/**
+ *
+ * @author tux
+ */
+public class PolygonConstraint implements ParticleConstraint2D {
+
+    /**
+     *
+     */
+    protected Polygon2D poly;
+    private boolean isContainer;
+
+    /**
+     *
+     * @param poly
+     * @param isContainer
+     */
+    public PolygonConstraint(Polygon2D poly, boolean isContainer) {
+        this.poly = poly;
+        this.isContainer = isContainer;
+    }
+
+    @Override
+    public void apply(VerletParticle2D p) {
+        if (poly.containsPoint(p) != isContainer) {
+            p.constrain(poly);
+        }
+    }
+
+    /**
+     *
+     * @return
+     */
+    public Polygon2D getPolygon() {
+        return poly;
+    }
+
+    /**
+     *
+     * @return
+     */
+    public boolean isContainer() {
+        return isContainer;
+    }
+
+    /**
+     *
+     * @param isContainer
+     */
+    public void setIsContainer(boolean isContainer) {
+        this.isContainer = isContainer;
+    }
+
+    /**
+     *
+     * @param poly
+     */
+    public void setPolygon(Polygon2D poly) {
+        this.poly = poly;
+    }
+}