# Cell Tool for MicroStation V8 XM Edition

Last revised: April 7, 2006

## Description

The CellTool application provides some very useful extensions to the standard cell placement tools in MicroStation and MicroStation PowerDraft. CellTool gives you the ability to:

- Place Active Cell with an interactive rotation angle
- Place Active Cell on a selected element with interactive rotation angle
- Place Active Cell on an element by partial deleting the target element to fit the cell.
- Place multiple copies of the active cell along or offset from a selected element at a given distance between each copy.

For each of these tools, a series of standard datafields are used to control their operation.

## Installation Instructions

CellTool.ma and CellTool.dll should be copied into the `..\mdlapps\` folder.

## To load CellTool

Key in: `MDL LOAD CELLTOOL` from the Key-in Browser

or

from Utilities > MDL Applications > Browse, select CellTool

This loads the MDL application containing CellTool's tools. Although you can key in the individual names of the tools, most users will likely find it easier to work with CellTool's user interface.

## To load the CellTool palette:

1. Key in: `DIALOG PALETTE CELLTOOL`
2. Select the appropriate tool
3. Enter name of cell to be used
4. Set the angle of the active cell (optional)
5. Follow prompts for specific tool operation

## Place Cell and Rotate

The simplest of the CellTools, Place Cell and Rotate mimics the standard Place Cell tool with one notable difference. After placing the active cell, this tool puts the cell into an interactive rotation or spin mode around the cell's origin.

To place a cell and rotate it:

1. Select the Place Cell and Rotate tool
2. Enter a data point to position a cell
3. Enter a data point to define the rotation angle
   or
   Reset to place the cell at the Active Angle.

## Place Cell On and Rotate

Similar in function to the previous tool, the Place Cell On and Rotate tool utilizes an existing element for locating the origin point and initial angle of the selected cell.

To place a cell on an element and rotate it:

1. Select Place Cell On and Rotate tool
2. Identify an existing element on which you want to place the cell
3. Enter a data point to accept it
4. Enter a data point to define the rotation angle of the cell
   or
   Reset to place the cell at the Active Angle with respect to the existing element.

## Place Cell On

This tool works in a similar fashion as Place Cell On and Rotate with one very important difference. When the cell is placed on the selected element, the original element is partially deleted to remove that portion obscured by the cell. This can result in two or more new elements replacing the original element.

To place a cell on an element with trim:

1. Select Place Cell On tool
2. Identify an existing element on which you want to place the cell
3. Enter a data point to accept it
4. Enter a data point to define the rotation angle of the cell
   or
   Reset to place the cell at the Active Angle with respect to the existing element.

## Place Cell Along

Acting like a tape measure, Place Cell Along will place cells at a set distance along the entire length of a selected element. In addition to placing the active cell on the selected element, this tool can be configured to place the cell offset from the centerline of the element. This is accomplished with the Offset tool setting.

To repeatedly place a cell a set distance along an element:

1. Select the Place Cell Along tool
2. Set the Spacing, Offset and Angle tool settings to the values desired
3. Identify the existing element at the point where you want the repeating cells to start
4. Enter a data point to accept it

NOTE: This offset is calculated from the normal direction of the chosen element (from the first endpoint entered). This direction is determined by the order in which the element’s coordinates were placed. If your offset appears on the wrong side of the element, select the Undo command and try a negative offset value.

© 2002, 2006 Bentley Systems, Incorporated.
685 Stockton Drive Exton, PA USA 19341

Bentley, the "B" logo, MicroStation, SELECT, and MDL are either registered or unregistered trademarks or service marks of Bentley Systems, Incorporated, or one of its direct or indirect wholly-owned subsidiaries. Other brands and product names are trademarks of their respective owners.