From 83b327e7f969a0a26d0dd7c2300b2d0e1e2630f0 Mon Sep 17 00:00:00 2001 From: csBlueChip Date: Fri, 14 Aug 2009 23:33:01 +0000 Subject: [PATCH] [ADD] Added GRRLIB.html "readme"/new-user-documentation --- GRRLIB.html | 191 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 191 insertions(+) create mode 100644 GRRLIB.html diff --git a/GRRLIB.html b/GRRLIB.html new file mode 100644 index 0000000..f053d28 --- /dev/null +++ b/GRRLIB.html @@ -0,0 +1,191 @@ +
+ +
+

+Introduction
+------------
+
+GRRLIB is a C/C++ 2D Graphics library for Wii application developers.  It is
+essentially a wrapper which presents a friendly interface to the Nintendo GX
+core.
+
+As of v4.10., 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'.
+
+libgrrlib          <- 2D graphics library
++-- libjpeg        <- JPEG image processor
++-- libpngu        <- Wii wrapper for libpng
+    +-- libpng     <- PNG image processor
+        +-- libz   <- Zip (lossless) compsression (for PNG compression)
+
+
+Developing for the Wii
+----------------------
+
+Do not progress until you have installed and configured devkitPro.  Guides are
+and assistance are available at http://forums.devkitpro.org
+
+If you have just performed a clean (re)install on your Windows PC, be sure to
+reboot before you continue.
+
+
+Downloading GRRLIB
+------------------
+
+You are advised to use "the latest SVN trunk version" of GRRLIB at all times.
+There is a simple guide to "Using SVN" here:
+http://grrlib.santo.fr/forum/viewtopic.php?id=182
+
+This document will presume that you have downloaded "the latest SVN trunk
+version" to a directory called  C:\grr\trunk
+
+Installing GRRLIB
+-----------------
+
+This guide is for Windows.  If you are using Linux, I am going to presume you
+are smart enough to convert these instructions.
+
+GRRLIB  is supplied as source code.
+libjpeg is supplied as a precompiled library.*
+libpngu is supplied as source code
+libpng  is supplied as a precompiled library
+libz    is supplied with devkitpro (Ie. preinstalled)
+
+*The version of libjpeg supplied with GRRLIB v4.1.0 contains bug fixes not
+available in the official release.  If you can track down the original author,
+please tell him about these fixes.
+
+Because of the way dependancies work, the libraries must be installed in reverse
+order.
+
+libz comes preinstalled with devkitPro, so we can move directly to libpng...
+
+To install libpng
+  c:
+  cd \grr\trunk\GRRLIB\lib\png
+  make install
+
+Next up the list is libpngu
+  c:
+  cd \grr\trunk\GRRLIB\lib\pngu
+  make clean
+  make all
+  make install
+
+Next up the list is libjpeg*
+  c:
+  cd \grr\trunk\GRRLIB\lib\jpeg
+  make install
+
+*The version of libjpeg supplied with GRRLIB v4.1.0 contains bug fixes not
+ available in the official release.
+
+Finally, we can now install libgrrlib
+  c:
+  cd \grr\trunk\GRRLIB\GRRLIB
+  make clean
+  make all
+  make install
+
+
+Using GRRLIB
+------------
+
+After everything is installed, simply put
+    #include 
+at the top of your .c file and use the functions as required
+
+You will also need to add
+    -lgrrlib -ljpeg -lpngu -lpng -lz
+to the libs line in your makefile
+...Remember the order of the libraries is critical.  You may (need to) insert
+other libraries in the middle of the list, you may need to add others to the
+start, or even the end - but do _not_ change the order of the libraries shown
+here.
+
+You do NOT need to placce /anything/ in your application directory.
+
+If you would like to see a working example of this, you can look at the example
+found in: C:\grr\trunk\examples\bluechip\composition
+...This example also includes a "Makefile" which tries to make it clear what is
+happening (unlike the more comprehensive cross-platform Makefile supplied with
+the devkitPro template application).
+
+
+Error: guVector redefined
+-------------------------
+
+If you get this error, you are probably using a version of libogc more recent
+than the released v1.7.1a.
+
+In the libogc SVN revision 3650 Vector was renamed to guVector "to avoid
+collisions"  ...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 (CFLAGS) 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
+
+
+Credits
+-------
+
+Project Leader : NoNameNo
+Documentation  : Crayon
+Lead Coder     : NoNameNo,
+Support Coders : BlueChip, DragonMinded, Xane
+Advisors       : RedShade
+
+
+Licence
+-------
+
+GRRLIB is released under the MIT Licence.  If we had chosen the GPL licence you
+would be +forced+ (legally required) to release your source code.  But in the
+spirit of "free as in FREE" we have left you with the +option+ to release your
+source code.
+
+We do request that you tell others about us by naming our library (GRRLIB) in
+the credits of your game/application.  And, if you choose to do that, we
+encourage you to use our logo to achieve it; You can find our logo here:
+C:\grr\trunk\grrlib_logo.png
+and here:
+http://grrlib.santo.fr/wiki/images/logo.png
+
+This is the official license text
+--------------------------------------------------------------------------------
+Copyright (c) 2009 The GRRLIB Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+--------------------------------------------------------------------------------
+
+[BlueChip]
+
+