GameJs is a JavaScript library for writing 2D games or other interactive graphic applications for the HTML Canvas http://gamejs.org.
Its API is modeled after the successful PyGame library http://pygame.org.
If you downloaded the git version, you will have to build the GameJs JavaScript
file. Go to the GameJs directory and execute this in a unix shell or in git bash:
$ ./bin/minify-gamejs.sh
This should create a gamejs.min.js file in the GameJs home directory.
See the examples/skeleton/ directory for a minimal GameJs app. We recommend
you also use this as the scaffolding if you want to create a new game yourself.
Note that you need to run the examples via http:// (not file://)
unless you use Firefox or Safari. One trivial, cross-plattform solution to serve
a directory via http is this executable: http://code.google.com/p/mongoose/.
To wrap your own game's JavaScript files into one single file, use
./bin/minify-app.sh ./path-to-your-app/javascript/. You can also add a second argument
compress to optionally minify the resulting JS file.
This will produce one file app.min.js holding all GameJs modules as
well as your application code. You can then remove all <script> lines except
the one loading the app.min.js file.
See the GameJs Website for more help or drop us an email in the Mailing List.
Check the docs folder of your GameJs installation.
Example application can be found in the examples/ directory.
In production, an application uses a bundled JavaScript file which contains all
GameJs modules (usually called gamejs.min.js). This is what all the examples
do.
Thus if you modify the files below ./lib your changes won't show up in the
examples unless you re-bundle the files with the ./bin/minify-gamejs.sh command
We use QUnit https://github.com/jquery/qunit for the GameJs unit tests. Execute
them by opening tests/index.html.
For the JavaScript documentation system, RingoJs must be installed on your system.
This bash file will take care of rewriting the documentation into docs/api/:
$ ./bin/create-jsdoc.sh