mirror of
https://github.com/GRRLIB/GRRLIB.git
synced 2024-11-14 03:42:20 +00:00
Update documentation
* Added 'Upgrading to v4.4.0 From Previous Versions of GRRLIB' * Use * for list items instead of - * Use _ for emphasis instead of *
This commit is contained in:
parent
b360811697
commit
19b6f866e0
1 changed files with 43 additions and 57 deletions
100
README.md
100
README.md
|
@ -6,25 +6,24 @@
|
||||||
|
|
||||||
## Table of Contents
|
## Table of Contents
|
||||||
|
|
||||||
- [Introduction](#introduction)
|
* [Introduction](#introduction)
|
||||||
- ...What is it?
|
* ...What is it?
|
||||||
- [Developing for the Wii](#developing-for-the-wii)
|
* [Developing for the Wii](#developing-for-the-wii)
|
||||||
- ...How do I even start?
|
* ...How do I even start?
|
||||||
- [Downloading GRRLIB](#downloading-grrlib)
|
* [Downloading GRRLIB](#downloading-grrlib)
|
||||||
- ...Where do I get it from?
|
* ...Where do I get it from?
|
||||||
- [Installing GRRLIB](#installing-grrlib)
|
* [Installing GRRLIB](#installing-grrlib)
|
||||||
- ...How do I get it to a useable state?
|
* ...How do I get it to a useable state?
|
||||||
- [Using GRRLIB](#using-grrlib)
|
* [Using GRRLIB](#using-grrlib)
|
||||||
- ...What essentials do I need to know to get going?
|
* ...What essentials do I need to know to get going?
|
||||||
- [Upgrading to v4.1.0 From Previous Versions of GRRLIB](#upgrading-to-v410-from-previous-versions-of-grrlib)
|
* [Upgrading to v4.4.0 From Previous Versions of GRRLIB](#upgrading-to-v440-from-previous-versions-of-grrlib)
|
||||||
- ...I upgraded and now my programs won't compile properly!?
|
* ...I upgraded and now my programs won't compile properly!?
|
||||||
- [Using GitHub](#using-github)
|
* [Using GitHub](#using-github)
|
||||||
- ...What is this Git thing that the L337 devs keep talking about?
|
* ...What is this Git thing that the L337 devs keep talking about?
|
||||||
- [Credits](#credits)
|
* [Credits](#credits)
|
||||||
- ...Who do I thank for all this free stuff?
|
* ...Who do I thank for all this free stuff?
|
||||||
- [Licence](#licence)
|
* [Licence](#licence)
|
||||||
- ...When you say "free" do you actually mean something else?
|
* ...When you say "free" do you actually mean something else?
|
||||||
|
|
||||||
|
|
||||||
## Introduction
|
## Introduction
|
||||||
|
|
||||||
|
@ -49,7 +48,6 @@ libgrrlib <- 2D/3D graphics library
|
||||||
└── libfreetype <- TrueType font processor
|
└── libfreetype <- TrueType font processor
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
## Developing for the Wii
|
## Developing for the Wii
|
||||||
|
|
||||||
Do not progress until you have installed and configured devkitPro. Guides are
|
Do not progress until you have installed and configured devkitPro. Guides are
|
||||||
|
@ -58,7 +56,6 @@ and assistance are available at <https://devkitpro.org/index.php>
|
||||||
If you have just performed a clean (re)install on your Windows PC, be sure to
|
If you have just performed a clean (re)install on your Windows PC, be sure to
|
||||||
reboot before you continue.
|
reboot before you continue.
|
||||||
|
|
||||||
|
|
||||||
## Downloading GRRLIB
|
## Downloading GRRLIB
|
||||||
|
|
||||||
You are invited to use "the latest Git master version" of GRRLIB at all times.
|
You are invited to use "the latest Git master version" of GRRLIB at all times.
|
||||||
|
@ -119,7 +116,6 @@ To install libgrrlib:
|
||||||
make clean all install
|
make clean all install
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
## Using GRRLIB
|
## Using GRRLIB
|
||||||
|
|
||||||
After everything is installed, simply put
|
After everything is installed, simply put
|
||||||
|
@ -146,46 +142,38 @@ You do NOT need to place /anything/ in your application directory.
|
||||||
If you would like to see a working example of this, you can look at the example
|
If you would like to see a working example of this, you can look at the example
|
||||||
found in: C:\grr\examples\template\source
|
found in: C:\grr\examples\template\source
|
||||||
|
|
||||||
|
## Upgrading to v4.4.0 From Previous Versions of GRRLIB
|
||||||
|
|
||||||
## Upgrading to v4.1.0 From Previous Versions of GRRLIB
|
This version now uses the ported libraries for the Wii.
|
||||||
|
|
||||||
Older versions of GRRLIB, required a line such as:
|
To install them, use this command line:
|
||||||
```c
|
|
||||||
#include "../../../GRRLIB/GRRLIB/GRRLIB.h"
|
```bash
|
||||||
```
|
pacman --sync --needed --noconfirm libfat-ogc ppc-libpng ppc-freetype ppc-libjpeg-turbo
|
||||||
...to be placed at the top of each C file which uses GRRLB.
|
|
||||||
Because GRRLIB is now installed as a system library, this must be replaced with:
|
|
||||||
```c
|
|
||||||
#include <grrlib.h>
|
|
||||||
```
|
```
|
||||||
|
|
||||||
Older versions of GRRLIB required the 'GRRLIB.h' and 'GRRLIB.c" files to be
|
You will need to add $(PORTLIBS) to the LIBDIRS line in your makefile.
|
||||||
present in every project which uses GRRLIB.
|
|
||||||
Because GRRLIB is now installed as a system library, these files are no longer
|
|
||||||
required and must be erased.
|
|
||||||
*WARNING* Be careful if you have edited (either of) these files.
|
|
||||||
|
|
||||||
Older versions of GRRLIB "passed 'structs'" and therefore Textured Images were
|
Previously it could have looked like this:
|
||||||
defined with:
|
|
||||||
```c
|
```make
|
||||||
GRRLIB_texImg tex1, tex2;
|
LIBDIRS :=
|
||||||
```
|
|
||||||
Because GRRLIB now "passes 'pointers'" these definitions should be changed to:
|
|
||||||
```c
|
|
||||||
GRRLIB_texImg *tex1, *tex2;
|
|
||||||
```
|
```
|
||||||
|
|
||||||
With older versions of GRRLIB if the programmer (you) required access to the
|
Now it needs to be like this:
|
||||||
mode and frame information, you were required to add one or more of the
|
|
||||||
following three lines:
|
|
||||||
```c
|
|
||||||
extern GXRModeObj *rmode;
|
|
||||||
extern void *xfb[2];
|
|
||||||
extern u32 fb;
|
|
||||||
```
|
|
||||||
Because GRRLIB now does this for you automatically, these lines must be removed
|
|
||||||
from your code.
|
|
||||||
|
|
||||||
|
```make
|
||||||
|
LIBDIRS := $(PORTLIBS)
|
||||||
|
```
|
||||||
|
|
||||||
|
The FreeType library is now compiled with a dependency on bzip2,
|
||||||
|
so lbz2 needs to be added after lfreetype in your makefile.
|
||||||
|
|
||||||
|
For example:
|
||||||
|
|
||||||
|
```make
|
||||||
|
LIBS := -lgrrlib -lfreetype -lbz2 -lpngu -lpng -ljpeg -lz -lfat
|
||||||
|
```
|
||||||
|
|
||||||
## Using GitHub
|
## Using GitHub
|
||||||
|
|
||||||
|
@ -199,11 +187,10 @@ features.
|
||||||
To obtain the "cutting edge" codebase go to <https://github.com/GRRLIB/GRRLIB/tree/master>
|
To obtain the "cutting edge" codebase go to <https://github.com/GRRLIB/GRRLIB/tree/master>
|
||||||
|
|
||||||
1. Create a directory to hold the code (e.g. C:\grr)
|
1. Create a directory to hold the code (e.g. C:\grr)
|
||||||
2. Click the *Download ZIP* button if you don't have the proper tools installed on your PC or Clone the following URL <https://github.com/GRRLIB/GRRLIB.git>
|
2. Click the _Download ZIP_ button if you don't have the proper tools installed on your PC or Clone the following URL <https://github.com/GRRLIB/GRRLIB.git>
|
||||||
|
|
||||||
All official releases can be found here <https://github.com/GRRLIB/GRRLIB/releases>
|
All official releases can be found here <https://github.com/GRRLIB/GRRLIB/releases>
|
||||||
|
|
||||||
|
|
||||||
## Credits
|
## Credits
|
||||||
|
|
||||||
### Project Leader
|
### Project Leader
|
||||||
|
@ -227,7 +214,6 @@ All official releases can be found here <https://github.com/GRRLIB/GRRLIB/releas
|
||||||
* RedShade
|
* RedShade
|
||||||
* Jespa
|
* Jespa
|
||||||
|
|
||||||
|
|
||||||
## Licence
|
## Licence
|
||||||
|
|
||||||
GRRLIB is released under the [MIT Licence](LICENCE.md).
|
GRRLIB is released under the [MIT Licence](LICENCE.md).
|
||||||
|
|
Loading…
Reference in a new issue