Hex Grid Renderer

Hex Grid Renderer


Hex Grid Renderer (HGR) is a free (and ad-free) Android app for creating hexagonal grids and exporting them to image files. It is intended as a utility for gamers who play tabletop games which use hex grids. HGR appears to be the only app of its kind in the Google Market.

This is my first Android app. It is "functional but beta," not terribly pretty, but what's there seems to work.

ACHTUNG: as of Dec. 2014, nerve damage (from too much typing!) severely limits my programming time. If you are interested in (and capable of!) taking over coding of this application, please get it touch!

If you feel you need to rate it as only 1 or 2 stars, PLEASE be adult enough to explain why (in the review text). So far the only people who are it less than 3 have only starred it without writing any review text, with no explanation as to why.

This description page exists in an expanded form on the project's web page:

http://android.wanderinghorse.net/hex-grid-renderer/

The complete source code can also be found there.

Features:

- Easily create hexagon grids with only a few finger-taps.

- Customize the colors, labels, center dots, border, and hexagons.

- Supports wide-grain and tall-grain grids.

- Export hex grids as image files to other Android Activities via Intents. What does that mean? It means it can export your hex grids directly to GMail, GDrive, Dropbox, printer services, and others.

- Has undo support (15 levels) and save/load support. Loading can be "undone."

- User-configurable starting values for row/column numbers (version 20130309+).

- It speaks English and some degree of German. If you want it in a language of your choice, get in touch and i will send you the information you need to translate it :). Contact info is at the bottom.


ACHTUNG: If your device force-closes this immediately or when changing map sizes, then it has too little memory. See the NOTES section below for why.



PERMISSIONS:

- HGR requires EXTERNAL STORAGE WRITE permissions in order to save its images to the SD card (under SD/app-data/net.wanderinghorse.android.hexish/...) before handing them off to services like GMail, GDrive, or Dropbox. If there were a way to do this without a file, _and_ not risk an out-of-memory error by buffering the exported data in a byte array, the app would need no special permissions.



DEVICE COMPATIBILITY:

HGR is has been seen to work on API7 devices (Android 2.1.x). It is tested on several emulator configurations (with various Android versions), a Samsung Galaxy S2 phone, and an Asus TF300 tablet (both running ICS).


NOTES AND CAVEATS:

- "No warranties," and all that.

- When exporting an image, a copy is placed in your SD storage under under SDCARD/app-data/net.wanderinghorse.android.hexish/. There is a menu entry which shows you the exact path for your device. Also be sure to check your Gallery, as saved images "should" show up there at some point.

- If HGR suddenly crashes at startup (after it worked before), try the "Clear Data" option in the app control center to remove its persistent state. This "shouldn't happen", but just in case it does.


KNOWN PROBLEMS:

- If it crashes after changing radii or dimensions then the problem is almost certainly that the rendered grid takes up too much memory and Android is killing the app. Workaround: scale it back a notch. The memory hog is the drawing/scrolling parts, not the actual hex data (which has low, constant memory costs).

- If the app starts up with a blank black area, use Hexes==>Radius to set the radius. (This might have been a side-effect of local tests and might never happen in the wild.)

CONTACT:

Constructive criticism is always welcomed: feel free to contact the developer (Stephan Beal) directly (in English or German) via [email protected] Code contributors are of course also welcomed (just get in touch). i cannot commit to adding every requested feature, but am nonetheless interested in hearing about your ideas for improvements.

Recent changes:
v20131012:

- Fixed a minor sizing problem which caused the right/bottom hex edges to get truncated in some cases.

- More internal work on exporting the underlying JSON data, but it is not yet exposed to users.

v20130922:

- Can now set hex label size relative to the current hex radius (4 size settings).

- Undo levels increased to 15.
Add to list
Free
74
3.7
User ratings
35
Installs
1,000+
Concerns
0
File size
175 kb
Screenshots
Screenshot of Hex Grid Renderer Screenshot of Hex Grid Renderer Screenshot of Hex Grid Renderer Screenshot of Hex Grid Renderer Screenshot of Hex Grid Renderer Screenshot of Hex Grid Renderer Screenshot of Hex Grid Renderer Screenshot of Hex Grid Renderer Screenshot of Hex Grid Renderer Screenshot of Hex Grid Renderer Screenshot of Hex Grid Renderer Screenshot of Hex Grid Renderer Screenshot of Hex Grid Renderer
About Hex Grid Renderer
Hex Grid Renderer (HGR) is a free (and ad-free) Android app for creating hexagonal grids and exporting them to image files. It is intended as a utility for gamers who play tabletop games which use hex grids. HGR appears to be the only app of its kind in the Google Market.

