getViewCenter: Difference between revisions
Jump to navigation
Jump to search
(Created page with "{{MacroFunction |name= getViewCenter |version=1.5.4 |description= Returns the limits of the visible area of the map window, given in either pixels or cell coordinates dependin...") |
No edit summary |
||
| Line 3: | Line 3: | ||
|version=1.5.4 | |version=1.5.4 | ||
|description= | |description= | ||
Returns the limits of the visible area of the map window, given in either pixels or cell coordinates depending on the first parameter. The result is in a ";" delimited String as default or can be configured by setting the delimiter or using JSON. | Returns the limits of the visible area of the map window, given in either map pixels or cell coordinates depending on the first parameter. The result is in a ";" delimited String as default or can be configured by setting the delimiter or using JSON. | ||
|usage= | |usage= | ||
| Line 13: | Line 13: | ||
'''Parameters''' | '''Parameters''' | ||
* {{code|pixels}} - if set to true (1) means the returned coordinates are measured in pixels. If set to false (0) the returned coordinates are measured in map cells. Defaults to {{code|true}}. | * {{code|pixels}} - if set to true (1) means the returned coordinates are measured in map pixels. If set to false (0) the returned coordinates are measured in map cells. Defaults to {{code|true}}. | ||
* {{code|delim}} - if set to "json" means the returned coordinates are defined in JSON style. Otherwise a String property list is returning using {{code|delim}} as a delimiter. Defaults to {{code|;}}. | * {{code|delim}} - if set to "json" means the returned coordinates are defined in JSON style. Otherwise a String property list is returning using {{code|delim}} as a delimiter. Defaults to {{code|;}}. | ||
Revision as of 13:52, 21 September 2019
getViewCenter() Function
• Introduced in version 1.5.4
Returns the limits of the visible area of the map window, given in either map pixels or cell coordinates depending on the first parameter. The result is in a ";" delimited String as default or can be configured by setting the delimiter or using JSON.
Usage
getViewCenter()
getViewCenter(pixels)
getViewCenter(pixels, delim)Parameters
pixels- if set to true (1) means the returned coordinates are measured in map pixels. If set to false (0) the returned coordinates are measured in map cells. Defaults totrue.delim- if set to "json" means the returned coordinates are defined in JSON style. Otherwise a String property list is returning usingdelimas a delimiter. Defaults to;.
Examples
Get the viewport dimensions of the current client:
[r: getViewCenter()] <!-- Default pixels -->
[r: getViewCenter(0)] <!-- in Grid Cells -->
[r: getViewCenter(1)] <!-- in Pixels -->
[r: getViewCenter(0, "json")] <!-- Cells as JSON -->
[r: getViewCenter(1, "json")] <!-- Pixels as JSON -->
[r: getViewCenter(0, ",")] <!-- Cells as "," separated String properties: -->
[r: getViewCenter(1, ";")] <!-- Pixels as ";" separated String properties: -->Output:
centerX=646; centerY=319;
centerX=14; centerY=7;
centerX=646; centerY=319;
{"centerX":14,"centerY":7}
{"centerX":646,"centerY":319}
centerX=14, centerY=7;
centerX=646; centerY=319,