In memory of Ben “bushing” Byer, who passed away on Monday, February 8th, 2016.

Difference between revisions of "The HOMEbrew Menu Standard Library"

From WiiBrew
Jump to navigation Jump to search
(Pulling off donations link)
m (Robot: Cosmetic changes)
Line 11: Line 11:
 
'''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.
 
'''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 21: 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===
+
=== 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 30: Line 30:
 
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: [[Image:Homebrew-menu-Shutdown-InfernoZeus.png‎|48px]] [[Image:Homebrew-Menu-Syncimage1-InfernoZeus.png‎|32px]]
+
* Examples: [[File:Homebrew-menu-Shutdown-InfernoZeus.png‎|48px]] [[File:Homebrew-Menu-Syncimage1-InfernoZeus.png‎|32px]]
  
==Screenshots==
+
== Screenshots ==
 
<gallery widths="300px" heights="225px">
 
<gallery widths="300px" heights="225px">
 
Image:HBMenuScreen.jpg|Screenshot for Libwiisprite version
 
Image:HBMenuScreen.jpg|Screenshot for Libwiisprite version
Line 45: Line 45:
 
'''NOTE:''' You can easily swap out the artwork to make either version look like the other.
 
'''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 53: Line 53:
 
*Open Source  
 
*Open Source  
  
==Incorporating the library into your programs==
+
== Incorporating the library into your programs ==
===Arikado's Notes for the libwiisprite version===
+
=== 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 61: Line 61:
 
#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===
+
=== 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==
+
== 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.
 
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===
+
=== MLIB ===
  
===libwiigui===
+
=== libwiigui ===
  
===LibPNG Only===
+
=== LibPNG Only ===
  
===LibJPG Only===
+
=== LibJPG Only ===
  
==Unofficial Versions==
+
== 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 84: Line 84:
 
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 99: Line 99:
  
 
GRRLIB version made by [[User:The_Lemon_Man|TheLemonMan]]
 
GRRLIB version made by [[User:The_Lemon_Man|TheLemonMan]]
 
[[Category:Libraries]] [[Category:Homebrew using libwiisprite]] [[Category:Homebrew using GRRLib]]
 
[[Category:HOME Button Libraries]]
 
 
 
<!--
 
<!--
  
Line 110: Line 106:
  
 
-->
 
-->
 +
 +
[[Category:Libraries]]
 +
[[Category:Homebrew using libwiisprite]]
 +
[[Category:Homebrew using GRRLib]]
 +
[[Category:HOME Button Libraries]]

Revision as of 18:20, 10 August 2009

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

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.

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