Adding Blocks

When you create a new set of building blocks, it starts out with one block. You can add more blocks to that block by means of the Add Blocks tool (addblockstool) in the toolbar. An alternative is to create a free-standing block by way of a command in the context menu. You can also add more than one block at a time by using the tool button labeled “Add a Layer…” (addlayer).

Using the Add Blocks Tool

When you click the Add Blocks tool, it puts the mouse into a mode where you can add one block after another.

Start by clicking a face that you want to add a block to. The green outline of a block appears. Click the same face again and the block will be added to the face.

adding a block

In most cases, you will have a choice of more than one kind of block to add. When you click a face, the mouse cursor changes to show the outline of a block with two arrows (addblockhasnextcursor). The arrows indicate whether another option exists for the shape of the block.

Mouse Cursor Description
botharrowsok Scrolling up or down will show a different shape.
downarrowok Scrolling down will show a different shape.
uparrowok Scrolling up will show a different shape.
noarrowok There are no other shapes available to add.

You can use arrow keys or the mouse wheel to scroll through the available shapes. When using the mouse wheel, the pointer must be over the face that was clicked, otherwise the whole view will zoom in or out. Pressing the Return or Enter key is another way to accept the proposed shape.

If you make a mistake and add the wrong kind of block, you can right-click the block and choose Delete Block from the context menu. Or use the Edit>Undo command to remove the mistake from the record.

While the list of shapes is displayed, pressing the ESC key will cancel the operation. Pressing ESC again will take the mouse out of Add Blocks mode.

Green outlines represent good (valid) blocks and red outlines represent blocks that will create invalid geometry if added to the model. You can add an invalid block but the geometry will need to be repaired before zones can be generated.

attached sides are colored

The block to be added may have faces that are attached or unattached to adjacent faces. A colored adjacent face (red or green) shows that the face will be attached to the new block; a gray face will not be attached.

unattached face for green block

To help determine which faces in a model are attached, there is a “Show Surfaces” command in the Validate menu.

Note: If you find that clicking a face with the Add Blocks tool does not show a list of blocks, the face may have one of its blocks hidden. In that case, the context menu for that face will have a command to show the hidden block. The mouse cursor should also change to indicate when a hidden block will prevent a block from being added to a face(cantaddblock).


The arrow at the right side of the Add Blocks tool button shows a menu that lets you set tolerance and the break angle.

the Add Blocks menu


The tolerance setting determines how close together two points need to be before they are considered to be at the same location. It also determines how close a point can be to any object before it is considered to intersect that object.

A recommended value is computed and updated as the model changes. You may want to override that value for a couple of reasons:
  1. If you add a new block when the tolerance setting is too small, new points in that block may not automatically merge with pre-existing points as they should.
  2. If the tolerance is too large, blocks may get marked as bad (red), due to intersections, when they shouldn’t. The tolerance can be so large that points appear to intersect other objects. This problem usually arises in models that are relatively large compared to the levels of small detail that occur within them. Setting the tolerance to a smaller value may help resolve the bad blocks. After setting the tolerance, use the Validate command in the Validate tool menu (valblocks) to see if the new value has an effect.

A checkbox determines whether the recommended tolerance will continually be used.

View Tolerance: The status bar contains a “View Tolerance” number that is based on the current zoom level of the Building Blocks pane and the size of the points. It is a low-precision estimate of the radius of the points. You may want to use this number as a tolerance setting if you have problems adding (or splitting) a block.

Break Angle

The break angle determines how wide an angle to consider when proposing new blocks.

break angle

A break angle of 110 degrees will not allow a block that fills the valley displayed in the picture. A break angle of 135 degrees will.

Adding a Free Block

When you want to add a block that is not attached to any other block, you can use the command “Add a Free Block” from the context menu when the mouse is in Selection mode (selecttool).

The following dialog will be displayed:

the Add a Free Block dialog

You may specify the shape of the block and the length of the edges. You may place the center of the block at the center of the view or provide x, y and z coordinates.

This dialog will also appear when there are no blocks in the set and you left-click inside the pane.

Adding a Layer

To add a layer of blocks, first select the faces where the layer should be added. Then click the tool button labeled “Add a layer…” (addlayer).

a proposed layer of blocks

A dialog will appear to let you adjust the depth of the new layer.

the Create Layer dialog

Click the Create button to add the layer.