Changes between Version 73 and Version 82 of Help/Dialog/Filter


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

Legend:

Unmodified
Added
Removed
Modified
  • Help/Dialog/Filter

    v73 v82  
    22[[PageOutline(2-9,Table of Contents)]]
    33
    4 = Filter window =
     4= Filter panel =
    55
    6 [[Image(source:/trunk/images/dialogs/filter.png,middle)]] ''Keyboard shortcut:'' ''' {{{Alt+Shift+F}}}''' — one of the [wikitr:/Help/ToggleDialogs#Toactivateawindow JOSM windows]
     6[[JOSMImage(dialogs/filter,middle,48,link=,margin-right=20)]] ''Keyboard shortcut:'' '''{{{Alt+Shift+F}}}''' — one of the [wikitr:/Help/ToggleDialogs#Toactivateawindow JOSM panels]
    77
    8 The filter window allows the user to temporarily disable and optionally hide certain types of [wikitr:/Help/Concepts/Object objects] based on one (or multiple) filters.
     8The filter panel allows the user to temporarily disable and optionally hide certain types of [wikitr:/Help/Concepts/Object objects] based on one (or multiple) filters.
     9
    910
    1011== Filtered objects ==
    11 * not selectable using [wikitr:/Help#Selection selection tools] (with few minor exceptions in #4929, see [ticket:4929#comment:14 comment 14])
     12* not selectable using [wikitr:/Help/Action/Select selection tools] (with few minor exceptions in #4929, see [ticket:4929#comment:14 comment 14])
    1213* not returned during [wikitr:/Help/Action/Search Search] action
    1314* will disappear from several menus until filters are disabled ([wikitr:/Help/Dialog/SelectionList#SmalltriangleinSelectbutton example])
     15
    1416
    1517== Use cases ==
    1618Simple usage is to enter single tag (or more complex expression similar to search) in "Text" column: objects complying with that text will be disabled.
    1719
    18 More complex scenarios include filters as quick way to develop and test custom [wikitr:/Rules tagchecker rules].
     20More complex scenarios include filters as quick way to develop and test custom [wikitr:/Rules validator rules].
    1921
    2022=== Usability ===
     
    2628* Disable/separate objects that were fully tagged (using tag count and custom filters) from incomplete objects
    2729* Disable recently modified objects (and it is irrelevant: if it modified by you or another person)
    28 * Untagged objects {{{untagged}}} can be used instead of Notes at osm.org. It is faster than to set/remove {{{fixme=resurvey}}} - please don't overuse this principle
     30* Untagged objects {{{untagged}}} can be used instead of Notes at [osmwww: openstreetmap.org]. It is faster than to set/remove {{{fixme=resurvey}}} - please don't overuse this principle
    2931
    3032=== Overview ===
    31 
    3233The filter lines are evaluated from top down, with respect to values in [#Columns Columns].
    3334
     
    3536
    3637=== Columns ===#Columns
    37 
    3838 * '''E''' (''Enable''): Enable or disable this filter line.
    3939 * '''H''' (''Hide elements'' from [wikitr:/Help/MapView main view]): normally, all matched objects are disabled, but you can completely hide them:
    4040  * disabled - visible and displayed as grey
    4141  * hidden - the chosen objects are completely hidden
    42  * '''Text''': The search term or property that defines the objects that are filtered. Every search query from [Help/Action/Search Search] action is supported:
     42 * '''Text''': The search term or property that defines the objects that are filtered. Every search query from [wikitr:/Help/Action/Search Search] action is supported:
    4343  * standard substring search (or exact search with "quotes")
    44   * Regular expressions ([http://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html Java Regex])
     44  * Regular expressions ([https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html Java Regex])
    4545  * MapCSS syntax
    4646 * '''I''' (''Inverse Filter''): Normally, the specified objects are hidden and the rest is shown. If this option is activated, only the specified objects are shown and the rest is hidden.
     
    5454
    5555=== Control buttons ===
    56 
    5756TODO explain 7 buttons.
    5857
    59 === Examples ===#Examples
     58=== Keyboard shortcuts ===
     59Additional to the checkbox in the filter panel, enabling or disabling filters is possible with keyboard shortcuts. `Ctrl+Alt+E` plus `[1-9,0,A-Z]` toggles the corresponding filter on or off, counting from the top of the list. If unsure, `Ctrl+Alt+E` only, without addition, will show a list of available shortcuts.
    6060
    61 ||Filter text                                                                  ||Description or note||
    62 ||{{{ ((landuse:|natural:|leisure:|building:) | (role:outer|role:inner))}}}    ||Doesn't handle relations perfectly||
    63 ||{{{ shop=* opening_hours=* }}}                                               ||shop= + opening_hours= tagged objects||
    64 ||{{{ shop=* name=* }}}                                                        ||shop= + name= tagged objects ||
    65 ||{{{ type:node -shop=* }}}                                                    ||All nodes except shops. Geometry modification using mouse move disabled, but possible using other modes (ex. - [wikitr:/Help/Action/ImproveWayAccuracy Improve Way Accuracy mode (W)])||
    66 ||{{{ (type:node | type:way | type:relation) (modified | user:Steve) }}}       ||Hide objects if you are the latest editor (useful during mass re-tagging and semi-mechanical edits)||
    67 ||{{{ -highway: }}}                                                            ||Everything except highway= tagged objects||
    68 ||{{{ man_made=pipeline }}}                                                    ||Pipelines||
    69 ||{{{ natural=water }}}                                                        ||Water objects||
    70 ||{{{ admin_level: }}}                                                         ||Admin boundaries||
    71 ||{{{ boundary: | leisure: | landuse: | waterway: | amenity: | natural: | building: }}} ||De-clutters map, aggressive (sometimes you may want to keep buildings or amenity key)||
    72 ||{{{ type:node & untagged }}}                                                 ||Make it easier to select ways||
    73 ||{{{ modified }}}                                                             ||Quickly see your changes||
    74 ||{{{ child (type:way & highway:) }}}                                          ||All nodes that's part of a highway||
    75 ||{{{ child (type:relation & (natural:|landuse:)) }}}                          ||All natural and landuse areas formed by relations||
    76 ||{{{ -((highway | child highway | untagged | public_transport) & -(highway=footway | highway=path | highway=steps | highway=track)) }}} || Only roads for public transport. Good for mapping bus networks.  ||
     61
     62== Filter warning ==
     63[[Image(filters warning.png,link=,right,margin-left=20,margin-right=100)]]
     64
     65If any filter is active, and at least one object was filtered, a transparent message box will appear in the top right corner of [wikitr:/Help/MapView main view].
     66 The message has the title **Filter active** and displays the number of disabled objects.
     67
     68
     69== Examples ==#Examples
     70||= Filter text =||= Description or note =||
     71|| `((landuse: | natural: | leisure: | building:) | (role:outer | role:inner))` || Doesn't handle relations perfectly ||
     72|| `shop=* opening_hours=*` || shop= + opening_hours= tagged objects ||
     73|| `shop=* name=*` || shop= + name= tagged objects ||
     74|| `type:node -shop=*` || All nodes except shops. Geometry modification using mouse move disabled, but possible using other modes (ex. - [wikitr:/Help/Action/ImproveWayAccuracy Improve Way Accuracy mode] (`W`)) ||
     75|| `(type:node | type:way | type:relation) (modified | user:Steve)` || Hide objects if you are the latest editor (useful during mass re-tagging and semi-mechanical edits) ||
     76|| `-highway:` || Everything except highway= tagged objects ||
     77|| `man_made=pipeline` || Pipelines ||
     78|| `natural=water` || Water objects ||
     79|| `admin_level:` || Admin boundaries ||
     80|| `boundary: | leisure: | landuse: | waterway: | amenity: | natural: | building:` || De-clutters map, aggressive (sometimes you may want to keep buildings or amenity key) ||
     81|| `type:node & untagged` || Make it easier to select ways ||
     82|| `modified` || Quickly see your changes ||
     83|| `child (type:way & highway:)` || All nodes that's part of a highway ||
     84|| `child (type:relation & (natural: | landuse:))` || All natural and landuse areas formed by relations ||
     85|| `-((highway | child highway | untagged | public_transport) & -(highway=footway | highway=path | highway=steps | highway=track))` || Only roads for public transport. Good for mapping bus networks. ||
    7786
    7887See also other [wikitr:/Help/Action/Search#Examples examples]. If you have some clever filters, add them here.
    7988
    80 == Filter warning ==
    81 
    82 If any filter is active, a transparent message box will appear in the top right corner of [wikitr:/Help/MapView main view].
    83 
    84 It is only visible if at least one object was disabled or hidden.
    85 
    86 [[Image(filters warning.png,link=)]]
    8789
    8890== Auto filters ==#Autofilters
     91Auto filters automatically adds filter buttons in the top left corner of the [wikitr:/Help/MapView map view] for special keys. This needs to be enabled in the [wikitr:/Help/Preferences/Display#OSMData Display settings]. These buttons only appear if there is at least one object tagged with the respective tag within the mapview. See the following screencast on how to enable and use the filter buttons. Above the filter buttons the key which is currently used for the autofilter is displayed (not yet shown in the screencast). A click on that button leads to the preferences where you can change the key.
    8992
    90 Auto filters automatically adds filter buttons in the top left corner of the [wiki:MapView map view] for special keys. This needs to be enabled in the [wiki:Help/Preferences/Display#OSMData Display settings]. These buttons only appear if there is at least one object tagged with the respective tag within the mapview. See the following screencast on how to enable and use the filter buttons.
     93[[Image(autofilter.gif,link=)]]
    9194
    92 [[Image(autofilter.gif)]]
    9395
    9496----
    95 Back to [wikitr:/Help/ToggleDialogs Windows][[BR]]
     97Back to [wikitr:/Help/ToggleDialogs Sidebar] \\
     98Back to [wikitr:/Help/Menu/Windows Windows menu] \\
    9699Back to [wikitr:/Help Main Help]