pointscape

Simplify point manipulation and interactions in your 2D projects with this versatile toolkit.Effortlessly calculate distances, areas, collision detection, and more with this collection of handy functions. ## How to use 1. Installation ```javascript npm install pointscape ``` 2. Usage ```javascript import pointscape from "pointscape"; ``` ## Examples ```javascript import { distance, triangle, center, inRange, chunk, randomBoolean } from "pointscape"; const distanceBetweenPoints = distance({x: 0, y: 0}, {x: 10, y: 10}); console.log(distanceBetweenPoints); // output: 14.142135623730951 const pointsForTriangle = triangle({x: 0, y: 0}, 10); console.log(pointsForTriangle); // output: [ { x: 0, y: 0 }, { x: -10, y: 0 }, { x: -5, y: 8.660254037844386 } ] const centralPoint = center( [{x:0, y: 0}, {x:0, y:10}, {x:10, y:10}, {x:10, y:0}] ); console.log(centralPoint); // output: { x: 5, y: 5 } const isInTheRange = inRange(1, 0, 10); console.log(isInTheRange); // output: true const chunks = chunk([1, 1, 1, 1], 2); console.log(chunks); // output: [[1, 1], [1, 1]] const randomBool = randomBoolean(); console.log(randomBool) // output: true or false ``` ## Functions #### Actions with points in XY coordinate system [distance](#distance) [area](#area) [collision](#collision) [collisionInArray](#collisioninarray) [positionInCircle](#positionincircle) [angle](#angle) [middle](#middle) [nearest](#nearest) [perimeter](#perimeter) [pointWithoutCollision](#pointwithoutcollision) [randomPoint](#randompoint) [randomPointInDistance](#randompointindistance) [randomPoints](#randompoints) [possibleConnections](#possibleconnections) [circleArea](#circlearea) [center](#center) [farest](#farest) [rotate](#rotate) [sort](#sort) [scale](#scale) [inLine](#inline) [cross](#cross) [move](#move) [square](#square) [rectangle](#rectangle) [pentagon](#pentagon) [triangle](#triangle) #### Math [degreesToRadians](#degreestodadians) [radiansToDegrees](#radianstodegrees) [inRange](#inrange) [roundToPrecision](#roundtoprecision) [average](#average) #### Arrays [intersection](#intersection) [difference](#difference) [chunk](#chunk) [removeDuplicate](#removeDuplicates) [sample](#sample) #### Randomization [randomNumber](#randomnumber) [randomBoolean](#randomboolean) [uniqueId](#uniqueid) ### Actions with points in XY coordinate system * distance ```typescript interface Point { x: number y: number } (point1: Point, point2: Point) => number ``` Returns the distance beetween two points, each point is an object with x and y properties. * area ```typescript (points: Point[]) => number ``` Returns the area enclosed by the given points. Takes an array of points as argument, where each point is an object with x and y properties. * collision ```typescript (point1: Point, point2: Point, collisionDistance: number, [callback]: Function) => boolean ``` Returns a boolean indicating if the two points are closer than the given distance. * collisionInArray ```typescript (point: Point, radius: number, points: Point[], [callback]: Function) => Point[] ``` Returns the points that are closer than the radius to the given point. * positionInCircle ```typescript (point: Point, radius: number, angleInRadians: number) => Point ``` Returns the x and y coordinates for the current point in the circle, given its center point, radius, and angle. * angle ```typescript (point1: Point, point2: Point) => number ``` Returns the angle formed by the connection of two points. * middle ```typescript (point1: Point, point2: Point) => Point ``` Returns the midpoint between two points. * nearest ```typescript (point: Point, points: Point[]) => Point ``` Returns the nearest point to the given point from the array. * perimeter ```typescript (points: Point[]) => number ``` Returns the perimeter of the figure formed by the given points. * pointWithoutCollision(minX, maxX, minY, maxY, distance, points) ```typescript interface Bounds { min: number max: number } (xBounds: Bounds, yBounds: Bounds, distance: number, points: Point[]) => Point | string ``` Returns a point that doesn't collide with any of the given points within the specified distance, if such a point exists, otherwise returns error string. * randomPoint ```typescript ([xBounds]: Bounds, [yBounds]: Bounds) => Point ``` Returns a random point within the given dimensions, if provided, otherwise in 100 units on both axes. * randomPointInDistance ```typescript (point: Point, distance: number) => Point ``` Returns a random point within the given distance from the specified point. * randomPoints ```typescript ([xBounds]: Bounds, [yBounds]: Bounds, quantity: number,) => Point[] ``` Returns a specified quantity of random points within the given dimensions, if dimensions are provided, otherwise in the range of 100. * possibleConnections ```typescript (pointsCount: number) => number ``` Returns the quantity of possible connections among given quantity of points. * circleArea ```typescript (radius): number => number ``` Returns the area of the circle. * center ```typescript (points: Point[]) => Point ``` Returns the center of given points. * farest ```typescript (point: Point, points: Point[]) => Point ``` Returns the farest point to the given point from the array. * rotate ```typescript (point: Point, points: Point[], angleInRadians: number) => Point[] ``` Returns the points rotated around the given point. * sort ```typescript (points: Point, [coordinate]: "x" | "y") => Point[] ``` Returns sorted array of the points.The coordinate parameter can be "x", "y", or none for sorting both for "x" and "y". * scale ```typescript (scaleFactorX: number, scaleFactorY: number, points: Point[]) => Point[] ``` Returns the scaled points. * inLine ```typescript interface Line { start: Point end: Point } (point: Point, line: Line) => boolean ``` Returns boolean value indicating whether or not the given coordinates are on line defined by two other points. * cross ```typescript (line1: Line, line2: Line) => boolean ``` Returns boolean value indicating if two lines each defined by two points intersect. * move ```typescript (point: Point, xStep: number, yStep: number, count: number) => Point[] ``` Returns an array of points representing a moving point over time. The number of elements in the array is equal to "count". Each element contains coordinates of the point. * square ```typescript (point: Point, size: number, [direction]: "left" | "right" | "down" | "up" ) => Point[] ``` Returns an array of points representing a shape of square.Takes four parameters: starting coordinates (x and y), size of square side, and direction which should be one of the values "left", "right", "up", "down". * rectangle(point, size, [direction]) ```typescript (point: Point, size: number, [direction]: "left" | "right" | "down" | "up" ) => Point[] ``` Returns an array of points representing a shape of rectangle.Takes same parameters as [square](#square) function. * triangle(point, size, [direction]) ```typescript (point: Point, size: number, [direction]: "left" | "right" | "down" | "up" ) => Point[] ``` Returns an array of points representing a shape of triangle.Takes same parameters as [square](#square) function. * pentagon(point, size, [direction]) ```typescript (point: Point, size: number, [direction]: "left" | "right" | "down" | "up" ) => Point[] ``` Returns an array of points representing a shape of pentagon.Takes four parameters: starting coordinates (x and y), size of pentagon side, and the angle of pentagon's rotation. ### Math * degreesToRadians ```typescript (degrees: number) => number ``` Converts degrees to radians. * radiansToDegrees ```typescript (radians: number) => number ``` Converts radians to degrees. * inRange ```typescript (number: number, min: number, max: number) => boolean ``` Returns true if the given number is within the specified range. * roundToPrecision) ```typescript (number: number, precision: -100 | -10 | 0 | 10 | 100 | number) => number ``` Rounds the number to the given precision. * average ```typescript (numbers: number[]) => number ``` Returns the average of all numbers in an array. ### Arrays * intersection( ```typescript (arr1: any[], arr2: any[]) => any[] ``` Returns the array of intersection of two arrays. * difference ```typescript (arr1: any[], arr2: any[]) => any[] ``` Returns the array of difference of two arrays. * chunk ```typescript (arr: any[], perArr: number) => any[][] ``` Returns an array splited into chunks based on elements count per chunk. * removeDuplicates(arr) ```typescript (arr: any[]) => any[] ``` Returns the array without duplicates. * sample ```typescript (arr: any[], [size]: number[]) => any[] ``` Returns a random sample from an array with optional size argument for sampling length. If not specified, it returns only one element. ### Randomization * randomNumber ```typescript (min: number, max: number) => number ``` Returns a random number within the given range. * randomBoolean ```typescript () => boolean ``` Returns a random boolean value. * uniqueId ```typescript ([other ids]: string[]) => string ``` Returns a unique ID that's different from the provided IDs, or a random ID if no other IDs are given.