GRRLib Forum / New version ready for testing & deployment

BlueChip · 2009-08-01 00:37:57

As of SVN rev 118 the lib-conversion branch is finished and ready for testing prior to deployment.

Key changes:
GRRLIB compiles to a proper C Library
jpeglib has got some bug fixes not available in the official release
Installer for vendor libraries (jpeg, png, pngu)
makefile for GRRLIB
many (all suitable) functions are now (correcly) inlined

Other changes
"GRRLIB" has been dropped to lower case in a couple of places to conform to the C naming convention
Alpha compositor function added
Alpha compositor example added

These notes assume you are using windows and have checked out branches/lib-conversion to c:\grr
Furthermore I'm going to presume that if you are a linux user you are able to translate the following windows commands:

To install the *bugfixed* jpeg library:
c:
cd \grr\GRRLIB\lib\jpeg
make install

To install the png library:
c:
cd \grr\GRRLIB\lib\png
make install

To install the pngu library:
...first install the png library, then...
c:
cd \grr\GRRLIB\lib\joeg
make clean
make all
make install

***NOTE***: you can install all three vendor libraries with:
c:
cd \grr\GRRLIB\lib
install
^^There is an install.bat for windows & an install.sh for linux

To install the (new) GRRLIB library:
...first install the jpeg, png & pngu libraries, then...
c:
cd \grr\GRRLIB\GRRLIB
make clean
make all
make install

You can now make sure everything is working fine with:
c:
cd \grr\examples\composition
make clean
make all
make run

After this has been ratified and absorbed in to trunk I will add the new functions from the contribution area of the forum

Enjoy,

BC

Last edited by BlueChip (2009-08-02 14:28:21)

BlueChip · 2009-08-01 00:43:22

Sorry, forgot to say.

After everything is installed, simply put
#include <grrlib.h>
at the top of your .c file and use the functions as normal

You will also need to add
-lgrrlib -lpngu -lpng -ljpeg -lz
to the libs line in your makefile
(grrlib implies pngu & jpeg ...pngu implies png ...png implies zip)

For a simple example of this [and a much more readable makefile than that supplied with devkitpro] see the composition example

BC

BlueChip · 2009-08-06 02:24:41

*** Temporary fix ***
After the release of libogc v1.7.1a, Vector was renamed to guVector "to avoid collisions" [svn 3650]
...also Quaternion was renamed to guQuaternion - but GRRLIB does not use these!

The main codebase of GRRLIB has been updated to reflect this change.
But until the new libogc is officially released, if you are using a version of libogc later than v1.7.1a/svn3649, you will need to add:
-DNOGUFIX
to the compiler flags in your makefile

When the libogc changes are officially released, this *temporary fix* should be removed [see grrlib.h, line 50ish]
The requirement for -DNOGUFIX will be deprecated, but its lingering presence will not be a hinderance

Thanks to Nicksasa for reporting this problem

BC

#1 2009-08-01 00:37:57

New version ready for testing & deployment

#2 2009-08-01 00:43:22

Re: New version ready for testing & deployment

#3 2009-08-06 02:24:41

Re: New version ready for testing & deployment

Board footer