The HOMEbrew Menu Standard Library

From WiiBrew
Jump to navigation Jump to search
The HOMEbrew Menu Standard Library
General
Author(s)Arikado, Pinball Wizard, WarpedFlash, TheLemonMan
TypeLibrary
VersionInitial Release
Links
[See page for Download]
[See Page for Source]

The HOMEbrew Menu Standard Library is a simple code library that allows developers to easily incorporate a HOME menu similar to Nintendos' into their applications.

Download

Libwiisprite

The HOMEbrew Menu Standard Library Compiled - Download

The HOMEbrew Menu Standard Library Source - Download

Demonstration Application - Download

Demonstration Application Source - Download

ftImage library Download

GRRLIB

The HOMEbrew Menu Standard Library Compiled - Download

The HOMEbrew Menu Standard Library Source - Download

Demonstration Application - Download

Demonstration Application Source - Download

Miscellaneous

Extra Artwork/Data Pack (Includes International Artwork) - Download

Extra Artwork/Data Pack (Only English) by InfernoZeus - Download

  • Examples: Homebrew-menu-Shutdown-InfernoZeus.png Homebrew-Menu-Syncimage1-InfernoZeus.png

Screenshots

NOTE: You can easily swap out the artwork to make either version look like the other.

The Main Features of the Library

  • Allows the user to return to the loader or the system menu
  • Allows the user to reset or shutdown his/her Wii
  • Displays sprites for up to 4 connected wiimotes
  • Displays which wiimotes are synced to the Wii
  • Displays if the balance board is synced to the Wii
  • Open Source

Incorporating the library into your programs

Arikado's Notes for the libwiisprite version

  1. Place libhbmenu.a into your libs folder (which should be somewhere in your devkitPRO directory)
  2. Place hbmenuhead.h into your include folder (which should be somewhere in your devkitPRO directory)
  3. Add the line -lhbmenu in your makefile under LIBS:
  4. Add the line #include <hbmenuhead.h> wherever necessary in your code.
  5. Place the artwork into your project's data folder and place a rule for compiling .pngs into buffers in your makefile or just include the provided build files into your projects build folder.

TheLemonMan's Notes for the GRRLIB version

As always it comes another good release from The Lemon Man, kudos to Arikado who wrote this lib.

To know how the port works just check the example and because of the static linking of GRRLIB into the library you need to build your project against the same version (you can find it into the library source). Also if you want to replace graphic be sure that the size is a multiple of 4.

---Problem with the "Vector" symbol with GRRLIB v4.3.1 (possibly earlier, and probably later) It appears TheLemonMan's source was written for a previous version of GRRLIB which used the "Vector" symbol. This must be updated to the "guVector" symbol in order to compile with at least GRRLIB v4.3.1. Also, the binaries provided won't link correctly under *nix, it is suggested you adjust the file name and linker options in the Makefile accordingly.

Ports

At the moment, The HOMEbrew Menu Standard Library is only compatible with programs that use Libwiisprite or GRRLIB. However, a couple ports are underway in order to widen compatibility for developers. If you would like to do a port, it would be appreciated if you say so before you do the port, so that the authors (and users) know that the port is underway.

MLIB

libwiigui

LibPNG Only

LibJPG Only

Unofficial Versions

Place all unofficial of the library here. Unofficial versions will only become official versions only if the original authors decide to make your version the next official version. All unofficial versions must be released open source in order to have a chance at becoming the next official version.


This is not a compiled version, but it is a point of concept moving artwork. (you need java enabled) Link: Here

Legal Stuff

Please be sure to credit the original authors in any unofficial versions of the library you make. You do not have to credit the original authors if you use the library in one of your public programs. However, you may do so if you would like to. Having said that, we would really appreciate if you at least mention that your program uses our library.

Credits

Original concept and design by Pinball Wizard

Artwork by WarpedFlash

Hand Artwork done by drmr.

Coding by Arikado

Special thanks to Tantric for giving linking assistance to Arikado

GRRLIB version made by TheLemonMan

Donations

You can donate to Arikado using the ChipIn widget on his blog : http://arikadosblog.blogspot.com

You can donate to other members of the project by contacting them privately.