Libwiisprite

libwiisprite
General
Author(s)	Chaosteil, Feesh!
Type	Development
Version	0.2.0
Links
[[Here|Download]]
Source

libwiisprite is a new sprite library which uses GX as its underlying rendering engine.

About

libwiisprite is a C++ sprite library written for the Wii which utilises GX for all its graphical operations, meaning the GPU is used to accelerate graphics.

libwiisprite aims to make developing Wii homebrew simple and fun with better graphical results than currently existing libraries.

libwiisprite is currently under heavy development, but this version is a semi-stable version allowing most of the proposed functionality of the library.

Currently 24bit and 32bit PNGs are the only supported image format. We are working on allowing images to be loaded from compiled-in texture data and even more formats.

The library comes with full Doxygen documentation to help get development started. It is also available online:

• http://feesh.braingravy.co.uk/libwiisprite/

Sample Application (Video)

A simple demonstration of basic libwiisprites capabilities:

• http://www.youtube.com/watch?v=rTphJHQI_Mo (This is an old version of the Invaders example. Try out the new one in the package!)

Download & Installation

You can download the library from

• http://chaosteil.googlepages.com/libwiisprite-0.2.0.tar.gz

Please refer to the README.TXT for installation instructions.

New Stuff

0.2.0 - We put a lot of effort and polish into this release, so we hope you will enjoy it as much as we enjoyed making it!

• Quad was added as an additional Layer-based class to use. You can now draw colored rectangles without textures.
• TiledLayer now supports transparency.
• Sprites can now get stretched with SetStretchWidth() and SetStretchHeight(). Check out the documentation for further instructions.
• You can get information about the current position of the sequence in a Sprite with GetFrameSequencePos().
• Frame sequences in Sprites now can get actually longer than the image has tiles.
• Layer got additional SetX() and SetY() methods for quicker position setting of one axis.
• LayerManagers now can erase their Layer list with RemoveAll().
• Bilinear filtering for textures can be turned off now. Look up the texture transformation enumeration for sprites.
• Fixed showing up of a green bar on startup.
• Squished out several small bugs to enhance stability. Also possible performance increase.
• Image.LoadImage() now returns an error code when loading an image with the wrong format.
• Loading of 24bit PNGs is also possible now.
• Complete compatibility with the previous version. Your code should work out of the box with no changes at all.
• There is now a Makefile for installing libwiisprite to your appropriate folders. Check RELEASE.TXT for further information.
• Documentation is more complete. There are several pages which explain the more "advanced" features of the library.
• All of the examples got updated. We also added an template example.

0.1.9

• This is mainly a bugfix release, no new features included. You may need to update your sources to correctly use the display now. The examples also got updated.
• Added a wrong size check to image loading errors. Image width and height have to be a multiple of 4.
• The whole screen estate is used. Pointer correction is also explained in the spritetest example.
• LayerManager.SetViewWindow() fixed. Displays correctly now.
• Fixed TiledLayer displaying (last version crashed GX) and collision detecting with sprites.
• Now doing more checks throughout the code.

Bugs, Suggestions

If you find a bug or have a suggestion (maybe a tutorial to add to the library) please send an e-mail to chaosteil [at} gmail [dot} com or gummybassist [at} gmail [dot} com or if you are on an EFNet server, PM Chaosteil or feesh.