https://github.com/bcvery1/tilepix
Library for combining tiled maps with pixel
https://github.com/bcvery1/tilepix
gamedev gamedev-library graphics ludum-dare ludumdare tiled tiled-map-editor
Last synced: 4 months ago
JSON representation
Library for combining tiled maps with pixel
- Host: GitHub
- URL: https://github.com/bcvery1/tilepix
- Owner: bcvery1
- License: mit
- Created: 2019-02-27T09:02:11.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-10-09T08:28:38.000Z (over 1 year ago)
- Last Synced: 2025-01-30T20:40:21.880Z (5 months ago)
- Topics: gamedev, gamedev-library, graphics, ludum-dare, ludumdare, tiled, tiled-map-editor
- Language: Go
- Size: 473 KB
- Stars: 45
- Watchers: 3
- Forks: 14
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
[](https://travis-ci.org/bcvery1/tilepix)
[](https://goreportcard.com/report/github.com/bcvery1/tilepix)
[](https://github.com/bcvery1/tilepix/blob/master/LICENSE)
[](https://godoc.org/github.com/bcvery1/tilepix)
#  TilePix
TilePix is a complementary library, designed to be used with the [Pixel](https://github.com/duysqubix/pixel2) library (see
below for more details on Pixel). TilePix was born out of [Ludum Dare](https://ldjam.com/); having found that a vast
amount of very limited time during the Ludum Dare weekends was used planing out map layouts, and defining collision
or activation areas. TilePix should make those activities a trivially short amount of time.
## Pixel
This library is a complement to the [Pixel](https://github.com/duysqubix/pixel2) 2D games library, and is largely inspired
by it. A huge thanks to [faiface](https://github.com/faiface) for one, giving us access to such a fantastic library;
and two, providing the inspiration for this library! Further thanks to [duysqubix](https://github.com/duysqubix) and
collaborators for continuing the effort with `Pixel2`.
TilePix would not have been possible without the great amount of care and effort that has been put into
[Pixel](https://github.com/duysqubix/pixel2).
### Legal
Pixel is subject to the [MIT](https://github.com/duysqubix/pixel2/blob/master/LICENSE) licence.
## Stability
TilePix is a work-in-progress project; as such, expect bugs and missing features. If you notice a bug or a feature you
feel is missing, please consider [contributing](https://github.com/bcvery1/tilepix/blob/master/CONTRIBUTING.md) - simply
(and correctly) raising issues is just as valuable as writing code!
## Example
Here is a very basic example of using the library. It is advisable to view the excellent
[Pixel tutorials](https://github.com/duysqubix/pixel2/wiki) before trying to understand this package, as TilePix is very
Pixel centric.
```go
package main
import (
"image/color"
// We must use blank imports for any image formats in the tileset image sources.
// You will get an error if a blank import is not made; TilePix does not import
// specific image formats, that is the responsibility of the calling code.
_ "image/png"
"github.com/bcvery1/tilepix"
pixel "github.com/duysqubix/pixel2"
"github.com/duysqubix/pixel2/pixelgl"
)
func run() {
cfg := pixelgl.WindowConfig{
Title: "TilePix",
Bounds: pixel.R(0, 0, 640, 320),
VSync: true,
}
win, err := pixelgl.NewWindow(cfg)
if err != nil {
panic(err)
}
// Load and initialise the map.
m, err := tilepix.ReadFile("myMap.tmx")
if err != nil {
panic(err)
}
for !win.Closed() {
win.Clear(color.White)
// Draw all layers to the window.
if err := m.DrawAll(win, color.White, pixel.IM); err != nil {
panic(err)
}
win.Update()
}
}
func main() {
pixelgl.Run(run)
}
```
Further examples can be found in the [examples directory](https://github.com/bcvery1/tilepix/tree/master/examples).
## Contributing
Thanks for considering contributing to TilePix; for details on how you can contribute, please consult the
[contribution guide](https://github.com/bcvery1/tilepix/blob/master/CONTRIBUTING.md).