FEATURE: Map Name & Visibility Functions

Developer discussion regarding MapTool 1.4

Moderators: dorpond, trevor, Azhrei

Forum rules
Posting now open to all registered forum users.
Post Reply
User avatar
Jagged
Great Wyrm
Posts: 1306
Joined: Mon Sep 15, 2008 9:27 am
Location: Bristol, UK

FEATURE: Map Name & Visibility Functions

Post by Jagged »

The following changes and functions have recently been submitted.

Bugfix
It is possible and acceptable to move players to a hidden map through the use of script functions. However when you do so, the players see the message "Map not visible to players". This message will now only display to the GM.

Bugfix
When you edit the current map and change the map name or use the rename ui to change the map name, the change does not get updated on the Maptool window frame unless you change maps. This will now update immediately the name is changed.

getMapVisible() function
Returns true (1) or false(0) indicating whether the specified map is visible to players. If no map is specified the current map is selected.
Usage:

Code: Select all

getMapVisible()
getMapVisible(mapName)


Examples:

Code: Select all

[r:getMapVisible()]
[r:getMapVisible("Grasslands")]


setMapVisible() function
Sets a maps visibility to players to true (1) or false(0). If no map is specified the current map is selected. May only be used by a trusted macro.
Usage:

Code: Select all

setMapVisible(visible)
setMapVisible(mapName)


Examples:

Code: Select all

[r:setMapVisible(1)]
[r:setMapVisible(1, "Grasslands")]


setMapName() function
Changes the name of a specified map. May only be used by a trusted macro.
Usage:

Code: Select all

setMapName(oldMapName, newMapName)

oldMapName is the current name of the map you wish to rename.
newMapName is the name to which you want it changed.

Examples:

Code: Select all

[r:setMapName("Grasslands","Map1")]

User avatar
Jagged
Great Wyrm
Posts: 1306
Joined: Mon Sep 15, 2008 9:27 am
Location: Bristol, UK

Re: FEATURE: Map Name & Visibility Functions

Post by Jagged »

copyMap() function
Function creates a copy of an specified map, with the new map name. Returns the name of the new map. May only be used by a trusted macro.
Usage:

Code: Select all

copyMap(originalMapName, newMapName)


Examples:

Code: Select all

[h:copyMap("BaseMap","Tower")]
[h:setMapVisible(1,"Tower")]


User avatar
Jagged
Great Wyrm
Posts: 1306
Joined: Mon Sep 15, 2008 9:27 am
Location: Bristol, UK

Re: FEATURE: Map Name & Visibility Functions

Post by Jagged »

I will add this to the wiki next week :mrgreen:

User avatar
RPTroll
TheBard
Posts: 3148
Joined: Tue Mar 21, 2006 7:26 pm
Location: Austin, Tx
Contact:

Re: FEATURE: Map Name & Visibility Functions

Post by RPTroll »

Great stuff!
ImageImage ImageImageImageImage
Support RPTools by shopping
Image
Image

User avatar
Jagged
Great Wyrm
Posts: 1306
Joined: Mon Sep 15, 2008 9:27 am
Location: Bristol, UK

Re: FEATURE: Map Name & Visibility Functions

Post by Jagged »

Wiki should now be up to date

User avatar
RPTroll
TheBard
Posts: 3148
Joined: Tue Mar 21, 2006 7:26 pm
Location: Austin, Tx
Contact:

Re: FEATURE: Map Name & Visibility Functions

Post by RPTroll »

Sweet. Again, thanks for all the effort.
ImageImage ImageImageImageImage
Support RPTools by shopping
Image
Image

User avatar
Full Bleed
Demigod
Posts: 4536
Joined: Sun Feb 25, 2007 11:53 am
Location: MD
Contact:

Re: FEATURE: Map Name & Visibility Functions

Post by Full Bleed »

Jagged wrote:Wiki should now be up to date

Thanks.

You might want to wfunc your nice syntax posts so they link to it.
Maptool is the Millennium Falcon of VTT's -- "She may not look like much, but she's got it where it counts."

Post Reply

Return to “MapTool 1.4”