phaser - v4.0.0-rc.4
    Preparing search index...

    A triangle is a plane created by connecting three points. The first two arguments specify the first point, the middle two arguments specify the second point, and the last two arguments specify the third point.

    Index

    Constructors

    • Parameters

      • Optionalx1: number

        x coordinate of the first point. Default 0.

      • Optionaly1: number

        y coordinate of the first point. Default 0.

      • Optionalx2: number

        x coordinate of the second point. Default 0.

      • Optionaly2: number

        y coordinate of the second point. Default 0.

      • Optionalx3: number

        x coordinate of the third point. Default 0.

      • Optionaly3: number

        y coordinate of the third point. Default 0.

      Returns Geom.Triangle

    Properties

    bottom: number

    Bottom most Y coordinate of the triangle. Setting it moves the triangle on the Y axis accordingly.

    left: number

    Left most X coordinate of the triangle. Setting it moves the triangle on the X axis accordingly.

    right: number

    Right most X coordinate of the triangle. Setting it moves the triangle on the X axis accordingly.

    top: number

    Top most Y coordinate of the triangle. Setting it moves the triangle on the Y axis accordingly.

    type: number

    The geometry constant type of this object: GEOM_CONST.TRIANGLE. Used for fast type comparisons.

    x1: number

    x coordinate of the first point.

    x2: number

    x coordinate of the second point.

    x3: number

    x coordinate of the third point.

    y1: number

    y coordinate of the first point.

    y2: number

    y coordinate of the second point.

    y3: number

    y coordinate of the third point.

    Methods

    • Checks whether a given points lies within the triangle.

      Parameters

      • x: number

        The x coordinate of the point to check.

      • y: number

        The y coordinate of the point to check.

      Returns boolean

    • Returns a Line object that corresponds to Line A of this Triangle.

      Type Parameters

      Parameters

      • Optionalline: O

        A Line object to set the results in. If undefined a new Line will be created.

      Returns O

    • Returns a Line object that corresponds to Line B of this Triangle.

      Type Parameters

      Parameters

      • Optionalline: O

        A Line object to set the results in. If undefined a new Line will be created.

      Returns O

    • Returns a Line object that corresponds to Line C of this Triangle.

      Type Parameters

      Parameters

      • Optionalline: O

        A Line object to set the results in. If undefined a new Line will be created.

      Returns O

    • Returns a specific point on the triangle.

      Type Parameters

      Parameters

      • position: number

        Position as float within 0 and 1. 0 equals the first point.

      • Optionaloutput: O

        Optional Vector2 point that the calculated point will be written to.

      Returns O

    • Calculates a list of evenly distributed points on the triangle. It is either possible to pass an amount of points to be generated (quantity) or the distance between two points (stepRate).

      Type Parameters

      Parameters

      • quantity: number

        Number of points to be generated. Can be falsey when stepRate should be used. All points have the same distance along the triangle.

      • OptionalstepRate: number

        Distance between two points. Will only be used when quantity is falsey.

      • Optionaloutput: O

        Optional array of Vector2 points for writing the calculated points into. Otherwise a new array will be created.

      Returns O

    • Sets all three points of the triangle. Leaving out any coordinate sets it to be 0.

      Parameters

      • Optionalx1: number

        x coordinate of the first point. Default 0.

      • Optionaly1: number

        y coordinate of the first point. Default 0.

      • Optionalx2: number

        x coordinate of the second point. Default 0.

      • Optionaly2: number

        y coordinate of the second point. Default 0.

      • Optionalx3: number

        x coordinate of the third point. Default 0.

      • Optionaly3: number

        y coordinate of the third point. Default 0.

      Returns this

    • Builds an equilateral triangle. In the equilateral triangle, all the sides are the same length (congruent) and all the angles are the same size (congruent). The x/y specifies the top-middle of the triangle (x1/y1) and length is the length of each side.

      Parameters

      • x: number

        x coordinate of the top point of the triangle.

      • y: number

        y coordinate of the top point of the triangle.

      • length: number

        Length of each side of the triangle.

      Returns Geom.Triangle

    • Takes an array of vertex coordinates, and optionally an array of hole indices, then returns an array of Triangle instances, where the given vertices have been decomposed into a series of triangles.

      Type Parameters

      Parameters

      • data: any[]

        A flat array of vertex coordinates like [x0,y0, x1,y1, x2,y2, ...]

      • Optionalholes: any[]

        An array of hole indices if any (e.g. [5, 8] for a 12-vertex input would mean one hole with vertices 5–7 and another with 8–11). Default null.

      • OptionalscaleX: number

        Horizontal scale factor to multiply the resulting points by. Default 1.

      • OptionalscaleY: number

        Vertical scale factor to multiply the resulting points by. Default 1.

      • Optionalout: O

        An array to store the resulting Triangle instances in. If not provided, a new array is created.

      Returns O

    • Builds a right triangle, i.e. one which has a 90-degree angle and two acute angles.

      Parameters

      • x: number

        The X coordinate of the right angle, which will also be the first X coordinate of the constructed Triangle.

      • y: number

        The Y coordinate of the right angle, which will also be the first Y coordinate of the constructed Triangle.

      • width: number

        The length of the side which is to the left or to the right of the right angle.

      • height: number

        The length of the side which is above or below the right angle.

      Returns Geom.Triangle

    • Positions the Triangle so that it is centered on the given coordinates.

      Type Parameters

      Parameters

      • triangle: O

        The triangle to be positioned.

      • x: number

        The horizontal coordinate to center on.

      • y: number

        The vertical coordinate to center on.

      • OptionalcenterFunc: CenterFunction

        The function used to center the triangle. Defaults to Centroid centering.

      Returns O

    • Calculates the position of a Triangle's centroid, which is also its center of mass (center of gravity).

      The centroid is the point in a Triangle at which its three medians (the lines drawn from the vertices to the bisectors of the opposite sides) meet. It divides each one in a 2:1 ratio.

      Type Parameters

      Parameters

      • triangle: Geom.Triangle

        The Triangle to use.

      • Optionalout: O

        A Vector2 object to store the coordinates in.

      Returns O

    • Computes the circumcentre of a triangle. The circumcentre is the centre of the circumcircle, the smallest circle which encloses the triangle. It is also the common intersection point of the perpendicular bisectors of the sides of the triangle, and is the only point which has equal distance to all three vertices of the triangle.

      Adapted from http://bjornharrtell.github.io/jsts/doc/api/jsts_geom_Triangle.js.html

      Type Parameters

      Parameters

      • triangle: Geom.Triangle

        The Triangle to get the circumcenter of.

      • Optionalout: O

        The Vector2 object to store the position in. If not given, a new Vector2 instance is created.

      Returns O

    • Checks if a point (as a pair of coordinates) is inside a Triangle's bounds.

      Parameters

      • triangle: Geom.Triangle

        The Triangle to check.

      • x: number

        The X coordinate of the point to check.

      • y: number

        The Y coordinate of the point to check.

      Returns boolean

    • Filters an array of point-like objects to only those contained within a triangle.

      If returnFirst is true, will return an array containing only the first point in the provided array that is within the triangle (or an empty array if there are no such points).

      Parameters

      • triangle: Geom.Triangle

        The triangle that the points are being checked in.

      • points: Math.Vector2[]

        An array of Vector2 objects to check if they are within the triangle.

      • OptionalreturnFirst: boolean

        If true, return an array containing only the first point found that is within the triangle. Default false.

      • Optionalout: any[]

        If provided, the points that are within the triangle will be appended to this array instead of being added to a new array. If returnFirst is true, only the first point found within the triangle will be appended. This array will also be returned by this function.

      Returns Math.Vector2[]

    • Decomposes a Triangle into an array of its points.

      Parameters

      • triangle: Geom.Triangle

        The Triangle to decompose.

      • Optionalout: any[]

        An array to store the points into.

      Returns any[]

    • Returns a Vector2 point from around the perimeter of a Triangle.

      Type Parameters

      Parameters

      • triangle: Geom.Triangle

        The Triangle to get the point on its perimeter from.

      • position: number

        The position along the perimeter of the triangle. A value between 0 and 1.

      • Optionalout: O

        An optional Vector2 point to store the value in. If not given a new Vector2 will be created.

      Returns O

    • Returns an array of evenly spaced points on the perimeter of a Triangle.

      Type Parameters

      Parameters

      • triangle: Geom.Triangle

        The Triangle to get the points from.

      • quantity: number

        The number of evenly spaced points to return. Set to 0 to return an arbitrary number of points based on the stepRate.

      • stepRate: number

        If quantity is 0, the distance between each returned point.

      • Optionalout: O

        An array to which the points should be appended.

      Returns O

    • Calculates the position of the incenter of a Triangle object. This is the point where its three angle bisectors meet and it's also the center of the incircle, which is the circle inscribed in the triangle.

      Type Parameters

      Parameters

      • triangle: Geom.Triangle

        The Triangle to find the incenter of.

      • Optionalout: O

        An optional Vector2 point in which to store the coordinates.

      Returns O

    • Moves each point (vertex) of a Triangle by a given offset, thus moving the entire Triangle by that offset.

      Type Parameters

      Parameters

      • triangle: O

        The Triangle to move.

      • x: number

        The horizontal offset (distance) by which to move each point. Can be positive or negative.

      • y: number

        The vertical offset (distance) by which to move each point. Can be positive or negative.

      Returns O

    • Gets the length of the perimeter of the given triangle. Calculated by adding together the length of each of the three sides.

      Parameters

      • triangle: Geom.Triangle

        The Triangle to get the length from.

      Returns number

    • Returns a random Point from within the area of the given Triangle.

      Type Parameters

      Parameters

      • triangle: Geom.Triangle

        The Triangle to get a random point from.

      • Optionalout: O

        The Vector2 point object to store the position in. If not given, a new Vector2 instance is created.

      Returns O

    • Rotates a Triangle about its incenter, which is the point at which its three angle bisectors meet.

      Type Parameters

      Parameters

      • triangle: O

        The Triangle to rotate.

      • angle: number

        The angle by which to rotate the Triangle, in radians.

      Returns O

    • Rotates a Triangle at a certain angle about a given Vector2 point.

      Type Parameters

      Parameters

      • triangle: O

        The Triangle to rotate.

      • point: Math.Vector2

        The Vector2 point to rotate the Triangle around.

      • angle: number

        The angle by which to rotate the Triangle, in radians.

      Returns O

    • Rotates an entire Triangle at a given angle about a specific point.

      Type Parameters

      Parameters

      • triangle: O

        The Triangle to rotate.

      • x: number

        The X coordinate of the point to rotate the Triangle about.

      • y: number

        The Y coordinate of the point to rotate the Triangle about.

      • angle: number

        The angle by which to rotate the Triangle, in radians.

      Returns O