1.1.1 • Published 1 year ago

@blade67/gridmatrix v1.1.1

Weekly downloads
3
License
ISC
Repository
github
Last release
1 year ago

GridMatrix

A simplified solution for 2D Arrays, Grids, Matrices or whatever you want to call them!

Disclaimer: This module was designed in a non-destructive way, meaning that if anything goes wrong, it tries to return undefined instead of an error. (if possible)

In case of issues or suggestions, please open an issue on the Github Repo: https://github.com/Blade67/GridMatrix

A minified version as also available for browser usage here.

Installation

npm i @blade67/gridmatrix

Setup

const GridMatrix = require("@blade67/gridmatrix");

let grid = new GridMatrix({ width: 2, height: 2 });
// Output: [[null, null], [null, null]]

API

Propperties

  • size
    <GridMatrix>.size
    // Output: { x: 2, y: 2}
  • width
    <GridMatrix>.width
    // Output: 2
  • height
    <GridMatrix>.height
    // Output: 2
  • data
    <GridMatrix>.data
    // Output: [[null, null], [null, null]]
  • options
    <GridMatrix>.options
    // Output: { allowOverflow: true, defaultValue: null }
  • Directions (Enum/Object: `{ North: 0, NorthEast: 1, East: 2, SouthEast: 3, South: 4, SouthWest: 5, West: 6, NorthWest: 7,

    <GridMatrix>.Directions
    // Output: {
    // North: 0,
    // NorthEast: 1,
    // East: 2,
    // SouthEast: 3,
    // South: 4,
    // SouthWest: 5,
    // West: 6,
    // NorthWest: 7,
    // }
    
        <GridMatrix>.Directions.North
        // Output: 0
        ```
    
    }`)

Methods

  • setData
    <GridMatrix>.setData({ x: 0, y: 0}, "Node 0-0");
    // Output: "Node 0-0"
  • getData
    <GridMatrix>.getData({ x: 0, y: 0});
    // Output: "Node 0-0"
  • toArray
    <GridMatrix>.toArray();
    // Output: ["Node 0-0", null, null, null]
  • getNeighbour
    <GridMatrix>.getNeighbour({ x: 0, y: 1 }, <GridMatrix>.Directions.North);
    // Output: "Node 0-0"
  • getNext
    <GridMatrix>.getNext({ x: 1, y: 1 }, { wrap: true });
    // Output: "Node 0-0"
    // Output (wrap: false): undefined
  • getPrevious
    <GridMatrix>.getPrevious({ x: 0, y: 0 }, { wrap: true });
    // Output: null
    // Output (wrap: false): undefined
  • swap
    <GridMatrix>.swap({ x: 0, y: 0 }, { x: 1, y: 1 });
    // Output: [[null, null],[null, "Node 0-0"]]
  • addRowBefore
    <GridMatrix>.addRowBefore(["a", "b"]);
    // Output: [["a", "b"],[null, null],[null, "Node 0-0"]]
  • addRowAfter
    <GridMatrix>.addRowAfter(["a", "b"]);
    // Output: [[null, null],[null, "Node 0-0"],["a", "b"]]
  • removeRow
    <GridMatrix>.removeRow(1);
    // Output: [[null, null],["a", "b"]]
  • addColumnBefore
    <GridMatrix>.addColumnBefore(["a", "b"]);
    // Ouput: [["a", null, null],["b", null, "Node 0-0"]]
  • addColumnAfter
    <GridMatrix>.addColumnAfter(["a", "b"]);
    // Ouput: [[null, null, "a"],[null, "Node 0-0", "b"]]
  • removeColumn
    <GridMatrix>.removeColumn(2);
    // Output: [[null, null],[null, "Node 0-0"]]
1.1.1

1 year ago

1.1.0

1 year ago

1.0.0

1 year ago