Image Stacks

Boxshot allows you to generate customizable stack of images. Currently supported are:

  • Simple stack
  • Stack with one additional image aside
  • Fan

All the stacks have some common parameters and specifc ones. Here is the complete list, many parameters are the same as in Image shape:

  • Width - the width of the image
  • Height - the height of the image
  • Thickness - the thickness of the image, please use small values.
  • Corner - the amount of the image corners to be rounded in percents
  • Border - the amount of the image surface to be replaced with border. This shrinks the image, keeping its proportions.
  • Number of images - the number of images in the stack
  • Space - the distance between images in the stack, set it to 0 or a small value, like 0.02 (it is in centimeters as all the other dimensions in the application).
  • Disorder - controls the noise level in the stack, makes it “live”.
  • Twist - controls the twist level of a simple stack. Zero means no twist.
  • Image distance - controls how far the image is from the stack, this affects its angle.
  • Spread - controls the spread of the image fan.

Exactly as with the Image shape you may use the “Fit to images” button to adjust the shape automatically.

Scripting

Here’s how to create a simple stack:

var m = scene.root.addMesh("stack1", "generator.Images.Stack");
var g = m.generator;
g.width = 10;
g.length = 5;
g.thickness = 0.03;
g.corner = 0.02;
g.border = 0;
g.space = 0.01;
g.disorder = 0.2;
g.twist = 0.1;
g.numberOfImages = 20;
g.material("Image").diffuseTexture = "/path/to/image.png";
g.fitToImages();

The “Stack + 1” shape can be created the same way, here’s the difference:

var m = scene.root.addMesh("stack2", "generator.Images.StackPlus1");
var g = m.generator;
// the same initialization
g.imageDistance = 0.5;

Finally the Fan stack is created this way:

var m = scene.root.addMesh("stack3", "generator.Images.Fan");
var g = m.generator;
// the same initialization
g.spread = 0.5;