tilemerge

README

tilemerge

Merge 2D map tiles into a single image.

Requires Go 1.9+

Under heavy development!

Purpose

This library is intended to assist with merging individual map tiles into a single image.

A common use case is to create a static map image from an interactive Leaflet.

TODO:

• Handle anti-meridian wrapping and several world-widths
• Handle negative offets and width / height larger than tiles
• Flag for test to update golden files
• Test with transparency
• Test with missing tiles
• Test with paletted PNGs
• Test with webp tiles
• Documentation

Dependencies

Dependencies are managed using dep

Similar libraries

• go-staticmaps

Documentation

Index

• Constants
• func Merge(tiles Tiles, xOff, yOff, width, height int, bg color.Color) (image.Image, error)
• type Tile
• type Tiles

Constants

const TILE_SIZE = 256

TILE_SIZE uses default size of map tiles for now TODO: probably should be a parameter or detected from the input images

Functions

func Merge

func Merge(tiles Tiles, xOff, yOff, width, height int, bg color.Color) (image.Image, error)

Merge merges input Tiles into a single Image with dimenensions `width` and `height`, and crops based on xOff, yOff from upper left of image. Tile x and y coordinates increase from the upper left of the image. Any tile that

Types

type Tile

type Tile struct {
	Z    uint8 // don't really need to know this here
	X, Y int
	Data *[]byte // nil if there is no valid image data for this tile coordinate
}

Tile is a container for basic information about a tile

type Tiles

type Tiles struct {
	Tiles          []Tile
	X0, Y0, X1, Y1 int
}

Tiles wraps Tile structs with information about the x and y tile index ranges