toxiclibs 0.2-java → 0.5.0-java

data/src/toxi/color/theory/ColorTheoryStrategy.java

@@ -0,0 +1,56 @@
+/*
+ * Some classes in this package have been partly inspired by & bits ported from
+ * Python code written by Tom De Smedt & Frederik De Bleser for the "colors" library
+ * of Nodebox.net.
+ * 
+ * http://nodebox.net/code/index.php/Colors
+ *
+ * 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.color.theory;
+
+import toxi.color.ColorList;
+import toxi.color.ReadonlyTColor;
+
+/**
+ * A simple interface for implementing rules used to create color palettes. The
+ * library currently comes with 10 default implementations realising different
+ * color theory approaches.
+ */
+public interface ColorTheoryStrategy {
+
+    /**
+     * Creates a new {@link ColorList} of colors for the supplied source color
+     * based on the strategy. The number of colors returned is unspecified and
+     * depends on the strategy.
+     * 
+     * @param src
+     *            source color
+     * @return list of matching colors created by the strategy.
+     */
+    ColorList createListFromColor(ReadonlyTColor src);
+
+    /**
+     * Returns the unique name of the strategy.
+     * 
+     * @return name
+     */
+    String getName();
+}

data/src/toxi/color/theory/ComplementaryStrategy.java

@@ -0,0 +1,111 @@
+/*
+ * Some classes in this package have been partly inspired by & bits ported from
+ * Python code written by Tom De Smedt & Frederik De Bleser for the "colors" library
+ * of Nodebox.net.
+ * 
+ * http://nodebox.net/code/index.php/Colors
+ *
+ * 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.color.theory;
+
+import toxi.color.ColorList;
+import toxi.color.ReadonlyTColor;
+import toxi.color.TColor;
+
+/**
+ * Creates 5 additional colors in relation to the given base color:
+ * <ul>
+ * <li>a contrasting color: much darker or lighter than the original.</li>
+ * <li>a soft supporting color: lighter and less saturated.</li>
+ * <li>a contrasting complement: very dark or very light.</li>
+ * <li>the complement and</li>
+ * <li>a light supporting variant.</li>
+ * </ul>
+ */
+public class ComplementaryStrategy implements ColorTheoryStrategy {
+
+    /**
+     *
+     */
+    public static final String NAME = "complementary";
+
+    /*
+     * (non-Javadoc)
+     * 
+     * @see
+     * toxi.color.ColorTheoryStrategy#createListFromcolor(toxi.color.TColor)
+     */
+    @Override
+    public ColorList createListFromColor(ReadonlyTColor src) {
+        ColorList colors = new ColorList(src);
+        // # A contrasting color: much darker or lighter than the original.
+        TColor c = src.copy();
+        if (c.brightness() > 0.4) {
+            c.setBrightness(0.1f + c.brightness() * 0.25f);
+        } else {
+            c.setBrightness(1.0f - c.brightness() * 0.25f);
+        }
+        colors.add(c);
+
+        // A soft supporting color: lighter and less saturated.
+        c = src.copy();
+        c.lighten(0.3f);
+        c.setSaturation(0.1f + c.saturation() * 0.3f);
+        colors.add(c);
+
+        // A contrasting complement: very dark or very light.
+        c = src.getComplement();
+        if (c.brightness() > 0.3) {
+            c.setBrightness(0.1f + c.brightness() * 0.25f);
+        } else {
+            c.setBrightness(1.0f - c.brightness() * 0.25f);
+        }
+        colors.add(c);
+
+        // The complement and a light supporting variant.
+        colors.add(src.getComplement());
+
+        c = src.getComplement();
+        c.lighten(0.3f);
+        c.setSaturation(0.1f + c.saturation() * 0.25f);
+        colors.add(c);
+        return colors;
+    }
+
+    /*
+     * (non-Javadoc)
+     * 
+     * @see toxi.color.ColorTheoryStrategy#getName()
+     */
+    @Override
+    public String getName() {
+        return NAME;
+    }
+
+    /**
+     *
+     * @return
+     */
+    @Override
+    public String toString() {
+        return NAME;
+    }
+}

