Group actions

Introduction

Set properties of game objects, built-in methods of phaser.

• Author: Richard Davey

Usage

Call function

Phaser.Actions.Call(gameObjects, function(gameObject) {

}, scope);

Set any property

Phaser.Actions.PropertyValueSet(gameObjects, key, value, step, index, direction);

• gameObjects : An array of game objects.
• key : The property to be updated.
• value : The amount to be added to the property.
• step : This is added to the value amount, multiplied by the iteration counter.
• index : An optional offset to start searching from within the items array.
• direction :
  • 1 : from beginning to end.
  • -1: from end to beginning.

Phaser.Actions.PropertyValueInc(gameObjects, key, value, step, index, direction);

Phaser.Actions.SmootherStep(gameObjects, key, min, max, inc));

Phaser.Actions.SmoothStep(gameObjects, key, min, max, inc));

Phaser.Actions.Spread(gameObjects, key, min, max, inc));

Position

Phaser.Actions.SetX(gameObjects, value, step, index, direction);

Phaser.Actions.IncX(gameObjects, value, step, index, direction);

Phaser.Actions.SetY(gameObjects, value, step, index, direction);

Phaser.Actions.IncY(gameObjects, value, step, index, direction);

Phaser.Actions.SetXY(gameObjects, x, y, stepX, stepY, index, direction);

Phaser.Actions.IncXY(gameObjects, x, y, stepX, stepY, index, direction);

Shift position

Set the position of first game object to (x, y), others to the position of previous game object.

Phaser.Actions.ShiftPosition(gameObjects, x, y, direction, output);

Position on shape

Grid align

Phaser.Actions.GridAlign(gameObjects, {
    width: -1,
    height: -1,
    cellWidth: 1,
    cellHeight: 1,
    position: Phaser.Display.Align.TOP_LEFT,
    x: 0,
    y: 0
});

• width : The width of the grid in items (not pixels). -1 means lay all items out horizontally, regardless of quantity.
• height : The height of the grid in items (not pixels). -1 means lay all items out vertically, regardless of quantity.
• cellWidth : The width of the cell, in pixels.
• cellHeight : The height of the cell, in pixels.
• position : The alignment position.
  • 0, or Phaser.Display.Align.TOP_LEFT
  • 1, or Phaser.Display.Align.TOP_CENTER
  • 2, or Phaser.Display.Align.TOP_RIGHT
  • 3, or Phaser.Display.Align.LEFT_TOP
  • 4, or Phaser.Display.Align.LEFT_CENTER
  • 5, or Phaser.Display.Align.LEFT_BOTTOM
  • 6, or Phaser.Display.Align.CENTER
  • 7, or Phaser.Display.Align.RIGHT_TOP
  • 8, or Phaser.Display.Align.RIGHT_CENTER
  • 9, or Phaser.Display.Align.RIGHT_BOTTOM
  • 10, or Phaser.Display.Align.BOTTOM_LEFT
  • 11, or Phaser.Display.Align.BOTTOM_CENTER
  • 12, or Phaser.Display.Align.BOTTOM_RIGHT
• x, y : Position of first item.

Line

Line :

var line = new Phaser.Geom.Line(x1, y1, x2, y2);

Phaser.Actions.PlaceOnLine(gameObjects, line);
// Phaser.Actions.PlaceOnLine(gameObjects, line, ease);

• ease :
  • A string
  • A function object.

Phaser.Actions.RandomLine(gameObjects, line);

Circle

Circle :

var circle = new Phaser.Geom.Circle(x, y, radius);
Phaser.Actions.PlaceOnCircle(gameObjects, circle, startAngle, endAngle);

Phaser.Actions.RandomCircle(gameObjects, circle);

Ellipse

Ellipse :

var ellipse = new Phaser.Geom.Ellipse(x, y, width, height);
Phaser.Actions.PlaceOnEllipse(gameObjects, ellipse, startAngle, endAngle);

Triangle

Triangle :

var triangle = new Phaser.Geom.Triangle(x1, y1, x2, y2, x3, y3);
Phaser.Actions.PlaceOnTriangle(gameObjects, triangle, stepRate);

Phaser.Actions.RandomTriangle(gameObjects, triangle);

Rectangle

Rectangle :

var rect = new Phaser.Geom.Rectangle(x, y, width, height);
Phaser.Actions.PlaceOnRectangle(gameObjects, rect, shift;

Phaser.Actions.RandomRectangle(gameObjects, rect);

Phaser.Actions.WrapInRectangle(gameObjects, rect, padding);

Angle

Phaser.Actions.Angle(gameObjects, value, step, index, direction);
// value: angle in radians

Phaser.Actions.Rotate(gameObjects, value, step, index, direction);
// value: angle in degree

Phaser.Actions.RotateAround(gameObjects, point, angle);
// point: {x, y}, angle: angle in radians

Phaser.Actions.RotateAroundDistance(gameObjects, point, angle, distance);
// point: {x, y}, angle: angle in radians

Visible

Phaser.Actions.SetVisible(gameObjects, value, index, direction);

Phaser.Actions.ToggleVisible(gameObjects);

Alpha

Phaser.Actions.SetAlpha(gameObjects, value, step, index, direction);

Tint

Phaser.Actions.setTint(gameObjects, value);
//Phaser.Actions.setTint(gameObjects, topLeft, topRight, bottomLeft, bottomRight);

Origin

Phaser.Actions.SetOrigin(gameObjects, originX, originY, stepX, stepY, index, direction);

Scale

Phaser.Actions.ScaleX(gameObjects, value, step, index, direction);

Phaser.Actions.ScaleY(gameObjects, value, step, index, direction);

Phaser.Actions.ScaleXY(gameObjects, x, y, stepX, stepY, index, direction);

Scroll factor

Phaser.Actions.SetScrollFactorX(gameObjects, value, step, index, direction);

Phaser.Actions.SetScrollFactorY(gameObjects, value, step, index, direction);

Phaser.Actions.SetScrollFactor(gameObjects, x, y, stepX, stepY, index, direction);

Depth

Phaser.Actions.SetDepth(gameObjects, value, step, index, direction);

Hit area

Phaser.Actions.SetHitArea(gameObjects, hitArea, hitAreaCallback);

Blend mode

Phaser.Actions.SetBlendMode(gameObjects, blendMode, index, direction);

• blendMode : Blend mode

Play animation

Phaser.Actions.PlayAnimation(gameObjects, key, ignoreIfPlaying);

Shuffle

Phaser.Actions.Shuffle(gameObjects);