Skip to content

extremscorner/libogc2

Repository files navigation

libogc2 build Extrems' Corner.org Discord

libogc2 contains wide-ranging fixes and additions to most subsystems of libogc, provides hardware enablement for most new (and old) Nintendo GameCube accessories on the market or in prototype stage, and enables greater interoperability with Swiss.

It is largely API compatible with libogc 2.1.0 and earlier.

Projects using libogc2

Unofficial ports

Subprojects

cubeboot-tools, gamecube-examples, gamecube-tools, GRRLIB, libansnd, libdvm, libfat, libntfs, opengx, SDL, wii-examples

Installing

Follow the instructions from pacman-packages.

sudo (dkp-)pacman -S libogc2 libogc2-docs libogc2-examples

When asked for a libogc2-libfat provider, libogc2-libdvm is generally preferred, but libogc2-libfat may be chosen if you have concerns regarding exFAT's legal status. If you have a need for libogc2-libdvm without exFAT support, please open an issue.

No code changes should be necessary when migrating from libfat to libdvm.

Migrating from libogc

GNU Make

-include $(DEVKITPPC)/gamecube_rules
+include $(DEVKITPRO)/libogc2/gamecube_rules
-include $(DEVKITPPC)/wii_rules
+include $(DEVKITPRO)/libogc2/wii_rules

CMake

sudo (dkp-)pacman -S libogc2-cmake

DKP_OGC_PLATFORM_LIBRARY may be set to libogc or libogc2 to build projects using either thereafter.

GitHub Actions

-    container: devkitpro/devkitppc:latest
+    container: ghcr.io/extremscorner/libogc2:latest

Building

Pacman

git clone https://github.com/extremscorner/libogc2.git
cd libogc2
makepkg -si
git clone --recurse-submodules https://github.com/extremscorner/libdvm.git
cd libdvm
makepkg -si

GNU Make

  1. Existing packages should first be uninstalled if already installed.

    sudo (dkp-)pacman -R --cascade libogc2(-git)
    
  2. Install build dependencies.

    sudo (dkp-)pacman -S --needed devkitPPC gamecube-tools ppc-libmad
    
  3. Clone and build source repositories.

    git clone https://github.com/extremscorner/libogc2.git
    cd libogc2
    make
    sudo -E make install
    
    git clone https://github.com/extremscorner/libfat.git
    cd libfat
    make ogc-release
    sudo -E make ogc-install
    

Using sudo is not necessary with MSYS2.

Upgrading

Pacman

cd libogc2
git pull
makepkg -si
cd libdvm
git pull --recurse-submodules
makepkg -si

GNU Make

  1. Supporting packages should first be upgraded.

    sudo (dkp-)pacman -Syu
    
  2. Clean, pull and rebuild source repositories.

    cd libogc2
    sudo -E make uninstall
    sudo -E make clean
    git pull
    make
    sudo -E make install
    
    cd libfat
    make ogc-clean
    git pull
    make ogc-release
    sudo -E make ogc-install
    

About

C library for GameCube and Wii targeting devkitPPC.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

 
 
 

Contributors 33