PistonDevelopers/ Piston-Tutorials
Need help with Piston-Tutorials?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.
About the developer
448 Stars 
80 Forks 
400 Commits 
24 Opened issues 
Description
Tutorials for Piston
Services available
Contributors list
Readme
Piston-Tutorials 
This is a repository for examples of Piston projects that have are accompanied by written tutorials explaining core concepts for that tutorial.
Current Tutorials
Getting Started Spinning Square
A "tutorial" with instructions on compiling and running a very simple Piston.
Sudoku (work in progress)
Write a Sudoku game with Piston.
Roguelike (work in progess)
Write a Roguelike game with Piston.
Planned Tutorials
- graphics
- piston
Troubleshooting
ld: library not found for -lSDL2
error on OSXI get "GL context creation failed" when running an example.
It's likely your hardware or driver doesn't support PistonWindow's default OpenGl spec. Just change it to something you can support at the beginning of the example. See hello_world.rs for an example.
Making changes to the tutorials
Because most of the tutorials will contain heavy amounts of code, TyOverby developed a markdown pre-processor that takes
readme.dev.mdfiles and includes code from the surrounding project. This way you don't need to make a change in the code for the tutorial and then also make the same change in the readme.md file; the preprocessor will do that for you!
In order to run the pre-processor, simply invoke
cargo runfrom the root directory (not the sub-tutorial directory) and it will rebuild all the markdown files that it knows about.