HSV and HSL conversion, rainbow() module for coloring multiple objects. The recolor() and color_this() modules allow you to change the color of previously colored attachable objects.

To use, add the following lines to the beginning of your file:

include <BOSL2/std.scad>

1. Section: Coloring Objects

   • recolor() – Sets the color for attachable children and their descendants. ^[Trans]
   • color_this() – Sets the color for children at the current level only. ^[Trans]
   • rainbow() – Iterates through a list, displaying children in different colors. ^[Trans]
   • color_overlaps() – Shows ghostly children, with overlaps highlighted in color. ^[Trans]

2. Section: Colorspace Conversion

   • hsl() – Sets the color of children to a specified hue, saturation, lightness and optional alpha channel value. ^[Trans]
   • hsv() – Sets the color of children to a hue, saturation, value and optional alpha channel value. ^[Trans]

Synopsis: Sets the color for attachable children and their descendants. ^[Trans]

Topics: Attachments

See Also: color_this(), hsl(), hsv()

Usage:

• recolor([c]) CHILDREN;

Description:

Sets the color for attachable children and their descendants, down until another recolor() or color_this(). This only works with attachables and you cannot have any color() modules above it in any parents, only other recolor() or color_this() modules. This works by setting the special $color variable, which attachable objects make use of to set the color.

Arguments:

Side Effects:

• Changes the value of $color.
• Sets the color of child attachments.

Example 1:

include <BOSL2/std.scad>
cuboid([10,10,5])
  recolor("green")attach(TOP,BOT) cuboid([9,9,4.5])
    attach(TOP,BOT) cuboid([8,8,4])
      recolor("purple") attach(TOP,BOT) cuboid([7,7,3.5])
        attach(TOP,BOT) cuboid([6,6,3])
          recolor("cyan")attach(TOP,BOT) cuboid([5,5,2.5])
            attach(TOP,BOT) cuboid([4,4,2]);

Synopsis: Sets the color for children at the current level only. ^[Trans]

Topics: Attachments

See Also: recolor(), hsl(), hsv()

Usage:

• color_this([c]) CHILDREN;

Description:

Sets the color for children at one level, reverting to the previous color for further descendants. This works only with attachables and you cannot have any color() modules above it in any parents, only recolor() or other color_this() modules. This works using the $color and $save_color variables, which attachable objects make use of to set the color.

Arguments:

Side Effects:

• Changes the value of $color and $save_color.
• Sets the color of child attachments.

Example 1:

include <BOSL2/std.scad>
cuboid([10,10,5])
  color_this("green")attach(TOP,BOT) cuboid([9,9,4.5])
    attach(TOP,BOT) cuboid([8,8,4])
      color_this("purple") attach(TOP,BOT) cuboid([7,7,3.5])
        attach(TOP,BOT) cuboid([6,6,3])
          color_this("cyan")attach(TOP,BOT) cuboid([5,5,2.5])
            attach(TOP,BOT) cuboid([4,4,2]);

Synopsis: Iterates through a list, displaying children in different colors. ^[Trans]

Topics: List Handling

See Also: hsl(), hsv()

Usage:

• rainbow(list,[stride],[maxhues],[shuffle],[seed]) CHILDREN;

Description:

Iterates the list, displaying children in different colors for each list item. The color is set using the color() module, so this module is not compatible with recolor() or color_this(). This is useful for debugging regions or lists of paths.

Arguments:

Side Effects:

• Sets the color to progressive values along the ROYGBIV spectrum for each item.
• Sets $idx to the index of the current item in list that we want to show.
• Sets $item to the current item in list that we want to show.

Example 1:

include <BOSL2/std.scad>
rainbow(["Foo","Bar","Baz"]) fwd($idx*10) text(text=$item,size=8,halign="center",valign="center");

Example 2:

include <BOSL2/std.scad>
rgn = [circle(d=45,$fn=3), circle(d=75,$fn=4), circle(d=50)];
rainbow(rgn) stroke($item, closed=true);

Synopsis: Shows ghostly children, with overlaps highlighted in color. ^[Trans]

Topics: Debugging

See Also: rainbow(), debug_vnf()

Usage:

• color_overlaps([color]) CHILDREN;

Description:

Displays the given children in ghostly transparent gray, while the places where the they overlap are highlighted with the given color.

Arguments:

Example 1: 2D Overlaps

include <BOSL2/std.scad>
color_overlaps() {
    circle(d=50);
    left(20) circle(d=50);
    right(20) circle(d=50);
}

Example 2: 3D Overlaps

include <BOSL2/std.scad>
color_overlaps() {
    cuboid(50);
    left(30) sphere(d=50);
    right(30) sphere(d=50);
    xcyl(d=10,l=120);
}

Synopsis: Sets the color of children to a specified hue, saturation, lightness and optional alpha channel value. ^[Trans]

Topics: Colors, Colorspace

See Also: hsv(), recolor(), color_this()

Usage:

• hsl(h,[s],[l],[a]) CHILDREN;
• rgb = hsl(h,[s],[l],[a]);

Description:

When called as a function, returns the [R,G,B] color for the given hue h, saturation s, and lightness l from the HSL colorspace. If you supply the a value then you'll get a length 4 list [R,G,B,A]. When called as a module, sets the color using the color() module to the given hue h, saturation s, and lightness l from the HSL colorspace.

Arguments:

Side Effects:

• When called as a module, sets the color of all children.

Example 1:

include <BOSL2/std.scad>
hsl(h=120,s=1,l=0.5) sphere(d=60);

Example 2:

include <BOSL2/std.scad>
rgb = hsl(h=270,s=0.75,l=0.6);
color(rgb) cube(60, center=true);

Synopsis: Sets the color of children to a hue, saturation, value and optional alpha channel value. ^[Trans]

Topics: Colors, Colorspace

See Also: hsl(), recolor(), color_this()

Usage:

• hsv(h,[s],[v],[a]) CHILDREN;
• rgb = hsv(h,[s],[v],[a]);

Description:

When called as a function, returns the [R,G,B] color for the given hue h, saturation s, and value v from the HSV colorspace. If you supply the a value then you'll get a length 4 list [R,G,B,A]. When called as a module, sets the color using the color() module to the given hue h, saturation s, and value v from the HSV colorspace.

Arguments:

Side Effects:

• When called as a module, sets the color of all children.

Example 1:

include <BOSL2/std.scad>
hsv(h=120,s=1,v=1) sphere(d=60);

Example 2:

include <BOSL2/std.scad>
rgb = hsv(h=270,s=0.75,v=0.9);
color(rgb) cube(60, center=true);