Changes between Version 48 and Version 55 of Help/Plugin/TurnRestrictions


Ignore:
Timestamp:
(multiple changes)
Author:
(multiple changes)
Comment:
(multiple changes)

Legend:

Unmodified
Added
Removed
Modified

  • Help/Plugin/TurnRestrictions

    v48 v55  
    44=  Plugin -> Turn Restrictions =
    55
    6 [[Image(source:osm/applications/editors/josm/plugins/turnrestrictions/images/preferences/turnrestrictions.png,48,link=,middle)]]
     6[[Image(source:osm/applications/editors/josm/plugins/turnrestrictions/images/preferences/turnrestrictions.png,48,link=,middle,margin-right=20)]]
    77
    88== Introduction ==
    … …  
    1313The ''**turnrestrictions**'' plugin supports editing of turn restrictions. It consists of two major components:
    1414
    15 1. **Turn Restriction Toggle Dialog** - the turn restrictions toggle dialog is displayed on the right in the Toggle Dialogs Section. It displays the list of turn restrictions in the current data set and allows to create or delete turn restrictions, or to launch the Turn Restriction Editor to edit a turn restriction.
    16 1. **Turn Restriction Editor** - the Turn Restriction Editor is a special purpose editor for turn restrictions.
     151. **Turn Restriction Panel** - the turn restrictions panel is displayed on the right in sidebar. It displays the list of turn restrictions in the current data set and allows to create or delete turn restrictions, or to launch the Turn Restriction Editor to edit a turn restriction.
     161. **Turn Restriction Editor (`Alt+Shift+2`)** - the Turn Restriction Editor is a special purpose editor for turn restrictions.
     17
    1718
    1819== Tagging model ==
    … …  
    2324 * must have a relation member with role **`from`** referring to a [wikitr:/Help/Concepts/Object#Ways way]. We call this way the **''from**''-**way**.
    2425 * must have a relation member with role **`to`** referring to a [wikitr:/Help/Concepts/Object#Ways way]. We call this way the **''to**''-**way**.
    25  * must have at least of relation member with role `via` referring to a [wikitr:/Help/Concepts/Object#Nodes node] or [wikitr:/Help/Concepts/Object#Ways way]. We call these objects **''via**''-**object**.
    26 
     26 * must have at least one relation member with role `via` referring to a [wikitr:/Help/Concepts/Object#Nodes node] or [wikitr:/Help/Concepts/Object#Ways way]. We call these objects **''via**''-**object**.
    2727
    2828
    2929== Use Cases ==
    3030=== Creating a turn restriction ===#CreateANewTurnRestriction
    31 There are several possibilities to create a new turn restriction. First, you can lauch the Turn Restriction Editor for a new turn restriction from the Turn Restriction Toggle Dialog:
    32  1. Click on [[JOSMImage(new,link=,24,middle)]] in the Turn Restriction Toggle Dialog. Alternatively, select [[JOSMImage(new,link=,24,middle)]] **New** from the popup menu.
     31There are several possibilities to create a new turn restriction. First, you can lauch the Turn Restriction Editor for a new turn restriction from the Turn Restriction Panel:
     32 1. Click on [[JOSMImage(new,link=,24,middle)]] in the Turn Restriction Panel. Alternatively, select [[JOSMImage(new,link=,24,middle)]] **New** from the popup menu.
    3333
    3434Alternatively, you can launch a new editor with a keyboard shortcut:
    35 1. Press the shortcut for creating or editing a turn restriction. On most platforms the shortcut is **`Ctrl+Shift+T`**.
     351. Press the shortcut for creating or editing a turn restriction. On most platforms the shortcut is **`Alt+Shift+2`**.
    36361. If objects in the current JOSM selection already participate in a turn restriction, the following window pops up.
    3737 
    3838 [[Image(create-turn-restriction-popup.png,link=)]] \\
    39  Just click on  [[JOSMImage(new,link=,24,middle)]] **Create new turn restriction** to launch the turn restriction editor for a new turn restriction. Alternatively, press the key **`N`** or hit **`Enter`**.
     39 Just click on [[JOSMImage(new,link=,24,middle)]] **Create new turn restriction** to launch the turn restriction editor for a new turn restriction. Alternatively, press the key **`N`** or hit **`Enter`**.
    4040
    4141In both cases, the ''turnrestrictions'' plugin initializes the new turn restriction with objects from the current JOSM selection:
    … …  
    4646A fast way to create a turn restriction is therefore to
    47471. Select the **''from**''- and **''to**''-way in JOSM
    48 1. Press **`Ctrl+Shift+T`**
     481. Press **`Alt+Shift+2`**
    49491. Choose the type of the turn restriction and save it.   
    5050   
    5151=== Editing a turn restriction === #EditingATurnRestriction
    52 There are several possible ways to launch a Turn Restriction Editor in order to edit a turn restriction. First, you can lauch the Turn Restriction Editor for an existing turn restriction from the Turn Restriction Toggle Dialog:
    53 1. Select a turn restriction in the Turn Restriction Toggle Dialog
     52There are several possible ways to launch a Turn Restriction Editor in order to edit a turn restriction. First, you can lauch the Turn Restriction Editor for an existing turn restriction from the Turn Restriction Panel:
     531. Select a turn restriction in the Turn Restriction Panel
    54541. Click on [[JOSMImage(dialogs/edit,link=,24,middle)]]. Alternatively, select [[JOSMImage(dialogs/edit,link=,24,middle)]] **Edit** from the popup menu.
    5555
    5656Second, you can launch a new editor with a keyboard shortcut:
    57 1. Press the shortcut for creating or editing a turn restriction. On most platforms the shortcut is **`Ctrl+Shift+T`**.
     571. Press the shortcut for creating or editing a turn restriction. On most platforms the shortcut is **`Alt+Shift+2`**.
    58581. If objects in the current JOSM selection already participate in a turn restriction, the following window pops up.
    5959
    … …  
    6363A fast way to edit a turn restriction is therefore to
    64641. Select the **''from**''- or **''to**''-way in JOSM
    65 1. Press **`Ctrl+Shift+T`**
    66 1. Type **`1`** to lauch the Turn Restriction Editor 
     651. Press **`Alt+Shift+2`**
     661. Type **`1`** to launch the Turn Restriction Editor
    6767 
    6868=== Deleting a turn restriction ===
    69 There are several possible ways to delete a turn restriction. First, you can delete it in the Turn Restriction Toggle Dialog:
    70 1. Select a turn restriction in the Turn Restriction Toggle Dialog
     69There are several possible ways to delete a turn restriction. First, you can delete it in the Turn Restriction Panel:
     701. Select a turn restriction in the Turn Restriction Panel
    71711. Press **`DEL`** or click on [[JOSMImage(dialogs/delete,link=,24,middle)]]. Alternatively, select [[JOSMImage(dialogs/delete,link=,24,middle)]] **Delete** from the popup menu.
    7272
    73 Alternatively, you can [#EditingATurnRestriction launch a Turn Restriction Editor] and click on  [[JOSMImage(dialogs/delete,link=,24,middle)]] in its toolbar.
     73Alternatively, you can [#EditingATurnRestriction launch a Turn Restriction Editor] and click on [[JOSMImage(dialogs/delete,link=,24,middle)]] in its toolbar.
    7474
    7575
     76== Turn Restriction Panel == #TurnRestrictionPanel
     77[=#TurnRestrictionToggleDialog]
     78The Turn Restriction Panel helps you to keep track of the turn restrictions in the current edit layer.
    7679
    77 == Turn Restriction Toggle Dialog == #TurnRestrictionToggleDialog
    78 The Turn Restriction Toggle Dialog helps you to keep track of the turn restrictions in the current edit layer.
    79 
    80 Here's a screenshot of the toggle dialog and its popup menu: \\
     80Here's a screenshot of the panel and its popup menu: \\
    8181[[Image(toggle-dialog-screenshot.png,link=)]]
    8282
    … …  
    8484
    8585You can apply some commands to the turn restrictions displayed in this dialog.
    86 ||**Create** a new turn restriction||Click [[JOSMImage(new,link=,24,middle)]] or select  [[JOSMImage(new,link=,24,middle)]] **New** from the popup menu||
    87 ||**Edit** a turn restriction||Select the turn restriction and click [[JOSMImage(dialogs/edit,link=,24,middle)]] or select  [[JOSMImage(dialogs/edit,link=,24,middle)]] **Edit** from the popup menu||
     86||=**Command**=||=**Description**=||
     87||**Create** a new turn restriction||Click [[JOSMImage(new,link=,24,middle)]] or select [[JOSMImage(new,link=,24,middle)]] **New** from the popup menu.||
     88||**Edit** a turn restriction||Select the turn restriction and click [[JOSMImage(dialogs/edit,link=,24,middle)]] or select [[JOSMImage(dialogs/edit,link=,24,middle)]] **Edit** from the popup menu.||
    8889||**Delete** a turn restriction||Select one or more turn restrictions, press **`DEL`**, or click on [[JOSMImage(dialogs/delete,link=,24,middle)]] or select [[JOSMImage(dialogs/delete,link=,24,middle)]] **Delete** from the popup menu.||
    8990||**Select** the turn restriction||In order to select the turn restriction and its members in the current edit layer, first select the turn restriction in the list and then select [[JOSMImage(selectall,link=,24,middle)]] **Select in current data layer** from the popup menu.||
    9091||**Zoom** to the turn restriction||Select the turn restriction in the list and then select [[JOSMImage(dialogs/autoscale/selection,link=,24,middle)]] **Zoom to** from the popup menu.||
    91 
    9292
    9393
    … …  
    129129* `type=restriction`  - this is a required tag for a turn restriction.
    130130* `restriction=...`   - the value of this tag should be one of the [osmwiki:Relation:restriction supported types for turn restrictions]. Instead of editing the raw tag value you can also select a restriction type from the drop-down box in the [#BasicEditor Basic Editor].
    131 * `exception=...` -  the value of this tag should be a set of [osmwiki:Relation:restriction supported vehicle types]. Instead of editing the raw tag value you can also tick the respective vehicle types in the [#BasicEditor Basic Editor].
    132 * `day_on=...`, `day_off=...`, `hour_on=...` and `hour_off=...` can be used to specify when a turn restriction is actually in place, refer to the [osmwiki:Relation:restriction OSM wiki for more information].
    133 
     131* `except=...` -  the value of this tag should be a set of [osmwiki:Relation:restriction supported vehicle types]. Instead of editing the raw tag value you can also tick the respective vehicle types in the [#BasicEditor Basic Editor].
     132* (`day_on=...`, `day_off=...`, `hour_on=...` and `hour_off=...` can be used to specify when a turn restriction is actually in place, refer to the [osmwiki:Relation:restriction OSM wiki for more information].) **''Deprecated, please use [osmwiki:/Conditional_restrictions conditional restrictions] instead.''**
    134133
    135134==== Editing the members ====
    136 In the lower half of the Advanced Editor you can edit the members of the turn restriction relation.
     135In the lower half of the Advanced Editor you can edit the [osmwiki:Relation:restriction#Members members] of the turn restriction relation.
    137136
    138 In addition to the ''from''-way and the ''to''-way, which you can edit in the  [#BasicEditor Basic Editor] too, you can also enter ''via''-object and a node with role `location_hint` (see  [osmwiki:Relation:restriction OSM wiki]).
     137In addition to the ''from''-way and the ''to''-way, which you can edit in the  [#BasicEditor Basic Editor] too, you can also enter ''via''-objects. (The role `location_hint` is deprecated as it is not verifiable on the ground).
    139138
    140139To add members just drag-and-drop or copy/paste objects from the JOSM selection view on the right to the list of relation members.
    … …  
    152151=== Resolving Errors and Warnings === #ErrorsAndWarnings
    153152[[Image(sample-screen-shot-3.png,link=)]]
    154 
    155153
    156154
    … …  
    172170You can override the standard setting, though. If you tick the respective checkbox in the preferences (see screen shot above) the list of via-objects is displayed in the Basic Editor too.
    173171
    174 {{{#!comment
    175 Shortcut configuration does not work, atm, and will probably not be readded to the plugin preferences. See #21243
    176 }}}
    177 
    178 {{{#!comment
    179 === Configure shortcut for creating/editing a turn restriction ===
    180 In the preference dialog you can also configure the shortcut to create/edit a turn restriction. The default shortcut is **`Ctrl+Shift+T`** but you can change it to whatever shortcut you like.
    181 
    182 Be careful not to override already defined shortcuts, though. For instance, **`Ctrl+S`** is the defined shortcut for **Save to file**. If you set the turn restrictions shortcut to **`Ctrl+S`**, then pressing **`Ctrl+S`** won't save the current layer any more. The turn restriction editor is launched instead.
    183 }}}
    184172
    185173== See also ==
    186174* [osmwiki:JOSM/Plugins/turnrestrictions Turnrestriction Plugin page] - Historic reference, development of this plugin in 2010-03 was sponsored by [https://www.skobbler.de/ skobbler GmbH]
    187175
     176
    188177----
    189178Back to [wikitr:/Plugins#JOSMdocu Plugin Help] \\