SetPlayerZoomByViewRange

Kategorie: Spieler / Sicht
Ab Engineversion: 1.0 OC

Beschreibung

Adjusts the zoom or zoom limit of all viewports of a player.

Syntax

bool SetPlayerZoomByViewRange(int player, int range_x, int range_y, int flags);

Parameter

player:
Spieler, dessen Zoom oder Zoomgrenzen angepasst werden sollen. NO_OWNER für alle Spieler.
range_x:
Horizontale Entfernung die vom Zoom abgedeckt wird. Null um nur range_y zu benutzen. Falls range_x und range_y null sind, wird eine vorgegebene Entfernung für range_x angenommen.
range_y:
Vertikale Entfernung die vom Zoom abgedeckt wird. Null um nur range_x zu benutzen. Falls range_x und range_y ungleich null sind, wird die Zahl genutzt die den kleineren Zoom.
flags:
Es sind folgende Kommandos definiert:
Wert Beschreibung
PLRZOOM_Direct Der Zoom scrollt nicht sanft zum neuen Wert, sondern wird direkt gesetzt.
PLRZOOM_NoIncrease Die neuen Zoomwerte sollen nur gesetzt werden, wenn sie kleiner als die aktuellen Werte sind.
PLRZOOM_NoDecrease Die neuen Zoomwerte sollen nur gesetzt werden, wenn sie größer als die aktuellen Werte sind.
PLRZOOM_LimitMin Setzt das minimale Grenze für den Zoom. Der Spieler kann nicht weiter herauszoomen als dieser Wert.
PLRZOOM_LimitMax Setzt das maximale Grenze für den Zoom. Der Spieler kann nicht weiter hineinzoomen als dieser Wert.
PLRZOOM_Set Set the current zoom. This flag is implied if neither PLRZOOM_LimitMin nor PLRZOOM_LimitMax is supplied but can be used if current zoom and limits should be set simultanuously.

Beispiel

func InitializePlayer(int plr)
{
  SetPlayerZoomByViewRange(plr, 1000, 0, PLRZOOM_LimitMin);
  SetPlayerZoomByViewRange(plr, 1000, 0, PLRZOOM_LimitMax);
  SetPlayerViewLock(plr, true);
  return true;
}
Code für ein Szenarioscript: Spieler sehen genau 1000 Pixel weit um ihren Clonk und können nicht weiterscrollen.
Siehe auch: GetPlayerZoomLimits, SetFoW, SetLightRange, SetPlayerViewLock, SetPlayerZoom, SetPlrView
Sven2, 2010-09