View source for GRRLIB

{{Infobox development tools
| title       = GRRLIB
| image       = [[File:GRRLIB_GX_Logo.png|200px]]
| type        = framework library
| author      = [[User:NoNameNo|NoNameNo]]
| contributor = Numerous
| version     = 4.3.2
| licence     = MIT Licence
| download    = https://github.com/GRRLIB/GRRLIB/releases/latest
| source      = https://github.com/GRRLIB/GRRLIB
| website     = http://grrlib.santo.fr/wiki/
| discussion  = http://grrlib.santo.fr/forum/
}}
'''GRRLIB''' is a C/C++ 2D/3D graphics library for Wii application developers. It is essentially a wrapper which presents a friendly interface to the Nintendo GX core. With it, coders can quickly and easily start creating graphical applications.

GRRLIB is supplied as a standard C/C++ library (aka. archive) called 'libgrrlib'. Because GRRLIB processes JPEG and PNG images, it requires the installation of the 'libjpeg' and 'libpngu' libraries. 'libpngu', in turn, requires 'libpng' and 'libpng' requires 'libz'. GRRLIB also has FileIO functions to allow real-time loading and saving of graphical data, and thus also requires '[[libfat]]'. GRRLIB also has the possibility to use TrueType fonts, so 'libfreetype' is also required.


There are currently [[:Category:Homebrew using GRRLib|{{PAGESINCATEGORY:Homebrew using GRRLib}} applications]] using GRRLIB.

Help can be found on the forum or in {{EFnet|grrlib}}.

== Update History ==

=== 4.3.2 - August 12, 2012 ===
* libpng was updated to version 1.5.12
* zlib was updated to version 1.2.7
* libjpeg was updated to version 8d
* FreeType updated to version 2.4.10
* GRRLIB_ClampVar8 was removed from GRRLIB
* Removed warnings from GRRLIB_LoadBMF

=== 4.3.1 - October 23, 2010 ===
* libpng was updated to version 1.4.4
* FreeType updated to version 2.4.3
* GRRLIB is compatible with libogc 1.8.4

=== 4.3.0 - June 28, 2010 ===
* libpng was updated to version 1.4.2
* libjpeg was updated to version 8b
* zlib was updated to version 1.2.5
* FreeType 2.3.12 support (first support)
* 3D primitive drawing: torus, sphere, cube, cylinder and cone
* Light functions (diffuse, specular, spot) + ambient
* Splitted functions for rotation/translation/scaling 3d object.
*Here is the list a new added samples demo code :
**3d_light1 -> Simple Diffuse light sample code
**3d_light2 -> Simple Lights and GRRLIB_ObjectViewInv sample
**3d_light3 -> A little Specular light sample code
**3d_light4 -> Spot Light Sample Code
**3D_sample5 -> Simple demo of  rotation/translation/scaling 3d object.
**ttf -> TrueType Font demo

=== 4.2.0 - December 16, 2009 ===
* First support to 3D functions
* GRRLIB_CompoStart and GRRLIB_CompoEnd for real GX compositing with transparency support
* GRRLIB_Screen2Texture is now fully optimized
* USB_Gecko output facilities
* GRRLIB_Compose was deleted since it was not fully using GX
* GRRLIB_GetColor was deleted, the RGBA macro should be used instead
* Lot of new sample code :
** 3D_CubedTileDemo (How to use dynamic texturing)
** 3D_sample1 (A simple rotating flat cube)
** 3D_sample2 (A simple rotating textured cube)
** 3D_sample3 (A textured cube and compositing)
** 3D_sample4 (A complex object rotating)
** basic_drawing (How to use some basic GRRLIB functions)
** bitmap_fx (Effects ShowRoom)
** blending (How to use blending mode)
** compositing (A simple compositing how to)
** funsin (A gradient sinusoid dancing)
** particle (A nice particle sample code)
** template (Use this as a basis for your project)
** TileDemo (This will show you how to use tiles/tileset and map)
** unlimited2d (A faky technic for unlimited sprites)
** unlimited3d (Same as above but with 3D)

=== 4.1.1 - November 24, 2009 ===
* Fully compatible with devkitPro release 18 and 19 (code and examples)
* libpng was updated to version 1.2.40
* Support for MS-Windows Bitmap format uncompressed (1-bit, 4-bit, 8-bit, 24-bit and 32-bit)
* New function called GRRLIB_DrawPart to draw a specific part of a texture
* Extra parameters to GRRLIB_Screen2Texture
* Video is now initialized even without a SD card
* Fixed a problem with scaling images
* Documentation improvement

