Extrude 2D shapes and modify existing 3D extrusions with the Push Pull Tool . You can hover over any shape to display handles to extend an edge or face.
- Click the Push Pull Tool button
or press P. You can also click Shapes > Push Pull Tool in the CityEngine main menu to open the tool.
- You can open the Tool Options window
by clicking Window > Tool Options in the CityEngine main menu.
Extrude face
Depending on the shape, different arrows appear. This allows you to create shapes along different directions. Hover over a direction arrow for immediate feedback. There are four types of directions, each with a unique color and mouse icon:
- Global y-axis (up)
- Face normal
- Face normal projected on the ground plane
- Special edge directions from adjacent faces
![Extruding faces on models Extruding faces on models](GUID-A9B4A167-61D4-445C-921E-4CE2D39ACCDE-web.png)
In the last case, all edges are extended along their adjacent faces during dragging. The arrow appears with a slight offset when it has the same direction as another arrow. The example below shows the difference between the up and special edge direction dragging:
![Special edge direction dragging Special edge direction dragging](GUID-1B68781C-1C3F-4807-B82A-D2DC48DDBBED-web.png)
Tip:
Press Ctrl to force the creation of new edges when starting a 3D drag operation.
3D shape editing
3D shapes allow polygonal editing, such as snapping, splitting, and automatic closing. Split parts can be moved to further refine the 3D model.
![3D shape editing consisting of a split, 3D move, and another split and move 3D shape editing consisting of a split, 3D move, and another split and move](GUID-52F1F669-8280-4A6F-A73C-F9C6ECAFDC99-web.png)
3D edge move
Hover over edges with the Push Pull Tool to display edge handles. Similar to dragging the face, you can drag the edges to display multiple directions:
- Global y-axis (up)
- Along adjacent faces
- Along average face normal
![From left to right: Edge move along global y-axis, adjacent faces, and average face normal. From left to right: Edge move along global y-axis, adjacent faces, and average face normal.](GUID-B6486787-4228-43C5-A8E1-8EF8C2A2C7B8-web.png)
While moving the edges with the Push Pull Tool, connected faces update to maintain planarity. In addition, the moved edge is intersected with neighboring polygons. Both features are useful for creating roofs as the examples below show:
![Edge moving on orthogonal faces Edge moving on orthogonal faces](GUID-7E52A424-D98F-4121-9E28-FC2FDFAF7BF5-web.png)
![Moving edge with inset edge along roof Moving edge with inset edge along roof](GUID-C6B1B296-70CE-4139-AE44-85347185976E-web.png)
Tool options
The Tool options window includes the following settings:
Distance (m) | Distance in meters of the edge or face extrusion.
|