data/src/toxi/color/theory/CompoundTheoryStrategy.java

@@ -0,0 +1,143 @@
+/*
+ * Some classes in this package have been partly inspired by & bits ported from
+ * Python code written by Tom De Smedt & Frederik De Bleser for the "colors" library
+ * of Nodebox.net.
+ * 
+ * http://nodebox.net/code/index.php/Colors
+ *
+ * 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.color.theory;
+
+import toxi.color.ColorList;
+import toxi.color.ReadonlyTColor;
+import toxi.color.TColor;
+import toxi.math.MathUtils;
+
+/**
+ *
+ * @author tux
+ */
+public class CompoundTheoryStrategy implements ColorTheoryStrategy {
+
+    /**
+     *
+     */
+    public static final String NAME = "compound";
+
+    private static float wrap(float x, float min, float threshold,
+            float plus) {
+        if (x - min < threshold) {
+            return x + plus;
+        } else {
+            return x - min;
+        }
+    }
+
+    private boolean isFlipped = false;
+
+    /**
+     *
+     */
+    public CompoundTheoryStrategy() {
+
+    }
+
+    /**
+     *
+     * @param flipped
+     */
+    public CompoundTheoryStrategy(boolean flipped) {
+        isFlipped = flipped;
+    }
+
+    /*
+     * (non-Javadoc)
+     * 
+     * @see
+     * toxi.color.ColorTheoryStrategy#createListFromcolor(toxi.color.TColor)
+     */
+    @Override
+    public ColorList createListFromColor(ReadonlyTColor src) {
+        ColorList colors = new ColorList(src);
+        int direction = isFlipped ? -1 : 1;
+
+        TColor c = src.getRotatedRYB(30 * direction);
+        c.setBrightness(wrap(c.brightness(), 0.25f, 0.6f, 0.25f));
+        colors.add(c);
+
+        c = src.getRotatedRYB(30 * direction);
+        c.setSaturation(wrap(c.saturation(), 0.4f, 0.1f, 0.4f));
+        c.setBrightness(wrap(c.brightness(), 0.4f, 0.2f, 0.4f));
+        colors.add(c);
+
+        c = src.getRotatedRYB(160 * direction);
+        c.setSaturation(wrap(c.saturation(), 0.25f, 0.1f, 0.25f));
+        c.setBrightness(MathUtils.max(0.2f, c.brightness()));
+        colors.add(c);
+
+        c = src.getRotatedRYB(150 * direction);
+        c.setSaturation(wrap(c.saturation(), 0.1f, 0.8f, 0.1f));
+        c.setBrightness(wrap(c.brightness(), 0.3f, 0.6f, 0.3f));
+        colors.add(c);
+
+        c = src.getRotatedRYB(150 * direction);
+        c.setSaturation(wrap(c.saturation(), 0.1f, 0.8f, 0.1f));
+        c.setBrightness(wrap(c.brightness(), 0.4f, 0.2f, 0.4f));
+        // colors.add(c);
+
+        return colors;
+    }
+
+    /*
+     * (non-Javadoc)
+     * 
+     * @see toxi.color.ColorTheoryStrategy#getName()
+     */
+    @Override
+    public String getName() {
+        return NAME;
+    }
+
+    /**
+     *
+     * @return
+     */
+    public boolean isFlipped() {
+        return isFlipped;
+    }
+
+    /**
+     *
+     * @param state
+     */
+    public void setFlipped(boolean state) {
+        isFlipped = state;
+    }
+
+    /**
+     *
+     * @return
+     */
+    @Override
+    public String toString() {
+        return NAME + (isFlipped ? "_flipped" : "");
+    }
+}

data/src/toxi/color/theory/LeftSplitComplementaryStrategy.java

