https://github.com/gmoller/zen.hexagons

Hexagon routines for use in for software that uses hexagon grids.
https://github.com/gmoller/zen.hexagons

hexagon hexagonal-grid-library hexagonal-grids hexagonal-tiles hexagons

Last synced: 6 months ago
JSON representation

Hexagon routines for use in for software that uses hexagon grids.

• Host: GitHub
• URL: https://github.com/gmoller/zen.hexagons
• Owner: gmoller
• License: mit
• Created: 2020-10-19T02:40:57.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2020-12-30T04:49:17.000Z (about 5 years ago)
• Last Synced: 2025-04-14T20:41:58.555Z (9 months ago)
• Topics: hexagon, hexagonal-grid-library, hexagonal-grids, hexagonal-tiles, hexagons
• Language: C#
• Homepage:
• Size: 112 KB
• Stars: 4
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Zen.Hexagons

Hexagon routines for use in for software that uses hexagon grids.

Can be used for pointy-topped or flat-topped hexes and offset, axial or cube coordinate systems.

Uses ideas from Amit Patel's brilliant http://www.redblobgames.com/grids/hexagons/.

Nuget package download: https://www.nuget.org/packages/Zen.Hexagons/1.0.7

# Example

To use:

    var hexLibrary = new Zen.Hexagons.HexLibrary(HexType.FlatTopped, OffsetCoordinatesType.Odd, 64.0f);

    

    var hexCube = hexLibrary.OffsetCoordinatesToCube(new HexOffsetCoordinates(2, 2));

    var hexAxial = hexLibrary.OffsetCoordinatesToAxial(new HexOffsetCoordinates(2, 2));

    

    var neighbors = hexLibrary.GetAllNeighbors(new HexOffsetCoordinates(1, 1));

    var neighborNW = hexLibrary.GetNeighbor(new HexOffsetCoordinates(1, 1), Direction.NorthWest);

    

    var ring1 = hexLibrary.GetSingleRing(new HexOffsetCoordinates(1, 1), 1);

    var ring2 = hexLibrary.GetSingleRing(new HexOffsetCoordinates(2, 2), 2);

    

    var ring3 = hexLibrary.GetSpiralRing(new HexOffsetCoordinates(2, 2), 2);

    

    var line = hexLibrary.GetLine(new HexOffsetCoordinates(1, 0), new HexOffsetCoordinates(3, 4));

    

    var distance = hexLibrary.GetDistance(new HexOffsetCoordinates(1, 0), new HexOffsetCoordinates(3, 4));

    

    var pixel = hexLibrary.FromOffsetCoordinatesToPixel(new HexOffsetCoordinates(1, 1));

    

    var coords = hexLibrary.FromPixelToOffsetCoordinates(96, 166);

    

# Developer

Written by Greg Moller (greg.moller@gmail.com)  

If you have any questions drop me a line at the above email.

# License

Licensed under the MIT License. See the LICENCE file for more information.