Feature Placement

Feature (document object)

Placement feature represents a new single Placement object.

Properties

FlipZ

Set to true to flip placement's Z local axis direction. Placement's Y axis is also reversed, X axis is preserved. (One can only flip two axes at a time, to preserve axis system handedness)

If PlacementChoice is Custom, setting the property to true will flip Z axis, and the property will self-reset back to false, to avoid flipping the placement on every recompute. If PlacementChoice is not Custom, the property will not self-reset.

Invert

Set to true to invert the placement (inverse placement is the placement that undoes the original placement).

If PlacementChoice is Custom, setting the property to true will invert the placement, and the property will self-reset back to false, to avoid inverting the placement on every recompute. If PlacementChoice is not Custom, the property will not self-reset.

Offset

This property acts like offset value in sketch orientation dialog. This property is only active if PlacementChoice is not none.

PlacementChoice

This property lets one to choose a standard placement. Available options are:

• Custom. This unlocks the placement, and allows directly manipulating it by editing Placement property. This also makes the Placement object moveable with all kinds of moving tools, Draft Move for example.
• XY Plane. X axis along global X axis; Y axis along global Y axis, Z axis along global Z axis (assuming FlipZ and Invert are False). This placement is a trivial placement, or zero placement: its local coordinate system is coincident with global; applying this placement does nothing.
• XZ Plane. X axis along global X axis; Y axis along global Z axis, Z axis opposite to global Y axis (assuming FlipZ and Invert are False).
• YZ Plane. X axis along global Y axis; Y axis along global Z axis, Z axis along global X axis (assuming FlipZ and Invert are False).

GUI Command (toolbar button)

SinglePlacementToolbar.png There are five commands under a drop-down toolbar button. The first four commands create the feature with PlacementChoice property preset to corresponding value.

The last command, Single Placement: linked to shape, creates a different feature - ArrayFromShape - preset to make a single placement out of selected object. See Feature ArrayFromShape for info on setting up the feature after creating it.