Skip to content
A hand-crafted 2D game library in Go
Go
Branch: master
Clone or download
faiface Merge pull request #195 from fgrosse/release-notes
Start to maintain a change log
Latest commit aeef94f Jun 30, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
imdraw add imdraw benchmarks Jul 2, 2017
logo Delete logo Mar 20, 2019
pixelgl Adding NoIconify and AlwaysOnTop GLFW window hints May 30, 2019
text Change package to text_test Jan 19, 2018
.gitignore add gitignore Dec 16, 2016
.travis.yml Prevent default TravisCI install action May 30, 2019
CHANGELOG.md Start to maintain a change log Jun 23, 2019
CONTRIBUTING.md Fixed link to examples repo in CONTRIBUTING.md May 19, 2019
LICENSE Initial commit Nov 19, 2016
README.md Update wording about tracked changes in README.md Jun 29, 2019
batch.go minor change Apr 15, 2017
color.go optimize ToRGBA (weird one) Jul 2, 2017
color_test.go Reverting back to origin Mar 26, 2019
compose.go fix type in ComposeMethod doc Apr 11, 2017
data.go Reverted changes on setlen Apr 24, 2019
data_test.go Added benchmark for MakeTrianglesData Apr 24, 2019
doc.go minor change in pixel package doc Apr 21, 2017
drawer.go optimize Drawer (reduce map access) Jul 2, 2017
drawer_test.go Reverting back to origin Mar 26, 2019
geometry.go docs changes May 24, 2019
geometry_test.go Added test cases Apr 10, 2019
go.mod Add missing github.com/golang/freetype dependency May 30, 2019
go.sum Add missing github.com/golang/freetype dependency May 30, 2019
interface.go move ComposeTarget to separate file Apr 11, 2017
matrix_test.go Reverting back to origin Mar 26, 2019
pixel_test.go Adding test for drawing sprites Apr 15, 2019
sprite.go Setting position in correct order Apr 15, 2019

README.md

Pixel Build Status GoDoc Go Report Card Join the chat at https://gitter.im/pixellib/Lobby

A hand-crafted 2D game library in Go. Take a look into the features to see what it can do.

go get github.com/faiface/pixel

If you are using Modules (Go 1.11 or higher) and want a mutable copy of the source code:

git clone https://github.com/faiface/pixel # clone outside of $GOPATH
cd pixel
go install ./...

See requirements for the list of libraries necessary for compilation.

All significant changes are documented in CHANGELOG.md.

Tutorial

The Wiki of this repo contains an extensive tutorial covering several topics of Pixel. Here's the content of the tutorial parts so far:

Examples

The examples repository contains a few examples demonstrating Pixel's functionality.

To run an example, navigate to it's directory, then go run the main.go file. For example:

$ cd pixel-examples/platformer
$ go run main.go

Here are some screenshots from the examples!

Lights Platformer
Lights Platformer
Smoke Typewriter
Smoke Typewriter
Raycaster Gizmo
Raycaster Gizmo

Features

Here's the list of the main features in Pixel. Although Pixel is still under heavy development, there should be no major breakage in the API. This is not a 100% guarantee, though.

  • Fast 2D graphics
    • Sprites
    • Primitive shapes with immediate mode style IMDraw (circles, rectangles, lines, ...)
    • Optimized drawing with Batch
    • Text drawing with text package
  • Audio through a separate Beep library.
  • Simple and convenient API
    • Drawing a sprite to a window is as simple as sprite.Draw(window, matrix)
    • Wanna know where the center of a window is? window.Bounds().Center()
    • ...
  • Full documentation and tutorial
  • Works on Linux, macOS and Windows
  • Window creation and manipulation (resizing, fullscreen, multiple windows, ...)
  • Keyboard (key presses, text input) and mouse input without events
  • Well integrated with the Go standard library
    • Use "image" package for loading pictures
    • Use "time" package for measuring delta time and FPS
    • Use "image/color" for colors, or use Pixel's own color.Color format, which supports easy multiplication and a few more features
    • Pixel uses float64 throughout the library, compatible with "math" package
  • Geometry transformations with Matrix
    • Moving, scaling, rotating
    • Easy camera implementation
  • Off-screen drawing to Canvas or any other target (Batch, IMDraw, ...)
  • Fully garbage collected, no Close or Dispose methods
  • Full Porter-Duff composition, which enables
    • 2D lighting
    • Cutting holes into objects
    • Much more...
  • Pixel let's you draw stuff and do your job, it doesn't impose any particular style or paradigm
  • Platform and backend independent core
  • Core Target/Triangles/Picture pattern makes it easy to create new drawing targets that do arbitrarily crazy stuff (e.g. graphical effects)
  • Small codebase, ~5K lines of code, including the backend glhf package

Related repositories

Here are some packages which use Pixel:

  • TilePix Makes handling TMX files built with Tiled trivially easy to work with using Pixel.

Missing features

Pixel is in development and still missing few critical features. Here're the most critical ones.

  • Audio
  • Drawing text
  • Antialiasing (filtering is supported, though)
  • Advanced window manipulation (cursor hiding, window icon, ...)
  • Better support for Hi-DPI displays
  • Mobile (and perhaps HTML5?) backend
  • More advanced graphical effects (e.g. blur) (solved with the addition of GLSL effects)
  • Tests and benchmarks
  • Vulkan support

Implementing these features will get us to the 1.0 release. Contribute, so that it's as soon as possible!

Requirements

If you're using Windows and having trouble building Pixel, please check this guide on the wiki.

PixelGL backend uses OpenGL to render graphics. Because of that, OpenGL development libraries are needed for compilation. The dependencies are same as for GLFW.

The OpenGL version used is OpenGL 3.3.

  • On macOS, you need Xcode or Command Line Tools for Xcode (xcode-select --install) for required headers and libraries.
  • On Ubuntu/Debian-like Linux distributions, you need libgl1-mesa-dev and xorg-dev packages.
  • On CentOS/Fedora-like Linux distributions, you need libX11-devel libXcursor-devel libXrandr-devel libXinerama-devel mesa-libGL-devel libXi-devel packages.
  • See here for full details.

The combination of Go 1.8, macOS and latest XCode seems to be problematic as mentioned in issue #7. This issue is probably not related to Pixel. Upgrading to Go 1.8.1 fixes the issue.

Contributing

Pixel is in, let's say, mid-stage of development. Many of the important features are here, some are missing. That's why contributions are very important and welcome! All alone, I will be able to finish the library, but it'll take a lot of time. With your help, it'll take much less. I encourage everyone to contribute, even with just an idea. Especially welcome are issues and pull requests.

However, I won't accept everything. Pixel is being developed with thought and care. Each component was designed and re-designed multiple times. Code and API quality is very important here. API is focused on simplicity and expressiveness.

When contributing, keep these goals in mind. It doesn't mean that I'll only accept perfect pull requests. It just means that I might not like your idea. Or that your pull requests could need some rewriting. That's perfectly fine, don't let it put you off. In the end, we'll just end up with a better result.

Take a look at CONTRIBUTING.md for further information.

For any kind of discussion, feel free to use our Gitter community.

License

MIT

You can’t perform that action at this time.