[[TranslatedPages]]
= Create Areas By Extrusion =

[[Image(source:trunk/images/mapmode/extrude/extrude.png)]] ''Keyboard shortcut:'' **{{{X}}}**

Replaces the segment of a [[Image(source:trunk/images/data/way.png)]] [Concepts/Object#Ways way] between two [[Image(source:trunk/images/data/node.png)]] [Concepts/Object#Nodes nodes] with up to three way segments, one of which is parallel to the original.

[[PageOutline(2-3,Table of Contents,inline)]]


== Basic usage ==
Click on a way segment and drag it. There are up to 3 possible directions - at right angle to the original position and along its neighboring segments. The chosen reference segment will be indicated.

[[Image(BasicExtrudes.png)]]

**Note**: In certain cases new nodes will not be created. Specifically, if new segment is just lengthening of the old one. However, the node will not be moved when it's part of another way, as to not affect the other way.

**Tip**: If you start with just a single line segment, you will get a rectangle.

[[Image(LineExtrude.png)]]

=== Insert node ===
A double click at a way segment inserts a new node.

=== Move node ===
{{{Ctrl}}}+click on a node and drag it along one segment. Possible directions are directions of all way segments connected to the node.

[[Image(MoveNode.png)]]

=== Dual alignment ===
Toggled by {{{X}}} or the [[Image(source:trunk/images/mapmode/extrude/dualalign.png)]] item in the //Edit// menu. Instead of using one reference segment and moving both nodes of the selected original segment in the same direction, 
this mode uses two reference segments (neigbors of the original segment) and moves the nodes each according to its own reference segment.

[[Image(DualAlign.png)]]

The status is indicated in the status line and visually (two reference segments shown instead of one).


== Modifiers ==

=== Shift ===
[[Image(source:trunk/images/cursor/modifier/rectangle_plussmall.png)]] Always create nodes, even if new segment is just lengthening of the old one.

[[Image(Shift.png)]]

=== Alt ===
[[Image(source:trunk/images/cursor/modifier/rectangle_plus.png)]] Don't alter original way, create new way instead. Ways will share the two nodes.

[[Image(Alt.png)]]

=== Ctrl ===
[[Image(source:trunk/images/cursor/modifier/rectangle_move.png)]] Move segment in parallel. Nodes are moved even if they are connected to other ways.

[[Image(Ctrl.png)]]

Move a node along line.

[[Image(x_ctrl_leftmouse_drag.png)]]

== Customization ==
* Color of main line: Defaults to {{{selected}}} color, but can be changed with [Preferences/Advanced advanced preference] {{{color.extrude.main.line}}}.
* Stroke of main line: {{{extrude.stroke.main}}}. Parameters: {{{<width>}}} for solid line (width in pixels), {{{<width> <dashlength> <spacelength>}}} for dashed line.
* Stroke of old line (used while [#Ctrl moving segment]): {{{extrude.ctrl.stroke.old-line}}} (stroke parameters).
* Color of helper line: {{{Extrude: helper line}}} in [Preferences/Display#Colors colors settings].
* Stroke of helper line: {{{extrude.stroke.helper-line}}} (stroke parameters).
* Size of right angle helper symbol: {{{extrude.angle-symbol-radius}}} (pixels).
* [#Movenode Moving nodes] without the need of pressing {{{Ctrl}}}: {{{extrude.drag-nodes-without-ctrl}}} (boolean).
* Ignoring shared nodes to avoid overlapping segments: {{{extrude.ignore-shared-nodes}}} (boolean).
    If enabled (default), nodes shared with other way(s) are left untouched and new node is created to facilitate the extrusion.
[[Image(IgnoreSharedNodes-enabled.png)]]
    If disabled, shared nodes are still part of the way, segments might overlap.
[[Image(IgnoreSharedNodes-disabled.png)]]
* The extrude action will be performed only if the pointer moved more than specified distance: {{{extrude.initial-move-threshold}}} (pixels, default 1).
* Changing the keyboard shortcut of [#Dualalignment Dual alignment mode]: Set {{{extrude.dualalign.toggleOnRepeatedX}}} to {{{false}}} to disable the default one, set new one via {{{Mode: Extrude Dual alignment}}} shortcut.

----
Back to [EditToolbar Edit Toolbar][[BR]]
Back to [wiki:/Help Main Help]