SW Renderer Sample with SDL

This Android project integrates SDL from a custom fork for software rendering experiments.

Project Structure

• app/ - Main Android application
• external/SDL/ - SDL library as a Git submodule from https://github.com/nikitapn/SDL

Setup Instructions

Initial Setup

The project is already configured with SDL as a submodule. If you clone this repository fresh:

git clone <your-repo-url>
cd SWRendererSample
git submodule init
git submodule update

Working with SDL

Making Changes to SDL

1. Navigate to the SDL submodule:

   cd external/SDL

2. Create a branch for your experiments:

   git checkout -b my-experiment

3. Make your changes to SDL source code

4. Commit changes in the SDL submodule:

   git add .
   git commit -m "Your SDL changes"

5. Push to your SDL fork:

   git push origin my-experiment

Updating SDL from Remote

To pull latest changes from your SDL fork:

cd external/SDL
git fetch origin
git pull origin main  # or your branch name
cd ../..
git add external/SDL
git commit -m "Update SDL submodule"

Switching SDL Branches

cd external/SDL
git checkout <branch-name>
cd ../..
git add external/SDL
git commit -m "Switch SDL to branch <branch-name>"

Building

Build the project normally through Android Studio or via Gradle:

./gradlew assembleDebug

Notes

• The SDL submodule points to https://github.com/nikitapn/SDL
• Changes to SDL should be committed in the submodule directory
• The parent project tracks which commit of SDL is used
• Always commit submodule reference updates in the parent project after changing SDL commits