toxiclibs 1.0.0 → 2.0.0

data/src/toxi/physics3d/VerletParticle3D.java

@@ -1,385 +0,0 @@
-/*
- *   __               .__       .__  ._____.           
- * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
- * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
- *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
- *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
- *                   \/       \/             \/     \/ 
- *
- * 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;
-
-import java.util.ArrayList;
-import java.util.List;
-
-import toxi.geom.AABB;
-import toxi.geom.ReadonlyVec3D;
-import toxi.geom.Vec3D;
-import toxi.physics3d.behaviors.ParticleBehavior3D;
-import toxi.physics3d.constraints.ParticleConstraint3D;
-
-/**
- * An individual 3D particle for use by the VerletPhysics and VerletSpring
- * classes. A particle has weight, can be locked in space and its position
- * constrained inside an (optional) axis-aligned bounding box.
- */
-public class VerletParticle3D extends Vec3D {
-
-    protected Vec3D prev,
-
-    /**
-     *
-     */
-
-    /**
-     *
-     */
-    temp;
-
-    /**
-     *
-     */
-    protected boolean isLocked;
-
-    /**
-     * Bounding box, by default set to null to disable
-     */
-    public AABB bounds;
-
-    /**
-     * An optional particle constraints, called immediately after a particle is
-     * updated (and only used if particle is unlocked (default)
-     */
-    public List<ParticleConstraint3D> constraints;
-
-    /**
-     *
-     */
-    public List<ParticleBehavior3D> behaviors;
-
-    /**
-     * Particle weight, default = 1
-     */
-    protected float weight, invWeight;
-
-    /**
-     *
-     */
-    protected Vec3D force = new Vec3D();
-
-    /**
-     * Creates particle at position xyz
-     * 
-     * @param x
-     * @param y
-     * @param z
-     */
-    public VerletParticle3D(float x, float y, float z) {
-        this(x, y, z, 1);
-    }
-
-    /**
-     * Creates particle at position xyz with weight w
-     * 
-     * @param x
-     * @param y
-     * @param z
-     * @param w
-     */
-    public VerletParticle3D(float x, float y, float z, float w) {
-        super(x, y, z);
-        prev = new Vec3D(this);
-        temp = new Vec3D();
-        setWeight(w);
-    }
-
-    /**
-     * Creates particle at the position of the passed in vector
-     * 
-     * @param v
-     *            position
-     */
-    public VerletParticle3D(ReadonlyVec3D v) {
-        this(v.x(), v.y(), v.z(), 1);
-    }
-
-    /**
-     * Creates particle with weight w at the position of the passed in vector
-     * 
-     * @param v
-     *            position
-     * @param w
-     *            weight
-     */
-    public VerletParticle3D(ReadonlyVec3D v, float w) {
-        this(v.x(), v.y(), v.z(), w);
-    }
-
-    /**
-     * Creates a copy of the passed in particle
-     * 
-     * @param p
-     */
-    public VerletParticle3D(VerletParticle3D p) {
-        this(p.x, p.y, p.z, p.weight);
-        isLocked = p.isLocked;
-    }
-
-    /**
-     *
-     * @param behavior
-     * @return
-     */
-    public VerletParticle3D addBehavior(ParticleBehavior3D behavior) {
-        return addBehavior(behavior, 1);
-    }
-
-    /**
-     *
-     * @param behavior
-     * @param timeStep
-     * @return
-     */
-    public VerletParticle3D addBehavior(ParticleBehavior3D behavior, float timeStep) {
-        if (behaviors == null) {
-            behaviors = new ArrayList<ParticleBehavior3D>(1);
-        }
-        behavior.configure(timeStep);
-        behaviors.add(behavior);
-        return this;
-    }
-
-    /**
-     * Adds the given constraint implementation to the list of constraints
-     * applied to this particle at each time step.
-     * 
-     * @param c
-     *            constraint instance
-     * @return itself
-     */
-    public VerletParticle3D addConstraint(ParticleConstraint3D c) {
-        if (constraints == null) {
-            constraints = new ArrayList<ParticleConstraint3D>(1);
-        }
-        constraints.add(c);
-        return this;
-    }
-
-    /**
-     *
-     * @param f
-     * @return
-     */
-    public VerletParticle3D addForce(Vec3D f) {
-        force.addSelf(f);
-        return this;
-    }
-
-    /**
-     *
-     * @param v
-     * @return
-     */
-    public VerletParticle3D addVelocity(Vec3D v) {
-        prev.subSelf(v);
-        return this;
-    }
-
-    /**
-     *
-     */
-    public void applyBehaviors() {
-        if (behaviors != null) {
-            for (ParticleBehavior3D b : behaviors) {
-                b.apply(this);
-            }
-        }
-    }
-
-    /**
-     *
-     */
-    public void applyConstraints() {
-        if (constraints != null) {
-            for (ParticleConstraint3D pc : constraints) {
-                pc.apply(this);
-            }
-        }
-    }
-
-    /**
-     *
-     */
-    protected void applyForce() {
-        temp.set(this);
-        addSelf(sub(prev).addSelf(force.scale(weight)));
-        prev.set(temp);
-        force.clear();
-    }
-
-    /**
-     * Removes any currently applied constraints from this particle.
-     * 
-     * @return itself
-     */
-    public VerletParticle3D clearConstraints() {
-        constraints.clear();
-        return this;
-    }
-
-    /**
-     *
-     * @return
-     */
-    public VerletParticle3D clearForce() {
-        force.clear();
-        return this;
-    }
-
-    /**
-     *
-     * @return
-     */
-    public VerletParticle3D clearVelocity() {
-        prev.set(this);
-        return this;
-    }
-
-    /**
-     * @return the inverse weight (1/weight)
-     */
-    public final float getInvWeight() {
-        return invWeight;
-    }
-
-    /**
-     * Returns the particle's position at the most recent time step.
-     * 
-     * @return previous position
-     */
-    public Vec3D getPreviousPosition() {
-        return prev;
-    }
-
-    /**
-     *
-     * @return
-     */
-    public Vec3D getVelocity() {
-        return sub(prev);
-    }
-
-    /**
-     * @return the weight
-     */
-    public final float getWeight() {
-        return weight;
-    }
-
-    /**
-     * @return true, if particle is locked
-     */
-    public final boolean isLocked() {
-        return isLocked;
-    }
-
-    /**
-     * Locks/immobilizes particle in space
-     * 
-     * @return itself
-     */
-    public VerletParticle3D lock() {
-        isLocked = true;
-        return this;
-    }
-
-    /**
-     *
-     * @param b
-     * @return
-     */
-    public boolean removeBehavior(ParticleBehavior3D b) {
-        return behaviors.remove(b);
-    }
-
-    /**
-     * Attempts to remove the given constraint instance from the list of active
-     * constraints.
-     * 
-     * @param c
-     *            constraint to remove
-     * @return true, if successfully removed
-     */
-    public boolean removeConstraint(ParticleConstraint3D c) {
-        return constraints.remove(c);
-    }
-
-    /**
-     *
-     * @param scl
-     * @return
-     */
-    public VerletParticle3D scaleVelocity(float scl) {
-        prev.interpolateToSelf(this, 1f - scl);
-        return this;
-    }
-
-    /**
-     *
-     * @param p
-     * @return
-     */
-    public VerletParticle3D setPreviousPosition(Vec3D p) {
-        prev.set(p);
-        return this;
-    }
-
-    /**
-     *
-     * @param w
-     */
-    public void setWeight(float w) {
-        weight = w;
-        invWeight = 1f / w;
-    }
-
-    /**
-     * Unlocks particle again
-     * 
-     * @return itself
-     */
-    public VerletParticle3D unlock() {
-        clearVelocity();
-        isLocked = false;
-        return this;
-    }
-
-    /**
-     *
-     */
-    public void update() {
-        if (!isLocked) {
-            applyBehaviors();
-            applyForce();
-            applyConstraints();
-        }
-    }
-}

