#gamedev #hexagonal #hex #coordinate

beehive

Utilities and collections for 3D hexagonal maps

2 releases

0.1.1 May 6, 2020
0.1.0 May 5, 2020

#918 in Data structures

MIT/Apache

110KB
3K SLoC

beehive

crates.io docs.rs travis.org

Library for working with 3D hexagonal maps.

Usage

Add the beehive crate as a dependency:

[dependencies]
beehive = "0.1"

Coordinate space

Coordinates are in cube or axial space where Z is the cube axis, with an additional vertical axis W.

Flat-top

       yz +Y
       __
   yx /  \ xz +X
-X zx \__/ xy
    -Y zy

Pointy-top

    yx  /\  yz  +Y
-X  zx |  | xz  +X
-Y  zy  \/  xy

Collections

The following collections are available behind the collections feature (enabled by default):

  • DirectionMap, a stack-allocated map backed by an array that can be indexed by Direction.
  • HexMap, a generic QuadPrism-shaped dense container indexed by hex coordinates.
  • KdTree, a generic KD-tree in hex space, implemented on a flat vector.

Crate Features

  • serde-1: Enabled by default. Serialization support via serde.
  • collections: Enabled by default. Collections that work with hex coordinates.
  • rand-07: Disabled by default.rand 0.7 distribution implementations for Direction and QuadPrism.

Licence

Licensed under either of Apache License, Version 2.0 or MIT license at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~100–420KB