The latest version is attached at the bottom of this post.





What is GrayLib? GrayLib is an Axe library, designed for Axe 1.2.1, to provide nearly perfect grayscale and tons of useful related functions to Axe programmers with extensive customizability.

• Tunable crystal timer-based grayscale for non-83+ calculators. Nearly perfect!
• Tunable slower hardware-timer based grayscale as a fallback for 83+ calculators. Still looks very good!
• Supports either 3-level or 4-level grayscale.
• A buffered approach to avoid any frame mixing when rendering new frames.
• Automatic setting loading and saving from/to an archived variable.
• Includes a default contrast and grayscale timing tuner which can automatically start on the first run.
• Masked sprite drawing for both 3- and 4-level grayscale. (Axe's built-in Pt-Mask() command can only draw to a set buffer pair, which is no good for a buffered approach)
• Text routines to print integers, tokens, strings, and characters in any foreground/background grayscale color combination.
• Support for hooks in the grayscale update interrupt, which can optionally replace the default grayscale update command.
• Support for using getKey like normal, despite the OS interrupt not running.

To get a basic idea for how to use GrayLib, I have created a few example programs. One is a very basic wrapper for the default tuner, one is a screensaver-style bouncing text program, and one is a fairly complicated recreation of the movement engine from the first-generation Pokemon games, set in Pallet Town. Every example program comes in two forms: a smaller version, which contains just the code, and a larger "Commented" version. The commented versions contain detailed comments explaining exactly how each piece of the code works, and can be good resources for both learning how to use GrayLib and simply learning Axe coding approaches and tricks.




GrayLib itself also comes in a small version and a commented version. The small version is good to store on your calculator if you don't need a reference on your calculator about how to use the library. Whether or not you want to store the commented version on your calculator, THE COMMENTED VERSION IS CRUCIAL TO LEARNING THE MYRIAD OPTIONS AND COMMANDS IN GRAYLIB.



If you have any questions, comments, concerns, feature requests, or bug reports, make a post here and I (or somebody else who knows the library) will try to reply as soon as possible!



1.0 (August 31, 2013)

• Initial release.

Wait so it's written in Axe ? I thought it was an Axiom. Awesome job Runer !

Looks great Runer!

Wait, what?
That makes it even more awesome

This looks awesome! Now if I only knew how to use it...

I thanketh thee very much. Also: thanks for putting up with my badgering, I'm sorry about that.

That is beautiful. Any chance for an 8-level (or higher) version?

Okay, I made him crash forever. I tried to set the darkest contrast setting I vould get, aaaand, GTune() now crash my calc!