data/src/toxi/util/FileUtils.java

@@ -1,467 +0,0 @@
-/*
- *   __               .__       .__  ._____.           
- * _/  |_  _______  __|__| ____ |  | |__\_ |__   ______
- * \   __\/  _ \  \/  /  |/ ___\|  | |  || __ \ /  ___/
- *  |  | (  <_> >    <|  \  \___|  |_|  || \_\ \\___ \ 
- *  |__|  \____/__/\_ \__|\___  >____/__||___  /____  >
- *                   \/       \/             \/     \/ 
- *
- * 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.util;
-
-import java.awt.FileDialog;
-import java.awt.Frame;
-import java.io.BufferedInputStream;
-import java.io.BufferedReader;
-import java.io.BufferedWriter;
-import java.io.ByteArrayOutputStream;
-import java.io.File;
-import java.io.FileInputStream;
-import java.io.FileOutputStream;
-import java.io.FilenameFilter;
-import java.io.IOException;
-import java.io.InputStream;
-import java.io.InputStreamReader;
-import java.io.OutputStream;
-import java.io.OutputStreamWriter;
-import java.io.UnsupportedEncodingException;
-import java.util.zip.GZIPInputStream;
-import java.util.zip.GZIPOutputStream;
-
-/**
- * A collection of file handling utilities.
- */
-public class FileUtils {
-
-    /**
-     * {@link FileDialog} constant
-     */
-    public static final int LOAD = FileDialog.LOAD;
-
-    /**
-     * {@link FileDialog} constant
-     */
-    public static final int SAVE = FileDialog.SAVE;
-
-    /**
-     * Attempts to create the full path of directories as specified by the given
-     * target path. The path is assumed to be a directory, NOT a file in a
-     * directory. For the latter, use {@link #createDirectoriesForFile(File)}.
-     * 
-     * @param path
-     * @return true, if the operation succeeded
-     */
-    static public boolean createDirectories(File path) {
-        try {
-            if (!path.exists()) {
-                path.mkdirs();
-            }
-            return true;
-        } catch (SecurityException se) {
-            System.err.println("No permissions to create "
-                    + path.getAbsolutePath());
-        }
-        return false;
-    }
-
-    /**
-     * Attempts to create the full path of directories as specified by the given
-     * target file.
-     * 
-     * @param file
-     * @return true, if the operation succeeded
-     */
-    static public boolean createDirectoriesForFile(File file) {
-        try {
-            String parentName = file.getParent();
-            if (parentName != null) {
-                File parent = new File(parentName);
-                if (!parent.exists()) {
-                    parent.mkdirs();
-                }
-            }
-            return true;
-        } catch (SecurityException se) {
-            System.err.println("No permissions to create "
-                    + file.getAbsolutePath());
-        }
-        return false;
-    }
-
-    /**
-     * Creates an {@link InputStream} for the given file. If the file extension
-     * ends with ".gz" the stream is automatically wrapped in a
-     * {@link GZIPInputStream} as well.
-     * 
-     * @param file
-     *            input file
-     * @return input stream
-     * @throws IOException
-     */
-    static public InputStream createInputStream(File file) throws IOException {
-        if (file == null) {
-            throw new IllegalArgumentException("file can't be null");
-        }
-        InputStream stream = new FileInputStream(file);
-        if (file.getName().toLowerCase().endsWith(".gz")) {
-            stream = new GZIPInputStream(stream);
-        }
-        return stream;
-    }
-
-    /**
-     * Creates an {@link OutputStream} for the given file. If the file extension
-     * ends with ".gz" the stream is automatically wrapped in a
-     * {@link GZIPOutputStream} as well. Also attempts to create any
-     * intermediate directories for the file using
-     * {@link #createDirectoriesForFile(File)}.
-     * 
-     * @param file
-     *            output file
-     * @return output stream
-     * @throws IOException
-     */
-    static public OutputStream createOutputStream(File file) throws IOException {
-        if (file == null) {
-            throw new IllegalArgumentException("file can't be null");
-        }
-        createDirectoriesForFile(file);
-        OutputStream stream = new FileOutputStream(file);
-        if (file.getName().toLowerCase().endsWith(".gz")) {
-            stream = new GZIPOutputStream(stream);
-        }
-        return stream;
-    }
-
-    /**
-     * Creates a {@link BufferedReader} for the given file using UTF-8 encoding.
-     * 
-     * @param file
-     * @return reader instance
-     * @throws IOException
-     */
-    public static BufferedReader createReader(File file) throws IOException {
-        return createReader(createInputStream(file));
-    }
-
-    /**
-     * Creates a {@link BufferedReader} for the given {@link InputStream} using
-     * UTF-8 encoding.
-     * 
-     * @param input
-     *            stream
-     * @return reader instance
-     */
-    public static BufferedReader createReader(InputStream input) {
-        return createReader(input, "UTF-8");
-    }
-
-    /**
-     * Creates a {@link BufferedReader} for the given {@link InputStream} and
-     * using the specified encoding.
-     * 
-     * @param input
-     *            stream
-     * @param encoding
-     *            text encoding to use
-     * @return reader instance
-     */
-    public static BufferedReader createReader(InputStream input, String encoding) {
-        InputStreamReader isr = null;
-        try {
-            isr = new InputStreamReader(input, encoding);
-        } catch (UnsupportedEncodingException e) {
-        }
-        return new BufferedReader(isr, 0x10000);
-    }
-
-    /**
-     * Creates a {@link BufferedWriter} for the given file using UTF-8 encoding.
-     * 
-     * @param file
-     * @return writer instance
-     * @throws IOException
-     */
-    public static BufferedWriter createWriter(File file) throws IOException {
-        return createWriter(createOutputStream(file));
-    }
-
-    /**
-     * Creates a {@link BufferedWriter} for the given {@link OutputStream} using
-     * UTF-8 encoding.
-     * 
-     * @param out
-     * @return writer instance
-     */
-    public static BufferedWriter createWriter(OutputStream out) {
-        return createWriter(out, "UTF-8");
-    }
-
-    /**
-     * Creates a {@link BufferedWriter} for the given {@link OutputStream} and
-     * using the specified encoding.
-     * 
-     * @param out
-     *            stream
-     * @param encoding
-     *            text encoding to use
-     * @return writer instance
-     */
-    public static BufferedWriter createWriter(OutputStream out, String encoding) {
-        OutputStreamWriter w = null;
-        try {
-            w = new OutputStreamWriter(out, encoding);
-        } catch (UnsupportedEncodingException e) {
-        }
-        return new BufferedWriter(w, 0x10000);
-    }
-
-    /**
-     * <p>
-     * Analyses the given file path for a file sequence pattern and returns a
-     * {@link FileSequenceDescriptor} instance for further use to handle this
-     * sequence. The file pattern should be in one of these formats:
-     * </p>
-     * <ul>
-     * <li>base_path-00001.ext</li>
-     * <li>base_path001.ext</li>
-     * </ul>
-     * <p>
-     * The sequence index should be using leading zeros, but the number of
-     * digits will be identified automatically.
-     * </p>
-     * 
-     * @param path
-     *            file path of the first file in the sequence
-     * @return descriptor, or null, if the path could not be analysed
-     */
-    public static FileSequenceDescriptor getFileSequenceDescriptorFor(
-            String path) {
-        int dotIndex = path.lastIndexOf('.');
-        int zeroIndex = path.lastIndexOf('-') + 1;
-        if (zeroIndex == 0) {
-            zeroIndex = dotIndex - 1;
-            while (path.charAt(zeroIndex) >= '0'
-                    && path.charAt(zeroIndex) <= '9') {
-                zeroIndex--;
-            }
-            zeroIndex++;
-        }
-        int numDigits = dotIndex - zeroIndex;
-        if (dotIndex != -1 && numDigits > 0) {
-            String base = path.substring(0, zeroIndex);
-            String extension = path.substring(dotIndex);
-            String filePattern = base + "%0" + numDigits + "d" + extension;
-            int start = Integer.parseInt(path.substring(zeroIndex, dotIndex));
-            return new FileSequenceDescriptor(filePattern, extension, dotIndex
-                    - zeroIndex, start);
-        } else {
-            return null;
-        }
-    }
-
-    /**
-     * Loads the given {@link InputStream} into a byte array buffer.
-     * 
-     * @param stream
-     * @return byte array
-     * @throws IOException
-     */
-    static public byte[] loadBytes(InputStream stream) throws IOException {
-        BufferedInputStream input = new BufferedInputStream(stream);
-        ByteArrayOutputStream buffer = new ByteArrayOutputStream();
-        int c;
-        while ((c = input.read()) != -1) {
-            buffer.write(c);
-        }
-        return buffer.toByteArray();
-    }
-
-    /**
-     * Loads the given {@link BufferedReader} as text, line by line into a
-     * {@link String}.
-     * 
-     * @param reader
-     * @return reader contents as string
-     * @throws IOException
-     */
-    public static String loadText(BufferedReader reader) throws IOException {
-        StringBuilder result = new StringBuilder();
-        String line;
-        while ((line = reader.readLine()) != null) {
-            result.append(line).append("\n");
-        }
-        return result.toString();
-    }
-
-    /**
-     * Loads the given {@link InputStream} as text, line by line into a
-     * {@link String} using UTF-8 encoding.
-     * 
-     * @param input
-     *            stream
-     * @return stream contents as string
-     * @throws IOException
-     */
-    public static String loadText(InputStream input) throws IOException {
-        return loadText(input, "UTF-8");
-    }
-
-    /**
-     * Loads the given {@link InputStream} as text, line by line into a
-     * {@link String} using the specified encoding.
-     * 
-     * @param input
-     *            stream
-     * @param encoding
-     * @return stream contents as single string
-     * @throws IOException
-     */
-    public static String loadText(InputStream input, String encoding)
-            throws IOException {
-        byte[] raw = loadBytes(input);
-        return new String(raw, encoding);
-    }
-
-    /**
-     * Saves the given text to the specified {@link BufferedWriter} instance,
-     * then closes the writer afterwards.
-     * 
-     * @param writer
-     * @param string
-     * @throws IOException
-     */
-    static public void saveText(BufferedWriter writer, String string)
-            throws IOException {
-        writer.write(string);
-        writer.flush();
-        writer.close();
-    }
-
-    /**
-     * Saves the given text to the specified {@link OutputStream} instance, then
-     * closes the underlying writer afterwards.
-     * 
-     * @param output
-     * @param string
-     * @throws IOException
-     */
-    static public void saveText(OutputStream output, String string)
-            throws IOException {
-        saveText(createWriter(output), string);
-    }
-
-    /**
-     * Displays a standard AWT file dialog for choosing a folder (no files!).
-     * 
-     * @param frame
-     *            parent frame
-     * @param title
-     *            dialog title
-     * @param path
-     *            base directory (or null)
-     * @return path to chosen directory or null, if user has canceled
-     */
-    public static String showDirectoryChooser(final Frame frame,
-            final String title, String path) {
-        System.setProperty("apple.awt.fileDialogForDirectories", "true");
-        String result = showFileDialog(frame, title, path, (File dir, String name) -> new File(dir + "/" + name).isDirectory(), LOAD);
-        System.setProperty("apple.awt.fileDialogForDirectories", "false");
-        return result;
-    }
-
-    /**
-     * Displays a standard AWT file dialog for choosing a file for loading or
-     * saving.
-     * 
-     * @param frame
-     *            parent frame
-     * @param title
-     *            dialog title
-     * @param path
-     *            base directory (or null)
-     * @param filter
-     *            a FilenameFilter implementation (or null)
-     * @param mode
-     *            either FileUtils.LOAD or FileUtils.SAVE
-     * @return path to chosen file or null, if user has canceled
-     */
-    public static String showFileDialog(final Frame frame, final String title,
-            String path, FilenameFilter filter, final int mode) {
-        String fileID = null;
-        FileDialog fd = new FileDialog(frame, title, mode);
-        if (path != null) {
-            fd.setDirectory(path);
-        }
-        if (filter != null) {
-            fd.setFilenameFilter(filter);
-        }
-        fd.setVisible(true);
-        if (fd.getFile() != null) {
-            fileID = fd.getFile();
-            fileID = fd.getDirectory() + fileID;
-        }
-        return fileID;
-    }
-
-    /**
-     * Displays a standard AWT file dialog for choosing a file for loading or
-     * saving.
-     * 
-     * @param frame
-     *            parent frame
-     * @param title
-     *            dialog title
-     * @param path
-     *            base directory (or null)
-     * @param formats
-     *            an array of allowed file extensions (or null to allow all)
-     * @param mode
-     *            either FileUtils.LOAD or FileUtils.SAVE
-     * @return path to chosen file or null, if user has canceled
-     */
-    public static String showFileDialog(final Frame frame, final String title,
-            String path, final String[] formats, final int mode) {
-        String fileID = null;
-        FileDialog fd = new FileDialog(frame, title, mode);
-        if (path != null) {
-            fd.setDirectory(path);
-        }
-        if (formats != null) {
-            fd.setFilenameFilter((File dir, String name) -> {
-                boolean isAccepted = false;
-                for (String ext : formats) {
-                    if (name.contains(ext)) {
-                        isAccepted = true;
-                        break;
-                    }
-                }
-                return isAccepted;
-            });
-        }
-        fd.setVisible(true);
-        if (fd.getFile() != null) {
-            fileID = fd.getFile();
-            fileID = fd.getDirectory() + fileID;
-        }
-        return fileID;
-    }
-}