Books

Boxshot supports several types of books, depending on the edition. The complete list is:

  • Hard cover book (optional dust jacket)
  • Paperback book
  • Magazine
  • Round corner paperback book
  • Step-back paperback book

Parameters

Common parameters

All the book shapes support the following properties: Width, Height and Thickness. They also can be automatically resized according to the loaded images using the Fit to images button.

When the Smart scaling option is enabled, Boxshot tries to keep the spine and corners of the shape uniformly-scaled. This works just fine for hard cover books and for some paperbacks, but in some cases the results are odd. If you are not happy with the scaled book you got, this is the first option to try.

Hard cover books

Hard cover books have optional dust jacket (not available in the Home edition) with adjustable flaps. It also allows you to switch between flat and curved spine.

Paperback books

Both paperback and step-back books have the Type parameter that controls how much the book is opened. Step-back book also allows you to control the width of the step-back page.

Cover Images

Boxshot supports both "full cover" images and separate ones. The "Use solid cover image" checkbox allows you to switch between modes, so you can provide either one image with both front, spine and back parts, or three different images for each side of the book cover.

Scripting

Here's how to create a hard cover book:

var m = scene.root.addMesh("book", "generator.book.HardCover");
var g = m.generator;
g.width = 10;
g.height = 5;
g.thickness = 2;
g.flatSpine = false;
g.showDustJacket = true;
g.flapsWidth = 1;
g.solidCoverImage = true;
g.smartScaling = true;
g.fitToImages();

Paperback books can be created the similar way:

var m = scene.root.addMesh("book", "generator.book.Paperback");
var g = m.generator;
g.width = 10;
g.height = 5;
g.thickness = 2;
g.type = "closed"; // or "opened a bit" or "opened"
g.solidCoverImage = false;
g.smartScaling = false;
g.fitToImages();

Step-back soft cover books have almost the same set of properties:

var m = scene.root.addMesh("book", "generator.book.Stepback");
var g = m.generator;
g.width = 10;
g.height = 5;
g.thickness = 2;
g.stepbackWidth = 1;
g.type = "closed"; // or "opened a bit" or "opened"
g.solidCoverImage = true;
g.smartScaling = false;
g.fitToImages();

Magazines and rounded-corners paperback books are the simplest two (use the "generator.book.PaperbackRoundCorners" identifier to create a rounded-corners soft cover book):

var m = scene.root.addMesh("book", "generator.book.Magazine");
var g = m.generator;
g.width = 10;
g.height = 5;
g.thickness = 2;
g.solidCoverImage = false;
g.smartScaling = false;
g.fitToImages();