Difference between revisions of "The HOMEbrew Menu Standard Library"
m (spelling fix) |
|||
| (21 intermediate revisions by 7 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | {{Infobox development tools | |
| − | |||
| − | {{Infobox | ||
| image = | | image = | ||
| title = The HOMEbrew Menu Standard Library | | title = The HOMEbrew Menu Standard Library | ||
| − | + | | type = library | |
| − | | type = | ||
| author = [[User:Arikado|Arikado]], [[User:pinball_wizard|Pinball Wizard]], [[User:Warpedflash|WarpedFlash]], [[User:The_Lemon_Man|TheLemonMan]] | | author = [[User:Arikado|Arikado]], [[User:pinball_wizard|Pinball Wizard]], [[User:Warpedflash|WarpedFlash]], [[User:The_Lemon_Man|TheLemonMan]] | ||
| version = Initial Release | | version = Initial Release | ||
| − | | download = | + | | download = See page for |
| − | | source = | + | | source = See Page for |
}} | }} | ||
| + | '''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 == | |
| − | ==Download== | + | === Libwiisprite === |
| − | ===Libwiisprite=== | ||
The HOMEbrew Menu Standard Library Compiled - [http://www.mediafire.com/download.php?zd1j0jmokzy Download] | The HOMEbrew Menu Standard Library Compiled - [http://www.mediafire.com/download.php?zd1j0jmokzy Download] | ||
| Line 24: | Line 21: | ||
Demonstration Application Source - [http://www.mediafire.com/download.php?41kmnrz2qbw Download] | Demonstration Application Source - [http://www.mediafire.com/download.php?41kmnrz2qbw Download] | ||
| − | ===GRRLIB=== | + | ftImage library [http://www.mediafire.com/download.php?nj22hjz2znh Download] |
| + | |||
| + | === GRRLIB === | ||
The HOMEbrew Menu Standard Library Compiled - [http://www.mediafire.com/?lgyjj2xczd2 Download] | The HOMEbrew Menu Standard Library Compiled - [http://www.mediafire.com/?lgyjj2xczd2 Download] | ||
| Line 33: | Line 32: | ||
Demonstration Application Source - [http://www.mediafire.com/?ktith4bvgjx Download] | Demonstration Application Source - [http://www.mediafire.com/?ktith4bvgjx Download] | ||
| − | ===Miscellaneous=== | + | === Miscellaneous === |
Extra Artwork/Data Pack (Includes International Artwork) - [http://warpedflash.com/data.zip Download] | Extra Artwork/Data Pack (Includes International Artwork) - [http://warpedflash.com/data.zip Download] | ||
Extra Artwork/Data Pack (Only English) by InfernoZeus - [http://benfxm.com/data.rar Download] | Extra Artwork/Data Pack (Only English) by InfernoZeus - [http://benfxm.com/data.rar Download] | ||
| − | * Examples: [[ | + | * Examples: [[File:Homebrew-menu-Shutdown-InfernoZeus.png|48px]] [[File:Homebrew-Menu-Syncimage1-InfernoZeus.png|32px]] |
| + | |||
| + | == Screenshots == | ||
| + | <gallery widths="300px" heights="225px"> | ||
| + | Image:HBMenuScreen.jpg|Screenshot for Libwiisprite version | ||
| + | Image:HOMEbrew Menu GRRLIB Screen.jpg|Screenshot for GRRLIB version | ||
| + | </gallery> | ||
| + | |||
| + | '''NOTE:''' You can easily swap out the artwork to make either version look like the other. | ||
| − | ==The Main Features of the Library== | + | == The Main Features of the Library == |
*Allows the user to return to the loader or the system menu | *Allows the user to return to the loader or the system menu | ||
*Allows the user to reset or shutdown his/her Wii | *Allows the user to reset or shutdown his/her Wii | ||
| Line 48: | Line 55: | ||
*Open Source | *Open Source | ||
| − | ==Incorporating the library into your programs== | + | == Incorporating the library into your programs == |
| − | === | + | === Arikado's Notes for the libwiisprite version === |
#Place libhbmenu.a into your libs folder (which should be somewhere in your devkitPRO directory) | #Place libhbmenu.a into your libs folder (which should be somewhere in your devkitPRO directory) | ||
#Place hbmenuhead.h into your include folder (which should be somewhere in your devkitPRO directory) | #Place hbmenuhead.h into your include folder (which should be somewhere in your devkitPRO directory) | ||
| Line 56: | Line 63: | ||
#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. | #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. | 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. | 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. | ||
| − | ==Ports== | + | ---Problem with the "Vector" symbol with GRRLIB v4.3.1 (possibly earlier, and probably later) |
| − | At the moment, The HOMEbrew Menu Standard Library is only compatible with programs that use [[Libwiisprite]] or [[GRRLIB]]. However, | + | 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 === |
| − | ==Unofficial Versions== | + | === 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. | 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. | ||
| − | |||
| Line 76: | Line 89: | ||
Link: [http://scratch.mit.edu/projects/jceggbert5/458003 Here] | Link: [http://scratch.mit.edu/projects/jceggbert5/458003 Here] | ||
| − | ==Legal Stuff== | + | == 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. | 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 == | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | ==Credits== | ||
Original concept and design by [[User:pinball_wizard|Pinball Wizard]] | Original concept and design by [[User:pinball_wizard|Pinball Wizard]] | ||
| Line 96: | Line 104: | ||
GRRLIB version made by [[User:The_Lemon_Man|TheLemonMan]] | GRRLIB version made by [[User:The_Lemon_Man|TheLemonMan]] | ||
| + | <!-- | ||
| + | |||
| + | ================================================== | ||
| + | Anyone who has contributed something to this library is free to add their own donation links below!!! | ||
| + | ================================================= | ||
| + | |||
| + | --> | ||
| + | |||
| + | == Donations == | ||
| + | You can donate to [[User:Arikado|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. | ||
| − | [[Category:Libraries]] [[Category:Homebrew using libwiisprite]] [[Category:Homebrew using GRRLib]] | + | [[Category:Libraries]] |
| + | [[Category:Homebrew using libwiisprite]] | ||
| + | [[Category:Homebrew using GRRLib]] | ||
| + | [[Category:HOME Button Libraries]] | ||
Latest revision as of 22:59, 4 January 2011
| The HOMEbrew Menu Standard Library | |
| General | |
|---|---|
| Author(s) | Arikado, Pinball Wizard, WarpedFlash, TheLemonMan |
| Type | Library |
| Version | Initial 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:
Screenshots
Screenshot for Libwiisprite version
Screenshot for GRRLIB version
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
- Place libhbmenu.a into your libs folder (which should be somewhere in your devkitPRO directory)
- Place hbmenuhead.h into your include folder (which should be somewhere in your devkitPRO directory)
- Add the line -lhbmenu in your makefile under LIBS:
- Add the line #include <hbmenuhead.h> wherever necessary in your code.
- 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.