WoopsiGfx --------- WoopsiGfx is a C++ 2D graphics library for the Nintendo DS, derived from the Woopsi GUI framework. It allows the developer to create and manipulate bitmaps using a comprehensive set of drawing tools. It includes an extensible font system for drawing text to bitmaps, and features support for packed monochrome and 16-bit fonts out of the box. WoopsiGfx can also be used to draw directly to the DS' VRAM. This is useful when the DS is in MODE_FB0 or MODE_5_2D. Features -------- - Extensible font system that supports compressed proportional and fixed-width fonts (monochrome and 16-bit); - Animation class with support for variable framerates and standard/pingpong looping; - Bitmap class for 16-bit bitmap image manipulation; - BufferedBitmap class that can restore itself to a previous state, undoing drawing operations; - Graphics class providing clipped, DMA-accelerated drawing functions: - Pixels; - Lines; - Filled and unfilled rectangles; - Filled and unfilled ellipses; - XOR horizontal/vertical lines, pixels, rectangles and filled rectangles; - Bitmap blitting; - Bitmap blitting with transparent colour key; - Bitmap blitting in greyscale; - Flood fill; - Region scrolling; - Region copying; - Region dimming; - Region conversion to greyscale; - Text rendering. - Dynamic array container and iterator classes. - Object-orientated design for easy integration into other C++ software; - Simple API; - Unicode strings encoded with UTF-8; - Compatible with Woopsi font tools. Requirements ------------ To compile the project you need devKitARM. Installation ------------ Create a new directory called "libwoopsigfx" in your devkitPro directory. In Windows, for example, this would typically be "C:\devkitPro". Copy the "icon", "lib" and "include" directories from this archive into the new directory. In Windows, you will end up with the following directory structure: C:\devkitPro\libwoopsigfx\icon C:\devkitPro\libwoopsigfx\include C:\devkitPro\libwoopsigfx\lib Alternatively, if you have installed devKitPro to the default directory (C:\devkitPro in Windows, or /opt/devkitpro in Linux/OSX), you can run the deploy script in the libwoopsigfx folder of this archive. Windows users should double-click the "deploy.bat" file. Linux/OSX users should open a shell, navigate to the libwoopsigfx folder, and run "sudo bash deploy.sh". Type in your password when prompted. These scripts will copy the necessary files automatically. Once you've done installed WoopsiGfx, you can test the installation by trying to compile the "simplepicture" example project in the "tests" folder of this archive. Open a shell, navigate to its directory, and type "make". If this successfully produces a ROM file then the installation worked. Credits and Acknowledgements --------------------------- - Coding and design - Antony Dzeryn - Packed font classes - Jeff Laing - PALib independence - Steven Harrison - Unicode work - Olivier Binda - Simian Zombie logo - John Clay Links ----- - http://simianzombie.com - Development blog Email ----- Contact me at firstname.lastname@example.org.