This is my first Android app. It is "functional but beta," not terribly pretty, but what's there seems to work.

ACHTUNG: as of Dec. 2014, nerve damage (from too much typing!) severely limits my programming time. If you are interested in (and capable of!) taking over coding of this application, please get it touch!

If you feel you need to rate it as only 1 or 2 stars, PLEASE be adult enough to explain why (in the review text). So far the only people who are it less than 3 have only starred it without writing any review text, with no explanation as to why.

This description page exists in an expanded form on the project's web page:

http://android.wanderinghorse.net/hex-grid-renderer/

The complete source code can also be found there.

Features:

- Easily create hexagon grids with only a few finger-taps.

- Customize the colors, labels, center dots, border, and hexagons.

- Supports wide-grain and tall-grain grids.

- Export hex grids as image files to other Android Activities via Intents. What does that mean? It means it can export your hex grids directly to GMail, GDrive, Dropbox, printer services, and others.

- Has undo support (15 levels) and save/load support. Loading can be "undone."

- User-configurable starting values for row/column numbers (version 20130309+).

- It speaks English and some degree of German. If you want it in a language of your choice, get in touch and i will send you the information you need to translate it :). Contact info is at the bottom.


ACHTUNG: If your device force-closes this immediately or when changing map sizes, then it has too little memory. See the NOTES section below for why.



PERMISSIONS:

- HGR requires EXTERNAL STORAGE WRITE permissions in order to save its images to the SD card (under SD/app-data/net.wanderinghorse.android.hexish/...) before handing them off to services like GMail, GDrive, or Dropbox. If there were a way to do this without a file, _and_ not risk an out-of-memory error by buffering the exported data in a byte array, the app would need no special permissions.



DEVICE COMPATIBILITY:

HGR is has been seen to work on API7 devices (Android 2.1.x). It is tested on several emulator configurations (with various Android versions), a Samsung Galaxy S2 phone, and an Asus TF300 tablet (both running ICS).


NOTES AND CAVEATS:

- "No warranties," and all that.

- When exporting an image, a copy is placed in your SD storage under under SDCARD/app-data/net.wanderinghorse.android.hexish/. There is a menu entry which shows you the exact path for your device. Also be sure to check your Gallery, as saved images "should" show up there at some point.

- If HGR suddenly crashes at startup (after it worked before), try the "Clear Data" option in the app control center to remove its persistent state. This "shouldn't happen", but just in case it does.


KNOWN PROBLEMS:

- If it crashes after changing radii or dimensions then the problem is almost certainly that the rendered grid takes up too much memory and Android is killing the app. Workaround: scale it back a notch. The memory hog is the drawing/scrolling parts, not the actual hex data (which has low, constant memory costs).

- If the app starts up with a blank black area, use Hexes==>Radius to set the radius. (This might have been a side-effect of local tests and might never happen in the wild.)

CONTACT:

Constructive criticism is always welcomed: feel free to contact the developer (Stephan Beal) directly (in English or German) via [email protected] Code contributors are of course also welcomed (just get in touch). i cannot commit to adding every requested feature, but am nonetheless interested in hearing about your ideas for improvements.

Recent changes:
v20131012:

- Fixed a minor sizing problem which caused the right/bottom hex edges to get truncated in some cases.

- More internal work on exporting the underlying JSON data, but it is not yet exposed to users.

v20130922:

- Can now set hex label size relative to the current hex radius (4 size settings).

- Undo levels increased to 15.

User reviews of Hex Grid Renderer
Write the first review for this app!
Android Market Comments
A Google User
Jan 17, 2015
Making my board game Perfect since I couldn't draw hexagons... Bloody tricky things. Exported it to sketchbook apps and what not and got exactly what I needed. Thank you.
A Google User
Dec 22, 2014
Cant INSTALL It's weird but can you post an apk mirror?
A Google User
Nov 4, 2014
Really confusing I dont know what to do with the program, really. A tutorial mode or help menu would be useful. Also the UI is really user unfriendly. I get that the app is in a kind of 'beta' phase but it takes too long to get used to what I actually have to press to get anything done. In later stages, pre made templates for DnD sessions or 40k campaigns would help for DMs who just want a generic map to get started on would be epic
A Google User
Jul 20, 2014
Major flaw I like what you can do with this, but I wish I could apply this to actual images as a decal to an image.
A Google User
Jun 27, 2014
Huh I don't know what this app is for if you cant change the individual hexes