=== 4.1.0 - October 5, 2009 ===
* Completely new file structure with sub-folders:
    libgrrlib          <- 2D graphics library
    +-- libfat         <- File I/O
    +-- libjpeg        <- JPEG image processor
    +-- libpngu        <- Wii wrapper for libpng
        +-- libpng     <- PNG image processor
            +-- libz   <- Zip (lossless) compression (for PNG compression)
* Installer for vendor libraries (jpeg, png, pngu)
* Makefile for GRRLIB
* Many (all suitable) functions are now inlined
* Support for the recent changes to libogc
* Alpha compositor function added
* Correct use of pointers (no more struct passing)
* Speed improvement, bug fixing and more...

=== 4.0.0 - March 5, 2009 ===
* Color format changed for ALL GRRLib functions (now its RGBA) to fit to GX_Color format and use GX_Color1u32
* GRRLIB_LoadTexture now Auto Detect PNG or JPEG
* GRRLib introduce a new texture structure (easier to handle texture width, height, etc ...)
* add void GRRLIB_InitTileSet(struct GRRLIB_texImg *tex, unsigned int tilew, unsigned int tileh, unsigned int tilestart);
* GRRLIB_DrawImg recoded for simpler use
* GRRLIB_DrawTile recoded for simpler use
* InitVideo() and GRRLIB_Start() merge into GRRLIB_Init().
* add GRRLIB_PtInRect, GRRLIB_RectInRect and GRRLIB_RectOnRect. (to detect hot zone)
* GRRLIB_GetPixelFromtexImg and GRRLIB_SetPixelTotexImg (to directly read/write in texture)
* GRRLIB_CreateEmptyTexture and GRRLIB_FlushTex
* New Bitmap FX
* add GRRLIB_Exit to free the memory allocated by GRRLIB

== Sample Code included in GRRLIB releases ==
{|
|<youtube width="425" height="265">f7tR9BPBCuU</youtube>
|<youtube width="425" height="265">Tb8wJYf3e3Q</youtube>
|-
|<youtube width="425" height="265">TLox2nqlBLo</youtube>
|<youtube width="425" height="265">_cuOdd0383g</youtube>
|-
|<youtube width="425" height="265">Sedo1s0Zh5E</youtube>
|<youtube width="425" height="265">dxCE-65p9uA</youtube>
|-
|<youtube width="425" height="265">Z03L3kOKwDE</youtube>
|<youtube width="425" height="265">o5DleSg8lpI</youtube>
|-
|<youtube width="425" height="265">1a7pU7GaYww</youtube>
|<youtube width="425" height="265">Fl6uX-lfAjw</youtube>
|-
|<youtube width="425" height="265">PlPdVqYZZ_g</youtube>
|<youtube width="425" height="265">EtB7QJ6EIFI</youtube>
|-
|<youtube width="425" height="265">ELESkRaUzUs</youtube>
|<youtube width="425" height="265">3TS0hwXJ6QQ</youtube>
|-
|<youtube width="425" height="265">RbHzAFiCf7A</youtube>
|<youtube width="425" height="265">8G4UwioHUkw</youtube>
|-
|<youtube width="425" height="265">ZJ0nHdrzhFg</youtube>
|<youtube width="425" height="265">kvbS30xfqGQ</youtube>
|-
|<youtube width="425" height="265">-_8m_BHMJV8</youtube>
|<youtube width="425" height="265">fi0CuLYMwxQ</youtube>
|}
== Little Promotion Demos ==
{|
|<youtube width="425" height="265">JmuHFjdad-E</youtube>
|<youtube width="425" height="265">ZzfIyjGafLQ</youtube>
|-
|<youtube width="425" height="265">zqnfM488D7E</youtube>
|<youtube width="425" height="265">9BS90PMu5Ik</youtube>
|}

== Credits ==
'''Programming'''<br />
:[[User:NoNameNo|NoNameNo]], [[User:Crayon|Crayon]], [[User:Xane|Xane]], [[User:DragonMinded|DragonMinded]], [[User:BlueChip|BlueChip]], [[User:elisherer|elisherer]]

'''Documentation'''<br />
:[[User:Crayon|Crayon]], [[User:BlueChip|BlueChip]]

'''Advising'''<br />
:[[User:RedShade|RedShade]], [[User:Jespa|Jespa]]

== Tools ==
* [[WiiBuilder]] is software for Windows that help you with image conversion/generation and more.

[[Category:Libraries]]