churchianity
6 years ago
1 changed files with 43 additions and 43 deletions
-
80README.md
@ -1,61 +1,61 @@ |
|||
----- INTRODUCTION [1.1] --------------------------------------------------- |
|||
--[[ author@churchianity.ca |
|||
# hex.lua |
|||
|
|||
this is a library for using hexagonal grids in amulet/lua. |
|||
it is extremely incomplete. the following list of features is |
|||
either implemented shoddily, or not at all. |
|||
## INTRODUCTION [1.1] |
|||
|
|||
if you want an actual good resource, go to [1.9]. |
|||
this is a library for using hexagonal grids in amulet/lua. |
|||
it is extremely incomplete. the following list of features is |
|||
either implemented shoddily, or not at all. |
|||
|
|||
----- COORDINATE SYSTEMS [1.2] ---------------------------------------------- |
|||
if you want an actual good resource, go to [1.9]. |
|||
|
|||
* as much coordinate manipulation as possible is done internally. |
|||
depending on the task, uses either Axial, Cube, or Doubled coordinates. |
|||
## GETTING STARTED [1.2] |
|||
|
|||
* three different ways of returning and sending coordinates: |
|||
//TODO |
|||
|
|||
1) amulet vectors |
|||
2) lua tables |
|||
3) individual coordinate numbers |
|||
## COORDINATE SYSTEMS [1.3] |
|||
|
|||
so you can use what your graphics library likes best! |
|||
as much coordinate manipulation as possible is done internally. |
|||
depending on the task, uses either Axial, Cube, or Doubled coordinates. |
|||
|
|||
----- MAPS & MAP STORAGE [1.3] ------------------------------------------------- |
|||
three different ways of returning and sending coordinates: |
|||
|
|||
some map shapes: parallelogram, rectangular, hexagonal, triangular. (and more) |
|||
* storage system based on map shape - see chart: |
|||
* amulet vectors |
|||
* lua tables |
|||
* individual coordinate numbers |
|||
|
|||
so you can use what your graphics library likes best! |
|||
|
|||
## MAPS & MAP STORAGE [1.4] |
|||
|
|||
Some map shapes: parallelogram, rectangular, hexagonal, triangular. (and more) |
|||
|
|||
* storage system based on map shape - see chart: |
|||
|
|||
* SHAPE : MAP STORAGE |
|||
* |
|||
* parallelogram : unordered, hash-like OR ordered, array-like |
|||
* rectangular : unordered, hash-like OR ordered, array-like |
|||
* hexagonal : unordered, hash-like OR ordered, array-like |
|||
* triangular : unordered, hash-like OR ordered, array-like |
|||
* ring : ordered, array-like |
|||
* spiral : ordered, array-like** |
|||
* arbitrary : unordered, hash-like |
|||
|
|||
________________________________________________________________________ |
|||
| SHAPE : MAP STORAGE | |
|||
|------------------------------------------------------------------------| |
|||
| parallelogram : unordered, hash-like OR ordered, array-like | |
|||
| rectangular : unordered, hash-like OR ordered, array-like | |
|||
| hexagonal : unordered, hash-like OR ordered, array-like | |
|||
| triangular : unordered, hash-like OR ordered, array-like | |
|||
| ring : ordered, array-like | |
|||
| spiral : ordered, array-like** | |
|||
| arbitrary : unordered, hash-like | |
|||
|________________________________________________________________________| |
|||
** note that a spiral map is just a hexagonal one with a particular order. |
|||
|
|||
## CONVENTIONS AND TERMINOLOGY [1.8] |
|||
|
|||
----- CONVENTIONS AND TERMINOLOGY [1.8] ----------------------------------------- |
|||
because so many different kinds of coordinate pairs, trios |
|||
|
|||
because so many different kinds of coordinate pairs, trios |
|||
|
|||
## RESOURCES USED TO DEVELOP THIS LIBRARY, AND FOR WHICH I AM GRATEFUL [1.9] |
|||
|
|||
----- RESOURCES USED TO DEVELOP THIS LIBRARY, AND FOR WHICH I AM GRATEFUL [1.9] - |
|||
* [Hex Map 1](https://catlikecoding.com/unity/tutorials/hex-map/) - unity tutorial for hexagon grids with some useful generalized math. |
|||
|
|||
* https://catlikecoding.com/unity/tutorials/hex-map/ |
|||
-> unity tutorial for hexagon grids with some useful generalized math. |
|||
* [3Blue1Brown - Essence of Linear Algebra](https://youtube.com/watch?v=fNk_zzaMoSs&list=PLZHQObOWTQDPD3MizzM2xVFitgF8hE_ab) - amazing series on linear algebra by 3Blue1Brown |
|||
|
|||
* https://youtube.com/watch?v=fNk_zzaMoSs&list=PLZHQObOWTQDPD3MizzM2xVFitgF8hE_ab |
|||
-> amazing series on linear algebra by 3Blue1Brown |
|||
* [Hexagonal Grids](https://redblobgames.com/grid/hexagons) - THE resource on hexagonal grids on the internet. |
|||
|
|||
* https://redblobgames.com/grid/hexagons |
|||
-> now THE resource on hexagonal grids on the internet. |
|||
* [Amulet Docs](http://amulet.xyz/doc) - amulet documentation. |
|||
|
|||
* http://amulet.xyz/doc |
|||
-> amulet documentation. |
|||
]] |
|||
|
Write
Preview
Loading…
Cancel
Save
Reference in new issue