Changes between Version 208 and Version 268 of Help/Styles/MapCSSImplementation


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

Legend:

Unmodified
Added
Removed
Modified

  • Help/Styles/MapCSSImplementation

    v208 v268  
    88* [wikitr:/Help/Action/Search Search dialog]
    99
     10Consider installing the [https://marketplace.visualstudio.com/items?itemName=whammo.mapcss-syntax MapCSS Syntax Highlighter] in VS Code to add visual highlighting for MapCSS paint and validator syntax.
    1011
    1112== General Structure ==
    … …  
    2021    set: class;
    2122    set: .class;
     23    /* note that validator rules do not use the colon after set */
    2224}
    2325}}}
    … …  
    6668
    6769=== Type selector ===
    68 
    6970{{{#!th valign=top
    7071'''Selector'''
    … …  
    251252way[highway=residential]                    /* is case sensitive, i.e. does NOT match e.g. highway=Residential or Highway=residential   */
    252253node[name="My name"]                        /* use quotes if key or value includes spaces                                               */
    253 node["name:ru"="Калининград"]               /* use quotes if key or value includes special characters like colons or unicode characters */
     254node["name:pl"="Królewiec"]                 /* use quotes if key or value includes special characters like colons or unicode characters */
    254255}}}
    255256}}}
    … …  
    266267way[highway!=residential]
    267268node[name!="My name"]
    268 node["name:ru"!="Калининград"]
     269node["name:pl"!="Królewiec"]
    269270}}}
    270271}}}
    … …  
    342343}}}
    343344{{{#!td align=left valign=top
    344 [https://download.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html#sum Regular expression] match
     345[https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/regex/Pattern.html#sum Regular expression] match
    345346
    346347}}}
    … …  
    351352                                            /* Note, that reqular expressions have to be enclosed in /.../                     */
    352353}}}
    353 Case-insensitive matching can be enabled via the embedded flag expression `(?i)` (see [https://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html#CASE_INSENSITIVE Pattern.CASE_INSENSITIVE]).
     354Case-insensitive matching can be enabled via the embedded flag expression `(?i)` (see [https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/regex/Pattern.html#CASE_INSENSITIVE Pattern.CASE_INSENSITIVE]).
    354355{{{
    355356#!mapcss
    … …  
    363364}}}
    364365{{{#!td align=left valign=top
    365 negated [https://download.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html#sum Regular expression] match
     366negated [https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/regex/Pattern.html#sum Regular expression] match
    366367
    367368}}}
    … …  
    507508|-------------------------------------------------------------------------------
    508509{{{#!td align=left  valign=top
    509 Presence of tag by [https://download.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html#sum Regular expression] match (since r6547)
     510Presence of tag by [https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/regex/Pattern.html#sum Regular expression] match (since r6547)
    510511}}}
    511512{{{#!td align=left  valign=top   
    … …  
    631632=== Zoom selector ===
    632633You can decorate a type selector with a '''zoom selector'''. The zoom selector restricts the range of zoom levels at which the respective MapCSS rule is applied.
    633 
    634 {{{#!th align=center valign=top
    635 '''Example'''
    636 }}}
    637 {{{#!th align=center valign=top
    638 '''Description'''
    639 }}}
    640 |-------------------------------------------------------------------------------
    641 || `way|z12 {...} ` || At zoom level 12 ||
    642 || `way|z13-15 {...} ` || From 13 to 15 ||
    643 || `way|z16- {...} ` || 16 and above ||
    644 || `way|z-12 {...} ` || 12 and below ||
    645 || `way {...} ` || any zoom level ||
     634||= '''Example 1''' =||= '''Example 2''' =||= '''Example 3''' =||= '''Description''' =||
     635|| `way|z12 {...}` || `node|z12 {...}` || `node|z12[...] {...}` || At zoom level 12 ||
     636|| `way|z13-15 {...}` || `node|z13-15 {...}` || `way|z13-15[...] {...}` ||From 13 to 15 ||
     637|| `way|z16- {...}` || `node|z16- {...}` || `node|z16-[...] {...}` || 16 and above ||
     638|| `way|z-12 {...}` || `node|z-12 {...}` || `node|z-12[...] {...}` || 12 and below ||
     639|| `way {...}` || `node{...}` || `way[...] {...}` || any zoom level ||
    646640
    647641The precise definition of scale ranges for each zoom level may change in the future. By rule of thumb you can expect to be approximately at zoom level ''n'' when imagery displays slippymap tiles of level ''n''.
    … …  
    650644See [/doc/org/openstreetmap/josm/gui/mappaint/mapcss/ConditionFactory.PseudoClasses.html Javadoc] for the up-to-date list of pseudo classes supported by JOSM's MapCSS implementation.
    651645
    652 ||= Class =||= Description =||
     646||= '''Class''' =||= '''Description''' =||
    653647|| `:closed` || true for ways where the first node is the same as the last and for any (completely downloaded) multipolygon relation ||
    654648|| `:closed2` || same as above, but this one ignores if a multipolygon is downloaded completely (since r9099) ||
    … …  
    732726way::A { a; }
    733727way::B { b; }
    734 way::* { c; }
     728way::* { c; }  /* overrides all existing subparts */
    735729}}}
    736730is equivalent to
    … …  
    739733way::A { a; }
    740734way::B { b; }
    741 way::A { c; }
    742 way::B { c; }
     735way::A { c; } /* overrides a with c all existing subparts */
     736way::B { c; } /* overrides b with c all existing subparts */
    743737}}}
    744738And it initializes new subparts. In other words:
    … …  
    807801}}}
    808802You can also negate classes. E.g. `way!.path` for all ways, which are not part of the class ''.path''.
     803
     804=== Classes and Layer together ===
     805If you want to use layer and classes together, please note that you have to identify the class via is_prop_set.
     806
     807{{{#!mapcss
     808node[railway=signal] { set sgnl; }
     809
     810/* it doesn't work */
     811node.sgnl::layer_signal_icon  { z-index: 1000; ... icon: icon/signal-icon.svg; ... }
     812node.sgnl::layer_signal_text  { z-index: 1010; ... text: concat("Name of signal: ", tag("ref")); ..... )
     813
     814/* use instead: is_prop_set("...", "default") */
     815node[is_prop_set("sgnl", "default")]::layer_signal_icon  { z-index: 1000; ... icon: icon/signal-icon.svg; ... }
     816node[is_prop_set("sgnl", "default")]::layer_signal_text  { z-index: 1010; ... text: concat("Name of signal: ", tag("ref")); ..... )
     817}}}
    809818
    810819=== @supports Conditional Processing  ===
    … …  
    10131022}}}
    10141023
    1015 Settings groups are displayed as sub-menus from the style settings menu. If at least two settings belong to a group, a special "Toggle all settings" menu item allows to quickly switch on/off all settings from this group at once. Usage example: [wiki:/Styles/MapWithAI MapWithAI].
     1024Settings groups are displayed as sub-menus from the style settings menu. If at least two settings belong to a group, a special "Toggle all settings" menu item allows to quickly switch on/off all settings from this group at once. Usage example: [wikitr:/Styles/MapWithAI MapWithAI].
    10161025
    10171026
    … …  
    10361045|| `icon-offset-x` || Shift the icon in horizontal direction (positive values to the right) (since r8085) || ''Number'' ||  0  ||
    10371046|| `icon-offset-y` || Shift the icon in vertical direction (positive values downwards) (since r8085) || ''Number'' ||  0  ||
    1038 || `icon-rotation` || Rotate the icon clockwise or anti clockwise (negative value)(since r8260) || `[rad]`, `[rad]rad`, `[deg]°`, `[deg]deg`, `[grad]grad`, `[turn]turn` ([https://developer.mozilla.org/en/docs/Web/CSS/angle definition]) or a cardinal direction (e.g. `northeast` or `sw`); See also the functions `degree_to_radians`, `cardinal_to_radians`. ||  -  ||
     1047|| `icon-rotation` || Rotate the icon clockwise or anti clockwise (negative value)(since r8260) || `[rad]`, `[rad]rad`, `[deg]°`, `[deg]deg`, `[grad]grad`, `[turn]turn` ([https://developer.mozilla.org/en/docs/Web/CSS/angle definition]) \\ or a cardinal direction (e.g. `northeast` or `sw`); \\ or `way` to rotate the icon in the direction of the parent way. \\ See also the functions `degree_to_radians`, `cardinal_to_radians`. \\Since version 18678 function parent_way_angle() is an alternativ to way: e.g. {{{ way > node[...]::layer_x { ... icon-rotation: parent_way_angle(); ... } }}} ||  -  ||
    10391048|| `icon-position` || Define the position of the icon for areas. Same as `text-position` (since r11730). || `center`, `inside`, `line` ||  `center`  ||
    10401049|| `symbol-shape` || Display a symbol at the position of the node || `square`, `circle`, `triangle`, `pentagon`, `hexagon`, `heptagon`, `octagon`, `nonagon`, `decagon` ||  -  ||
    … …  
    10451054|| `symbol-fill-color` || fill color for the shape || ''Color'' || `blue`, unless either `symbol-stroke-width` or `symbol-stroke-color` is set ||
    10461055|| `symbol-fill-opacity` || fill opacity || ''Opacity'' ||  1.0  ||
    1047 || `text-...`, `font-...` ||||||  general text & font properties  ||
    1048 || `text-anchor-horizontal` || horizontal text label placement || `left`, `center`, `right` ||  `right`  ||
    1049 || `text-anchor-vertical` || vertical text label placement || `above`, `top`, `center`, `bottom`, `below` ||  `bottom`  ||
    1050 || `text-rotation` || Rotate the text clockwise or anti clockwise (negative value) (since r16253) || `[rad]`, `[rad]rad`, `[deg]°`, `[deg]deg`, `[grad]grad`, `[turn]turn` ([https://developer.mozilla.org/en/docs/Web/CSS/angle definition]) or a cardinal direction (e.g. `northeast` or `sw`); See also the functions `degree_to_radians`, `cardinal_to_radians`. (Note that the direction means where the upper edge of the text faces. That means with the default direction of north the text flows to east (with a left to right language). So if you want to flow it to e.g. south you need to set east.) ||  -  ||
     1056|| `text-...`, `font-...` ||||||  see general '''Text & Font properties''' ||
    10511057
    10521058Do not rely on the default values for `symbol-...` properties (except for `opacity`). They are intended for "quick & dirty" style sheets and should be set to an explicit value.
    10531059
    1054 === Line styles ===
     1060=== Line styles ===#LineStyles
    10551061||=  '''Key''' =||= '''Description''' =||= '''Value Format''' =||= '''Default Value''' =||
    10561062|| `width` || Line width || ''Width'' ||  -  ||
    1057 || `color` || Line color || ''Color'' ||  value of `fill-color` or (if unset) JOSM's default untagged color (`#808080`) ||
     1063|| `color` || Line color || ''Color'' ||  value of `fill-color` or\\(if unset) JOSM's default \\untagged color (`#808080`) ||
    10581064|| `opacity` || How transparent the line is. || ''Opacity'' ||  1.0  ||
    10591065|| `dashes` || An array of alternating on/off lengths || list of numbers, e.g. \\> 15, 5 \\ \\may be written as expression: \\ > `list(3, 4, 5, 6)` \\ \\or the keyword `none` \\to turn dashes off ||  -  ||
    … …  
    10631069|| `linecap` || Shape at the end of the line (see [https://www.w3.org/TR/SVG/painting.html#StrokeLinecapProperty here]) || `none`, `round`, `square` ||  `none`  ||
    10641070|| `linejoin` || Shape at the line corners || `round`, `miter`, `bevel` ||  `round`  ||
    1065 || `miterlimit` || Applies for `linejoin: miter`. Sets the maximum overshoot when line segments meet at a very small angle || ''Number'' (>= 1.0) ||  10.0  ||
    1066 || `offset` || Move line to the left or right (when looking in way direction). This could be used to draw multiple lanes for one way or mark left and right side of a way differently. || ''Number'' (positive value moves line to the left, negative to the right) ||  0  ||
     1071|| `miterlimit` || Applies for `linejoin: miter`. \\Sets the maximum overshoot when line segments meet at a very small angle || ''Number'' (>= 1.0) ||  10.0  ||
     1072|| `offset` || Move line to the left or right (when looking in way direction). \\This could be used to draw multiple lanes for one way or mark left and right side of a way differently. || ''Number'' (positive value moves line to the left,\\negative to the right) ||  0  ||
    10671073|| `text-position` || set to `line`, if text should be drawn along the line || `line`, `center` ||  -  ||
    1068 || `text-...`, `font-...` ||||||  general text & font properties  ||
     1074|| `text-...`,\\`font-...` |||||| see general '''Text & Font properties  ||
    10691075|| `repeat-image` || repeated image along a line ''(since r5801)'' || ''Image'' ||  -  ||
    10701076|| `repeat-image-width` || Width of the image (optional, see `icon-width`) ''(since r5811)'' || ''Number'' ||  -  ||
    10711077|| `repeat-image-height` || Height of the image (optional) ''(since r5811)'' || ''Number'' ||  -  ||
    1072 || `repeat-image-align` || Alignment of the image. Top-, bottom edge or the (horizontal) center line of the image will be along the line ''(since r5801)'' || `top`, `center`, `bottom` ||  `center`  ||
     1078|| `repeat-image-align` || Alignment of the image.\\Top-, bottom edge or the (horizontal) center line of the image will be along the line ''(since r5801)'' || `top`, `center`, `bottom` ||  `center`  ||
    10731079|| `repeat-image-offset` || Offset from the line ''(since r5801)'' || ''Number'' ||  0  ||
    10741080|| `repeat-image-spacing` || Spacing between repeated images ''(since r5801)'' || ''Number'' ||  0  ||
    … …  
    10781084All these properties (except for `text-...` and `font-...`) exist also with the `casing-` prefix. The casing is a second independent line element, that is drawn below the normal line and can be used to draw a thin frame around the line in another color.
    10791085||=  '''Key''' =||= '''Description''' =||= '''Value Format''' =||= '''Default Value''' =||
    1080 || `casing-width` || Width of the border on both sides of the main line. In JOSM < 5214: Total width of the casing || ''Width'' (revers to `width` if relative width is specified) ||  -  ||
    1081 || `casing-color` || Casing color || ''Color'' ||  value of `fill-color` or (if unset) JOSM's default untagged color (`#808080`) ||
     1086|| `casing-width` || Width of the border on both sides of the main line. \\In JOSM < 5214: Total width of the casing || ''Width'' (revers to `width` if relative width is specified) ||  -  ||
     1087|| `casing-color` || Casing color || ''Color'' ||  value of `fill-color` or (if unset) \\JOSM's default untagged color (`#808080`) ||
    10821088|| `casing-opacity` || How transparent the casing is. || ''Opacity'' ||  1.0  ||
    10831089|| `casing-`... || ... || ... ||  ...  ||
    10841090Similar to `casing-`, there is also the `left-casing-` and `right-casing-` prefix. It draws additional lines to the left and to the right of the main line.
    10851091
    1086 === Area styles ===
    1087 ||=  '''Key''' =||= '''Description''' =||= '''Value Format''' =||= '''Default Value''' =||
     1092=== Area styles ===#AreaStyles
     1093||= '''Key''' =||= '''Description''' =||= '''Value Format''' =||= '''Default Value''' =||
    10881094|| `fill-color` || Color in which to fill the area. Until 11700, the alpha component was set to 50 to create a transparency effect. || ''Color'' ||  -  ||
    10891095|| `fill-image` || Image pattern || ''Image'' ||  -  ||
    10901096|| `fill-extent` || Set this property, to draw only the outline of the area. The number specifies, how far to fill from the border of the area towards the center. (If unset, the area will be filled completely) ''(since r9008)'' || ''Number'' ||  -  ||
    10911097|| `fill-extent-threshold` || Set this property, to draw full area when the given percentage of coverage is reached. Can be greater than 100% as the covered area is estimated as **perimeter * extent**. || ''Number'' ||  -  ||
    1092 || `fill-opacity` || How transparent the fill is; applies to both color and image || ''Opacity'' || 0.2 ''(since r11700, 1.0 before that)'' (can be changed with the `mappaint.fillalpha` and `mappaint.fill-image-alpha` preferences)  ||
     1098|| `fill-opacity` || How transparent the fill is; applies to both color and image || ''Opacity'' || 0.2 ''(since r11700, 1.0 before that)'' \\(can be changed with the `mappaint.fillalpha` and \\`mappaint.fill-image-alpha` preferences)  ||
    10931099|| `text-position` || set to `center`, if text should be drawn in the center of the area. Set to `inside` to place the text completely inside the area. ''(since r11722)'' || `line`, `center`, `inside` ||  -  ||
    1094 || `text-...`, `font-...` ||||||  general text & font properties  ||
     1100|| `text-...`, `font-...` ||||||  see general text & font properties  ||
    10951101Required properties to create an Area style: `fill-color` or `fill-image`
    10961102
    … …  
    11131119}}}
    11141120{{{#!td align=left  valign=top
    1115 How to find the label text. No label is displayed, unless this instruction is present.
     1121How to find the label text.\\No label is displayed, unless this instruction is present.
    11161122}}}
    11171123{{{#!td align=left  valign=top
    11181124`auto`
    1119    Derive the text automatically. The default name tags are: "`name:`"+''<LANG>'', "`name`", "`int_name`", "`ref`", "`operator`", "`brand`" and "`addr:housenumber`".
    1120 
    1121    Configure a list of tag names in the preference "`mappaint.nameOrder`" in order to change this list. (After changing the list, a restart of JOSM is required.)
     1125  Derive the text automatically. The default name tags are: "`name:`"+''<LANG>'', \\"`name`", "`int_name`", "`ref`", "`operator`", "`brand`" and "`addr:housenumber`".
     1126
     1127  Configure a list of tag names in the preference "`mappaint.nameOrder`" in order \\ to change this list. (After changing the list, a restart of JOSM is required.)
    11221128
    11231129''String''
    1124    Denotes the key of the tag whose value is used as text.
     1130  Denotes the key of the tag whose value is used as text.
    11251131
    11261132''Expressions''
    11271133  You can enter an expression to compute the text to be displayed. Examples:
    11281134  * `eval("this is a static text")` - renderes a static text
    1129   * `eval(concat(tag("first"), "-", tag("second")))` - displays the concatenated tags "first" and "second"
     1135  * `eval(concat(tag("first"), "-", tag("second")))` - displays \\ the concatenated tags "first" and "second"
    11301136
    11311137`""`
    … …  
    11361142}}}
    11371143|-------------------------------------------------------------------------------
    1138 || `text-color` || the text color || ''Color'' ||  `white` for lines and nodes, `#c0c0c0` for areas (JOSM "`text`" and "`areatext`" color preferences) ||
     1144|| `text-color` || the text color || ''Color'' ||  `white` for lines and nodes,\\`#c0c0c0` for areas \\(JOSM "`text`" and "`areatext`"\\color preferences) ||
    11391145|| `text-opacity` || how transparent the text is || ''Opacity'' ||  1.0  ||
    1140 || `text-offset-x` || shift the text horizontally, (not supported for text along line) || ''Number'' ||  0  ||
    1141 || `text-offset-y` (can also be written as `text-offset`)  || shift the text vertically, positive values shift the text in upwards direction  || ''Number'' ||  0  ||
    1142 || `text-halo-radius` || size of text background border (to make text visible on background with a similar color) || ''Number'' ||  -  ||
     1146|| `text-offset-x` || shift the text horizontally, \\(not supported for text along line) || ''Number'' ||  0  ||
     1147|| `text-offset-y`\\(can also be written as\\`text-offset`)  || shift the text vertically, positive values shift the text in upwards direction  || ''Number'' ||  0  ||
     1148|| `text-halo-radius` || size of text background border \\(to make text visible on background \\with a similar color) || ''Number'' ||  -  ||
    11431149|| `text-halo-color` || color of the text halo || ''Color'' ||  complement of the text color  ||
    11441150|| `text-halo-opacity` || transparency for the text halo || ''Opacity'' ||  1.0  ||
    1145 || `font-family` || font family || ''String'' ||  "Droid Sans" \\(JOSM preference "mappaint.font")  ||
    1146 || `font-size` || font size || ''Number'' ||  8 \\(JOSM preference "mappaint.fontsize")  ||
     1151|| `text-anchor-horizontal` || horizontal text label placement || `left`, `center`, `right` ||  `right`  ||
     1152|| `text-anchor-vertical` || vertical text label placement || `above`, `top`, `center`, `bottom`, `below` ||  `bottom`  ||
     1153|| `text-rotation` || Rotate the text clockwise or anti clockwise (negative value)\\(since r16253) || `[rad]`, `[rad]rad`, `[deg]°`, `[deg]deg`, `[grad]grad`, `[turn]turn` \\([https://developer.mozilla.org/en/docs/Web/CSS/angle definition]) or a cardinal direction (e.g. `northeast` or `sw`); \\ or `way` to rotate the text in the direction of the parent way. \\See also the functions `degree_to_radians`, `cardinal_to_radians`. \\Since version 18678 function parent_way_angle() is an alternativ to way: e.g. {{{ way > node[...]::layer_x { ... text-rotation: parent_way_angle(); ... } }}} \\(Note that the direction means where the upper edge of the text faces.\\That means with the default direction of north the text flows to east\\(with a left to right language). \\So if you want to flow it to e.g. south you need to set east.) ||  -  ||
     1154|| `text-position` |||||| see [#AreaStyles Area styles] and [#LineStyles Line styles] ||
     1155|| `font-family` || font family || ''String'' ||  "Droid Sans" \\(JOSM preference "`mappaint.font`")  ||
     1156|| `font-size` || font size || ''Number'' ||  8 \\(JOSM preference "`mappaint.fontsize`")  ||
    11471157|| `font-weight` || bold or not || `bold`, `normal` ||  `normal`  ||
    11481158|| `font-style` || italic or not || `italic`, `normal` ||  `normal`  ||
    … …  
    11681178 * '''`rgba(/*r*/, /*g*/, /*b*/, /*alpha*/)`''' - rgb value with alpha
    11691179 * '''`hsb_color(/*hue*/, /*saturation*/, /*brightness*/)`''' - color from HSB color space
     1180 * if the color is prefixed with a name and #, e.g. `color: highway_track#6e541c;` it will appear in the [wikitr:/Help/Preferences/ColorPreference Color Preference] and end users can adjust the color there themself
    11701181
    11711182'' '''Opacity''' ''
    … …  
    11901201  comparison operators
    11911202 asin, atan, atan2, ceil, cos, cosh, exp, floor, log, max, min, mod (since r17759), random, round, signum, sin, sinh, sqrt, tan, tanh::
    1192   the usual meaning, [https://download.oracle.com/javase/8/docs/api/java/lang/Math.html details]
     1203  the usual meaning, [https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Math.html details]
    11931204 cond(b, fst, snd)::
    11941205 b ? fst : snd::
    … …  
    12631274  return the substring of ''str'', starting at index ''idx'' (0-indexed) [''since r6534'']
    12641275 substring(str, start, end)::
    1265   return the substring of ''str'', starting at index ''start'' (inclusive) up to ''end'' (exclusive) (0-indexed) [''since r6534'']
     1276  return the substring of ''str'', starting at index ''start'' (inclusive) up to ''end'' (exclusive) (0-indexed) [''since r6534''], a negative end index counts from the string end [''since r19259'']
    12661277 replace(string, old, new)::
    12671278   Replaces any occurrence of the substring ''old'' within the string ''string'' with the text ''new''
    … …  
    12881299 CRC32_checksum(''str'')::
    12891300  calculate the CRC32 checksum of a string (result is an integer from 0 to 2^32^-1) [''since r6908'']
     1301 siunit_length(''str'')::
     1302   convert length units to meter (fault tolerant, ignoring white space) [''since r19089'']
    12901303 is_right_hand_traffic()::
    12911304  Check if there is left-hand or right-hand traffic at the current location. [''since r7193'']
    … …  
    13181331 sort(''str1'', ''str2'', ''str3'', ''...'')::
    13191332  sorts an array of strings [''since r15279'']
    1320  sort_list()::
     1333 sort_list(''list_name'')::
    13211334  sorts a list of strings [''since r15279'']
    13221335 tag_regex(''regex'')::
    1323   returns a list of values that match the regex [''since r15317'']
     1336  returns a list containing the values of keys that match the regex [''since r15317'']
    13241337 to_boolean(''str'')::
    13251338  returns the string argument as a boolean [''since r16110'']
    … …  
    13381351 uniq(''str1'', ''str2'', ''str3'', ''...'')::
    13391352  returns a list of strings that only have unique values from an array of strings [''since r15323'']
    1340  uniq_list()::
    1341   returns a list of strings that only have unique values from a list of strings [''since r15353'']
     1353 uniq_list(''list_name'')::
     1354  returns a list of strings that only have unique values from a list of strings [''since r15323'']
     1355 parent_way_angle()::
     1356  returns the angle of the parent way as a double in rad [''since r18664''] (see: text-rotation or icon-rotation)
     1357 convert_primitive_to_string(''PrimitiveId'')::
     1358  returns the primitive id as a string [''since r18829'']
     1359 convert_primitives_to_string(''PrimitiveId'', ''PrimitiveId'', ''...'')::
     1360  returns a list of primitive ids converted to strings [''since r18829'']
     1361 parent_osm_primitives(''optional key'', ''optional value'')::
     1362  returns a list of primitive ids which match the key and value (if present) [''since r18829'']
    13421363
    13431364=== Examples ===