exposePCOnlyArea: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
m (Conversion script moved page exposePCOnlyArea to ExposePCOnlyArea without leaving a redirect: Converting page title to first-letter uppercase)
m (Text replacement - "source>" to "syntaxhighlight>")
 
(3 intermediate revisions by 2 users not shown)
Line 8: Line 8:
This function is often used in combination with the [[onTokenMove]] event.
This function is often used in combination with the [[onTokenMove]] event.
| usage=
| usage=
<source lang="mtmacro">
<syntaxhighlight lang="mtmacro">
exposePCOnlyArea()
exposePCOnlyArea()
exposePCOnlyArea(mapname)
exposePCOnlyArea(mapRef)
</source>
</syntaxhighlight>


'''Parameters'''
'''Parameters'''
{{param|mapname|Optional map name }}
{{param|mapRef|Optional.  Name or ID of the map. }}


|example=
|example=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
<!-- Expose areas that can be seen by PC tokens on current map. -->
<!-- Expose areas that can be seen by PC tokens on current map. -->
[h: exposePCOnlyArea()]
[h: exposePCOnlyArea()]
<!-- Expose areas that can be seen by PC tokens on named map. -->
<!-- Expose areas that can be seen by PC tokens on named map. -->
[h: exposePCOnlyArea("Cliffs of Insanity")]
[h: exposePCOnlyArea("Cliffs of Insanity")]
</source>
</syntaxhighlight>


}}
}}
[[Category:Miscellaneous Function]]
[[Category:Miscellaneous Function]]
[[Category:FoW]]
[[Category:FoW]]

Latest revision as of 23:59, 14 March 2023

exposePCOnlyArea() Function

 Note: This function can only be used in a Trusted Macro

Introduced in version 1.3b76
Clears Fog of War (FOW) where PC tokens can see and establishes/restores FOW everywhere they cannot. This works the same as the hotkey Meta-Shift-O. Note that the keystroke may be different for locales other than U.S. English. This function is often used in combination with the onTokenMove event.

Usage

exposePCOnlyArea()
exposePCOnlyArea(mapRef)

Parameters

  • mapRef - Optional. Name or ID of the map.

Example

<!-- Expose areas that can be seen by PC tokens on current map. -->
[h: exposePCOnlyArea()]
<!-- Expose areas that can be seen by PC tokens on named map. -->
[h: exposePCOnlyArea("Cliffs of Insanity")]