@@ -0,0 +1,82 @@
+/*
+ * Some classes in this package have been partly inspired by & bits ported from
+ * Python code written by Tom De Smedt & Frederik De Bleser for the "colors" library
+ * of Nodebox.net.
+ * 
+ * http://nodebox.net/code/index.php/Colors
+ *
+ * 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.color.theory;
+
+import toxi.color.ColorList;
+import toxi.color.ReadonlyTColor;
+import toxi.color.TColor;
+
+/**
+ *
+ * @author tux
+ */
+public class LeftSplitComplementaryStrategy implements ColorTheoryStrategy {
+
+    /*
+     * (non-Javadoc)
+     * 
+     * @see
+     * toxi.color.ColorTheoryStrategy#createListFromcolor(toxi.color.TColor)
+     */
+
+    /**
+     *
+     */
+    
+    public static final String NAME = "leftSplitComplementary";
+
+    @Override
+    public ColorList createListFromColor(ReadonlyTColor src) {
+        ReadonlyTColor left = src.getComplement().rotateRYB(-30).lighten(0.1f);
+        ColorList colors = ColorTheoryRegistry.COMPLEMENTARY
+                .createListFromColor(src);
+        for (int i = 3; i < 6; i++) {
+            TColor c = colors.get(i);
+            c.setHue(left.hue());
+        }
+        return colors;
+    }
+
+    /*
+     * (non-Javadoc)
+     * 
+     * @see toxi.color.ColorTheoryStrategy#getName()
+     */
+    @Override
+    public String getName() {
+        return NAME;
+    }
+
+    /**
+     *
+     * @return
+     */
+    @Override
+    public String toString() {
+        return NAME;
+    }
+}

data/src/toxi/color/theory/MonochromeTheoryStrategy.java

@@ -0,0 +1,103 @@
+/*
+ * Some classes in this package have been partly inspired by & bits ported from
+ * Python code written by Tom De Smedt & Frederik De Bleser for the "colors" library
+ * of Nodebox.net.
+ * 
+ * http://nodebox.net/code/index.php/Colors
+ *
+ * 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.color.theory;
+
+import toxi.color.ColorList;
+import toxi.color.ReadonlyTColor;
+import toxi.color.TColor;
+import toxi.math.MathUtils;
+
+/**
+ * Creates 4 additional shades of the given color, thus creating a monochrome
+ * palette.
+ */
+public class MonochromeTheoryStrategy implements ColorTheoryStrategy {
+
+    /**
+     *
+     */
+    public static final String NAME = "monochrome";
+
+    private static float wrap(float x, float min, float threshold,
+            float plus) {
+        if (x - min < threshold) {
+            return x + plus;
+        } else {
+            return x - min;
+        }
+    }
+
+    /*
+     * (non-Javadoc)
+     * 
+     * @see
+     * toxi.color.ColorTheoryStrategy#createListFromcolor(toxi.color.TColor)
+     */
+    @Override
+    public ColorList createListFromColor(ReadonlyTColor src) {
+        ColorList colors = new ColorList(src);
+        TColor c = src.copy();
+        c.setBrightness(wrap(c.brightness(), 0.5f, 0.2f, 0.3f));
+        c.setSaturation(wrap(c.saturation(), 0.3f, 0.1f, 0.3f));
+        colors.add(c);
+
+        c = src.copy();
+        c.setBrightness(wrap(c.brightness(), 0.2f, 0.2f, 0.6f));
+        colors.add(c);
+
+        c = src.copy();
+        c.setBrightness(MathUtils.max(0.2f,
+                c.brightness() + (1 - c.brightness()) * 0.2f));
+        c.setSaturation(wrap(c.saturation(), 0.3f, 0.1f, 0.3f));
+        colors.add(c);
+
+        c = src.copy();
+        c.setBrightness(wrap(c.brightness(), 0.5f, 0.2f, 0.3f));
+        colors.add(c);
+
+        return colors;
+    }
+
+    /*
+     * (non-Javadoc)
+     * 
+     * @see toxi.color.ColorTheoryStrategy#getName()
+     */
+    @Override
+    public String getName() {
+        return NAME;
+    }
+
+    /**
+     *
+     * @return
+     */
+    @Override
+    public String toString() {
+        return NAME;
+    }
+}