# Hexx

Hexagonal tools lib in rust.

Inspired by this RedBlobGames article.

This lib allows you to: - Manipulate hexagon coordinates - Generate hexagonal maps with custom layouts and orientation - Generate hexagon meshes (planes or columns)

I made the choice to use Axial Coordinates for performance and utility reasons, but the Hex type allows you to use computes Cubic coordinates. (See the hexagonal coordinate systems)

The Hex type gives you access to most hexagonal arithmetics like: - Distances - Neighbors and directions - Lines - Ranges - Rings - Rotation

## Example

cargo run --example hex_grid

## Usage in bevy

If you want to generate 3D hexagonal mesh and use it in bevy you may do it this way:

```rust use bevy::prelude::Mesh; use bevy::render::{mesh::Indices, render_resource::PrimitiveTopology}; use hexx::{HexLayout, Hex, MeshInfo};

pub fn hexagonalplane(hex: Hex, hexlayout: &HexLayout) -> Mesh { let meshinfo = MeshInfo::hexagonalplane( hexlayout, hex, ); let mut mesh = Mesh::new(PrimitiveTopology::TriangleList); mesh.insertattribute(Mesh::ATTRIBUTEPOSITION, meshinfo.vertices.tovec()); mesh.insertattribute(Mesh::ATTRIBUTENORMAL, meshinfo.normals.tovec()); mesh.insertattribute(Mesh::ATTRIBUTEUV0, meshinfo.uvs.tovec()); mesh.setindices(Some(Indices::U16(meshinfo.indices))); mesh } ```