Piece generator for cubes with stickers is added.

Author: EVGVir

doc/README.md

@@ -240,3 +240,17 @@ rubik_cube_generate_cube(
   array[2] {Red, White}   // Piece generator parameter.
 )
 ```
+
+
+#### Predefined Piece Generators
+
+There are two piece generators provided with the library:
+- *[rubik-cube-generator-cube.inc](../rubik-cube-generator-cube.inc)*
+  [default] — generates cubes without stickers.
+
+  ![](simple-cube/simple-cube.png)
+
+- *[rubik-cube-generator-with-stickers.inc](../rubik-cube-generator-with-stickers.inc)* —
+  generates cubes with stickers.
+
+  ![](piece-generators/with-stickers.png)

doc/piece-generators/with-stickers.ini

@@ -0,0 +1,5 @@
+Input_File_Name=with-stickers.pov
+Library_Path=../..
+Width=320
+Height=240
+Antialias=true

doc/piece-generators/with-stickers.png

@@ -0,0 +1,17 @@
+#include "../doc-scene.inc"
+#include "rubik-cube.inc"
+
+rubik_cube_to_object(
+  rubik_cube_generate_cube(
+    <3, 3, 3>,
+    "rubik-cube-generator-with-stickers.inc",
+    array[6] {
+      pigment { Green },
+      pigment { Red },
+      pigment { Yellow },
+      pigment { Blue },
+      pigment { Orange},
+      pigment { White }
+    }
+  )
+)

doc/piece-generators/with-stickers.pov

@@ -0,0 +1,33 @@
+// Generates a piece of cube with stickers.
+//
+// gen_param - array of six textures to be applied for the cube
+//   stickers. Textures are ordered in the following way: right face
+//   (0); top face (1); back face (2); left face (3); bottom face (4);
+//   front face (5).
+// Note. Interiors are just colored in black.
+
+union {
+  // Piece.
+  #local piece_edge_radius = 0.06;
+
+  object {
+    Round_Box(<-0.5, -0.5, -0.5>, <0.5, 0.5, 0.5>, piece_edge_radius, 1)
+    pigment { Black }
+  }
+
+  // Stickers.
+  #local thickness_ = 0.01;           // Thickness of the sticker. (outer part)
+  #local bt = thickness_ + 0.5;       // Thickness of the block used for sticker creation.
+  #local s = 0.5 - piece_edge_radius; // Sticker size (a half of it, actually).
+  #local ser = 0.05;                  // Sticker edge radius.
+
+  #if (pos.x = dim.x - 1) object { Round_Box(< bt,  -s,  -s>, <0, s, s>, ser, 1) texture { gen_param[0] }} #end
+  #if (pos.y = dim.y - 1) object { Round_Box(< -s,  bt,  -s>, <s, 0, s>, ser, 1) texture { gen_param[1] }} #end
+  #if (pos.z = dim.z - 1) object { Round_Box(< -s,  -s,  bt>, <s, s, 0>, ser, 1) texture { gen_param[2] }} #end
+
+  #if (pos.x = 0)         object { Round_Box(<-bt,  -s,  -s>, <0, s, s>, ser, 1) texture { gen_param[3] }} #end
+  #if (pos.y = 0)         object { Round_Box(< -s, -bt,  -s>, <s, 0, s>, ser, 1) texture { gen_param[4] }} #end
+  #if (pos.z = 0)         object { Round_Box(< -s,  -s, -bt>, <s, s, 0>, ser, 1) texture { gen_param[5] }} #end
+
+  translate 0.5
+}

rubik-cube-generator-with-stickers.inc

@@ -4,4 +4,5 @@
 ../doc/layers-rotation/layers-rotation-3x3x3.ini
 ../doc/notation/notation.ini
 ../doc/piece-generators/sphere.ini
+../doc/piece-generators/with-stickers.ini
 ../doc/simple-cube/simple-cube.ini