https://github.com/lloydevans/vec2-fn
A type-safe set of functions for working with vec2-like objects and arrays.
https://github.com/lloydevans/vec2-fn
Last synced: about 2 months ago
JSON representation
A type-safe set of functions for working with vec2-like objects and arrays.
- Host: GitHub
- URL: https://github.com/lloydevans/vec2-fn
- Owner: lloydevans
- License: mit
- Created: 2021-05-10T19:33:36.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2021-07-24T13:25:13.000Z (almost 5 years ago)
- Last Synced: 2025-11-14T14:13:09.516Z (7 months ago)
- Language: TypeScript
- Homepage:
- Size: 1.09 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# vec2-fn
[
](LINK)
[
](LINK)
### What's this?
This is a small JS library containing some utility functions for working with vector 2 (like) objects an arrays. The functions are sometimes not pure in the sense that they will modify the vector you provide to them. This allows the reuse of vector object instances and compatibility between different vector class types.
### Install
```bash
npm i -S vec2-fn
```
### API Docs
API docs can be found [here](https://lloydevans.github.io/vec2-fn/)
### ES usage:
```ts
// Import star
import * as vec2 from "vec2-fn";
vec2.equal({ x: 0, y: 0 }, vec2.ZERO);
// Import named
import { equal, ZERO } from "vec2-fn";
equal({ x: 0, y: 0 }, ZERO);
```
### Node usage:
```js
// Import all
const vec2 = require("vec2-fn");
vec2.equal({ x: 0, y: 0 }, vec2.ZERO);
// Assign named
const { equal, ZERO } = require("vec2-fn");
equal({ x: 0, y: 0 }, ZERO);
```
### Static usage:
Old school method
```html
vec2.equal({ x: 0, y: 0 }, vec2.ZERO);
```
For static usage, ambient type definitions can optionally be referenced here `node_modules/vec2-fn/bin/vec2.d.ts`.
## Table of contents
### Interfaces
- [Vec2](https://github.com/lloydevans/vec2-fn/blob/main/docs/md/interfaces/vec2.md)
### Type aliases
- [Vec2Array](https://lloydevans.github.io/vec2-fn/modules.html#vec2array)
- [Vec2Param](https://lloydevans.github.io/vec2-fn/modules.html#vec2param)
- [Vec2Readonly](https://lloydevans.github.io/vec2-fn/modules.html#vec2readonly)
### Variables
- [APPROX\_THRESHOLD](https://lloydevans.github.io/vec2-fn/modules.html#approx_threshold)
- [MINUS\_ONE](https://lloydevans.github.io/vec2-fn/modules.html#minus_one)
- [ONE](https://lloydevans.github.io/vec2-fn/modules.html#one)
- [PRECISION](https://lloydevans.github.io/vec2-fn/modules.html#precision)
- [VEC2\_DOWN](https://lloydevans.github.io/vec2-fn/modules.html#vec2_down)
- [VEC2\_DOWN\_LEFT](https://lloydevans.github.io/vec2-fn/modules.html#vec2_down_left)
- [VEC2\_DOWN\_RIGHT](https://lloydevans.github.io/vec2-fn/modules.html#vec2_down_right)
- [VEC2\_LEFT](https://lloydevans.github.io/vec2-fn/modules.html#vec2_left)
- [VEC2\_RIGHT](https://lloydevans.github.io/vec2-fn/modules.html#vec2_right)
- [VEC2\_UP](https://lloydevans.github.io/vec2-fn/modules.html#vec2_up)
- [VEC2\_UP\_LEFT](https://lloydevans.github.io/vec2-fn/modules.html#vec2_up_left)
- [VEC2\_UP\_RIGHT](https://lloydevans.github.io/vec2-fn/modules.html#vec2_up_right)
- [ZERO](https://lloydevans.github.io/vec2-fn/modules.html#zero)
### Functions
- [abs](https://lloydevans.github.io/vec2-fn/modules.html#abs)
- [add](https://lloydevans.github.io/vec2-fn/modules.html#add)
- [angleTo](https://lloydevans.github.io/vec2-fn/modules.html#angleto)
- [approx](https://lloydevans.github.io/vec2-fn/modules.html#approx)
- [ceil](https://lloydevans.github.io/vec2-fn/modules.html#ceil)
- [clamp](https://lloydevans.github.io/vec2-fn/modules.html#clamp)
- [copy](https://lloydevans.github.io/vec2-fn/modules.html#copy)
- [distance](https://lloydevans.github.io/vec2-fn/modules.html#distance)
- [distanceSq](https://lloydevans.github.io/vec2-fn/modules.html#distancesq)
- [divide](https://lloydevans.github.io/vec2-fn/modules.html#divide)
- [dot](https://lloydevans.github.io/vec2-fn/modules.html#dot)
- [dotPerp](https://lloydevans.github.io/vec2-fn/modules.html#dotperp)
- [equal](https://lloydevans.github.io/vec2-fn/modules.html#equal)
- [floor](https://lloydevans.github.io/vec2-fn/modules.html#floor)
- [isOne](https://lloydevans.github.io/vec2-fn/modules.html#isone)
- [isVec2LikeArray](https://lloydevans.github.io/vec2-fn/modules.html#isvec2likearray)
- [isVec2LikeObject](https://lloydevans.github.io/vec2-fn/modules.html#isvec2likeobject)
- [isZero](https://lloydevans.github.io/vec2-fn/modules.html#iszero)
- [length](https://lloydevans.github.io/vec2-fn/modules.html#length)
- [lengthSq](https://lloydevans.github.io/vec2-fn/modules.html#lengthsq)
- [lerp](https://lloydevans.github.io/vec2-fn/modules.html#lerp)
- [max](https://lloydevans.github.io/vec2-fn/modules.html#max)
- [min](https://lloydevans.github.io/vec2-fn/modules.html#min)
- [multiply](https://lloydevans.github.io/vec2-fn/modules.html#multiply)
- [negate](https://lloydevans.github.io/vec2-fn/modules.html#negate)
- [normalize](https://lloydevans.github.io/vec2-fn/modules.html#normalize)
- [rotate](https://lloydevans.github.io/vec2-fn/modules.html#rotate)
- [round](https://lloydevans.github.io/vec2-fn/modules.html#round)
- [subtract](https://lloydevans.github.io/vec2-fn/modules.html#subtract)
- [toArray](https://lloydevans.github.io/vec2-fn/modules.html#toarray)
- [toObject](https://lloydevans.github.io/vec2-fn/modules.html#toobject)
- [zero](https://lloydevans.github.io/vec2-fn/modules.html#zero)
## Type aliases
### Vec2Array
Ƭ **Vec2Array**: T
Vec2-like array object.
#### Type parameters
| Name | Type | Default |
| :------ | :------ | :------ |
| `T` | *number*[] | [*number*, *number*] |
Defined in: types/vec2-array.ts:2
___
### Vec2Param
Ƭ **Vec2Param**: [*Vec2*](https://github.com/lloydevans/vec2-fn/blob/main/docs/md/interfaces/vec2.md) \| [*Vec2Array*](https://lloydevans.github.io/vec2-fn/modules.html#vec2array)
A Vec2 array or object.
Defined in: types/vec2-param.ts:5
___
### Vec2Readonly
Ƭ **Vec2Readonly**: *Readonly*<[*Vec2*](https://github.com/lloydevans/vec2-fn/blob/main/docs/md/interfaces/vec2.md)\>
Readonly Vec2
Defined in: types/vec2-readonly.ts:4
## Variables
### APPROX\_THRESHOLD
• `Const` **APPROX\_THRESHOLD**: ``1e-8``= 0.00000001
Approximate threshold for approx comparison
Defined in: constants/approx-threshold.ts:2
___
### MINUS\_ONE
• `Const` **MINUS\_ONE**: [*Vec2Readonly*](https://lloydevans.github.io/vec2-fn/modules.html#vec2readonly)
Constant readonly Vec2 with both values equalling `-1`
Defined in: constants/minus-one.ts:4
___
### ONE
• `Const` **ONE**: [*Vec2Readonly*](https://lloydevans.github.io/vec2-fn/modules.html#vec2readonly)
Constant readonly Vec2 with both values equalling `1`
Defined in: constants/one.ts:4
___
### PRECISION
• `Const` **PRECISION**: ``11``= 11
The number of decimal places calculations are made to.
Defined in: constants/precision.ts:2
___
### VEC2\_DOWN
• `Const` **VEC2\_DOWN**: [*Vec2Readonly*](https://lloydevans.github.io/vec2-fn/modules.html#vec2readonly)
Normalized Vec2 pointing down
Defined in: constants/vec2-down.ts:4
___
### VEC2\_DOWN\_LEFT
• `Const` **VEC2\_DOWN\_LEFT**: [*Vec2Readonly*](https://lloydevans.github.io/vec2-fn/modules.html#vec2readonly)
Normalized Vec2 pointing down-left
Defined in: constants/vec2-down-left.ts:5
___
### VEC2\_DOWN\_RIGHT
• `Const` **VEC2\_DOWN\_RIGHT**: [*Vec2Readonly*](https://lloydevans.github.io/vec2-fn/modules.html#vec2readonly)
Normalized Vec2 pointing down-right
Defined in: constants/vec2-down-right.ts:5
___
### VEC2\_LEFT
• `Const` **VEC2\_LEFT**: [*Vec2Readonly*](https://lloydevans.github.io/vec2-fn/modules.html#vec2readonly)
Normalized Vec2 pointing left
Defined in: constants/vec2-left.ts:4
___
### VEC2\_RIGHT
• `Const` **VEC2\_RIGHT**: [*Vec2Readonly*](https://lloydevans.github.io/vec2-fn/modules.html#vec2readonly)
Normalized Vec2 pointing right
Defined in: constants/vec2-right.ts:4
___
### VEC2\_UP
• `Const` **VEC2\_UP**: [*Vec2Readonly*](https://lloydevans.github.io/vec2-fn/modules.html#vec2readonly)
Normalized Vec2 pointing up
Defined in: constants/vec2-up.ts:4
___
### VEC2\_UP\_LEFT
• `Const` **VEC2\_UP\_LEFT**: [*Vec2Readonly*](https://lloydevans.github.io/vec2-fn/modules.html#vec2readonly)
Normalized Vec2 pointing up-left
Defined in: constants/vec2-up-left.ts:5
___
### VEC2\_UP\_RIGHT
• `Const` **VEC2\_UP\_RIGHT**: [*Vec2Readonly*](https://lloydevans.github.io/vec2-fn/modules.html#vec2readonly)
Normalized Vec2 pointing up-right
Defined in: constants/vec2-up-right.ts:5
___
### ZERO
• `Const` **ZERO**: [*Vec2Readonly*](https://lloydevans.github.io/vec2-fn/modules.html#vec2readonly)
Constant readonly Vec2 with both values equalling `0`
Defined in: constants/zero.ts:4
## Functions
### abs
▸ **abs**(`target`: T): T
Calculate vec2 absolute value.
**`example`**
```ts
abs({ x: -1, y: -1 }); // -> { x: 0, y: 0 }
```
#### Type parameters
| Name | Type |
| :------ | :------ |
| `T` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | T | Target vector. |
**Returns:** T
- A reference to the modified target vector.
Defined in: fn/abs.ts:19
▸ **abs**(`target`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `dest?`: D): D
Calculate vec2 absolute value.
**`example`**
```ts
abs({ x: -1, y: -1 }); // -> { x: 0, y: 0 }
```
#### Type parameters
| Name | Type |
| :------ | :------ |
| `D` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | Target vector. |
| `dest?` | D | Destination object to store the result. |
**Returns:** D
- A reference to the modified destination object.
Defined in: fn/abs.ts:34
___
### add
▸ **add**(`target`: T, `value`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number*): T
Add vectors together.
**`example`**
```ts
add({ x: -1, y: -1 }, { x: 1, y: 1 }); // -> { x: 0, y: 0 }
```
#### Type parameters
| Name | Type |
| :------ | :------ |
| `T` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | T | Target vector. |
| `value` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number* | The vector to add. |
**Returns:** T
- A reference to the modified target object.
Defined in: fn/add.ts:17
▸ **add**(`target`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `value`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number*, `dest`: D): D
Add vectors together.
**`example`**
```ts
let result = { x: 0, y: 0 };
add({ x: -1, y: -1 }, { x: 1, y: 1 }, result); // -> { x: 0, y: 0 }
```
#### Type parameters
| Name | Type |
| :------ | :------ |
| `D` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | Target vector. |
| `value` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number* | The vector to add. |
| `dest` | D | Destination object to store the result. |
**Returns:** D
- A reference to the modified destination object.
Defined in: fn/add.ts:34
___
### angleTo
▸ **angleTo**(`to`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `from?`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param)): *number*
Calculate angle.
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `to` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | Vector to calculate to. |
| `from` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | Vector to calculate from. Defaults to `ZERO`. |
**Returns:** *number*
- Number angle result.
Defined in: fn/angle-to.ts:14
___
### approx
▸ **approx**(`v1`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `v2`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `threshold?`: *number*): *boolean*
Calculate whether two vectors are approximately equal.
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `v1` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | First vector for comparison. |
| `v2` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | Second vector for comparison. |
| `threshold` | *number* | - |
**Returns:** *boolean*
- Whether the vectors are approximately equal or not.
Defined in: fn/approx.ts:15
___
### ceil
▸ **ceil**(`target`: T): T
Ceil the values of a vector.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `T` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | T | The target vector. |
**Returns:** T
- A reference to the modified target vector.
Defined in: fn/ceil.ts:12
▸ **ceil**(`target`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `dest`: D): D
Ceil the values of a vector.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `D` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | The target vector. |
| `dest` | D | Destination object to store the result. |
**Returns:** D
- A reference to the modified destination vector.
Defined in: fn/ceil.ts:20
___
### clamp
▸ **clamp**(`target`: T, `vMin`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number*, `vMax`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number*): T
Clamp a vector by min and max limits.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `T` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | T | Target object. |
| `vMin` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number* | Minimum vector. |
| `vMax` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number* | Maximum vector. |
**Returns:** T
- A reference to the modified target object.
Defined in: fn/clamp.ts:14
▸ **clamp**(`target`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `vMin`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number*, `vMax`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number*, `dest`: D): D
Clamp a vector by min and max limits.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `D` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | Target object. |
| `vMin` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number* | Minimum vector. |
| `vMax` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number* | Maximum vector. |
| `dest` | D | Destination object to store the values. |
**Returns:** D
- A reference to the modified destination object.
Defined in: fn/clamp.ts:24
___
### copy
▸ **copy**(`target`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `dest`: D): D
Copy one vectors values to another.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `D` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | Target to be copied from. |
| `dest` | D | The destination object. |
**Returns:** D
- The destination object reference.
Defined in: fn/copy.ts:13
___
### distance
▸ **distance**(`from`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `to`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param)): *number*
Get the distance between two vectors.
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `from` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | From vector. |
| `to` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | To vector. |
**Returns:** *number*
- Number distance result.
Defined in: fn/distance.ts:11
___
### distanceSq
▸ **distanceSq**(`from`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `to`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param)): *number*
Get the squared distance between two vectors.
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `from` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | From vector. |
| `to` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | To vector. |
**Returns:** *number*
- Number distance squared result.
Defined in: fn/distance-sq.ts:13
___
### divide
▸ **divide**(`target`: T, `value`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number*): T
Divide two vectors.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `T` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | T | Target vector. |
| `value` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number* | The vector to divide by. |
**Returns:** T
- A reference to the modified target object.
Defined in: fn/divide.ts:11
▸ **divide**(`target`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `value`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number*, `dest`: D): D
Divide two vectors.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `D` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | Target vector. |
| `value` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number* | The vector to divide by. |
| `dest` | D | Destination object to store the result. |
**Returns:** D
- A reference to the modified destination object.
Defined in: fn/divide.ts:20
___
### dot
▸ **dot**(`v1`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `v2`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param)): *number*
Calculate the dot product of two vectors.
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `v1` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | Vector 1. |
| `v2` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | = Vector 2. |
**Returns:** *number*
- Number result of the dot product.
Defined in: fn/dot.ts:13
___
### dotPerp
▸ **dotPerp**(`v1`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `v2`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param)): *number*
Calculate the perpendicular dot product of two vectors.
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `v1` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | Vector 1. |
| `v2` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | = Vector 2. |
**Returns:** *number*
- Number result of the perpendicular dot product.
Defined in: fn/dot-perp.ts:13
___
### equal
▸ **equal**(`target`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `value`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number*): *boolean*
Check whether two vectors are exactly equal to system precision.
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | Target vector. |
| `value` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number* | Value vector. |
**Returns:** *boolean*
- Boolean result of whether the vectors are equal.
Defined in: fn/equal.ts:13
___
### floor
▸ **floor**(`target`: T): T
Floor the values of a vector.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `T` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | T | The target vector. |
**Returns:** T
- A reference to the modified target vector.
Defined in: fn/floor.ts:12
▸ **floor**(`target`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `dest`: D): D
Floor the values of a vector.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `D` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | The target vector. |
| `dest` | D | Destination object to store the result. |
**Returns:** D
- A reference to the modified destination vector.
Defined in: fn/floor.ts:20
___
### isOne
▸ **isOne**(`target`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param)): *boolean*
Check whether a vector is exactly equal to one (1,1).
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | Target vector. |
**Returns:** *boolean*
- Boolean result of whether the vector is equal to one.
Defined in: fn/is-one.ts:11
___
### isVec2LikeArray
▸ **isVec2LikeArray**(`value`: T): value is T extends [number, number] ? T : never
Check whether a value is a vec2-like array.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `T` | *unknown* |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `value` | T | Input value to check. |
**Returns:** value is T extends [number, number] ? T : never
- Boolean result of whether the input is a vec2-like array.
Defined in: fn/is-vec2-array.ts:9
___
### isVec2LikeObject
▸ **isVec2LikeObject**(`value`: T): value is T extends Vec2 ? T : never
Check whether a value is a vec2-like object.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `T` | *unknown* |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `value` | T | Input value to check. |
**Returns:** value is T extends Vec2 ? T : never
- Boolean result of whether the input is a vec2-like object.
Defined in: fn/is-vec2-object.ts:12
___
### isZero
▸ **isZero**(`vec1`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param)): *boolean*
Check whether a vector is exactly equal to zero (0,0).
#### Parameters
| Name | Type |
| :------ | :------ |
| `vec1` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
**Returns:** *boolean*
- Boolean result of whether the vector is equal to zero.
Defined in: fn/is-zero.ts:11
___
### length
▸ **length**(`vec`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param)): *number*
Get the length of a vector.
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `vec` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | The input vector. |
**Returns:** *number*
- The number result of the vector length.
Defined in: fn/length.ts:10
___
### lengthSq
▸ **lengthSq**(`vec`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param)): *number*
Get the squared length of a vector.
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `vec` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | The input vector. |
**Returns:** *number*
- The number result of the squared vector length.
Defined in: fn/length-sq.ts:12
___
### lerp
▸ **lerp**(`target`: T, `value`: V, `k`: *number*): T
Linear interpolate two vectors.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `T` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
| `V` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | T | Vector A. |
| `value` | V | Vector B. |
| `k` | *number* | The amount to interpolate by. |
**Returns:** T
- A reference to the modified target object.
Defined in: fn/lerp.ts:15
▸ **lerp**(`target`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `value`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `k`: *number*, `dest`: D): D
Linear interpolate two vectors.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `D` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | Vector A. |
| `value` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | Vector B. |
| `k` | *number* | The amount to interpolate by. |
| `dest` | D | Destination object to store the result. |
**Returns:** D
- A reference to the modified destination object.
Defined in: fn/lerp.ts:25
___
### max
▸ **max**(`dest`: D, ...`values`: ([*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number*)[]): D
Returns the max x and y of a set of vectors.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `D` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `dest` | D | - |
| `...values` | ([*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number*)[] | - |
**Returns:** D
-
Defined in: fn/max.ts:13
___
### min
▸ **min**(`dest`: D, ...`values`: ([*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number*)[]): D
Returns the min x and y of a set of vectors.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `D` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `dest` | D | - |
| `...values` | ([*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number*)[] | - |
**Returns:** D
-
Defined in: fn/min.ts:13
___
### multiply
▸ **multiply**(`target`: T, `value`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number*): T
Multiply two vectors.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `T` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | T | The target vector. |
| `value` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number* | The vector to multiply by. |
**Returns:** T
- A reference to the modified target object.
Defined in: fn/multiply.ts:11
▸ **multiply**(`target`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `value`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number*, `dest`: D): D
Multiply two vectors.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `D` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | The target vector. |
| `value` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number* | The vector to multiply by. |
| `dest` | D | Destination object to store the result. |
**Returns:** D
- A reference to the modified destination object.
Defined in: fn/multiply.ts:20
___
### negate
▸ **negate**(`target`: T): T
Negate a vector.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `T` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | T | The target vector. |
**Returns:** T
- A reference to the modified target vector.
Defined in: fn/negate.ts:12
▸ **negate**(`target`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `dest`: D): D
Negate a vector.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `D` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | The target vector. |
| `dest` | D | Destination object to store the result. |
**Returns:** D
- A reference to the modified destination vector.
Defined in: fn/negate.ts:20
___
### normalize
▸ **normalize**(`target`: T): T
Normalize a vector.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `T` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | T | Target can be vec object or array. |
**Returns:** T
- The modified target object.
Defined in: fn/normalize.ts:13
▸ **normalize**(`target`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `dest?`: D): D
Normalize a vector.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `D` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | Target can be vec object or array. |
| `dest?` | D | destination object to store the result. |
**Returns:** D
- A reference to the destination object.
Defined in: fn/normalize.ts:21
___
### rotate
▸ **rotate**(`target`: T, `angle`: *number*): T
Rotate a vector around zero point.
**`readonly`** - A reference to the modified target vector.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `T` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | T | The target vector. |
| `angle` | *number* | The amount of rotation to apply in radians. |
**Returns:** T
Defined in: fn/rotate.ts:14
▸ **rotate**(`target`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `angle`: *number*, `dest?`: D): D
Rotate a vector around zero point.
**`readonly`** - A reference to the modified destination vector.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `D` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | The target vector. |
| `angle` | *number* | The amount of rotation to apply in radians. |
| `dest?` | D | Optional destination object to store the result. |
**Returns:** D
Defined in: fn/rotate.ts:23
___
### round
▸ **round**(`target`: T): T
Round the values of a vector.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `T` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | T | The target vector. |
**Returns:** T
- A reference to the modified target vector.
Defined in: fn/round.ts:12
▸ **round**(`target`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `dest`: D): D
Round the values of a vector.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `D` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | The target vector. |
| `dest` | D | Destination object to store the result. |
**Returns:** D
- A reference to the modified destination vector.
Defined in: fn/round.ts:20
___
### subtract
▸ **subtract**(`target`: T, `value`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number*): T
Subtract one vector from another.
**`example`**
```ts
subtract({ x: 1, y: 1 }, { x: 1, y: 1 }); // -> { x: 0, y: 0 }
```
#### Type parameters
| Name | Type |
| :------ | :------ |
| `T` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | T | The target vector. |
| `value` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number* | The vector to subtract. |
**Returns:** T
- A reference to the modified target vector.
Defined in: fn/subtract.ts:17
▸ **subtract**(`target`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param), `value`: [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number*, `dest?`: D): D
Subtract one vector from another.
**`example`**
```ts
let result = { x: 0, y: 0 };
subtract({ x: 1, y: 1 }, { x: 1, y: 1 }, result); // -> { x: 0, y: 0 }
```
#### Type parameters
| Name | Type |
| :------ | :------ |
| `D` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) | The target vector. |
| `value` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) \| *number* | The vector to subtract. |
| `dest?` | D | Destination object to store the result. |
**Returns:** D
- A reference to the modified destination vector.
Defined in: fn/subtract.ts:33
___
### toArray
▸ **toArray**(`target`: [*Vec2*](https://github.com/lloydevans/vec2-fn/blob/main/docs/md/interfaces/vec2.md)): [*Vec2Array*](https://lloydevans.github.io/vec2-fn/modules.html#vec2array)
Convert a vec2-like object to an array.
#### Parameters
| Name | Type |
| :------ | :------ |
| `target` | [*Vec2*](https://github.com/lloydevans/vec2-fn/blob/main/docs/md/interfaces/vec2.md) |
**Returns:** [*Vec2Array*](https://lloydevans.github.io/vec2-fn/modules.html#vec2array)
- Newly created array.
Defined in: fn/to-array.ts:12
___
### toObject
▸ **toObject**(`target`: [*Vec2Array*](https://lloydevans.github.io/vec2-fn/modules.html#vec2array)): [*Vec2*](https://github.com/lloydevans/vec2-fn/blob/main/docs/md/interfaces/vec2.md)
Convert a vec2-like array to an object.
#### Parameters
| Name | Type |
| :------ | :------ |
| `target` | [*Vec2Array*](https://lloydevans.github.io/vec2-fn/modules.html#vec2array) |
**Returns:** [*Vec2*](https://github.com/lloydevans/vec2-fn/blob/main/docs/md/interfaces/vec2.md)
- Newly created Vec2 object.
Defined in: fn/to-object.ts:12
___
### zero
▸ **zero**(`target`: T): T
Set vector to zero.
#### Type parameters
| Name | Type |
| :------ | :------ |
| `T` | [*Vec2Param*](https://lloydevans.github.io/vec2-fn/modules.html#vec2param) |
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `target` | T | Target Vec2-like object the values will be written to. |
**Returns:** T
- A reference to the object the result was written to.
Defined in: fn/zero.ts:12