added more grrlib examples, not all working yet, and gclink

README.md

@@ -9,7 +9,7 @@
  - Docker (see specific installatino for WSL2)
  - [Optional] Visual Code with extensions (https://code.visualstudio.com/download)
    - WSL remote if using WSL2
-   - C/C++ extensions
+   - C/C++ Extension Pack
 
 ### Installation
 
@@ -38,8 +38,17 @@ git clone https://github.com/PacMooseIncorporated/GameCube4Fun.git
 
 Compile the GRRLIB, GameCube examples (already in devkitPro `/opt/devkitpro/examples/gamecube` in fact)
 
+```text
+libgrrlib          <- 2D/3D graphics library
+├── libfat         <- File I/O
+├── libjpeg        <- JPEG image processor
+├── libpngu        <- Wrapper for libpng
+│   └── libpng     <- PNG image processor
+└── libfreetype    <- TrueType font processor
+```
+
 ````bash
-sudo docker run --rm -it --name devkit -v /projects/gc:/home/gc devkitpro/devkitppc bash
+sudo docker run -it --name devkit -v /projects/gc:/home/gc devkitpro/devkitppc bash
 
 cd /home/gc/gamecube-examples
 make
@@ -82,14 +91,27 @@ dkp-pacman -S gamecube-dev
    - examples: https://github.com/devkitPro/gamecube-examples (cloned)
    - forums: https://devkitpro.org/viewforum.php?f=40
    - Interesting article on the GameCube GX (GPU) and libogc: https://devkitpro.org/wiki/libogc/GX#Preface
-   
+
  - GRRLIB: 
    - docs: https://grrlib.github.io/GRRLIB/
    - examples: https://github.com/GRRLIB/GRRLIB/tree/master/examples (cloned)
    - forums: 
      - http://grrlib.santo.fr/forum/ (closed, for reference only)
      - https://github.com/GRRLIB/GRRLIB/discussions
-
+
+ - Interesting codebase:
+   - Terri Fried https://github.com/PolyMarsDev/Terri-Fried/tree/master/gamecube/source (CPP, OGG Player)
+   - Cubecraft https://github.com/camthesaxman/cubecraft/ (debug_malloc, keyboard...)
+   - Donut.c https://github.com/AndrewPiroli/Wii-donut.c
+
+ - Technical details:
+   - DOL file format: https://wiibrew.org/wiki/DOL and converter: https://github.com/devkitPro/gamecube-tools/blob/master/elftool/elf2dol.c
+   - Homebrew swiss knife: https://gchomebrew.com/ultimate/
+   - forums:
+     - https://www.gc-forever.com/forums/index.php
+
+
+
 ### Installing Docker without Docker Desktop on WSL2
 
 ref: https://dev.to/felipecrs/simply-run-docker-on-wsl2-3o8

gclink/Makefile

@@ -0,0 +1,130 @@
+#---------------------------------------------------------------------------------
+# Clear the implicit built in rules
+#---------------------------------------------------------------------------------
+.SUFFIXES:
+#---------------------------------------------------------------------------------
+ifeq ($(strip $(DEVKITPPC)),)
+$(error "Please set DEVKITPPC in your environment. export DEVKITPPC=<path to>devkitPPC")
+endif
+
+include $(DEVKITPPC)/gamecube_rules
+
+#---------------------------------------------------------------------------------
+# TARGET is the name of the output
+# BUILD is the directory where object files & intermediate files will be placed
+# SOURCES is a list of directories containing source code
+# INCLUDES is a list of directories containing extra header files
+#---------------------------------------------------------------------------------
+TARGET		:=	$(notdir $(CURDIR))
+BUILD		:=	build
+SOURCES		:=	source
+DATA		:=	data
+INCLUDES	:=  include
+
+#---------------------------------------------------------------------------------
+# options for code generation
+#---------------------------------------------------------------------------------
+
+CFLAGS	= -g -O2 -Wall $(MACHDEP) $(INCLUDE)
+CXXFLAGS	=	$(CFLAGS)
+
+LDFLAGS	=	-g $(MACHDEP) -Wl,-Map,$(notdir $@).map
+
+#---------------------------------------------------------------------------------
+# any extra libraries we wish to link with the project
+#---------------------------------------------------------------------------------
+LIBS	:=	-ldb -lbba -logc -lm
+
+#---------------------------------------------------------------------------------
+# list of directories containing libraries, this must be the top level containing
+# include and lib
+#---------------------------------------------------------------------------------
+LIBDIRS	:=
+
+#---------------------------------------------------------------------------------
+# no real need to edit anything past this point unless you need to add additional
+# rules for different file extensions
+#---------------------------------------------------------------------------------
+ifneq ($(BUILD),$(notdir $(CURDIR)))
+#---------------------------------------------------------------------------------
+
+export OUTPUT	:=	$(CURDIR)/$(TARGET)
+
+export VPATH	:=	$(foreach dir,$(SOURCES),$(CURDIR)/$(dir)) \
+					$(foreach dir,$(DATA),$(CURDIR)/$(dir))
+
+export DEPSDIR	:=	$(CURDIR)/$(BUILD)
+
+#---------------------------------------------------------------------------------
+# automatically build a list of object files for our project
+#---------------------------------------------------------------------------------
+CFILES		:=	$(foreach dir,$(SOURCES),$(notdir $(wildcard $(dir)/*.c)))
+CPPFILES	:=	$(foreach dir,$(SOURCES),$(notdir $(wildcard $(dir)/*.cpp)))
+sFILES		:=	$(foreach dir,$(SOURCES),$(notdir $(wildcard $(dir)/*.s)))
+SFILES		:=	$(foreach dir,$(SOURCES),$(notdir $(wildcard $(dir)/*.S)))
+BINFILES	:=	$(foreach dir,$(DATA),$(notdir $(wildcard $(dir)/*.*)))
+
+#---------------------------------------------------------------------------------
+# use CXX for linking C++ projects, CC for standard C
+#---------------------------------------------------------------------------------
+ifeq ($(strip $(CPPFILES)),)
+	export LD	:=	$(CC)
+else
+	export LD	:=	$(CXX)
+endif
+
+export OFILES	:=	$(addsuffix .o,$(BINFILES)) \
+					$(CPPFILES:.cpp=.o) $(CFILES:.c=.o) \
+					$(sFILES:.s=.o) $(SFILES:.S=.o)
+
+#---------------------------------------------------------------------------------
+# build a list of include paths
+#---------------------------------------------------------------------------------
+export INCLUDE	:=	$(foreach dir,$(INCLUDES),-I$(CURDIR)/$(dir)) \
+					$(foreach dir,$(LIBDIRS),-I$(dir)/include) \
+					-I$(CURDIR)/$(BUILD) \
+					-I$(LIBOGC_INC)
+
+#---------------------------------------------------------------------------------
+# build a list of library paths
+#---------------------------------------------------------------------------------
+export LIBPATHS	:=	$(foreach dir,$(LIBDIRS),-L$(dir)/lib) \
+					-L$(LIBOGC_LIB)
+
+export OUTPUT	:=	$(CURDIR)/$(TARGET)
+.PHONY: $(BUILD) clean
+
+#---------------------------------------------------------------------------------
+$(BUILD):
+	@[ -d $@ ] || mkdir -p $@
+	@$(MAKE) --no-print-directory -C $(BUILD) -f $(CURDIR)/Makefile
+
+#---------------------------------------------------------------------------------
+clean:
+	@echo clean ...
+	@rm -fr $(BUILD) $(OUTPUT).elf $(OUTPUT).dol
+
+#---------------------------------------------------------------------------------
+else
+
+DEPENDS	:=	$(OFILES:.o=.d)
+
+#---------------------------------------------------------------------------------
+# main targets
+#---------------------------------------------------------------------------------
+$(OUTPUT).dol: $(OUTPUT).elf
+$(OUTPUT).elf: $(OFILES)
+
+#---------------------------------------------------------------------------------
+# This rule links in binary data with the .jpg extension
+#---------------------------------------------------------------------------------
+%.jpg.o	:	%.jpg
+#---------------------------------------------------------------------------------
+	@echo $(notdir $<)
+	$(bin2o)
+
+-include $(DEPENDS)
+
+#---------------------------------------------------------------------------------
+endif
+#---------------------------------------------------------------------------------

gclink/include/elf.h

@@ -0,0 +1,9 @@
+#ifndef __ELF_H
+#define __ELF_H
+
+#include "elf_abi.h"
+
+int valid_elf_image(void *addr);
+unsigned int load_elf_image(void *addr);
+
+#endif