setViewArea: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 7: Line 7:
|usage=
|usage=
<source lang="mtmacro" line>
<source lang="mtmacro" line>
setViewArea(startX,startY,endX,endY [,allPlayers])
setViewArea(startX, startY, endX, endY [, pixels [, allPlayers]])
</source>
</source>


Line 15: Line 15:
* {{code|endX}} - the x coordinate of the cell that will mark the lower right corner of the displayed area.
* {{code|endX}} - the x coordinate of the cell that will mark the lower right corner of the displayed area.
* {{code|endY}} - the x coordinate of the cell that will mark the lower right corner of the displayed area
* {{code|endY}} - the x coordinate of the cell that will mark the lower right corner of the displayed area
* {{code|pixels}} - an optional parameter that if set to true (1) means the coordinates are measured in pixels. If set to false (0) the coordinates are measured in map cells. Defaults to true (1).
* {{code|allPlayers}} - Optional: If set to true (1) and called from a trusted macro, all players views will be set. Defaults to 0
* {{code|allPlayers}} - Optional: If set to true (1) and called from a trusted macro, all players views will be set. Defaults to 0



Revision as of 17:21, 6 May 2015

setViewArea() Function

Introduced in version 1.4
Sets the currently viewed screen area, set by two cell coordinates, so that the two cells are at the edge of the screen. If the map is "gridless", the coordinates will be pixel coordinates. A final optional parameter causes the view of any connected players to be set the same. Only GMs or trusted macros can trigger the view of all players to change.

Usage

setViewArea(startX, startY, endX, endY [, pixels [, allPlayers]])

Parameters

  • startX - the x coordinate of the cell that will mark the upper left corner of the displayed area.
  • startY - the y coordinate of the cell that will mark the upper left corner of the displayed area.
  • endX - the x coordinate of the cell that will mark the lower right corner of the displayed area.
  • endY - the x coordinate of the cell that will mark the lower right corner of the displayed area
  • pixels - an optional parameter that if set to true (1) means the coordinates are measured in pixels. If set to false (0) the coordinates are measured in map cells. Defaults to true (1).
  • allPlayers - Optional: If set to true (1) and called from a trusted macro, all players views will be set. Defaults to 0

Examples

Set the viewport of the current client such that it at least sees the corners of the area with the following coordinates:
[h:setViewArea(0,0,30,20)]

When the GM runs the macro change the viewport on ALL clients, else only on the current client:

[h:setViewArea(0,0,30,20,isGM())]

See Also