[ { "path": ".gitattributes", "content": ".gitignore merge=union text\ndocs/changelog.txt merge=union text\ndocs/cycles_and_commands.txt text\ndocs/idle_direction_oddities.txt text\ndocs/macro.txt text\ndocs/port.txt text\ndocs/push_and_transport.txt text\ndocs/WIPHelp.txt text\nunit/io/data/*.txt text eol=lf\nconfig.txt text\n" }, { "path": ".github/workflows/main.yml", "content": "name: Regression tests\n\nenv:\n MZXDEPS_DEBIAN_SDL2: \"zlib1g-dev libpng-dev libogg-dev libvorbis-dev libsdl2-dev\"\n MZXDEPS_DEBIAN_MISC: \"libsdl1.2-dev libegl1-mesa-dev libmikmod-dev libopenmpt-dev\"\n MZXDEPS_MACOS: \"libpng libogg libvorbis sdl2\"\n MZX_MAKE: \"make -j4\"\n\non:\n push:\n branches: [ master ]\n pull_request:\n branches: [ master ]\n\n workflow_dispatch:\n\njobs:\n #\n # Platform variants and distribution packages.\n #\n unix:\n runs-on: ubuntu-latest\n steps:\n - name: Install dependencies\n run: sudo apt update && sudo apt install -y --no-install-recommends $MZXDEPS_DEBIAN_SDL2\n - uses: actions/checkout@v4\n - name: Configure\n run: ./config.sh --platform unix --enable-release --enable-sdlaccel\n - name: Build\n run: $MZX_MAKE\n - name: Run tests\n run: $MZX_MAKE test\n - name: Install\n run: sudo $MZX_MAKE install V=1\n - name: Check install\n run: command -v megazeux && [ -f \"/usr/share/licenses/megazeux/LICENSE\" ] && [ -f \"/etc/megazeux-config\" ]\n - name: Uninstall\n run: sudo $MZX_MAKE uninstall V=1\n - name: Check uninstall\n run: true && [ ! -f \"/usr/bin/megazeux\" ] && [ ! -f \"/usr/share/licenses/megazeux/LICENSE\" ] && [ ! -f \"/etc/megazeux-config\" ]\n - name: Package source .tar.xz\n run: make source\n\n unix-portable:\n runs-on: ubuntu-latest\n steps:\n - name: Install dependencies\n run: sudo apt update && sudo apt install -y --no-install-recommends $MZXDEPS_DEBIAN_SDL2\n - uses: actions/checkout@v4\n - name: Configure\n run: ./config.sh --platform unix-devel --enable-release --enable-sdlaccel\n - name: Build\n run: $MZX_MAKE\n - name: Run tests\n run: $MZX_MAKE test\n - name: Package linux-amd64 .zip\n run: make archive\n\n unix-misc:\n runs-on: ubuntu-latest\n steps:\n - name: Install dependencies\n run: sudo apt update && sudo apt install -y --no-install-recommends $MZXDEPS_DEBIAN_SDL2 $MZXDEPS_DEBIAN_MISC\n - uses: actions/checkout@v4\n - name: Configure (SDL 1.2)\n run: ./config.sh --platform unix-devel --enable-release --enable-sdl1\n - name: Build (SDL 1.2)\n run: $MZX_MAKE\n - name: Run tests (SDL 1.2)\n run: $MZX_MAKE test\n - name: Distclean (SDL 1.2)\n run: $MZX_MAKE distclean\n - name: Configure (EGL/X11)\n run: ./config.sh --platform unix-devel --enable-release --disable-sdl --enable-egl\n - name: Build (EGL/X11)\n run: $MZX_MAKE\n # Note: EGL mzxrun builds can't run headless, unit tests only.\n - name: Run tests (EGL/X11)\n run: $MZX_MAKE unit\n - name: Distclean (EGL/X11)\n run: $MZX_MAKE distclean\n - name: Configure (ModPlug)\n run: ./config.sh --platform unix-devel --enable-release --enable-modplug\n - name: Build (Modplug)\n run: $MZX_MAKE\n - name: Run tests (Modplug)\n run: $MZX_MAKE test\n - name: Distclean (Modplug)\n run: $MZX_MAKE distclean\n - name: Configure (MikMod)\n run: ./config.sh --platform unix-devel --enable-release --enable-mikmod\n - name: Build (MikMod)\n run: $MZX_MAKE\n - name: Run tests (MikMod)\n run: $MZX_MAKE test\n - name: Distclean (MikMod)\n run: $MZX_MAKE distclean\n - name: Configure (OpenMPT)\n run: ./config.sh --platform unix-devel --enable-release --enable-openmpt\n - name: Build (OpenMPT)\n run: $MZX_MAKE\n - name: Run tests (OpenMPT)\n run: $MZX_MAKE test\n - name: Distclean (OpenMPT)\n run: $MZX_MAKE distclean\n - name: Configure (debug)\n run: ./config.sh --platform unix-devel --disable-release --enable-trace --enable-fps\n - name: Build (debug)\n run: $MZX_MAKE\n - name: Run tests (debug)\n run: $MZX_MAKE test\n - name: Distclean (debug)\n run: $MZX_MAKE distclean\n\n darwin-arm64:\n runs-on: macos-latest\n steps:\n - uses: actions/checkout@v4\n - name: Install dependencies\n run: brew install $MZXDEPS_MACOS\n - name: Configure (darwin-devel)\n run: ./config.sh --platform darwin-devel --prefix /opt/homebrew --enable-release --enable-sdlaccel\n - name: Build (darwin-devel)\n run: $MZX_MAKE\n - name: Run tests (darwin-devel)\n run: $MZX_MAKE test\n\n darwin-x86_64:\n runs-on: macos-26-intel\n steps:\n - uses: actions/checkout@v4\n - name: Install dependencies\n run: brew install $MZXDEPS_MACOS\n - name: Configure (darwin-devel)\n run: ./config.sh --platform darwin-devel --prefix /usr/local --enable-release --enable-sdlaccel\n - name: Build (darwin-devel)\n run: $MZX_MAKE\n - name: Run tests (darwin-devel)\n run: $MZX_MAKE test\n\n MSYS2-MINGW64:\n runs-on: windows-latest\n defaults:\n run:\n shell: msys2 {0}\n steps:\n - name: Setup msys2\n uses: msys2/setup-msys2@v2\n with:\n msystem: MINGW64\n update: true\n install: >-\n base-devel git zip\n mingw-w64-x86_64-gcc mingw-w64-x86_64-zlib mingw-w64-x86_64-libpng\n mingw-w64-x86_64-libogg mingw-w64-x86_64-libvorbis mingw-w64-x86_64-SDL2\n - uses: actions/checkout@v4\n - name: Configure x64\n run: ./config.sh --platform win64 --enable-release\n - name: Build x64\n run: $MZX_MAKE\n - name: Test x64\n run: $MZX_MAKE test\n - name: Package x64 .zip\n run: make archive\n\n MSYS2-MINGW32:\n runs-on: windows-latest\n defaults:\n run:\n shell: msys2 {0}\n steps:\n - name: Setup msys2\n uses: msys2/setup-msys2@v2\n with:\n msystem: MINGW32\n update: true\n install: >-\n base-devel git zip\n mingw-w64-i686-gcc mingw-w64-i686-zlib mingw-w64-i686-libpng\n mingw-w64-i686-libogg mingw-w64-i686-libvorbis mingw-w64-i686-SDL2\n - uses: actions/checkout@v4\n - name: Configure x86\n run: ./config.sh --platform win32 --enable-release\n - name: Build x86\n run: $MZX_MAKE\n - name: Test x86\n run: $MZX_MAKE test\n - name: Package x86 .zip\n run: make archive\n\n AArch64-Switch:\n runs-on: ubuntu-latest\n container: devkitpro/devkita64\n steps:\n - run: echo \"PATH=$DEVKITPRO/devkitA64/bin:$PATH\" >> $GITHUB_ENV\n - uses: actions/checkout@v4\n - name: Configure Switch\n run: arch/switch/CONFIG.SWITCH\n - name: Build Switch\n run: $MZX_MAKE\n - name: Package Switch .zip\n run: make archive\n\n ARM-3DS:\n runs-on: ubuntu-latest\n container: devkitpro/devkitarm\n steps:\n - run: echo \"PATH=$DEVKITPRO/devkitARM/bin:$PATH\" >> $GITHUB_ENV\n - uses: actions/checkout@v4\n - name: Configure 3DS\n run: arch/3ds/CONFIG.3DS\n - name: Build 3DS\n run: $MZX_MAKE\n - name: Package 3DS .zip\n run: make archive\n\n ARM-NDS:\n runs-on: ubuntu-latest\n container: devkitpro/devkitarm:20241104\n steps:\n - run: echo \"PATH=$DEVKITPRO/devkitARM/bin:$PATH\" >> $GITHUB_ENV\n - uses: actions/checkout@v4\n - name: Configure NDS\n run: arch/nds/CONFIG.NDS\n - name: Build NDS\n run: $MZX_MAKE\n - name: Package NDS .zip\n run: make archive\n\n ARM-NDS-BlocksDS:\n runs-on: ubuntu-latest\n container: skylyrac/blocksds:slim-latest\n steps:\n - name: Install dependencies\n run: apt update && apt install -y --no-install-recommends zip\n - name: Install target dependencies\n run: wf-pacman -S --noconfirm toolchain-gcc-arm-none-eabi-zlib\n - uses: actions/checkout@v4\n - name: Configure NDS/BlocksDS\n run: arch/nds-blocksds/CONFIG.NDS\n - name: Build NDS/BlocksDS\n run: $MZX_MAKE\n - name: Package NDS/BlocksDS .zip\n run: make archive\n\n PowerPC-Wii:\n runs-on: ubuntu-latest\n container: devkitpro/devkitppc\n steps:\n - run: echo \"PATH=$DEVKITPRO/devkitPPC/bin:$PATH\" >> $GITHUB_ENV\n - uses: actions/checkout@v4\n - name: Configure Wii\n run: arch/wii/CONFIG.WII\n - name: Build Wii\n run: $MZX_MAKE\n - name: Package Wii .zip\n run: make archive\n\n PowerPC-WiiU:\n runs-on: ubuntu-latest\n container: devkitpro/devkitppc\n steps:\n - run: echo \"PATH=$DEVKITPRO/devkitPPC/bin:$PATH\" >> $GITHUB_ENV\n - uses: actions/checkout@v4\n - name: Configure Wii U\n run: arch/wiiu/CONFIG.WIIU\n - name: Build Wii U\n run: $MZX_MAKE\n - name: Package Wii U .zip\n run: make archive\n\n Emscripten-HTML5:\n runs-on: ubuntu-latest\n steps:\n - name: Install Emscripten\n uses: mymindstorm/setup-emsdk@v14\n with:\n version: 4.0.7\n# actions-cache-folder: 'emsdk-cache'\n - uses: actions/checkout@v4\n - name: Configure HTML5\n run: arch/emscripten/CONFIG.HTML5\n - name: Build HTML5\n run: $MZX_MAKE && make build\n - name: Package HTML5 .zip\n run: make archive\n\n # FIXME: vitasdk hasn't bothered adding SDL3 to the container,\n # vdpm and git are missing from the container.\n Vita:\n runs-on: ubuntu-latest\n container: vitasdk/vitasdk\n steps:\n - name: Install dependencies\n run: apk add --no-cache zip\n - uses: actions/checkout@v4\n - name: Configure Vita\n run: arch/psvita/CONFIG.PSVITA --enable-sdl2 --disable-libpng --disable-lto\n - name: Build Vita\n run: $MZX_MAKE\n - name: Package Vita\n run: make archive\n\n #\n # Sanitizers.\n #\n AddressSanitizer:\n runs-on: ubuntu-latest\n env:\n CC: clang\n CXX: clang++\n steps:\n - name: Install dependencies\n run: sudo apt update && sudo apt install -y --no-install-recommends $MZXDEPS_DEBIAN_SDL2\n - uses: actions/checkout@v4\n - name: Configure\n run: ./config.sh --platform unix-devel --enable-asan --enable-extram\n - name: Build\n run: $MZX_MAKE\n - name: Run tests\n run: $MZX_MAKE test\n\n # Note: requires all non-system/libc calls to be from instrumented libraries.\n # For the regression tests, MZX can get away with just zlib.\n # SDL calls into uninstrumented functions and is not built at all.\n # libpng is temporarily disabled. libogg/libvorbis work with no issue.\n MemorySanitizer:\n runs-on: ubuntu-latest\n env:\n CC: clang\n CXX: clang++\n steps:\n - uses: actions/checkout@v4\n - name: Fetch dependencies\n run: |\n (cd scripts/deps;\n wget https://github.com/AliceLR/megazeux-dependencies/releases/download/v2.93c-r1/megazeux-dependencies-2.93c-r1-linux-msan-mint22.tar.xz;\n tar -xJf megazeux-dependencies-*-linux-msan-mint22.tar.xz)\n - name: Configure\n run: ./config.sh --platform unix-devel --prefix scripts/deps/linux-msan/x86_64 --enable-msan --disable-sdl --disable-libpng --disable-x11 --enable-extram\n - name: Build\n run: $MZX_MAKE V=1\n - name: Run tests\n run: $MZX_MAKE V=1 test\n\n UndefinedBehaviorSanitizer:\n runs-on: ubuntu-latest\n env:\n CC: clang\n CXX: clang++\n UBSAN_OPTIONS: print_stacktrace=1\n steps:\n - name: Install dependencies\n run: sudo apt update && sudo apt install -y --no-install-recommends $MZXDEPS_DEBIAN_SDL2\n - uses: actions/checkout@v4\n - name: Configure\n run: ./config.sh --platform unix-devel --enable-ubsan --enable-extram\n - name: Build\n run: $MZX_MAKE\n - name: Run tests\n run: $MZX_MAKE test\n" }, { "path": ".gitignore", "content": "arch/3ds/*.d\narch/3ds/*.o\narch/3ds/*shbin*\narch/android/deps\narch/android/include\narch/android/project/.eclipse\narch/android/project/.gradle\narch/android/project/.idea\narch/android/project/*.iml\narch/android/project/*.ipr\narch/android/project/app/.cxx\narch/android/project/app/.externalNativeBuild\narch/android/project/app/jni/.gradle\narch/android/project/app/jni/SDL2\narch/android/project/app/jni/lib\narch/android/project/app/jni/libogg\narch/android/project/app/jni/libvorbis\narch/android/project/app/debug/\narch/android/project/app/release/\narch/android/project/app/src/main/res/raw/assets.zip\narch/android/project/app/*.iml\narch/android/project/build\narch/android/project/keystore.properties\narch/android/project/local.properties\narch/djgpp/*.d\narch/djgpp/*.o\narch/dreamcast/*.d\narch/dreamcast/*.o\narch/emscripten/web/mzxrun_web.js*\narch/emscripten/web/node_modules\narch/emscripten/web/package-lock.json\narch/mingw/pefix\narch/mingw/pefix.d\narch/mingw/pefix.exe\narch/mingw/pefix.o\narch/msvc/.vs\narch/msvc/*.user\narch/msvc/Deps/\narch/msvc/MegaZeux.opensdf\narch/msvc/MegaZeux.sdf\narch/msvc/MegaZeux.v12.suo\narch/msvc/obj\narch/msvc/version.h\narch/nds/mzxrun.arm7.elf\narch/nds/protected_palette_bin.c\narch/nds/protected_palette_bin.h\narch/nds/*.S\narch/nds/*.d\narch/nds/*.o\narch/psp/*.d\narch/psp/*.o\narch/psvita/*.d\narch/psvita/*.o\narch/wii/*.d\narch/wii/*.o\narch/xcode/version.h\nbuild\ncontrib/gdm2s3m/src/.build/\ncontrib/icons/.build/\ncontrib/libmodplug/src/.build/\ncontrib/libxmp/src/.build/\ncontrib/libxmp/src/win32/.build/\ncontrib/libxmp/src/loaders/.build/\ncontrib/unzip/src/.build/\n1ST_READ.BIN\nboot.dol\nCore.exp\nCore.ilk\nCore.iobj\nCore.ipdb\nCore.lib\nCore.pdb\ncore.dll\nlibcore.so\nlibcore.dylib\nEBOOT.PBP\neboot.bin\nEditor.exp\nEditor.ilk\nEditor.iobj\nEditor.ipdb\nEditor.lib\nEditor.map\nEditor.pdb\neditor.dll\nICON0.PNG\nlibeditor.so\nlibeditor.dylib\nmegazeux-cia.*\nmegazeux.3dsx\nmegazeux.bin\nmegazeux.dol\nmegazeux.elf\nmegazeux.exe\nmegazeux.exp\nMegaZeux.ilk\nMegaZeux.iobj\nMegaZeux.ipdb\nMegaZeux.lib\nmegazeux.nacp\nmegazeux.nro\nmegazeux.nso\nMegaZeux.pdb\nmegazeux.rpx\nmegazeux.smdh\nmegazeux.velf\nmegazeux.vpk\n/megazeux\nmzxrun.3dsx\nmzxrun.bin\nmzxrun.cia\nmzxrun.dol\nmzxrun.elf\nmzxrun.exe\nmzxrun.exp\nmzxrun.ilk\nmzxrun.iobj\nmzxrun.ipdb\nmzxrun.js\nmzxrun.js.orig.js\nmzxrun.js.mem\nmzxrun.lib\nmzxrun.nacp\nmzxrun.nds\nmzxrun.nro\nmzxrun.nso\nmzxrun.pdb\nmzxrun.rpx\nmzxrun.smdh\nmzxrun.velf\nmzxrun.vpk\nmzxrun.wasm\nmzxrun.wasm.map\n/mzxrun\nPARAM.SFO\nparam.sfo\nplatform.inc\nSDL.dll\nSDL2.dll\nsrc/.build/\nsrc/config.h\nsrc/audio/.build/\nsrc/editor/.build/\nsrc/io/.build/\nsrc/network/.build/\nsrc/utils/.build/\nsrc/utils/ccv.exe\nsrc/utils/ccv\nsrc/utils/checkres.exe\nsrc/utils/checkres\nsrc/utils/downver.exe\nsrc/utils/downver\nsrc/utils/hlp2html.exe\nsrc/utils/hlp2html\nsrc/utils/hlp2txt.exe\nsrc/utils/hlp2txt\nsrc/utils/txt2hlp.exe\nsrc/utils/txt2hlp\nsrc/utils/png2smzx.exe\nsrc/utils/png2smzx\nsrc/utils/y4m2smzx.exe\nsrc/utils/y4m2smzx\nsrc/utils/*.debug\nstdout.txt\nstderr.txt\nThumbs.db\nunit/.build/\nunit/audio/.build/\nunit/editor/.build/\nunit/io/.build/\nunit/network/.build/\nunit/utils/.build/\n/*.js\n/*.js.mem\n/*.js.orig.js\n/*.wasm\n/*.wasm.map\n*.code-workspace\n*.debug\n*.mzx\n*.sav\n*.mzm\n*~\n.clangd\n.vscode\n.DS_Store\nxcuserdata/\n\n# This MUST go after the *.mzx rule.\n!testworlds/*/*.mzx\ntestworlds/*/backup*\ntestworlds/backup*\ntestworlds/log\ntestworlds/next\ntestworlds/test\ntestworlds/temp/*\n!testworlds/temp/README.md\n!testworlds/data/*\n" }, { "path": ".valgrindrc", "content": "--memcheck:leak-check=full\n--memcheck:track-origins=yes\n--suppressions=valgrind.supp\n" }, { "path": "BUILDING.md", "content": "Building MegaZeux\n=================\n\nMegaZeux can currently be built for Microsoft Windows, Linux, macOS,\nNetBSD, FreeBSD, OpenBSD, Haiku, Amiga OS 4, Android, HTML5, MS-DOS (DJGPP),\nNDS, 3DS, Wii, Wii U, Switch, PSP, Vita, Dreamcast, GP2X, and Pandora.\n\nMegaZeux has three buildsystems--the GNU Make buildsystem for building most\nports, the Xcode project (`arch/xcode/`) for development and release builds\non macOS, and the MSVC project (`arch/msvc/`) for testing on Windows. This\ndocument applies primarily to the GNU Make buildsystem.\n\nFor architecture specific build instructions, please see `arch/[platform]/README`.\n[The DigitalMZX wiki](https://www.digitalmzx.com/wiki/Compiling_MegaZeux) has\nmore info, particularly for setting up console toolchains.\n\n\nRequirements\n------------\n\nFor the GNU Make buildsystem, most versions of these tools from the\npast 20 years work with little issue. You should almost always use the\nmost recent versions available.\n\n- POSIX-compatible base system e.g. Linux, macOS, BSD, MSYS2:\n - **GNU coreutils**: <=4.5.3 or newer (packaging MinGW requires `sha256sum`, 6.0+)\n - **BusyBox**: <=1.22 or newer (packaging MinGW requires `sha256sum`, 1.14.0+)\n - (**BSD** `sha256` or **Perl** `shasum -a256` also works.)\n- GNU-compatible C and C++ compilers:\n - **GCC**: 3.4 or newer\n - **clang/LLVM**\n- **GNU binutils** or **LLVM** or equivalent\n- **GNU Make**: <=3.79 or newer\n- **pkgconf** or **pkg-config** (SDL 3 builds only)\n- **zip** or **7za** (packaging only)\n- **tar** and **xz** (packaging source only)\n- **ImageMagick** 7.0 or newer (rebuilding icons only)\n - Older versions may work if `MAGICK=convert` is provided to Make.\n - **GraphicsMagick** does not work as a substitute (no parentheses or clone).\n\nDependencies:\n\n- **SDL** (all ports except DJGPP, NDS, 3DS, Wii, and Dreamcast)\n [(link)](https://www.libsdl.org/)\n - **SDL 3** (with `--enable-sdl3`)\n - **SDL 2** (default)\n - **SDL 1.2**: <=1.2.5 or newer (with `--enable-sdl1`)\n - Clipboard support for SDL 1.2 in Linux additionally requires X11 headers.\n- **zlib**: 1.2.0 or newer\n [(link)](https://www.zlib.net/)\n- **libpng**: 1.2.3 or newer (or `--disable-libpng`)\n [(link)](http://www.libpng.org/pub/png/libpng.html)\n- **libogg**: 1.0 or newer (or **stb_vorbis** or `--disable-vorbis`)\n [(link)](https://xiph.org/downloads/)\n- **libvorbis**: 1.2.2 or newer (or **Tremor** or **stb_vorbis** or `--disable-vorbis`)\n [(link)](https://xiph.org/downloads/)\n\nFor MinGW, DJGPP, and Darwin (macOS/Mac OS X), plus the Xcode and MSVC projects,\nprebuilt dependencies can be found [here](https://github.com/AliceLR/megazeux-dependencies).\nSee below or the platform-specific README for more info.\n\n\nConfiguring and building\n------------------------\n\nAll operations must be run within a POSIX-compatible shell environment\nsuch as Bash, BusyBox, ksh, MSYS2 terminal, or similar.\n\nConfigure MegaZeux with the script `config.sh` located in the source root:\n```sh\n# You may need to specify --prefix [dir] or other options.\n# For debug builds, omit --enable-release and --enable-lto.\n\n./config.sh --platform [platform] --enable-release --enable-lto\n\n# For a full list of supported options and platforms:\n./config.sh\n```\nSeveral platforms have shell scripts named `CONFIG.[arch]` located in their\n`arch/[platform]/` directory, which will run `config.sh` with appropriate\ndefault configurations.\n\nCompile MegaZeux with GNU Make:\n```sh\n# Use gmake on NetBSD et al.\n# For verbose output, provide V=1. Parallel builds (-j#) are supported.\nmake\n\n# For some platforms, it's safe to override the compilers if needed.\n# (Most platforms that prefer clang will automatically select it.)\nCC=clang CXX=clang++ make\n```\n\nMegaZeux comes with two regression test systems to verify that MegaZeux works\n(for platforms and build environments where executables can be run locally).\nThe unit tests located in `unit/` are compiled and executed individually.\nThe test worlds located in `testworlds/` are run together via MZXRun.\n```sh\n# Perform the unit tests and then run the test worlds. (-j# supported)\nmake test\n\n# Perform just the unit tests. (-j# supported)\nmake unit\n\n# Perform just the test worlds.\nmake testworlds\n```\n\n\nInstalling\n----------\n\nFor Linux/BSD/etc. using the `unix` platform and macOS/Mac OS X using the\n`darwin` platform, MegaZeux can be installed to the install root that was\nprovided to the `--prefix` option. (Note the default install root is `/usr`,\nso you may want to explicitly change that to `/usr/local` or similar):\n```sh\n# As superuser:\nmake install\n\n# Can be reversed:\nmake uninstall\n```\n\n\nPackaging\n---------\n\nFor all other platforms, MegaZeux is typically packaged instead.\nMegaZeux's packaging varies from platform to platform.\n\nFirst, for platforms that don't automatically separate or strip debug info\n(mainly MinGW and DJGPP), separate the debug info. (For MinGW, this also runs\nthe locally compiled tool `arch/mingw/pefix` to strip PE timestamps.)\n```sh\nmake debuglink -j8\n```\n\nPackage the MegaZeux build into a zip archive. The prepared build directory can\nbe found at `build/[platform]/` and the archive at `build/dist/[platform]/`:\n```sh\nmake archive\n```\n\nTo prepare a directory (in `build/[platform]/`) for packaging without archiving\nit, this can usually be used instead:\n```sh\nmake build\n```\n\nTo package a source tarball from a local Git repository:\n```sh\nmake source\n```\n\n\nPlatform-specific notes\n-----------------------\n\nCheck `arch/[platform]/README[.md]` for more detailed platform-specific\ninformation.\n\n### Debian-based distributions\n\n.deb packages can be generated with a single command.\nSee `debian/README` for more information.\n\n### RPM-based distributions\n\n.rpm packages can be generated with a single command:\n```sh\nrpmbuild -bb --build-in-place megazeux.spec\n```\n\n### Other Linux/BSD\n\nUse platform `unix` for `make install` or `unix-devel` for running directly\nfrom the source directory.\n\n### MinGW and DJGPP\n\nDownload the latest dependencies tarball from\n[here](https://github.com/AliceLR/megazeux-dependencies) and extract it into\n`scripts/deps/`. Provide the following to `config.sh`:\n\n- MINGW64: `--platform win64 --prefix scripts/deps/mingw/x64`\n- MINGW32: `--platform win32 --prefix scripts/deps/mingw/x86`\n- DJGPP: set `DJGPP` environment variable to `scripts/deps/djgpp/i386`\n and run `arch/djgpp/CONFIG.DJGPP` from the base directory.\n\nWhen cross-compiling from Linux, use platforms `mingw64` and `mingw32` instead.\n\nAdditionally, DJGPP currently requires a copy of CWSDPMI.EXE to be placed in\n`arch/djgpp/` for packaging.\n\n### Darwin (macOS/Mac OS X via GNU Make)\n\nUse platform `darwin` for `make install`, `darwin-devel` for running from the\nsource directory, and `darwin-dist` to build a portable multi-architecture .app\nfor distribution (see `arch/darwin/README.md` for more info on `darwin-dist`).\n\nAll three variants require Xcode to be installed with available command line\ntools. It is easiest to get the dependency libraries from MacPorts (prefix\n`/opt/local`) or from the MegaZeux prebuilt dependencies.\n\nFor `darwin-dist` (and optionally `darwin-devel`), download the latest\ndependencies tarball from [here](https://github.com/AliceLR/megazeux-dependencies)\nand extract it into `scripts/deps/`. In addition to the requirements listed in\nthe general requirements section, `darwin-dist` also requires dylibbundler,\nwhich (along with other tools) is easiest to get via MacPorts.\n\n### Other notes\n\nAmiga OS 4, GP2X, and Pandora have not been tested recently and may have bitrot.\nOpenSolaris was previously mentioned in the list of working platforms, but\nneither old OpenSolaris nor modern Solaris can be verified currently.\n\nMegaZeux builds in ancient environments with a little manual effort, if\nfor some reason you actually need this. The oldest tested is CentOS 3:\n\n- Partial triage has been done on GCC 3.2 and 3.3, but this is low priority:\n - 3.3: `-Wextra` added in 3.4 (trivial but left as a canary)\n - 3.3: `-Wdeclaration-after-statement` added in 3.4\n - 3.3: requires `--disable-stack-protector`\n - 3.3: requires `--disable-modular`\n (`CORE_LIBSPEC export struct graphics graphics_data` doesn't work)\n - 3.2: `-std=gnu++98` added in 3.3\n - 3.2: `-Wunused-macros` added in 3.3\n - 3.2: `__attribute__(visibility(\"default\"))` also doesn't work\n- **zlib** <1.2.0 requires replacing/disabling `deflateBound` and `infback9`\n - The numeric version macros didn't exist at this point; `ZLIB_VERNUM` was\n added in 1.2.0.2 and the rest later.\n- **libpng** <1.2.3 works if `libpng-config` is backported or if\n `LIBPNG_CFLAGS` and `LIBPNG_LDFLAGS` are manually supplied to `platform.inc`.\n- **libvorbis**: <1.2.2 works if `vorbis_version_string` is manually disabled.\n libvorbis has never had numeric version macros to test.\n" }, { "path": "LICENSE", "content": "\t\t GNU GENERAL PUBLIC LICENSE\n\t\t Version 2, June 1991\n\n Copyright (C) 1989, 1991 Free Software Foundation, Inc.\n 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n Everyone is permitted to copy and distribute verbatim copies\n of this license document, but changing it is not allowed.\n\n\t\t\t Preamble\n\n The licenses for most software are designed to take away your\nfreedom to share and change it. By contrast, the GNU General Public\nLicense is intended to guarantee your freedom to share and change free\nsoftware--to make sure the software is free for all its users. This\nGeneral Public License applies to most of the Free Software\nFoundation's software and to any other program whose authors commit to\nusing it. (Some other Free Software Foundation software is covered by\nthe GNU Lesser General Public License instead.) You can apply it to\nyour programs, too.\n\n When we speak of free software, we are referring to freedom, not\nprice. Our General Public Licenses are designed to make sure that you\nhave the freedom to distribute copies of free software (and charge for\nthis service if you wish), that you receive source code or can get it\nif you want it, that you can change the software or use pieces of it\nin new free programs; and that you know you can do these things.\n\n To protect your rights, we need to make restrictions that forbid\nanyone to deny you these rights or to ask you to surrender the rights.\nThese restrictions translate to certain responsibilities for you if you\ndistribute copies of the software, or if you modify it.\n\n For example, if you distribute copies of such a program, whether\ngratis or for a fee, you must give the recipients all the rights that\nyou have. You must make sure that they, too, receive or can get the\nsource code. And you must show them these terms so they know their\nrights.\n\n We protect your rights with two steps: (1) copyright the software, and\n(2) offer you this license which gives you legal permission to copy,\ndistribute and/or modify the software.\n\n Also, for each author's protection and ours, we want to make certain\nthat everyone understands that there is no warranty for this free\nsoftware. If the software is modified by someone else and passed on, we\nwant its recipients to know that what they have is not the original, so\nthat any problems introduced by others will not reflect on the original\nauthors' reputations.\n\n Finally, any free program is threatened constantly by software\npatents. We wish to avoid the danger that redistributors of a free\nprogram will individually obtain patent licenses, in effect making the\nprogram proprietary. To prevent this, we have made it clear that any\npatent must be licensed for everyone's free use or not licensed at all.\n\n The precise terms and conditions for copying, distribution and\nmodification follow.\n\n\t\t GNU GENERAL PUBLIC LICENSE\n TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION\n\n 0. This License applies to any program or other work which contains\na notice placed by the copyright holder saying it may be distributed\nunder the terms of this General Public License. The \"Program\", below,\nrefers to any such program or work, and a \"work based on the Program\"\nmeans either the Program or any derivative work under copyright law:\nthat is to say, a work containing the Program or a portion of it,\neither verbatim or with modifications and/or translated into another\nlanguage. (Hereinafter, translation is included without limitation in\nthe term \"modification\".) Each licensee is addressed as \"you\".\n\nActivities other than copying, distribution and modification are not\ncovered by this License; they are outside its scope. The act of\nrunning the Program is not restricted, and the output from the Program\nis covered only if its contents constitute a work based on the\nProgram (independent of having been made by running the Program).\nWhether that is true depends on what the Program does.\n\n 1. You may copy and distribute verbatim copies of the Program's\nsource code as you receive it, in any medium, provided that you\nconspicuously and appropriately publish on each copy an appropriate\ncopyright notice and disclaimer of warranty; keep intact all the\nnotices that refer to this License and to the absence of any warranty;\nand give any other recipients of the Program a copy of this License\nalong with the Program.\n\nYou may charge a fee for the physical act of transferring a copy, and\nyou may at your option offer warranty protection in exchange for a fee.\n\n 2. You may modify your copy or copies of the Program or any portion\nof it, thus forming a work based on the Program, and copy and\ndistribute such modifications or work under the terms of Section 1\nabove, provided that you also meet all of these conditions:\n\n a) You must cause the modified files to carry prominent notices\n stating that you changed the files and the date of any change.\n\n b) You must cause any work that you distribute or publish, that in\n whole or in part contains or is derived from the Program or any\n part thereof, to be licensed as a whole at no charge to all third\n parties under the terms of this License.\n\n c) If the modified program normally reads commands interactively\n when run, you must cause it, when started running for such\n interactive use in the most ordinary way, to print or display an\n announcement including an appropriate copyright notice and a\n notice that there is no warranty (or else, saying that you provide\n a warranty) and that users may redistribute the program under\n these conditions, and telling the user how to view a copy of this\n License. (Exception: if the Program itself is interactive but\n does not normally print such an announcement, your work based on\n the Program is not required to print an announcement.)\n\nThese requirements apply to the modified work as a whole. If\nidentifiable sections of that work are not derived from the Program,\nand can be reasonably considered independent and separate works in\nthemselves, then this License, and its terms, do not apply to those\nsections when you distribute them as separate works. But when you\ndistribute the same sections as part of a whole which is a work based\non the Program, the distribution of the whole must be on the terms of\nthis License, whose permissions for other licensees extend to the\nentire whole, and thus to each and every part regardless of who wrote it.\n\nThus, it is not the intent of this section to claim rights or contest\nyour rights to work written entirely by you; rather, the intent is to\nexercise the right to control the distribution of derivative or\ncollective works based on the Program.\n\nIn addition, mere aggregation of another work not based on the Program\nwith the Program (or with a work based on the Program) on a volume of\na storage or distribution medium does not bring the other work under\nthe scope of this License.\n\n 3. You may copy and distribute the Program (or a work based on it,\nunder Section 2) in object code or executable form under the terms of\nSections 1 and 2 above provided that you also do one of the following:\n\n a) Accompany it with the complete corresponding machine-readable\n source code, which must be distributed under the terms of Sections\n 1 and 2 above on a medium customarily used for software interchange; or,\n\n b) Accompany it with a written offer, valid for at least three\n years, to give any third party, for a charge no more than your\n cost of physically performing source distribution, a complete\n machine-readable copy of the corresponding source code, to be\n distributed under the terms of Sections 1 and 2 above on a medium\n customarily used for software interchange; or,\n\n c) Accompany it with the information you received as to the offer\n to distribute corresponding source code. (This alternative is\n allowed only for noncommercial distribution and only if you\n received the program in object code or executable form with such\n an offer, in accord with Subsection b above.)\n\nThe source code for a work means the preferred form of the work for\nmaking modifications to it. For an executable work, complete source\ncode means all the source code for all modules it contains, plus any\nassociated interface definition files, plus the scripts used to\ncontrol compilation and installation of the executable. However, as a\nspecial exception, the source code distributed need not include\nanything that is normally distributed (in either source or binary\nform) with the major components (compiler, kernel, and so on) of the\noperating system on which the executable runs, unless that component\nitself accompanies the executable.\n\nIf distribution of executable or object code is made by offering\naccess to copy from a designated place, then offering equivalent\naccess to copy the source code from the same place counts as\ndistribution of the source code, even though third parties are not\ncompelled to copy the source along with the object code.\n\n 4. You may not copy, modify, sublicense, or distribute the Program\nexcept as expressly provided under this License. Any attempt\notherwise to copy, modify, sublicense or distribute the Program is\nvoid, and will automatically terminate your rights under this License.\nHowever, parties who have received copies, or rights, from you under\nthis License will not have their licenses terminated so long as such\nparties remain in full compliance.\n\n 5. You are not required to accept this License, since you have not\nsigned it. However, nothing else grants you permission to modify or\ndistribute the Program or its derivative works. These actions are\nprohibited by law if you do not accept this License. Therefore, by\nmodifying or distributing the Program (or any work based on the\nProgram), you indicate your acceptance of this License to do so, and\nall its terms and conditions for copying, distributing or modifying\nthe Program or works based on it.\n\n 6. Each time you redistribute the Program (or any work based on the\nProgram), the recipient automatically receives a license from the\noriginal licensor to copy, distribute or modify the Program subject to\nthese terms and conditions. You may not impose any further\nrestrictions on the recipients' exercise of the rights granted herein.\nYou are not responsible for enforcing compliance by third parties to\nthis License.\n\n 7. If, as a consequence of a court judgment or allegation of patent\ninfringement or for any other reason (not limited to patent issues),\nconditions are imposed on you (whether by court order, agreement or\notherwise) that contradict the conditions of this License, they do not\nexcuse you from the conditions of this License. If you cannot\ndistribute so as to satisfy simultaneously your obligations under this\nLicense and any other pertinent obligations, then as a consequence you\nmay not distribute the Program at all. For example, if a patent\nlicense would not permit royalty-free redistribution of the Program by\nall those who receive copies directly or indirectly through you, then\nthe only way you could satisfy both it and this License would be to\nrefrain entirely from distribution of the Program.\n\nIf any portion of this section is held invalid or unenforceable under\nany particular circumstance, the balance of the section is intended to\napply and the section as a whole is intended to apply in other\ncircumstances.\n\nIt is not the purpose of this section to induce you to infringe any\npatents or other property right claims or to contest validity of any\nsuch claims; this section has the sole purpose of protecting the\nintegrity of the free software distribution system, which is\nimplemented by public license practices. Many people have made\ngenerous contributions to the wide range of software distributed\nthrough that system in reliance on consistent application of that\nsystem; it is up to the author/donor to decide if he or she is willing\nto distribute software through any other system and a licensee cannot\nimpose that choice.\n\nThis section is intended to make thoroughly clear what is believed to\nbe a consequence of the rest of this License.\n\n 8. If the distribution and/or use of the Program is restricted in\ncertain countries either by patents or by copyrighted interfaces, the\noriginal copyright holder who places the Program under this License\nmay add an explicit geographical distribution limitation excluding\nthose countries, so that distribution is permitted only in or among\ncountries not thus excluded. In such case, this License incorporates\nthe limitation as if written in the body of this License.\n\n 9. The Free Software Foundation may publish revised and/or new versions\nof the General Public License from time to time. Such new versions will\nbe similar in spirit to the present version, but may differ in detail to\naddress new problems or concerns.\n\nEach version is given a distinguishing version number. If the Program\nspecifies a version number of this License which applies to it and \"any\nlater version\", you have the option of following the terms and conditions\neither of that version or of any later version published by the Free\nSoftware Foundation. If the Program does not specify a version number of\nthis License, you may choose any version ever published by the Free Software\nFoundation.\n\n 10. If you wish to incorporate parts of the Program into other free\nprograms whose distribution conditions are different, write to the author\nto ask for permission. For software which is copyrighted by the Free\nSoftware Foundation, write to the Free Software Foundation; we sometimes\nmake exceptions for this. Our decision will be guided by the two goals\nof preserving the free status of all derivatives of our free software and\nof promoting the sharing and reuse of software generally.\n\n\t\t\t NO WARRANTY\n\n 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY\nFOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN\nOTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES\nPROVIDE THE PROGRAM \"AS IS\" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED\nOR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF\nMERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS\nTO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE\nPROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,\nREPAIR OR CORRECTION.\n\n 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING\nWILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR\nREDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,\nINCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING\nOUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED\nTO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY\nYOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER\nPROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE\nPOSSIBILITY OF SUCH DAMAGES.\n\n\t\t END OF TERMS AND CONDITIONS\n\n\t How to Apply These Terms to Your New Programs\n\n If you develop a new program, and you want it to be of the greatest\npossible use to the public, the best way to achieve this is to make it\nfree software which everyone can redistribute and change under these terms.\n\n To do so, attach the following notices to the program. It is safest\nto attach them to the start of each source file to most effectively\nconvey the exclusion of warranty; and each file should have at least\nthe \"copyright\" line and a pointer to where the full notice is found.\n\n \n Copyright (C) \n\n This program is free software; you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation; either version 2 of the License, or\n (at your option) any later version.\n\n This program is distributed in the hope that it will be useful,\n but WITHOUT ANY WARRANTY; without even the implied warranty of\n MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n GNU General Public License for more details.\n\n You should have received a copy of the GNU General Public License\n along with this program; if not, write to the Free Software\n Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n\n\nAlso add information on how to contact you by electronic and paper mail.\n\nIf the program is interactive, make it output a short notice like this\nwhen it starts in an interactive mode:\n\n Gnomovision version 69, Copyright (C) year name of author\n Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.\n This is free software, and you are welcome to redistribute it\n under certain conditions; type `show c' for details.\n\nThe hypothetical commands `show w' and `show c' should show the appropriate\nparts of the General Public License. Of course, the commands you use may\nbe called something other than `show w' and `show c'; they could even be\nmouse-clicks or menu items--whatever suits your program.\n\nYou should also get your employer (if you work as a programmer) or your\nschool, if any, to sign a \"copyright disclaimer\" for the program, if\nnecessary. Here is a sample; alter the names:\n\n Yoyodyne, Inc., hereby disclaims all copyright interest in the program\n `Gnomovision' (which makes passes at compilers) written by James Hacker.\n\n , 1 April 1989\n Ty Coon, President of Vice\n\nThis General Public License does not permit incorporating your program into\nproprietary programs. If your program is a subroutine library, you may\nconsider it more useful to permit linking proprietary applications with the\nlibrary. If this is what you want to do, use the GNU Lesser General\nPublic License instead of this License.\n" }, { "path": "Makefile", "content": "##\n# MegaZeux Build System (GNU Make)\n#\n# NOTE: This build system is designed to not use recursive Makefiles.\n# The rationale for this is documented here:\n#\n# https://web.archive.org/web/20200128044903/http://aegis.sourceforge.net/auug97.pdf\n##\n\n#\n# Remove all built-in rules.\n#\n.SUFFIXES:\nifeq ($(filter -r,$(MAKEFLAGS)),)\nMAKEFLAGS += -r\nendif\n\n.PHONY: all clean help_check mzx mzx.debug build build_clean source\n.PHONY: test testworlds unit unittest test_clean unit_clean\n\n#\n# Define this first so arch-specific rules don't hijack the default target.\n#\nall:\n\n-include platform.inc\ninclude version.inc\n\n#\n# ${build_root}: base location where builds are copied to be archived for release.\n# ${build}: location where the MegaZeux executable and data files should be placed.\n# Defaults to ${build_root}, but the architecture Makefile may override this to\n# use a subdirectory instead. This is useful when a platform expects a particular\n# path hierarchy within the archive (e.g. MacOS .app bundles).\n#\nbuild_root := build/${SUBPLATFORM}\nbuild := ${build_root}\n\nEXTRA_LICENSES ?=\nLICENSE_CC0 ?= arch/LICENSE.CC0\nLICENSE_DJGPP ?= arch/LICENSE.DJGPP\nLICENSE_LGPL2 ?= arch/LICENSE.LGPL2\nLICENSE_MPL2 ?= arch/LICENSE.MPL2\nLICENSE_NEWLIB ?= arch/LICENSE.Newlib\n\n-include arch/${PLATFORM}/Makefile.in\n\nCC ?= gcc\nCXX ?= g++\nAR ?= ar\nAS ?= as\nSTRIP ?= strip\nOBJCOPY ?= objcopy\nWINDRES ?= windres\nPEFIX ?= true\n\nCHMOD ?= chmod\nCP ?= cp\nHOST_CC ?= gcc\nLN ?= ln\nMKDIR ?= mkdir\nMV ?= mv\nRM ?= rm\n\nifneq (${CROSS_COMPILE},)\nifeq (${CC},cc)\nCC = gcc\nendif\nCC := ${CROSS_COMPILE}${CC}\nCXX := ${CROSS_COMPILE}${CXX}\nAR := ${CROSS_COMPILE}${AR}\nAS := ${CROSS_COMPILE}${AS}\nSTRIP := ${CROSS_COMPILE}${STRIP}\nOBJCOPY := ${CROSS_COMPILE}${OBJCOPY}\nWINDRES := ${CROSS_COMPILE}${WINDRES}\nendif\n\ninclude arch/compat.inc\n\n#\n# Set up CFLAGS/LDFLAGS for all MegaZeux external dependencies.\n#\n\nifneq (${BUILD_SDL},)\n\n#\n# SDL 3\n#\nifeq (${BUILD_SDL},3)\n# Check SDL_PKG_CONFIG_PATH and PREFIX/lib/pkgconfig for sdl3.pc.\n# Note --with-path is a pkgconf extension.\nifneq ($(and ${SDL_PKG_CONFIG_PATH},$(wildcard ${SDL_PKG_CONFIG_PATH}/sdl3.pc)),)\n# nop\nelse\n# Check dependencies prefix instead for LIBDIR=. platforms.\n# This is useless for unix/darwin, which should have sdl3.pc in a\n# place pkgconf can find through normal means.\nifeq (${LIBDIR},.)\nifneq ($(wildcard ${PREFIX}/lib/pkgconfig/sdl3.pc),)\nSDL_PKG_CONFIG_PATH ?= ${PREFIX}/lib/pkgconfig\nendif\nendif # LIBDIR=.\nendif\nifneq (${SDL_PKG_CONFIG_PATH},)\nSDL_PKG_CONFIG_FLAGS = --with-path=${SDL_PKG_CONFIG_PATH}\nSDL_PKG_CONFIG_FORCE := PKG_CONFIG_PATH=\"${SDL_PKG_CONFIG_PATH}\"\nelse\nSDL_PKG_CONFIG_FORCE :=\nendif\n\nSDL_PREFIX := $(shell ${SDL_PKG_CONFIG_FORCE} ${PKGCONF} ${SDL_PKG_CONFIG_FLAGS} sdl3 --variable=prefix)\nSDL_CFLAGS ?= $(shell ${SDL_PKG_CONFIG_FORCE} ${PKGCONF} ${SDL_PKG_CONFIG_FLAGS} sdl3 --cflags)\nSDL_LDFLAGS ?= $(shell ${SDL_PKG_CONFIG_FORCE} ${PKGCONF} ${SDL_PKG_CONFIG_FLAGS} sdl3 --libs)\nendif # SDL3\n\n#\n# SDL 2\n#\nifeq (${BUILD_SDL},2)\n# Check PREFIX for sdl2-config.\nifneq ($(and ${SDL_PREFIX},$(wildcard ${SDL_PREFIX}/bin/sdl2-config)),)\nSDL_CONFIG := ${SDL_PREFIX}/bin/sdl2-config\nelse\nifneq ($(wildcard ${PREFIX}/bin/sdl2-config),)\nSDL_CONFIG := ${PREFIX}/bin/sdl2-config\nelse\nSDL_CONFIG := sdl2-config\nendif\nendif\n\nSDL_PREFIX ?= $(shell ${SDL_CONFIG} --prefix)\nSDL_CFLAGS ?= $(shell ${SDL_CONFIG} --prefix=${SDL_PREFIX} --cflags | sed 's,-I,-isystem ,g')\nSDL_LDFLAGS ?= $(shell ${SDL_CONFIG} --prefix=${SDL_PREFIX} --libs)\nendif # SDL2\n\n#\n# SDL 1.2\n#\nifeq (${BUILD_SDL},1)\nEXTRA_LICENSES += ${LICENSE_LGPL2}\n\n# Check PREFIX for sdl-config.\nifneq ($(and ${SDL_PREFIX},$(wildcard ${SDL_PREFIX}/bin/sdl-config)),)\nSDL_CONFIG := ${SDL_PREFIX}/bin/sdl-config\nelse\nifneq ($(wildcard ${PREFIX}/bin/sdl-config),)\nSDL_CONFIG := ${PREFIX}/bin/sdl-config\nelse\nSDL_CONFIG := sdl-config\nendif\nendif\n\nSDL_PREFIX ?= $(shell ${SDL_CONFIG} --prefix)\nSDL_CFLAGS ?= $(shell ${SDL_CONFIG} --prefix=${SDL_PREFIX} --cflags | sed 's,-I,-isystem ,g')\nSDL_LDFLAGS ?= $(shell ${SDL_CONFIG} --prefix=${SDL_PREFIX} --libs)\nendif # SDL1\n\n# Make these immediate so the scripts run only once.\nSDL_PREFIX := $(SDL_PREFIX)\nSDL_CFLAGS := $(SDL_CFLAGS)\nSDL_LDFLAGS := $(LINK_DYNAMIC_IF_MIXED) $(SDL_LDFLAGS)\n\nendif # SDL\n\n#\n# libvorbis/tremor/stb_vorbis\n#\n\nVORBIS_CFLAGS ?= -I${PREFIX}/include -DOV_EXCLUDE_STATIC_CALLBACKS\nifeq (${VORBIS},vorbis)\nVORBIS_LDFLAGS ?= $(LINK_STATIC_IF_MIXED) -L${PREFIX}/lib -lvorbisfile -lvorbis -logg\nendif\nifeq (${VORBIS},tremor)\nVORBIS_LDFLAGS ?= $(LINK_STATIC_IF_MIXED) -L${PREFIX}/lib -lvorbisidec -logg\nendif\nifeq (${VORBIS},tremor-lowmem)\nVORBIS_LDFLAGS ?= $(LINK_STATIC_IF_MIXED) -L${PREFIX}/lib -lvorbisidec\nendif\nifeq (${VORBIS},stb_vorbis)\nVORBIS_LDFLAGS ?= -L${PREFIX}/lib\nendif\n\n#\n# MikMod (optional mod engine)\n#\n\nMIKMOD_CFLAGS ?= -I${PREFIX}/include\nMIKMOD_LDFLAGS ?= $(LINK_STATIC_IF_MIXED) -L${PREFIX}/lib -lmikmod\nifneq (${BUILD_MIKMOD},)\nEXTRA_LICENSES += ${LICENSE_LGPL2}\nendif\n\n#\n# libopenmpt (optional mod engine)\n#\n\nOPENMPT_CFLAGS ?= -I${PREFIX}/include\nOPENMPT_LDFLAGS ?= $(LINK_STATIC_IF_MIXED) -L${PREFIX}/lib -lopenmpt\n\n#\n# zlib\n#\n\nZLIB_CFLAGS ?= -I${PREFIX}/include\nZLIB_LDFLAGS ?= $(LINK_STATIC_IF_MIXED) -L${PREFIX}/lib -lz\n\n#\n# libpng\n#\n\nifeq (${LIBPNG},1)\n\n# Check PREFIX for libpng-config.\nifneq ($(and ${LIBPNG_PREFIX},$(wildcard ${LIBPNG_PREFIX}/bin/libpng-config)),)\nLIBPNG_CONFIG := ${LIBPNG_PREFIX}/bin/libpng-config\nelse\nifneq ($(wildcard ${PREFIX}/bin/libpng-config),)\nLIBPNG_CONFIG := ${PREFIX}/bin/libpng-config\nelse\nLIBPNG_CONFIG := libpng-config\nendif\nendif\n\nLIBPNG_CFLAGS ?= $(shell ${LIBPNG_CONFIG} --cflags)\nLIBPNG_LDFLAGS ?= $(shell ${LIBPNG_CONFIG} --ldflags)\n\n# Make these immediate so the scripts run only once.\nLIBPNG_CFLAGS := $(LIBPNG_CFLAGS)\nLIBPNG_LDFLAGS := $(LINK_STATIC_IF_MIXED) $(LIBPNG_LDFLAGS)\nendif\n\n#\n# X11\n#\n\nifneq (${X11DIR},)\n# BSD needs this but Fedora rpmbuild will whine about it and fail.\nifneq (${X11DIR},/usr)\nX11RPATH ?= -Wl,-rpath,${X11LIBDIR}\nendif\nX11_CFLAGS ?= -I${X11DIR}/include\nX11_LDFLAGS ?= -L${X11LIBDIR} -lX11 ${X11RPATH}\n# Make these immediate\nX11_CFLAGS := $(X11_CFLAGS)\nX11_LDFLAGS := $(X11_LDFLAGS)\nendif\n\n#\n# pthread\n#\n\nPTHREAD_LDFLAGS ?= -lpthread\n\n#\n# Set up general CFLAGS/LDFLAGS\n#\n\n#\n# Usually, just disable the optimizer for \"true\" debug builds and\n# define \"DEBUG\" to enable optional code at compile time.\n# Optimized builds have assert() compiled out.\n#\nifneq (${DEBUG},1)\nOPTIMIZE_FLAGS := -O3 ${OPTIMIZE_CFLAGS} ${OPTIMIZE_FLAGS}\nOPTIMIZE_DEF ?= -DNDEBUG\nelse\nOPTIMIZE_FLAGS := -O0 ${DEBUG_CFLAGS} ${OPTIMIZE_FLAGS}\nOPTIMIZE_DEF ?= -DDEBUG\nendif\n\n#\n# Enable a sanitizer and its corresponding extra options, if selected.\n#\nifeq (${SANITIZER},address)\nOPTIMIZE_FLAGS += -fsanitize=address -fno-omit-frame-pointer\nendif\nifeq (${SANITIZER},undefined)\n# Signed integer overflows (shift-base, signed-integer-overflow)\n# are pretty much inevitable in Robotic, so ignore them.\nOPTIMIZE_FLAGS += -fsanitize=undefined -fno-omit-frame-pointer \\\n -fno-sanitize-recover=all -fno-sanitize=shift-base,signed-integer-overflow\nendif\nifeq (${SANITIZER},thread)\nOPTIMIZE_FLAGS += -fsanitize=thread -fno-omit-frame-pointer -fPIE\nARCH_EXE_LDFLAGS += -pie\nendif\nifeq (${SANITIZER},memory)\n# Note: to be useful, this requires a fairly special build with most\n# external libraries turned off or re-built with instrumentation.\n# This sanitizer is only implemented by clang.\nOPTIMIZE_FLAGS += -fsanitize=memory -fno-omit-frame-pointer -fPIC \\\n -fsanitize-memory-track-origins=2\nARCH_EXE_LDFLAGS += -pie\nendif\n\n#\n# Enable link-time optimization.\n#\nifeq (${LTO},1)\nifeq (${HAS_F_LTO},1)\nOPTIMIZE_FLAGS += -flto\nelse\n$(warning link-time optimization not supported, ignoring.)\nendif\nendif\n\nCFLAGS += ${OPTIMIZE_FLAGS} ${OPTIMIZE_DEF}\nCXXFLAGS += ${OPTIMIZE_FLAGS} ${OPTIMIZE_DEF}\nLDFLAGS += ${OPTIMIZE_FLAGS}\n\n#\n# Enable C++11 for compilers that support it.\n# Anything actually using C++11 should be optional or platform-specific,\n# as features using C++11 reduce portability.\n#\nifeq (${HAS_CXX_11},1)\nCXX_STD = -std=gnu++11\nelse\nCXX_STD = -std=gnu++98\nendif\n\n#\n# Always generate debug information; this may end up being\n# stripped (on embedded platforms) or objcopy'ed out.\n#\nCFLAGS += -std=gnu99 -g ${ARCH_CFLAGS}\nCXXFLAGS += ${CXX_STD} -g -fno-exceptions -fno-rtti ${ARCH_CXXFLAGS}\nLDFLAGS += ${ARCH_LDFLAGS}\n\n#\n# Default warnings.\n# Note: -Wstrict-prototypes was previously turned off for Android/NDS/Wii/PSP.\n#\nwarnings := -Wall -Wextra -Wno-unused-parameter -Wwrite-strings\nwarnings += -Wundef -Wunused-macros -Wpointer-arith\nCFLAGS += ${warnings} -Wdeclaration-after-statement -Wmissing-prototypes -Wstrict-prototypes\nCXXFLAGS += ${warnings}\n\n#\n# Optional compile flags.\n#\n\n#\n# Warn against global functions defined without a previous declaration (C++).\n#\nifeq (${HAS_W_MISSING_DECLARATIONS_CXX},1)\nCXXFLAGS += -Wmissing-declarations\nendif\n\n#\n# Warn against variable-length array (VLA) usage, which is technically valid\n# C99 but is in bad taste and isn't supported by MSVC.\n#\nifeq (${HAS_W_VLA},1)\nCFLAGS += -Wvla\nCXXFLAGS += -Wvla\nendif\n\n#\n# Linux GCC gives spurious format truncation warnings. The snprintf\n# implementation on Linux will terminate even in the case of truncation,\n# making this largely useless. It does not trigger using mingw (where it\n# would actually matter).\n#\nifeq (${HAS_W_NO_FORMAT_TRUNCATION},1)\nCFLAGS += -Wno-format-truncation\nCXXFLAGS += -Wno-format-truncation\nendif\n\n#\n# Old GCC versions emit false positive warnings for C++11 value initializers.\n#\nifeq (${HAS_BROKEN_W_MISSING_FIELD_INITIALIZERS},1)\nCXXFLAGS += -Wno-missing-field-initializers\nendif\n\n#\n# We enable pedantic warnings here, but this ends up turning on some things\n# we must disable by hand.\n#\n# Variadic macros are arguably less portable, but all the compilers we\n# support have them.\n#\nifeq (${HAS_PEDANTIC},1)\nCFLAGS += -pedantic\nCXXFLAGS += -pedantic\n\nifeq (${HAS_W_NO_VARIADIC_MACROS},1)\nCFLAGS += -Wno-variadic-macros\nCXXFLAGS += -Wno-variadic-macros\nendif\nendif\n\n#\n# KallistiOS has a pretty dire header situation\n#\nifeq (${BUILD_DREAMCAST},1)\nCFLAGS += -Wno-strict-prototypes -Wno-pedantic\nCXXFLAGS += -Wno-pedantic\nendif\n\n#\n# As does BlocksDS, currently\n#\nifeq (${BUILD_NDS_BLOCKSDS},1)\nCFLAGS += -Wno-strict-prototypes -Wno-pedantic -Wno-declaration-after-statement\nCXXFLAGS += -Wno-pedantic\nendif\n\n#\n# The following flags are not applicable to mingw or djgpp builds.\n#\nifneq (${PLATFORM},mingw)\nifneq (${PLATFORM},djgpp)\n\n#\n# Symbols in COFF binaries are implicitly hidden unless exported; this\n# flag just confuses GCC and must be disabled.\n#\nifeq (${HAS_F_VISIBILITY},1)\nCFLAGS += -fvisibility=hidden\nCXXFLAGS += -fvisibility=hidden\nendif\n\nendif # PLATFORM=djgpp\nendif # PLATFORM=mingw\n\n#\n# The stack protector is optional and is generally only built for Linux/BSD and\n# Mac OS X. It also works on Windows. GCC's -fstack-protector-strong is\n# preferred when available due to better performance.\n#\nifeq (${BUILD_STACK_PROTECTOR},1)\nifeq (${HAS_F_STACK_PROTECTOR_STRONG},1)\nCFLAGS += -fstack-protector-strong\nCXXFLAGS += -fstack-protector-strong\nelse\nifeq (${HAS_F_STACK_PROTECTOR},1)\nCFLAGS += -fstack-protector-all\nCXXFLAGS += -fstack-protector-all\nelse\n$(warning stack protector not supported, ignoring.)\nendif\nendif\nendif\n\n#\n# Enable -fanalyzer if supported.\n#\nifeq (${BUILD_F_ANALYZER},1)\nifeq (${HAS_F_ANALYZER},1)\nCFLAGS += -fanalyzer\nCXXFLAGS += -fanalyzer\nelse\n$(warning GCC 10+ is required for -fanalyzer, ignoring.)\nendif\nendif\n\n#\n# Enable position-independent code across the board for modular builds.\n#\nifeq (${BUILD_MODULAR},1)\nCFLAGS += -fPIC\nCXXFLAGS += -fPIC\nendif\n\n#\n# We don't want these commands to be echo'ed in non-verbose mode\n#\nifneq (${V},1)\noverride V:=\n\nCC := @${CC}\nCXX := @${CXX}\nAR := @${AR}\nAS := @${AS}\nSTRIP := @${STRIP}\nOBJCOPY := @${OBJCOPY}\nWINDRES := @${WINDRES}\nPEFIX := @${PEFIX}\n\nCHMOD := @${CHMOD}\nCP := @${CP}\nHOST_CC := @${HOST_CC}\nLN := @${LN}\nMKDIR := @${MKDIR}\nMV := @${MV}\nRM := @${RM}\nendif\n\nbuild_clean:\n\t$(if ${V},,@echo \" RM \" build)\n\t${RM} -r build\n\nsource: build/${TARGET}src\n\n#\n# Build source target\n# Targeting unix primarily, so turn off autocrlf if necessary.\n#\nbuild/${TARGET}src:\n\t${RM} -r build/${TARGET}\n\t${MKDIR} -p build/dist/source\n\t@git -c \"core.autocrlf=false\" checkout-index -a --prefix build/${TARGET}/\n\t${RM} -r build/${TARGET}/scripts\n\t${RM} build/${TARGET}/.gitignore build/${TARGET}/.gitattributes\n\t@cd build/${TARGET} && ${MAKE} distclean\n\t@tar -C build -Jcf build/dist/source/${TARGET}src.tar.xz ${TARGET}\n\n#\n# The SUPPRESS_ALL_TARGETS hack is required to allow the placebo \"dist\"\n# Makefile to provide an 'all:' target, which allows it to print\n# a message. Pulling in any other targets would confuse Make.\n#\n# Additionally, there are several other SUPPRESS flags that can be set to\n# conditionally disable rules. This is useful for cross-compiling builds that\n# have no use for host-based rules or for platforms that use meta targets.\n#\n# * SUPPRESS_CC_TARGETS prevents \"mzx\", etc from being added to \"all\".\n# * SUPPRESS_BUILD_TARGETS suppresses \"build\".\n# * SUPPRESS_HOST_TARGETS suppresses \"assets/help.fil\", \"test\", etc.\n#\nifneq (${SUPPRESS_ALL_TARGETS},1)\n\nmzxrun = mzxrun${BINEXT}\nmzx = megazeux${BINEXT}\n\nmzx: ${mzxrun} ${mzx}\nmzx.debug: ${mzxrun}.debug ${mzx}.debug\n\nifeq (${BUILD_MODPLUG},1)\nBUILD_GDM2S3M=1\nendif\n\n%/.build:\n\t$(if ${V},,@echo \" MKDIR \" $@)\n\t${MKDIR} $@\n\n%.debug: %\n\t$(if ${V},,@echo \" OBJCOPY \" --only-keep-debug $< $@)\n\t${OBJCOPY} --only-keep-debug $< $@\n\t${PEFIX} $@\n\t${CHMOD} a-x $@\nifneq (${NO_STRIP_IN_DEBUGLINK},1)\n\t$(if ${V},,@echo \" STRIP \" --strip-unneeded $<)\n\t${STRIP} --strip-unneeded $<\nendif\n\t$(if ${V},,@echo \" OBJCOPY \" --add-gnu-debuglink $@ $<)\n\t${OBJCOPY} --add-gnu-debuglink=$@ $<\n\t${PEFIX} $<\n\t@touch $@\n\ninclude src/Makefile.in\n\nclean: mzx_clean test_clean unit_clean\n\nifneq (${SUPPRESS_CC_TARGETS},1)\nall: mzx\ndebuglink: all mzx.debug\nendif\n\nifeq (${BUILD_UTILS},1)\ninclude src/utils/Makefile.in\nclean: utils_clean\nifneq (${SUPPRESS_CC_TARGETS},1)\ndebuglink: utils utils.debug\nall: utils\nendif\nendif\n\nifneq (${SUPPRESS_BUILD_TARGETS},1)\n\nifeq (${build},)\nbuild := ${build_root}\nendif\n\n.PHONY: ${build}\n\nbuild: ${build} ${build}/assets ${build}/docs\n\n${build}:\n\t${RM} -r ${build_root}\n\t${MKDIR} -p ${build}\n\t${CP} config.txt LICENSE arch/LICENSE.3rd ${EXTRA_LICENSES} ${build}\n\t@if test -f ${mzxrun}; then \\\n\t\tcp ${mzxrun} ${build}; \\\n\tfi\n\t@if test -f ${mzxrun}.debug; then \\\n\t\tcp ${mzxrun}.debug ${build}; \\\n\tfi\nifeq (${BUILD_EDITOR},1)\n\t@if test -f ${mzx}; then \\\n\t\tcp ${mzx} ${build}; \\\n\tfi\n\t@if test -f ${mzx}.debug; then \\\n\t\tcp ${mzx}.debug ${build}; \\\n\tfi\nendif\nifeq (${BUILD_MODULAR},1)\n\t${CP} ${core_target} ${editor_target} ${build}\n\t@if test -f ${core_target}.debug; then \\\n\t\tcp ${core_target}.debug ${build}; \\\n\tfi\n\t@if test -f ${editor_target}.debug; then \\\n\t\tcp ${editor_target}.debug ${build}; \\\n\tfi\nendif\nifeq (${BUILD_UTILS},1)\n\t${MKDIR} ${build}/utils\n\t${CP} ${checkres} ${downver} ${build}/utils\n\t${CP} ${hlp2txt} ${txt2hlp} ${build}/utils\n\t${CP} ${ccv} ${png2smzx} ${y4m2smzx} ${build}/utils\n\t@if [ -f \"${checkres}.debug\" ]; then cp ${checkres}.debug ${build}/utils; fi\n\t@if [ -f \"${downver}.debug\" ]; then cp ${downver}.debug ${build}/utils; fi\n\t@if [ -f \"${hlp2txt}.debug\" ]; then cp ${hlp2txt}.debug ${build}/utils; fi\n\t@if [ -f \"${txt2hlp}.debug\" ]; then cp ${txt2hlp}.debug ${build}/utils; fi\n\t@if [ -f \"${ccv}.debug\" ]; then cp ${ccv}.debug ${build}/utils; fi\n\t@if [ -f \"${png2smzx}.debug\" ]; then cp ${png2smzx}.debug ${build}/utils; fi\n\t@if [ -f \"${y4m2smzx}.debug\" ]; then cp ${y4m2smzx}.debug ${build}/utils; fi\nendif\n\n${build}/docs: ${build}\n\t${MKDIR} -p ${build}/docs\n\t${CP} docs/macro.txt docs/keycodes.html docs/mzxhelp.html ${build}/docs\n\t${CP} docs/joystick.html docs/cycles_and_commands.txt ${build}/docs\n\t${CP} docs/fileform.html ${build}/docs\n\t${CP} docs/changelog.txt docs/platform_matrix.html ${build}/docs\n\n${build}/assets: ${build}\n\t${MKDIR} -p ${build}/assets\n\t${CP} assets/default.chr assets/edit.chr ${build}/assets\n\t${CP} assets/smzx.pal ${build}/assets\nifeq (${BUILD_EDITOR},1)\n\t${CP} assets/ascii.chr assets/blank.chr ${build}/assets\n\t${CP} assets/smzx.chr assets/smzx2.chr ${build}/assets\nendif\nifeq (${BUILD_HELPSYS},1)\n\t${CP} assets/help.fil ${build}/assets\nendif\nifeq (${BUILD_RENDER_GL_PROGRAM},1)\n\t${MKDIR} -p ${build}/assets/glsl/scalers\n\t${CP} assets/glsl/*.vert ${build}/assets/glsl\n\t${CP} assets/glsl/*.frag ${build}/assets/glsl\n\t${CP} assets/glsl/README.md ${build}/assets/glsl\n\t${CP} assets/glsl/scalers/*.frag assets/glsl/scalers/*.vert \\\n\t\t${build}/assets/glsl/scalers\nendif\nifeq (${BUILD_GAMECONTROLLERDB},1)\n\t${CP} assets/gamecontrollerdb.txt \\\n\t ${build}/assets\nendif\nifeq (${BUILD_UTILS},1)\n\t${CP} contrib/mzvplay/mzvplay.txt \\\n\t ${build}/utils\nendif\n\nendif # !SUPPRESS_BUILD_TARGETS\n\ndistclean: clean\n\t@echo \" DISTCLEAN\"\n\t@rm -f src/config.h\n\t@echo \"PLATFORM=none\" > platform.inc\n\nifneq (${SUPPRESS_HOST_TARGETS},1)\n\nassets/help.fil: ${txt2hlp} docs/WIPHelp.txt\n\t$(if ${V},,@echo \" txt2hlp \" $@)\n\t@src/utils/txt2hlp docs/WIPHelp.txt $@\n\ndocs/mzxhelp.html: ${hlp2html} docs/WIPHelp.txt\n\t$(if ${V},,@echo \" hlp2html\" $@)\n\t@src/utils/hlp2html docs/WIPHelp.txt docs/mzxhelp.html\n\nhelp_check: ${hlp2txt} assets/help.fil\n\t@src/utils/hlp2txt assets/help.fil help.txt\n\t@echo @ >> help.txt\n\t@diff --strip-trailing-cr -q docs/WIPHelp.txt help.txt\n\t@rm -f help.txt\n\n-include unit/Makefile.in\n\ntest: unit\n\ntest testworlds:\nifeq (${BUILD_MODULAR},1)\n\t@${SHELL} testworlds/run.sh ${PLATFORM} \"$(realpath ${core_target})\"\nelse\n\t@${SHELL} testworlds/run.sh ${PLATFORM}\nendif\n\nendif # !SUPPRESS_HOST_TARGETS\n\ntest_clean:\n\t@rm -rf testworlds/log\n\nendif # !SUPPRESS_ALL_TARGETS\n" }, { "path": "README.md", "content": "# MegaZeux\n[Official MegaZeux git repository](https://github.com/AliceLR/megazeux)\n\nMegaZeux is a game creation system (GCS) created by game developer Alexis Janson in 1994.\nOriginally a DOS program, in 2005 a multi-platform port was released by Exophase. The most\nrecent version of MegaZeux is 2.93d, which was released on June 9th, 2025.\n\nMegaZeux is officially supported on Windows, Linux, macOS, BSD, Haiku, HTML5,\nand MS-DOS, as well as numerous console ports. See platform_matrix.html for a\nfull list of ports.\n\n## Downloads\n\nWindows, MS-DOS, and console releases are packaged with a copy of the game\nCaverns of Zeux. Older versions are available at [DigitalMZX](https://www.digitalmzx.com/)\nor [on the Github releases page](https://github.com/AliceLR/megazeux/releases).\n\n\n[megazeux-w64]: https://www.digitalmzx.com/download.php?latest=windows64\n[megazeux-w32]: https://www.digitalmzx.com/download.php?latest=windows32\n[megazeux-dos]: https://www.digitalmzx.com/download.php?latest=dos\n[megazeux-dos32]: https://www.digitalmzx.com/download.php?latest=dosdjgpp\n[megazeux-osx]: https://www.digitalmzx.com/download.php?latest=osx\n[megazeux-ppc]: https://www.digitalmzx.com/download.php?latest=osxppc\n[megazeux-u64]: https://www.digitalmzx.com/download.php?latest=ubuntu64\n[megazeux-ults]: https://www.digitalmzx.com/download.php?latest=ubuntu64lts\n[megazeux-d64]: https://www.digitalmzx.com/download.php?latest=debian64\n[megazeux-d32]: https://www.digitalmzx.com/download.php?latest=debian32\n[megazeux-f64]: https://www.digitalmzx.com/download.php?latest=fedora64\n[megazeux-rpi]: https://www.digitalmzx.com/download.php?latest=raspbian\n[megazeux-flat]: https://www.digitalmzx.com/download.php?latest=flatpak\n[megazeux-and]: https://www.digitalmzx.com/download.php?latest=android\n[megazeux-html]: https://www.digitalmzx.com/download.php?latest=html5\n[megazeux-nds]: https://www.digitalmzx.com/download.php?latest=nds\n[megazeux-3ds]: https://www.digitalmzx.com/download.php?latest=3ds\n[megazeux-wii]: https://www.digitalmzx.com/download.php?latest=wii\n[megazeux-wiiu]: https://www.digitalmzx.com/download.php?latest=wiiu\n[megazeux-swi]: https://www.digitalmzx.com/download.php?latest=switch\n[megazeux-psp]: https://www.digitalmzx.com/download.php?latest=psp\n[megazeux-vita]: https://www.digitalmzx.com/download.php?latest=psvita\n[megazeux-dc]: https://www.digitalmzx.com/download.php?latest=dreamcast\n[megazeux-src]: https://www.digitalmzx.com/download.php?latest=src\n\n\n[arch-w64]: contrib/archicons/windows64.png \"Windows x64\"\n[arch-w32]: contrib/archicons/windows32.png \"Windows x86\"\n[arch-dos]: contrib/archicons/dos.png \"MS DOS (MZX 2.70)\"\n[arch-dos32]:contrib/archicons/dosdjgpp.png \"MS DOS (32-bit)\"\n[arch-osx]: contrib/archicons/osx.png \"macOS\"\n[arch-ppc]: contrib/archicons/maccompat.png \"macOS (Compatible)\"\n[arch-u64]: contrib/archicons/ubuntu64.png \"Ubuntu AMD64\"\n[arch-ults]: contrib/archicons/ubuntu64lts.png \"Ubuntu AMD64 LTS\"\n[arch-d64]: contrib/archicons/debian64.png \"Debian AMD64\"\n[arch-d32]: contrib/archicons/debian32.png \"Debian i386\"\n[arch-f64]: contrib/archicons/fedora64.png \"Fedora x86_64\"\n[arch-rpi]: contrib/archicons/raspbian.png \"Raspbian\"\n[arch-flat]:contrib/archicons/flatpak.png \"Flatpak\"\n[arch-and]: contrib/archicons/android.png \"Android\"\n[arch-html]:contrib/archicons/html5.png \"HTML5 (Emscripten)\"\n[arch-aur]: contrib/archicons/archlinux.png \"Arch Linux (via AUR)\"\n[arch-void]:contrib/archicons/voidlinux.png \"Void Linux\"\n[arch-gen]: contrib/archicons/gentoo.png \"Gentoo\"\n[arch-alp]: contrib/archicons/alpine.png \"Alpine Linux\"\n[arch-nds]: contrib/archicons/nds.png \"Nintendo DS\"\n[arch-3ds]: contrib/archicons/3ds.png \"Nintendo 3DS\"\n[arch-wii]: contrib/archicons/wii.png \"Nintendo Wii\"\n[arch-wiiu]:contrib/archicons/wiiu.png \"Nintendo Wii U\"\n[arch-swi]: contrib/archicons/switch.png \"Nintendo Switch\"\n[arch-psp]: contrib/archicons/psp.png \"PlayStation Portable\"\n[arch-vita]:contrib/archicons/psvita.png \"PlayStation Vita\"\n[arch-dc]: contrib/archicons/dreamcast.png \"Sega Dreamcast\"\n[arch-ami]: contrib/archicons/amiga.png \"Amiga OS 4\"\n[arch-gp2x]:contrib/archicons/gp2x.png \"GP2X\"\n[arch-pand]:contrib/archicons/pandora.png \"Pandora\"\n[arch-src]: contrib/archicons/src.png \"Source code\"\n\n\n  [![Windows x64 ][arch-w64]][megazeux-w64]\n  [![Windows x86 ][arch-w32]][megazeux-w32]\n  [![Mac OS X ][arch-osx]][megazeux-osx]\n  [![macOS (Compatible)) ][arch-ppc]][megazeux-ppc]\n  [![Ubuntu AMD64 ][arch-u64]][megazeux-u64]\n  [![Ubuntu AMD64 LTS ][arch-ults]][megazeux-ults]\n  [![Debian AMD64 ][arch-d64]][megazeux-d64]\n  [![Debian i386 ][arch-d32]][megazeux-d32]\n  [![Fedora x86_64 ][arch-f64]][megazeux-f64]\n  [![Raspbian ][arch-rpi]][megazeux-rpi]\n  [![Flatpak ][arch-flat]][megazeux-flat]\n  [![Android ][arch-and]][megazeux-and]\n  [![HTML5 (Emscripten) ][arch-html]][megazeux-html]\n  [![Nintendo DS ][arch-nds]][megazeux-nds]\n  [![Nintendo 3DS ][arch-3ds]][megazeux-3ds]\n  [![Nintendo Wii ][arch-wii]][megazeux-wii]\n  [![Nintendo Wii U ][arch-wiiu]][megazeux-wiiu]\n  [![Nintendo Switch ][arch-swi]][megazeux-swi]\n  [![PlayStation Portable][arch-psp]][megazeux-psp]\n  [![PlayStation Vita ][arch-vita]][megazeux-vita]\n  [![Sega Dreamcast ][arch-dc]][megazeux-dc]\n  [![DOS (32-bit) ][arch-dos32]][megazeux-dos32]\n  [![MS DOS (MZX 2.70) ][arch-dos]][megazeux-dos]\n  [![Source code ][arch-src]][megazeux-src]\n\nThe following platforms have MegaZeux releases available via repository:\n\n  [![Arch Linux (via AUR)][arch-aur]](https://aur.archlinux.org/packages/megazeux/)\n  [![Void Linux][arch-void]](https://github.com/void-linux/void-packages/tree/master/srcpkgs/megazeux)\n  [![Gentoo][arch-gen]](https://github.com/Spectere/megazeux-overlay)\n  [![Alpine Linux][arch-alp]](https://pkgs.alpinelinux.org/packages?name=megazeux)\n  [![Amiga OS 4 (outdated)][arch-ami]](http://aminet.net/package/game/misc/pfp-mgzx)\n  [![GP2X (outdated)][arch-gp2x]](https://dl.openhandhelds.org/cgi-bin/gp2x.cgi?0,0,0,0,26,2920)\n  [![Pandora (outdated)][arch-pand]](https://repo.openpandora.org/?page=detail&app=megazeux_ptitseb)\n\n## Building MegaZeux\n\nSee BUILDING.md for more information about compiling MegaZeux from source.\n\n## Credits\n\n| MegaZeux 2.9x | |\n| ----------------------- | ---------------------------------------------------------- |\n| Alice Rowan | Development/current maintainer |\n| Terryn | Help file; testing |\n| Lancer X | Development; testing |\n| Adrian Siekierka | Development; testing; various ports |\n| Dizzy O'Malley-Morrison | Development; testing; Ubuntu/Debian/Raspbian/Arch packages |\n| Spectere | Development; testing; Xcode and MSVC projects |\n| Alistair Strachan | Development |\n| Others | Various |\n\n#### MegaZeux Credits\n\nProgramming and Overall Design by Gilead Kutnick (Exophase),\nAlistair Strachan (ajs), Alice Rowan (Lachesis) and Lancer-X.\n\nBased off of original program and source code by Alexis Janson.\n\nHelp file by Terryn.\n\nDefault SMZX palette by Joel Lamontagne (LogiCow).\n\nccv utility by Lancer-X.\npng2smzx utility by Alan Williams (Mr_Alert).\ncheckres utility by Josh Matthews (Revvy), ajs and Lachesis.\n\nPort contributors: Adrian Siekierka (asiekierka) [3DS],\nMr_Alert [Wii], Kevin Vance [NDS], Simon Parzer [GP2X].\n\nRenderer code contributors: LogiCow, Mr_Alert.\nShader code contributors: David Cravens (astral), GreaseMonkey.\n\nIcon by Quantum P.; Extra icons by LogiCow.\nGDM conversion by ajs and MadBrain.\nOther past contributors: Spider124, Koji, JZig, Akwende, MenTaLguY.\n\n#### Special Thanks\n\nDizzy (Testing, .deb and Arch packages)\nSpectere (Testing, OS X Builds, MSVC project)\nTerryn (Testing)\nmzxgiant (MSVC Testing, Bug Fixes)\nmzxrules (Testing)\nQuantum P. (OS X Testing / Builds)\nWervyn (Testing)\n\n## License\n\nThis program is free software; you can redistribute it and/or\nmodify it under the terms of the GNU General Public License as\npublished by the Free Software Foundation; either version 2 of\nthe License, or (at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\nGeneral Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this program; if not, write to the Free Software\nFoundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n\n## Contact\n\nWant to talk about MegaZeux? Encountered a bug or would like a new feature?\nThe MegaZeux community and development team can be contacted through Discord,\nGitHub, or the DigitalMZX forums.\n\n[MegaZeux Discord](https://discord.gg/XJCvb4P)
\n[DigitalMZX forums](https://www.digitalmzx.com/forums/)
\n[MegaZeux Bug tracker](https://www.digitalmzx.com/forums/index.php?app=tracker&showproject=4)
\n[MegaZeux Feature requests](https://www.digitalmzx.com/forums/index.php?app=tracker&showproject=9)
\n[AliceLR on GitHub](https://github.com/AliceLR)
\n\n## Resources\n\n[Official MegaZeux game archive](https://www.digitalmzx.com/)
\n[MegaZeux help file](https://www.digitalmzx.com/mzx_help.html)
\n[Development roadmap](https://www.digitalmzx.com/forums/index.php?showtopic=15226)\n" }, { "path": "arch/3ds/CONFIG.3DS", "content": "#!/bin/sh\n\n./config.sh --platform 3ds --enable-release --enable-lto --enable-meter \\\n --disable-sdl --enable-tremor --disable-screenshots --disable-utils \\\n --enable-stdio-redirect \"$@\"\n\n" }, { "path": "arch/3ds/Makefile.in", "content": "#\n# Nintendo 3DS Makefile\n#\n\ninclude $(DEVKITARM)/3ds_rules\n\n.PHONY: package clean\n\nifeq ($(strip $(DEVKITPRO)),)\n$(error \"DEVKITPRO must be set in your environment.\")\nendif\n\nifeq ($(strip $(DEVKITARM)),)\n$(error \"DEVKITARM must be set in your environment.\")\nendif\n\nifneq (${BUILD_EDITOR},)\nAPP_TITLE_MZX = MegaZeux\nAPP_TITLE_MZXRUN = MegaZeux (MZXRun)\nelse\nAPP_TITLE_MZXRUN = MegaZeux\nendif\n\nAPP_DESCRIPTION = Game creation system\nAPP_AUTHOR = MegaZeux Developers\nAPP_ICON = contrib/icons/generated/icon_48.png\n\nEXTRA_LICENSES += ${LICENSE_MPL2} ${LICENSE_NEWLIB}\n\n#\n# 3DS target rules\n#\n\n# Block --host, which will break things.\nCROSS_COMPILE =\n# Don't strip when generating debug symbols.\nNO_STRIP_IN_DEBUGLINK ?= 1\n# Disable rules that require target code to run natively.\nSUPPRESS_HOST_TARGETS ?= 1\n\n#\n# Override library paths.\n#\n\n#\n# As of devkitARM r51 $(PORTLIBS) has multiple paths...\n#\nPORTLIBS_INCLUDES := $(foreach dir, $(PORTLIBS), -isystem $(dir)/include)\nPORTLIBS_LIBS := $(foreach dir, $(PORTLIBS), -L$(dir)/lib)\n\nEXTRA_INCLUDES := -isystem $(CTRULIB)/include ${PORTLIBS_INCLUDES}\nEXTRA_LIBS := -L$(CTRULIB)/lib ${PORTLIBS_LIBS}\nifeq (${DEBUG},1)\nEXTRA_LIBS += -lcitro3dd -lctrud -lpng16 -lz\nelse\nOPTIMIZE_FLAGS += -fomit-frame-pointer -ffunction-sections\nEXTRA_LIBS += -lcitro3d -lctru -lpng16 -lz\nendif\n\nMACHDEP = -march=armv6k -mtune=mpcore -mfloat-abi=hard -mtp=soft -mword-relocations\n\nifneq (${BUILD_SDL},)\n# devkitPro's SDL 1.2 port accidentally defines key_press and key_release as\n# global symbols.\n3DS_CFLAGS += -Dkey_press=mzx_key_press -Dkey_release=mzx_key_release\nendif\n\n3DS_CFLAGS += ${EXTRA_INCLUDES} ${MACHDEP} -DARM11 -D__3DS__ -Iarch/3ds\n\nARCH_CFLAGS += ${3DS_CFLAGS}\nARCH_CXXFLAGS += ${3DS_CFLAGS}\nARCH_LDFLAGS += ${EXTRA_LIBS} ${MACHDEP} -specs=3dsx.specs\n\nLIBPNG_CFLAGS =\nLIBPNG_LDFLAGS = -lpng16\n\n#\n# Vile hack, remove me ASAP\n# (also, vile hack in a vile hack to get the shaders to build parallel)\n#\narch/3ds/%.o: arch/3ds/%.c\n\t$(if ${V},,@echo \" CC \" $<)\n\t${CC} -MD ${core_cflags} ${core_flags} -Wno-unused-macros -c $< -o $@\n\narch/3ds/%.o: arch/3ds/%.cpp arch/3ds/shader_2d.shbin.o arch/3ds/shader_playfield.shbin.o\n\t$(if ${V},,@echo \" CXX \" $<)\n\t${CXX} -MD ${core_cxxflags} ${core_flags} -Wno-unused-macros -c $< -o $@\n\n# Do not delete these, since doing so will retrigger .o rebuilds above\n.SECONDARY: arch/3ds/shader_2d_shbin.h arch/3ds/shader_playfield_shbin.h\n\narch/3ds/%.shbin: arch/3ds/%.v.pica arch/3ds/%.g.pica\n\t$(if ${V},,@echo \" PICASSO \" $^)\n\t@picasso -o $@ $^\n\narch/3ds/%.shbin.o: arch/3ds/%.shbin arch/3ds/%_shbin.h\n\t$(if ${V},,@echo \" AS \" $<)\n\t@bin2s $< > $<.S\n\t@# Shut up the assembler since bin2s doesn't emit a trailing newline:\n\t@echo '' >> $<.S\n\t$(AS) $<.S -o $@\n\narch/3ds/%_shbin.h: arch/3ds/%.shbin\n\t$(eval CURLOC := $(patsubst %_shbin.h,%.shbin,$@))\n\t$(eval CURBIN := $(patsubst %_shbin.h,%.shbin,$(notdir $@)))\n\t$(if ${V},,@echo \" ECHO \" $@)\n\t@echo \"extern const u8\" `(echo $(CURBIN) | sed -e 's/^\\([0-9]\\)/_\\1/' | tr . _)`\"_end[];\" > `(echo $(CURLOC) | tr . _)`.h\n\t@echo \"extern const u8\" `(echo $(CURBIN) | sed -e 's/^\\([0-9]\\)/_\\1/' | tr . _)`\"[];\" >> `(echo $(CURLOC) | tr . _)`.h\n\t@echo \"extern const u32\" `(echo $(CURBIN) | sed -e 's/^\\([0-9]\\)/_\\1/' | tr . _)`_size\";\" >> `(echo $(CURLOC) | tr . _)`.h\n\n#\n# Target-specific variables to force the .3dsx files to have different titles...\n#\nmzxrun.smdh: APP_TITLE=${APP_TITLE_MZXRUN}\nmegazeux.smdh: APP_TITLE=${APP_TITLE_MZX}\n\npackage: mzx mzxrun.smdh megazeux.smdh\n\t3dsxtool ${mzxrun} ${mzxrun}.3dsx --smdh=${mzxrun}.smdh\t--romfs=arch/3ds/romfs\nifneq (${BUILD_EDITOR},)\n\t3dsxtool ${mzx} ${mzx}.3dsx --smdh=${mzx}.smdh --romfs=arch/3ds/romfs\nendif\n\nclean:\n\t${RM} ${mzxrun}.smdh ${mzxrun}.3dsx ${mzx}.smdh ${mzx}.3dsx\n\t${RM} arch/3ds/*.d arch/3ds/*.o arch/3ds/*shbin*\n\nbuild := ${build_root}/3ds/megazeux\nbuild: package ${build}\nifeq ($(BUILD_SDL),)\n\t${CP} arch/3ds/pad.config ${build}\nelse\nifeq ($(BUILD_SDL),1)\n\t${CP} arch/3ds/pad.config.sdl12 ${build}/pad.config\nelse\n\t${CP} arch/3ds/pad.config.sdl2 ${build}/pad.config\nendif\nendif\n\t${CP} ${mzxrun}.3dsx ${build}\nifneq (${BUILD_EDITOR},)\n\t${CP} ${mzx}.3dsx ${build}\nendif\n\t${RM} ${build}/${mzxrun} ${build}/${mzxrun}.debug\n\t${RM} ${build}/${mzx} ${build}/${mzx}.debug\n\ninclude arch/zip.inc\n" }, { "path": "arch/3ds/README.md", "content": "## Preparation\n\nYou need to install the latest versions of the devkitARM\ntoolchain, as well as the necessary 3DS tooling.\n\nYou also need to install zlib, libpng and libtremor. This\ncan be done with the following command:\n\n pacman -S 3ds-libogg 3ds-libpng 3ds-libvorbisidec 3ds-zlib\n\n## Configuring\n\nSee CONFIG.3DS for an optimal `config.sh` configure line. You need\nto ensure DEVKITPRO and DEVKITARM are both defined and valid.\n\n## Building\n\nFor the moment, you need to build with:\n\n make package\n\nThis will emit the \"mzxrun.3dsx\" file.\n\n## Packaging\n\nYou can then use the usual `make archive` to build a\nbuild/dist/3ds/mzxgit-3ds.zip file for distribution.\n" }, { "path": "arch/3ds/audio.c", "content": "/* MegaZeux\n *\n * Copyright (C) 2016 Adrian Siekierka \n *\n * This program is free software; you can redistribute it and/or\n * modify it under the terms of the GNU General Public License as\n * published by the Free Software Foundation; either version 2 of\n * the License, or (at your option) any later version.\n *\n * This program is distributed in the hope that it will be useful,\n * but WITHOUT ANY WARRANTY; without even the implied warranty of\n * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n * General Public License for more details.\n *\n * You should have received a copy of the GNU General Public License\n * along with this program; if not, write to the Free Software\n * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n */\n\n#include \"../../src/event.h\"\n#include \"../../src/platform.h\"\n#include \"../../src/graphics.h\"\n#include \"../../src/audio/audio.h\"\n#include \"../../src/audio/audio_struct.h\"\n\n#include <3ds.h>\n#include \n#include \"platform.h\"\n\n#ifdef CONFIG_AUDIO\n\nstatic u8 *audio_buffer;\nstatic ndspWaveBuf ndsp_buffer[2];\nstatic unsigned buffer_frames;\nstatic unsigned buffer_size;\nstatic bool soundFillBlock = false;\n\nstatic void ndsp_callback(void *dud)\n{\n if(ndsp_buffer[soundFillBlock].status == NDSP_WBUF_DONE)\n {\n audio_mixer_render_frames(ndsp_buffer[soundFillBlock].data_pcm16,\n buffer_frames, 2, SAMPLE_S16);\n\n DSP_FlushDataCache(ndsp_buffer[soundFillBlock].data_pcm8, buffer_size);\n ndspChnWaveBufAdd(0, &ndsp_buffer[soundFillBlock]);\n soundFillBlock = !soundFillBlock;\n }\n}\n\nvoid init_audio_platform(struct config_info *conf)\n{\n // buffer size must be multiple of 32 bytes(?), so samples must be multiple of 8\n unsigned frames = (conf->audio_buffer_samples + 7) & ~7;\n float mix[12];\n\n audio_buffer = NULL;\n if(!audio_mixer_init(conf->audio_sample_rate, frames, 2))\n return;\n\n buffer_frames = audio.buffer_frames;\n buffer_size = buffer_frames * sizeof(int16_t) * 2 /* stereo */;\n\n if(ndspInit() != 0)\n return;\n\n memset(mix, 0, sizeof(mix));\n mix[0] = mix[1] = 1.0f;\n ndspSetOutputMode(NDSP_OUTPUT_STEREO);\n ndspSetOutputCount(1);\n ndspSetMasterVol(1.0f);\n\n audio_buffer = clinearAlloc(buffer_size * 2, 0x80);\n memset(audio_buffer, 0, buffer_size * 2);\n ndspSetCallback(ndsp_callback, audio_buffer);\n\n memset(&ndsp_buffer[0], 0, sizeof(ndspWaveBuf));\n memset(&ndsp_buffer[1], 0, sizeof(ndspWaveBuf));\n ndspChnReset(0);\n ndspChnSetInterp(0, NDSP_INTERP_LINEAR);\n ndspChnSetRate(0, audio.output_frequency);\n ndspChnSetFormat(0, NDSP_CHANNELS(2) | NDSP_ENCODING(NDSP_ENCODING_PCM16));\n ndspChnSetMix(0, mix);\n\n ndsp_buffer[0].data_vaddr = &audio_buffer[0];\n ndsp_buffer[0].nsamples = buffer_frames;\n ndsp_buffer[1].data_vaddr = &audio_buffer[buffer_size];\n ndsp_buffer[1].nsamples = buffer_frames;\n\n ndspChnWaveBufAdd(0, &ndsp_buffer[0]);\n ndspChnWaveBufAdd(0, &ndsp_buffer[1]);\n}\n\nvoid quit_audio_platform(void)\n{\n if(audio_buffer)\n {\n linearFree(audio_buffer);\n audio_buffer = NULL;\n\n ndspExit();\n }\n}\n\n#endif // CONFIG_AUDIO\n" }, { "path": "arch/3ds/event.c", "content": "/* MegaZeux\n *\n * Copyright (C) 2016 Adrian Siekierka \n *\n * This program is free software; you can redistribute it and/or\n * modify it under the terms of the GNU General Public License as\n * published by the Free Software Foundation; either version 2 of\n * the License, or (at your option) any later version.\n *\n * This program is distributed in the hope that it will be useful,\n * but WITHOUT ANY WARRANTY; without even the implied warranty of\n * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n * General Public License for more details.\n *\n * You should have received a copy of the GNU General Public License\n * along with this program; if not, write to the Free Software\n * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n */\n\n#include \"../../src/event.h\"\n#include \"../../src/graphics.h\"\n#include \"../../src/platform.h\"\n#include \"../../src/util.h\"\n\n#include <3ds.h>\n#include \n\n#include \"event.h\"\n#include \"keyboard.h\"\n\nextern struct input_status input;\nstatic enum bottom_screen_mode b_mode;\nstatic enum focus_mode allow_focus_changes = FOCUS_ALLOW;\nstatic boolean is_dragging = false;\n\nboolean update_hid(void);\n\nenum focus_mode get_allow_focus_changes(void)\n{\n return allow_focus_changes;\n}\n\nenum bottom_screen_mode get_bottom_screen_mode(void)\n{\n return b_mode;\n}\n\nboolean __update_event_status(void)\n{\n boolean retval = false;\n retval |= aptMainLoop();\n retval |= update_hid();\n return retval;\n}\n\nboolean __peek_exit_input(void)\n{\n /* FIXME stub */\n return false;\n}\n\nvoid __wait_event(void)\n{\n while(!__update_event_status())\n gspWaitForVBlank();\n}\n\nvoid __warp_mouse(int x, int y)\n{\n // Since the touchscreen stylus can't be warped, focus there instead.\n focus_pixel(x, y);\n}\n\n// Convert the 3DS axis ranges to the MZX axis ranges. The 3DS uses values in\n// (roughly) the -150 to 150 range, but MZX uses the full range of a int16_t.\n// The 3DS Y axis is also inverted from the typical axis direction, but that\n// is fixed in check_circle below.\nstatic inline int16_t axis_convert(s16 value)\n{\n int new_value = ((int)value) * 32768 / 150;\n return (int16_t)CLAMP(new_value, -32768, 32767);\n}\n\nstatic inline boolean check_circle(struct buffered_status *status,\n circlePosition *current, circlePosition *prev, int axis_x, int axis_y)\n{\n boolean rval = false;\n\n if(current->dx != prev->dx)\n {\n joystick_axis_update(status, 0, axis_x, axis_convert(current->dx));\n rval = true;\n }\n\n if(current->dy != prev->dy)\n {\n // 3DS has an inverted Y axis on the circle pad vs. most controllers.\n joystick_axis_update(status, 0, axis_y, axis_convert(-current->dy));\n rval = true;\n }\n\n return rval;\n}\n\nstatic inline boolean check_hat(struct buffered_status *status,\n uint32_t down, uint32_t up, uint32_t key, enum joystick_hat dir)\n{\n if(down & key)\n {\n joystick_hat_update(status, 0, dir, true);\n return true;\n }\n else\n\n if(up & key)\n {\n joystick_hat_update(status, 0, dir, false);\n return true;\n }\n\n return false;\n}\n\nstatic inline boolean check_joy(struct buffered_status *status,\n uint32_t down, uint32_t up, uint32_t key, int button)\n{\n if(down & key)\n {\n joystick_button_press(status, 0, button);\n return true;\n }\n else\n\n if(up & key)\n {\n joystick_button_release(status, 0, button);\n return true;\n }\n\n return false;\n}\n\nstatic inline boolean ctr_is_mouse_area(touchPosition *touch)\n{\n int mx, my;\n\n if(b_mode == BOTTOM_SCREEN_MODE_KEYBOARD)\n {\n mx = touch->px * 4 - 320;\n my = touch->py * 4 - (13 * 4);\n\n if(mx < 0 || mx >= 640 || my < 0 || my >= 350)\n return false;\n\n else\n return true;\n }\n else\n {\n return true;\n }\n}\n\nstatic inline boolean ctr_update_touch(struct buffered_status *status,\n touchPosition *touch)\n{\n int mx, my;\n\n if(b_mode == BOTTOM_SCREEN_MODE_KEYBOARD)\n {\n mx = touch->px * 4 - 320;\n my = touch->py * 4 - (13 * 4);\n\n if(mx < 0 || mx >= 640 || my < 0 || my >= 350)\n return false;\n }\n else\n {\n int s_height = ctr_get_subscreen_height();\n mx = touch->px * 2;\n my = ((int)(touch->py - ((240 - s_height) / 2)) * 350 / s_height);\n if(mx < 0) mx = 0;\n if(mx >= 640) mx = 639;\n if(my < 0) my = 0;\n if(my >= 350) my = 349;\n }\n\n if(mx != status->mouse_pixel_x || my != status->mouse_pixel_y)\n {\n status->mouse_pixel_x = mx;\n status->mouse_pixel_y = my;\n status->mouse_x = mx / 8;\n status->mouse_y = my / 14;\n status->mouse_moved = true;\n\n allow_focus_changes = FOCUS_PASS;\n focus_pixel(mx, my);\n allow_focus_changes = FOCUS_FORBID;\n\n return true;\n }\n else\n {\n return false;\n }\n}\n\nstatic inline boolean ctr_update_cstick(struct buffered_status *status)\n{\n circlePosition pos;\n int dmx, dmy, nmx, nmy;\n\n hidCstickRead(&pos);\n dmx = pos.dx / 3;\n dmy = pos.dy / 3;\n\n if(dmx != 0 || dmy != 0)\n {\n nmx = status->mouse_pixel_x + dmx;\n nmy = status->mouse_pixel_y + dmy;\n if(nmx < 0) nmx = 0;\n if(nmx >= 640) nmx = 639;\n if(nmy < 0) nmy = 0;\n if(nmy >= 350) nmy = 349;\n\n if(nmx != status->mouse_pixel_x || nmy != status->mouse_pixel_y)\n {\n status->mouse_pixel_x = nmx;\n status->mouse_pixel_y = nmy;\n status->mouse_x = nmx / 8;\n status->mouse_y = nmy / 14;\n status->mouse_moved = true;\n\n focus_pixel(nmx, nmy);\n\n return true;\n }\n }\n\n return false;\n}\n\nboolean update_hid(void)\n{\n struct buffered_status *status = store_status();\n uint32_t down, held, up;\n boolean retval = false;\n touchPosition touch;\n circlePosition cpad;\n static circlePosition last_cpad;\n\n hidScanInput();\n hidCircleRead(&cpad);\n down = hidKeysDown();\n held = hidKeysHeld();\n up = hidKeysUp();\n\n retval |= check_circle(status, &cpad, &last_cpad, 0, 1);\n retval |= check_hat(status, down, up, KEY_DUP, JOYHAT_UP);\n retval |= check_hat(status, down, up, KEY_DDOWN, JOYHAT_DOWN);\n retval |= check_hat(status, down, up, KEY_DLEFT, JOYHAT_LEFT);\n retval |= check_hat(status, down, up, KEY_DRIGHT, JOYHAT_RIGHT);\n retval |= check_joy(status, down, up, KEY_A, 0);\n retval |= check_joy(status, down, up, KEY_B, 1);\n retval |= check_joy(status, down, up, KEY_X, 2);\n retval |= check_joy(status, down, up, KEY_Y, 3);\n retval |= check_joy(status, down, up, KEY_L, 4);\n retval |= check_joy(status, down, up, KEY_R, 5);\n retval |= check_joy(status, down, up, KEY_SELECT, 6);\n retval |= check_joy(status, down, up, KEY_START, 7);\n retval |= check_joy(status, down, up, KEY_ZL, 8);\n retval |= check_joy(status, down, up, KEY_ZR, 9);\n\n last_cpad = cpad;\n\n if((down | held | up) & KEY_TOUCH)\n {\n hidTouchRead(&touch);\n\n if((down & KEY_TOUCH) && ctr_is_mouse_area(&touch))\n {\n status->mouse_button = MOUSE_BUTTON_LEFT;\n status->mouse_repeat = MOUSE_BUTTON_LEFT;\n status->mouse_button_state |= MOUSE_BUTTON(MOUSE_BUTTON_LEFT);\n status->mouse_repeat_state = 1;\n status->mouse_drag_state = -1;\n status->mouse_time = get_ticks();\n is_dragging = true;\n allow_focus_changes = FOCUS_FORBID;\n retval = true;\n }\n\n if(is_dragging)\n {\n if(up & KEY_TOUCH)\n {\n status->mouse_button_state &= ~MOUSE_BUTTON(MOUSE_BUTTON_LEFT);\n status->mouse_repeat = 0;\n status->mouse_repeat_state = 0;\n status->mouse_drag_state = -0;\n allow_focus_changes = FOCUS_ALLOW;\n is_dragging = false;\n retval = true;\n }\n else\n {\n retval |= ctr_update_touch(status, &touch);\n }\n }\n\n retval |= ctr_keyboard_update(status);\n }\n\n// retval |= ctr_update_cstick(status);\n\n return retval;\n}\n\nint ctr_get_subscreen_height(void)\n{\n switch(get_config()->video_ratio)\n {\n case RATIO_CLASSIC_4_3:\n case RATIO_STRETCH:\n return 240;\n default:\n return 175;\n }\n}\n\nboolean platform_has_screen_keyboard(void)\n{\n return true;\n}\n\nboolean platform_show_screen_keyboard(void)\n{\n input.showing_screen_keyboard = true;\n b_mode = BOTTOM_SCREEN_MODE_KEYBOARD;\n return true;\n}\n\nboolean platform_hide_screen_keyboard(void)\n{\n input.showing_screen_keyboard = false;\n b_mode = BOTTOM_SCREEN_MODE_PREVIEW;\n return true;\n}\n\nboolean platform_is_screen_keyboard_active(void)\n{\n return input.showing_screen_keyboard;\n}\n\nvoid platform_init_event(void)\n{\n struct buffered_status *status = store_status();\n joystick_set_active(status, 0, true);\n joystick_map_fallback_keyboard_button(0, 5);\n}\n" }, { "path": "arch/3ds/event.h", "content": "/* MegaZeux\n *\n * Copyright (C) 2004-2006 Gilead Kutnick \n * Copyright (C) 2007 Alistair John Strachan \n * Copyright (C) 2007 Alan Williams \n *\n * This program is free software; you can redistribute it and/or\n * modify it under the terms of the GNU General Public License as\n * published by the Free Software Foundation; either version 2 of\n * the License, or (at your option) any later version.\n *\n * This program is distributed in the hope that it will be useful,\n * but WITHOUT ANY WARRANTY; without even the implied warranty of\n * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n * General Public License for more details.\n *\n * You should have received a copy of the GNU General Public License\n * along with this program; if not, write to the Free Software\n * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n */\n\n#ifndef __3DS_EVENT_H__\n#define __3DS_EVENT_H__\n\n#include \"../../src/event.h\"\n\n__M_BEGIN_DECLS\n\nenum bottom_screen_mode\n{\n BOTTOM_SCREEN_MODE_PREVIEW,\n BOTTOM_SCREEN_MODE_KEYBOARD,\n BOTTOM_SCREEN_MODE_MAX\n};\n\nenum focus_mode\n{\n FOCUS_FORBID,\n FOCUS_ALLOW, // checks if position changed\n FOCUS_PASS // ignores all checks and check updates - for touchscreen\n};\n\nenum bottom_screen_mode get_bottom_screen_mode(void);\nenum focus_mode get_allow_focus_changes(void);\nint ctr_get_subscreen_height(void);\n\n__M_END_DECLS\n\n#endif /* __3DS_EVENT_H__ */\n" }, { "path": "arch/3ds/keyboard.c", "content": "/* MegaZeux\n *\n * Copyright (C) 2004-2006 Gilead Kutnick \n * Copyright (C) 2007 Alistair John Strachan \n * Copyright (C) 2007 Alan Williams \n *\n * This program is free software; you can redistribute it and/or\n * modify it under the terms of the GNU General Public License as\n * published by the Free Software Foundation; either version 2 of\n * the License, or (at your option) any later version.\n *\n * This program is distributed in the hope that it will be useful,\n * but WITHOUT ANY WARRANTY; without even the implied warranty of\n * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n * General Public License for more details.\n *\n * You should have received a copy of the GNU General Public License\n * along with this program; if not, write to the Free Software\n * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n */\n\n#include \"../../src/event.h\"\n#include \"../../src/util.h\"\n\n#include <3ds.h>\n#include \n\n#include \"event.h\"\n#include \"keyboard.h\"\n#include \"platform.h\"\n#include \"render.h\"\n\n#define MAX_KEYS_DOWN 8\n\nC3D_Tex *keyboard_tex;\nstatic enum keycode keys_down[] =\n{\n IKEY_UNKNOWN, IKEY_UNKNOWN, IKEY_UNKNOWN, IKEY_UNKNOWN,\n IKEY_UNKNOWN, IKEY_UNKNOWN, IKEY_UNKNOWN, IKEY_UNKNOWN\n};\nstatic u8 keys_down_count = 0;\nstatic boolean force_zoom_out = false;\n\nstatic touch_area_t touch_areas[] =\n{\n { 2, 118, 22, 16, IKEY_ESCAPE, 0 },\n { 23, 118, 22, 16, IKEY_F1, 0 },\n { 44, 118, 22, 16, IKEY_F2, 0 },\n { 65, 118, 22, 16, IKEY_F3, 0 },\n { 86, 118, 22, 16, IKEY_F4, 0 },\n { 107, 118, 22, 16, IKEY_F5, 0 },\n { 128, 118, 22, 16, IKEY_F6, 0 },\n { 149, 118, 22, 16, IKEY_F7, 0 },\n { 170, 118, 22, 16, IKEY_F8, 0 },\n { 191, 118, 22, 16, IKEY_F9, 0 },\n { 212, 118, 22, 16, IKEY_F10, 0 },\n { 233, 118, 22, 16, IKEY_F11, 0 },\n { 254, 118, 22, 16, IKEY_F12, 0 },\n { 275, 118, 22, 16, IKEY_INSERT, 0 },\n { 296, 118, 22, 16, IKEY_DELETE, 0 },\n\n { 2, 133, 22, 22, IKEY_BACKQUOTE, 0 },\n { 23, 133, 22, 22, IKEY_1, 0 },\n { 44, 133, 22, 22, IKEY_2, 0 },\n { 65, 133, 22, 22, IKEY_3, 0 },\n { 86, 133, 22, 22, IKEY_4, 0 },\n { 107, 133, 22, 22, IKEY_5, 0 },\n { 128, 133, 22, 22, IKEY_6, 0 },\n { 149, 133, 22, 22, IKEY_7, 0 },\n { 170, 133, 22, 22, IKEY_8, 0 },\n { 191, 133, 22, 22, IKEY_9, 0 },\n { 212, 133, 22, 22, IKEY_0, 0 },\n { 233, 133, 22, 22, IKEY_MINUS, 0 },\n { 254, 133, 22, 22, IKEY_EQUALS, 0 },\n { 275, 133, 43, 22, IKEY_BACKSPACE, 0 },\n\n { 2, 154, 34, 22, IKEY_TAB, 0 },\n { 35, 154, 22, 22, IKEY_q, 0 },\n { 56, 154, 22, 22, IKEY_w, 0 },\n { 77, 154, 22, 22, IKEY_e, 0 },\n { 98, 154, 22, 22, IKEY_r, 0 },\n { 119, 154, 22, 22, IKEY_t, 0 },\n { 140, 154, 22, 22, IKEY_y, 0 },\n { 161, 154, 22, 22, IKEY_u, 0 },\n { 182, 154, 22, 22, IKEY_i, 0 },\n { 203, 154, 22, 22, IKEY_o, 0 },\n { 224, 154, 22, 22, IKEY_p, 0 },\n { 245, 154, 22, 22, IKEY_LEFTBRACKET, 0 },\n { 266, 154, 22, 22, IKEY_RIGHTBRACKET, 0 },\n { 287, 154, 31, 22, IKEY_BACKSLASH, 0 },\n\n { 2, 175, 41, 22, IKEY_LCTRL, 0 },\n { 42, 175, 22, 22, IKEY_a, 0 },\n { 63, 175, 22, 22, IKEY_s, 0 },\n { 84, 175, 22, 22, IKEY_d, 0 },\n { 105, 175, 22, 22, IKEY_f, 0 },\n { 126, 175, 22, 22, IKEY_g, 0 },\n { 147, 175, 22, 22, IKEY_h, 0 },\n { 168, 175, 22, 22, IKEY_j, 0 },\n { 189, 175, 22, 22, IKEY_k, 0 },\n { 210, 175, 22, 22, IKEY_l, 0 },\n { 231, 175, 22, 22, IKEY_SEMICOLON, 0 },\n { 252, 175, 22, 22, IKEY_QUOTE, 0 },\n { 273, 175, 45, 22, IKEY_RETURN, 0 },\n\n { 2, 196, 54, 22, IKEY_LSHIFT, 0 },\n { 55, 196, 22, 22, IKEY_z, 0 },\n { 76, 196, 22, 22, IKEY_x, 0 },\n { 97, 196, 22, 22, IKEY_c, 0 },\n { 118, 196, 22, 22, IKEY_v, 0 },\n { 139, 196, 22, 22, IKEY_b, 0 },\n { 160, 196, 22, 22, IKEY_n, 0 },\n { 181, 196, 22, 22, IKEY_m, 0 },\n { 202, 196, 22, 22, IKEY_COMMA, 0 },\n { 223, 196, 22, 22, IKEY_PERIOD, 0 },\n { 244, 196, 22, 22, IKEY_SLASH, 0 },\n { 265, 196, 53, 22, IKEY_RSHIFT, 0 },\n\n { 29, 217, 37, 22, IKEY_LALT, 0 },\n { 65, 217, 190, 22, IKEY_SPACE, 0 },\n { 254, 217, 37, 22, IKEY_RALT, 0 }\n};\n#define touch_areas_len (sizeof(touch_areas) / sizeof(touch_area_t))\n\nstatic inline boolean ctr_is_modifier(enum keycode keycode)\n{\n return keycode >= IKEY_RSHIFT && keycode <= IKEY_RSUPER;\n}\n\nstatic inline boolean ctr_key_touched(touchPosition *pos, touch_area_t *area)\n{\n return (pos->px >= area->x) && (pos->py >= area->y) &&\n (pos->px < (area->x + area->w)) && (pos->py < (area->y + area->h));\n}\n\nboolean ctr_keyboard_force_zoom_out(void)\n{\n return force_zoom_out;\n}\n\nvoid ctr_keyboard_init(struct ctr_render_data *render_data)\n{\n keyboard_tex = ctr_load_png(\"romfs:/kbd_display.png\");\n}\n\nvoid ctr_keyboard_draw(struct ctr_render_data *render_data)\n{\n size_t i, j;\n\n ctr_draw_2d_texture(render_data, keyboard_tex, 0, 0, 320, 240, 0, 0, 320, 240,\n 4.0f, 0xffffffff, false);\n\n if(ctr_is_2d())\n {\n ctr_draw_2d_texture(render_data, keyboard_tex, force_zoom_out ? 16 : 0, 240,\n 16, 16, 302, 2, 16, 16, 3.0f, 0xffffffff, false);\n }\n\n if(ctr_supports_wide())\n {\n ctr_draw_2d_texture(render_data, keyboard_tex, gfxIsWide() ? 48 : 32, 240,\n 16, 16, 284, 2, 16, 16, 3.0f, 0xffffffff, false);\n }\n\n if(keys_down_count > 0)\n {\n for(i = 0; i < touch_areas_len; i++)\n {\n touch_area_t *area = &touch_areas[i];\n for(j = 0; j < keys_down_count; j++)\n {\n if(keys_down[j] == area->keycode)\n {\n ctr_draw_2d_texture(render_data, keyboard_tex, area->x,\n 240 - area->y - area->h, area->w, area->h,\n area->x, area->y + 1, area->w, area->h - 1,\n 3.0f, 0x808080ff, false);\n break;\n }\n }\n }\n }\n}\n\nboolean ctr_keyboard_update(struct buffered_status *status)\n{\n touchPosition pos;\n u32 down, up, i;\n boolean retval = false;\n u32 unicode;\n\n if(get_bottom_screen_mode() != BOTTOM_SCREEN_MODE_KEYBOARD)\n return retval;\n\n down = hidKeysDown();\n up = hidKeysUp();\n hidTouchRead(&pos);\n\n if(down & KEY_TOUCH)\n {\n if(ctr_is_2d() && pos.px >= 302 && pos.py >= 2 && pos.px < 318 &&\n pos.py < 18)\n {\n force_zoom_out = !force_zoom_out;\n }\n else\n\n if(ctr_supports_wide() && pos.px >= 284 && pos.py >= 2 &&\n pos.px < 300 && pos.py < 18)\n {\n ctr_request_set_wide(!gfxIsWide());\n }\n\n for(i = 0; i < touch_areas_len; i++)\n {\n touch_area_t *area = &touch_areas[i];\n if(ctr_key_touched(&pos, area))\n {\n unicode = convert_internal_unicode(area->keycode, false);\n\n key_press(status, area->keycode);\n key_press_unicode(status, unicode, true);\n\n keys_down[keys_down_count++] = area->keycode;\n retval = true;\n break;\n }\n }\n }\n\n if(up & KEY_TOUCH && keys_down_count > 0 &&\n !ctr_is_modifier(keys_down[keys_down_count - 1]))\n {\n for(; keys_down_count > 0; keys_down_count--)\n {\n key_release(status, keys_down[keys_down_count - 1]);\n keys_down[keys_down_count - 1] = IKEY_UNKNOWN;\n }\n retval = true;\n }\n\n return retval;\n}\n" }, { "path": "arch/3ds/keyboard.h", "content": "/* MegaZeux\n *\n * Copyright (C) 2004-2006 Gilead Kutnick \n * Copyright (C) 2007 Alistair John Strachan \n * Copyright (C) 2007 Alan Williams \n *\n * This program is free software; you can redistribute it and/or\n * modify it under the terms of the GNU General Public License as\n * published by the Free Software Foundation; either version 2 of\n * the License, or (at your option) any later version.\n *\n * This program is distributed in the hope that it will be useful,\n * but WITHOUT ANY WARRANTY; without even the implied warranty of\n * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n * General Public License for more details.\n *\n * You should have received a copy of the GNU General Public License\n * along with this program; if not, write to the Free Software\n * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n */\n\n#ifndef __3DS_KEYBOARD_H__\n#define __3DS_KEYBOARD_H__\n\n#include \"../../src/event.h\"\n#include \"render.h\"\n\n__M_BEGIN_DECLS\n\ntypedef struct\n{\n u16 x, y, w, h;\n enum keycode keycode;\n u8 flags;\n} touch_area_t;\n\nvoid ctr_keyboard_init(struct ctr_render_data *render_data);\nvoid ctr_keyboard_draw(struct ctr_render_data *render_data);\nboolean ctr_keyboard_update(struct buffered_status *status);\nboolean ctr_keyboard_force_zoom_out(void);\n\n__M_END_DECLS\n\n#endif /* __3DS_KEYBOARD_H__ */\n" }, { "path": "arch/3ds/pad.config", "content": "# Axis 1/2: Circle pad x/y\r\n# Hat: Directional pad\r\n# Button1: A\r\n# Button2: B\r\n# Button3: X\r\n# Button4: Y\r\n# Button5: Left shoulder\r\n# Button6: Right shoulder\r\n# Button7: Select\r\n# Button8: Start\r\n# Button9: ZL (NOTE: New 3DS only)\r\n# Button10: ZR (NOTE: New 3DS only)\r\n\r\njoy_axis_threshold = 16000\r\n\r\njoy1hat = act_up, act_down, act_left, act_right\r\njoy1axis1 = act_l_left, act_l_right\r\njoy1axis2 = act_l_up, act_l_down\r\njoy1button1 = act_a\r\njoy1button2 = act_b\r\njoy1button3 = act_x\r\njoy1button4 = act_y\r\njoy1button5 = act_lshoulder\r\njoy1button6 = act_rshoulder\r\njoy1button7 = act_select\r\njoy1button8 = act_start\r\njoy1button9 = act_ltrigger\r\njoy1button10 = act_rtrigger\r\njoy1.axis_lx = 1\r\njoy1.axis_ly = 2\r\n" }, { "path": "arch/3ds/pad.config.sdl12", "content": "# Axis 1/2: Circle pad x/y\n# Hat: Directional pad\n# Button1: Start\n# Button2: A\n# Button3: B\n# Button4: X\n# Button5: Y\n# Button6: Left shoulder\n# Button7: Right shoulder\n# Button8: Select\n# Button9: ZL (NOTE: New 3DS only)\n# Button10: ZR (NOTE: New 3DS only)\n\njoy1hat = act_up, act_down, act_left, act_right\njoy1axis1 = act_l_left, act_l_right\njoy1axis2 = act_l_up, act_l_down\njoy1button1 = act_start\njoy1button2 = act_a\njoy1button3 = act_b\njoy1button4 = act_x\njoy1button5 = act_y\njoy1button6 = act_lshoulder\njoy1button7 = act_rshoulder\njoy1button8 = act_select\njoy1button9 = act_ltrigger\njoy1button10 = act_rtrigger\njoy1.axis_lx = 1\njoy1.axis_ly = 2\n" }, { "path": "arch/3ds/pad.config.sdl2", "content": "# Axis 1/2: Circle pad x/y\n# Button1: A\n# Button2: B\n# Button3: Select\n# Button4: Start\n# Button5: Right\n# Button6: Left\n# Button7: Up\n# Button8: Down\n# Button9: Right shoulder\n# Button10: Left shoulder\n# Button11: X\n# Button12: Y\n# Button15: ZL (NOTE: New 3DS only)\n# Button16: ZR (NOTE: New 3DS only)\n\njoy1axis1 = act_l_left, act_l_right\njoy1axis2 = act_l_up, act_l_down\njoy1button1 = act_a\njoy1button2 = act_b\njoy1button3 = act_select\njoy1button4 = act_start\njoy1button5 = act_right\njoy1button6 = act_left\njoy1button7 = act_up\njoy1button8 = act_down\njoy1button9 = act_rshoulder\njoy1button10 = act_lshoulder\njoy1button11 = act_x\njoy1button12 = act_y\njoy1button15 = act_ltrigger\njoy1button16 = act_rtrigger\njoy1.axis_lx = 1\njoy1.axis_ly = 2\n" }, { "path": "arch/3ds/platform.c", "content": "/* MegaZeux\n *\n * Copyright (C) 2009 Alistair John Strachan \n * Copyright (C) 2007-2009 Kevin Vance \n *\n * This program is free software; you can redistribute it and/or\n * modify it under the terms of the GNU General Public License as\n * published by the Free Software Foundation; either version 2 of\n * the License, or (at your option) any later version.\n *\n * This program is distributed in the hope that it will be useful,\n * but WITHOUT ANY WARRANTY; without even the implied warranty of\n * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n * General Public License for more details.\n *\n * You should have received a copy of the GNU General Public License\n * along with this program; if not, write to the Free Software\n * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n */\n\n#include \n\n#include \"platform.h\"\n\n#include \"../../src/platform.h\"\n#undef main\n\n#include \"../../src/util.h\"\n#include \"../../src/event.h\"\n#include \"../../src/error.h\"\n#include \"../../src/graphics.h\"\n\n#include \n#include \n\n#include <3ds.h>\n#include \n\n#include \"keyboard.h\"\n\nstatic u8 isNot2DS, consoleModelId;\n\nFILE *popen(const char *command, const char *type)\n{\n return NULL;\n}\n\nint pclose(FILE *stream)\n{\n return 0;\n}\n\nvoid delay(uint32_t ms)\n{\n if(ms > 0)\n {\n svcSleepThread(1e6 * ms);\n }\n}\n\nboolean ctr_is_2d(void)\n{\n return isNot2DS == 0;\n}\n\nboolean ctr_supports_wide(void)\n{\n return consoleModelId != 3 /* O2DS */;\n}\n\nuint64_t get_ticks(void)\n{\n return osGetTime();\n}\n\nboolean platform_init(void)\n{\n cfguInit();\n romfsInit();\n osSetSpeedupEnable(1);\n APT_SetAppCpuTimeLimit(30);\n\n gfxInitDefault();\n gfxSet3D(false);\n\n CFGU_GetSystemModel(&consoleModelId);\n CFGU_GetModelNintendo2DS(&isNot2DS);\n return true;\n}\n\nvoid platform_quit(void)\n{\n gfxExit();\n\n romfsExit();\n cfguExit();\n}\n\n#ifdef CONFIG_CHECK_ALLOC\n\nstatic void out_of_linear_memory_check(void *p, const char *file, int line)\n{\n char msgbuf[128];\n if(!p)\n {\n snprintf(msgbuf, sizeof(msgbuf), \"Out of linear memory in %s:%d\",\n file, line);\n msgbuf[sizeof(msgbuf)-1] = '\\0';\n error(msgbuf, 2, 4, 0);\n }\n}\n\nvoid *check_linearAlloc(size_t size, size_t alignment, const char *file,\n int line)\n{\n void *result = linearMemAlign(size, alignment);\n out_of_linear_memory_check(result, file, line);\n return result;\n}\n\n#endif\n\n/**\n * argv[0] will either not exist (cia) or be the location of the 3dsx.\n * For the cia case we can't really do anything, so assume a SHAREDIR\n * startup location.\n */\n\nint main(int argc, char *argv[])\n{\n static char _argv0[] = SHAREDIR \"/mzxrun.3dsx\";\n static char *_argv[] = { _argv0 };\n\n if(argc < 1 || argv == NULL || argv[0] == NULL)\n {\n iprintf(\"argv[0]: not found.\\n\"\n \"using '%s'\\n\"\n \"WARNING: Use of a loader that supports argv[0] is recommended.\\n\",\n _argv0);\n\n chdir(SHAREDIR);\n real_main(1, _argv);\n }\n else\n {\n iprintf(\"argv[0]: '%s'\\n\", argv[0]);\n real_main(argc, argv);\n }\n\n return 0;\n}\n" }, { "path": "arch/3ds/platform.h", "content": "/* MegaZeux\n *\n * Copyright (C) 2004-2006 Gilead Kutnick \n * Copyright (C) 2007 Alistair John Strachan \n * Copyright (C) 2007 Alan Williams \n *\n * This program is free software; you can redistribute it and/or\n * modify it under the terms of the GNU General Public License as\n * published by the Free Software Foundation; either version 2 of\n * the License, or (at your option) any later version.\n *\n * This program is distributed in the hope that it will be useful,\n * but WITHOUT ANY WARRANTY; without even the implied warranty of\n * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n * General Public License for more details.\n *\n * You should have received a copy of the GNU General Public License\n * along with this program; if not, write to the Free Software\n * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n */\n\n#ifndef __3DS_PLATFORM_H__\n#define __3DS_PLATFORM_H__\n\n#include \"../../src/compat.h\"\n\n#include \n#include <3ds.h>\n#include \n\n__M_BEGIN_DECLS\n\nboolean ctr_is_2d(void);\nboolean ctr_supports_wide(void);\n\n#ifdef CONFIG_CHECK_ALLOC\n\n#include \n\n#define clinearAlloc(size, alignment) \\\n check_linearAlloc(size, alignment, __FILE__, __LINE__)\n\nvoid *check_linearAlloc(size_t size, size_t alignment, const char *file,\n int line);\n\n#else\n\nstatic inline void *clinearAlloc(size_t size)\n{\n return linearAlloc(size);\n}\n\n#endif /* CONFIG_CHECK_ALLOC */\n\n__M_END_DECLS\n\n#endif /* __3DS_PLATFORM_H__ */\n" }, { "path": "arch/3ds/render.cpp", "content": "/* MegaZeux\n *\n * Copyright (C) 2004-2006 Gilead Kutnick \n * Copyright (C) 2007 Alistair John Strachan \n * Copyright (C) 2007 Alan Williams \n *\n * This program is free software; you can redistribute it and/or\n * modify it under the terms of the GNU General Public License as\n * published by the Free Software Foundation; either version 2 of\n * the License, or (at your option) any later version.\n *\n * This program is distributed in the hope that it will be useful,\n * but WITHOUT ANY WARRANTY; without even the implied warranty of\n * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n * General Public License for more details.\n *\n * You should have received a copy of the GNU General Public License\n * along with this program; if not, write to the Free Software\n * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n */\n\n#include \"../../src/graphics.h\"\n#include \"../../src/pngops.h\"\n#include \"../../src/render.h\"\n#include \"../../src/renderers.h\"\n#include \"../../src/util.h\"\n\n#include \"event.h\"\n#include \"keyboard.h\"\n#include \"platform.h\"\n#include \"render.h\"\n\n#include \"shader_2d_shbin.h\"\n#include \"shader_playfield_shbin.h\"\n\n//#define RDR_DEBUG\n\nstruct ctr_shader_data\n{\n DVLB_s *dvlb;\n shaderProgram_s program;\n int proj_loc, offs_loc, geo_count;\n C3D_AttrInfo attr;\n};\n\nstruct ctr_layer\n{\n unsigned int w, h, mode;\n float z;\n int draw_order;\n boolean has_background_texture;\n struct v_char *foreground;\n C3D_Tex background;\n};\n\nstruct v_char\n{\n s16 x, y;\n u32 uv;\n u32 col;\n};\n\nstruct vertex\n{\n float x, y, w, h;\n float z;\n float tx, ty, tw, th;\n u32 color;\n};\n\nstruct linear_ptr_list_entry\n{\n void *ptr;\n struct linear_ptr_list_entry *next;\n};\n\n#define CTR_TOP_WIDTH (gfxIsWide() ? 800 : 400)\n#define CTR_TOP_HEIGHT 240\n#define CTR_CHAR_H 16\n#define CTR_TEXTURE_WIDTH 1024\n#define CTR_TEXTURE_CHARS_ROW (CTR_TEXTURE_WIDTH / CHAR_W)\n#define CTR_TEXTURE_HEIGHT ((FULL_CHARSET_SIZE / CTR_TEXTURE_CHARS_ROW) * CTR_CHAR_H)\n#define CTR_LAYER_MAX (LAYER_DRAWORDER_MAX + 101)\n#define CTR_LAYER_CURSOR (LAYER_DRAWORDER_MAX + 50)\n#define CTR_LAYER_MOUSE (LAYER_DRAWORDER_MAX + 75)\n\nstruct ctr_render_data\n{\n C3D_Tex charset[5], charset_vram[5];\n u8 charset_dirty_set;\n u8 charset_dirty[NUM_CHARSETS * 2];\n boolean rendering_frame, checked_frame;\n struct ctr_shader_data shader_2d, shader_playfield;\n C3D_Mtx projection;\n C3D_Tex playfield_tex;\n C3D_TexEnv env_normal, env_no_texture, env_playfield, env_playfield_inv;\n C3D_RenderTarget *playfield, *target_top, *target_bottom;\n u8 cursor_on, mouse_on;\n u32 last_focus_x, last_focus_y;\n u32 focus_x, focus_y;\n u32 layer_num;\n};\n\nstatic u8 morton_lut[64] =\n{\n 0x00, 0x01, 0x04, 0x05, 0x10, 0x11, 0x14, 0x15,\n 0x02, 0x03, 0x06, 0x07, 0x12, 0x13, 0x16, 0x17,\n 0x08, 0x09, 0x0c, 0x0d, 0x18, 0x19, 0x1c, 0x1d,\n 0x0a, 0x0b, 0x0e, 0x0f, 0x1a, 0x1b, 0x1e, 0x1f,\n 0x20, 0x21, 0x24, 0x25, 0x30, 0x31, 0x34, 0x35,\n 0x22, 0x23, 0x26, 0x27, 0x32, 0x33, 0x36, 0x37,\n 0x28, 0x29, 0x2c, 0x2d, 0x38, 0x39, 0x3c, 0x3d,\n 0x2a, 0x2b, 0x2e, 0x2f, 0x3a, 0x3b, 0x3e, 0x3f\n};\n\nstatic u8 morton_lut4[32] =\n{\n 0x00, 0x02, 0x08, 0x0a, 0x01, 0x03, 0x09, 0x0b,\n 0x04, 0x06, 0x0c, 0x0e, 0x05, 0x07, 0x0d, 0x0f,\n 0x10, 0x12, 0x18, 0x1a, 0x11, 0x13, 0x19, 0x1b,\n 0x14, 0x16, 0x1c, 0x1e, 0x15, 0x17, 0x1d, 0x1f\n};\n\n// 2 char bits -> 8 texture bits\nstatic u8 bitmask_mzx[4] = { 0x00, 0xf0, 0x0f, 0xff };\n\n// 4 char bits -> 8 texture bits\n// bitmask_smzx[layer, 0-3][bits]\nstatic u8 bitmask_smzx[4][16] =\n{\n { 0xff, 0x0f, 0x0f, 0x0f, 0xf0, 0x00, 0x00, 0x00,\n 0xf0, 0x00, 0x00, 0x00, 0xf0, 0x00, 0x00, 0x00 },\n { 0x00, 0xf0, 0x00, 0x00, 0x0f, 0xff, 0x0f, 0x0f,\n 0x00, 0xf0, 0x00, 0x00, 0x00, 0xf0, 0x00, 0x00 },\n { 0x00, 0x00, 0xf0, 0x00, 0x00, 0x00, 0xf0, 0x00,\n 0x0f, 0x0f, 0xff, 0x0f, 0x00, 0x00, 0xf0, 0x00 },\n { 0x00, 0x00, 0x00, 0xf0, 0x00, 0x00, 0x00, 0xf0,\n 0x00, 0x00, 0x00, 0xf0, 0x0f, 0x0f, 0x0f, 0xff }\n};\n\n// texture PNG dimensions must be powers of two\nstatic boolean tex_w_h_constraint(png_uint_32 w, png_uint_32 h)\n{\n return w > 0 && h > 0 && ((w & (w - 1)) == 0) && ((h & (h - 1)) == 0);\n}\n\nstatic inline int to_texture_size(int v)\n{\n int i;\n for(i = 8; i <= 65536; i *= 2)\n if(i >= v)\n return i;\n return v;\n}\n\nstatic void *tex_alloc_png_surface(png_uint_32 w, png_uint_32 h,\n png_uint_32 *stride, void **pixels)\n{\n C3D_Tex *tex;\n\n tex = (C3D_Tex *) ccalloc(1, sizeof(C3D_Tex));\n *stride = w << 2;\n\n if(!C3D_TexInit(tex, w, h, GPU_RGBA8))\n {\n free(tex);\n return NULL;\n }\n\n *pixels = tex->data;\n return tex;\n}\n\nstatic inline void ctr_set_2d_projection(struct ctr_render_data *render_data,\n int width, int height, boolean tilt)\n{\n if(tilt)\n Mtx_OrthoTilt(&render_data->projection, 0, width, height, 0, -1.0, CTR_LAYER_MAX,\n true);\n\n else\n Mtx_Ortho(&render_data->projection, 0, width, 0, height, -1.0, CTR_LAYER_MAX,\n true);\n}\n\nstatic inline void ctr_set_2d_projection_screen(\n struct ctr_render_data *render_data, boolean top_screen)\n{\n ctr_set_2d_projection(render_data, top_screen ? 400 : 320, 240, true);\n}\n\nstatic void ctr_bind_shader(struct ctr_shader_data *shader)\n{\n C3D_BindProgram(&shader->program);\n C3D_SetAttrInfo(&shader->attr);\n}\n\nstatic inline void ctr_prepare_2d(struct ctr_render_data *render_data,\n struct vertex *array)\n{\n C3D_BufInfo *bufInfo;\n\n bufInfo = C3D_GetBufInfo();\n BufInfo_Init(bufInfo);\n BufInfo_Add(bufInfo, array, sizeof(struct vertex), 4, 0x3210);\n\n ctr_bind_shader(&render_data->shader_2d);\n C3D_FVUnifMtx4x4(GPU_GEOMETRY_SHADER, render_data->shader_2d.proj_loc,\n &render_data->projection);\n}\n\nstatic inline void ctr_prepare_playfield(struct ctr_render_data *render_data,\n struct v_char *array, float xo, float yo, float z)\n{\n C3D_BufInfo *bufInfo;\n\n bufInfo = C3D_GetBufInfo();\n BufInfo_Init(bufInfo);\n BufInfo_Add(bufInfo, array, sizeof(struct v_char), 3, 0x210);\n\n ctr_bind_shader(&render_data->shader_playfield);\n C3D_FVUnifMtx4x4(GPU_GEOMETRY_SHADER, render_data->shader_playfield.proj_loc,\n &render_data->projection);\n C3D_FVUnifSet(GPU_GEOMETRY_SHADER, render_data->shader_playfield.offs_loc,\n (float) xo, (float) yo, z, 0.0f);\n}\n\nC3D_Tex *ctr_load_png(const char *name)\n{\n C3D_Tex *output;\n u16 width, height;\n u32 *data, *dataBuf;\n int i;\n\n output = (C3D_Tex *) png_read_file(name, NULL, NULL, tex_w_h_constraint,\n tex_alloc_png_surface);\n\n if(output != NULL)\n {\n C3D_TexSetWrap(output, GPU_CLAMP_TO_BORDER, GPU_CLAMP_TO_BORDER);\n data = (u32 *)output->data;\n dataBuf = (u32 *)clinearAlloc(output->size, 0x10);\n\n for(i = 0; i < output->size >> 2; i++)\n dataBuf[i] = __builtin_bswap32(data[i]);\n\n width = output->width;\n height = output->height;\n C3D_TexDelete(output);\n C3D_TexInitVRAM(output, width, height, GPU_RGBA8);\n data = (u32*) output->data;\n\n GSPGPU_FlushDataCache(dataBuf, output->size);\n C3D_SyncDisplayTransfer(\n dataBuf,\n GX_BUFFER_DIM(output->width, output->height),\n data,\n GX_BUFFER_DIM(output->width, output->height),\n (GX_TRANSFER_FLIP_VERT(0) |\n GX_TRANSFER_OUT_TILED(1) |\n GX_TRANSFER_RAW_COPY(0) |\n GX_TRANSFER_IN_FORMAT(GPU_RGBA8) |\n GX_TRANSFER_OUT_FORMAT(GPU_RGBA8) |\n GX_TRANSFER_SCALING(GX_TRANSFER_SCALE_NO))\n );\n\n linearFree(dataBuf);\n }\n\n return output;\n}\n\nstatic int vertex_heap_pos = 0, vertex_heap_len = 0;\nstatic struct vertex *vertex_heap;\n\nvoid ctr_draw_2d_texture(struct ctr_render_data *render_data, C3D_Tex *texture,\n int tx, int ty, int tw, int th,\n float x, float y, float w, float h, float z, u32 color, boolean flipy)\n{\n struct vertex *vertices;\n\n if(flipy && texture != NULL)\n {\n ty = texture->height - ty;\n th = -th;\n }\n\n if(vertex_heap_len == 0)\n {\n vertex_heap_len = 64;\n vertex_heap = (struct vertex *) clinearAlloc(sizeof(struct vertex) * vertex_heap_len, 0x80);\n }\n else\n\n if(vertex_heap_pos + 1 > vertex_heap_len)\n {\n struct vertex *vertex_heap_new =\n (struct vertex *) clinearAlloc(sizeof(struct vertex) * vertex_heap_len * 2, 0x80);\n memcpy(vertex_heap_new, vertex_heap,\n sizeof(struct vertex) * vertex_heap_len);\n vertex_heap_len *= 2;\n linearFree(vertex_heap);\n vertex_heap = vertex_heap_new;\n }\n\n vertices = &vertex_heap[vertex_heap_pos];\n vertex_heap_pos++;\n\n vertices[0].x = x;\n vertices[0].y = y;\n vertices[0].w = w;\n vertices[0].h = h;\n vertices[0].z = z;\n vertices[0].color = color;\n\n ctr_prepare_2d(render_data, vertex_heap);\n if(texture != NULL)\n {\n vertices[0].tx = tx / ((float) texture->width);\n vertices[0].ty = ty / ((float) texture->height);\n vertices[0].tw = tw / ((float) texture->width);\n vertices[0].th = th / ((float) texture->height);\n\n C3D_SetTexEnv(0, &(render_data->env_normal));\n C3D_TexBind(0, texture);\n }\n else\n {\n vertices[0].tx = tx;\n vertices[0].ty = ty;\n vertices[0].tw = tw;\n vertices[0].th = th;\n\n C3D_SetTexEnv(0, &(render_data->env_no_texture));\n }\n C3D_DrawArrays(GPU_GEOMETRY_PRIM, vertex_heap_pos - 1, 1);\n}\n\nstatic void ctr_init_shader(struct ctr_shader_data *shader, const void *data,\n int size, int geo_count)\n{\n shader->dvlb = DVLB_ParseFile((u32 *)data, size);\n shader->geo_count = geo_count;\n shaderProgramInit(&shader->program);\n shaderProgramSetVsh(&shader->program, &shader->dvlb->DVLE[0]);\n shaderProgramSetGsh(&shader->program, &shader->dvlb->DVLE[1], geo_count);\n shader->proj_loc =\n shaderInstanceGetUniformLocation(shader->program.geometryShader, \"projection\");\n shader->offs_loc =\n shaderInstanceGetUniformLocation(shader->program.geometryShader, \"offset\");\n AttrInfo_Init(&shader->attr);\n}\n\nstatic boolean wide_requested = false, wide_new_state;\n\nvoid ctr_request_set_wide(bool wide)\n{\n wide_requested = true;\n wide_new_state = wide;\n}\n\nstatic void ctr_set_wide(struct ctr_render_data *render_data, bool wide)\n{\n gfxSetWide(wide);\n\n C3D_RenderTargetDelete(render_data->target_top);\n render_data->target_top =\n C3D_RenderTargetCreate(240, CTR_TOP_WIDTH, GPU_RB_RGB8, GPU_RB_DEPTH16);\n C3D_RenderTargetClear(render_data->target_top, C3D_CLEAR_ALL, 0x000000, 0);\n C3D_RenderTargetSetOutput(render_data->target_top, GFX_TOP, GFX_LEFT,\n GX_TRANSFER_IN_FORMAT(GX_TRANSFER_FMT_RGB8) |\n GX_TRANSFER_OUT_FORMAT(GX_TRANSFER_FMT_RGB8));\n}\n\nstatic boolean ctr_init_video(struct graphics_data *graphics,\n struct config_info *conf)\n{\n static struct ctr_render_data render_data;\n unsigned int bits_per_pixel = 16;\n\n#ifdef RDR_DEBUG\n consoleInit(GFX_TOP, NULL);\n#endif\n\n memset(&render_data, 0, sizeof(struct ctr_render_data));\n graphics->render_data = &render_data;\n\n gfxSet3D(false);\n C3D_Init(0x40000);\n C3D_CullFace(GPU_CULL_NONE);\n\n render_data.rendering_frame = false;\n render_data.checked_frame = false;\n\n if(conf->force_bpp == 32)\n bits_per_pixel = conf->force_bpp;\n\n // 1024x512 is the smallest power of two texture which can fit a 640x350 playfield\n if(bits_per_pixel == 32)\n C3D_TexInitVRAM(&render_data.playfield_tex, 1024, 512, GPU_RGBA8);\n else\n C3D_TexInitVRAM(&render_data.playfield_tex, 1024, 512, GPU_RGB565);\n C3D_TexSetFilter(&render_data.playfield_tex, GPU_LINEAR, GPU_LINEAR);\n\n render_data.playfield =\n C3D_RenderTargetCreateFromTex(&render_data.playfield_tex, GPU_TEXFACE_2D, 0,\n GPU_RB_DEPTH16);\n render_data.target_top =\n C3D_RenderTargetCreate(240, 400, GPU_RB_RGB8, GPU_RB_DEPTH16);\n render_data.target_bottom =\n C3D_RenderTargetCreate(240, 320, GPU_RB_RGB8, GPU_RB_DEPTH16);\n\n C3D_RenderTargetClear(render_data.playfield, C3D_CLEAR_ALL, 0x000000, 0);\n C3D_RenderTargetClear(render_data.target_top, C3D_CLEAR_ALL, 0x000000, 0);\n C3D_RenderTargetClear(render_data.target_bottom, C3D_CLEAR_ALL, 0x000000, 0);\n C3D_RenderTargetSetOutput(render_data.target_top, GFX_TOP, GFX_LEFT,\n GX_TRANSFER_IN_FORMAT(GX_TRANSFER_FMT_RGB8) |\n GX_TRANSFER_OUT_FORMAT(GX_TRANSFER_FMT_RGB8));\n C3D_RenderTargetSetOutput(render_data.target_bottom, GFX_BOTTOM, GFX_LEFT,\n GX_TRANSFER_IN_FORMAT(GX_TRANSFER_FMT_RGB8) |\n GX_TRANSFER_OUT_FORMAT(GX_TRANSFER_FMT_RGB8));\n\n ctr_init_shader(&render_data.shader_2d,\n shader_2d_shbin, shader_2d_shbin_size, 4);\n ctr_init_shader(&render_data.shader_playfield,\n shader_playfield_shbin, shader_playfield_shbin_size, 3);\n\n // v0 = x,y,w,h\n // v1 = z\n // v2 = tx,ty,tw,th\n // v3 = color\n AttrInfo_AddLoader(&render_data.shader_2d.attr, 0, GPU_FLOAT, 4);\n AttrInfo_AddLoader(&render_data.shader_2d.attr, 1, GPU_FLOAT, 1);\n AttrInfo_AddLoader(&render_data.shader_2d.attr, 2, GPU_FLOAT, 4);\n AttrInfo_AddLoader(&render_data.shader_2d.attr, 3, GPU_UNSIGNED_BYTE, 4);\n\n // v0 = position\n // v1 = texcoord\n // v2 = color\n AttrInfo_AddLoader(&render_data.shader_playfield.attr, 0, GPU_SHORT, 2);\n AttrInfo_AddLoader(&render_data.shader_playfield.attr, 1, GPU_SHORT, 2);\n AttrInfo_AddLoader(&render_data.shader_playfield.attr, 2, GPU_UNSIGNED_BYTE, 4);\n\n for(int i = 0; i < 5; i++)\n {\n int tex_width = CTR_TEXTURE_WIDTH;\n if(i > 0)\n tex_width /= 2;\n\n C3D_TexInit(&render_data.charset[i], tex_width,\n CTR_TEXTURE_HEIGHT, GPU_A4);\n C3D_TexSetFilter(&render_data.charset[i], GPU_NEAREST, GPU_NEAREST);\n C3D_TexSetWrap(&render_data.charset[i], GPU_REPEAT, GPU_REPEAT);\n\n C3D_TexInitVRAM(&render_data.charset_vram[i], tex_width,\n CTR_TEXTURE_HEIGHT, GPU_A4);\n C3D_TexSetFilter(&render_data.charset_vram[i], GPU_NEAREST, GPU_NEAREST);\n C3D_TexSetWrap(&render_data.charset_vram[i], GPU_REPEAT, GPU_REPEAT);\n }\n\n C3D_TexEnvInit(&(render_data.env_normal));\n C3D_TexEnvSrc(&(render_data.env_normal), C3D_Both, GPU_TEXTURE0, (GPU_TEVSRC) 0, (GPU_TEVSRC) 0);\n C3D_TexEnvOpRgb(&(render_data.env_normal), (GPU_TEVOP_RGB) 0, (GPU_TEVOP_RGB) 0, (GPU_TEVOP_RGB) 0);\n C3D_TexEnvOpAlpha(&(render_data.env_normal), (GPU_TEVOP_A) 0, (GPU_TEVOP_A) 0, (GPU_TEVOP_A) 0);\n C3D_TexEnvFunc(&(render_data.env_normal), C3D_Both, GPU_MODULATE);\n\n C3D_TexEnvInit(&(render_data.env_no_texture));\n C3D_TexEnvSrc(&(render_data.env_no_texture), C3D_Both, GPU_PRIMARY_COLOR, (GPU_TEVSRC) 0, (GPU_TEVSRC) 0);\n C3D_TexEnvOpRgb(&(render_data.env_no_texture), (GPU_TEVOP_RGB) 0, (GPU_TEVOP_RGB) 0, (GPU_TEVOP_RGB) 0);\n C3D_TexEnvOpAlpha(&(render_data.env_no_texture), (GPU_TEVOP_A) 0, (GPU_TEVOP_A) 0, (GPU_TEVOP_A) 0);\n C3D_TexEnvFunc(&(render_data.env_no_texture), C3D_Both, GPU_REPLACE);\n\n C3D_TexEnvInit(&(render_data.env_playfield));\n C3D_TexEnvSrc(&(render_data.env_playfield), C3D_RGB, (GPU_TEVSRC) 0, GPU_PRIMARY_COLOR, (GPU_TEVSRC) 0);\n C3D_TexEnvSrc(&(render_data.env_playfield), C3D_Alpha, (GPU_TEVSRC) 0, GPU_TEXTURE0, (GPU_TEVSRC) 0);\n C3D_TexEnvOpRgb(&(render_data.env_playfield), (GPU_TEVOP_RGB) 0, GPU_TEVOP_RGB_SRC_ALPHA, (GPU_TEVOP_RGB) 0);\n C3D_TexEnvOpAlpha(&(render_data.env_playfield), (GPU_TEVOP_A) 0, GPU_TEVOP_A_SRC_ALPHA, (GPU_TEVOP_A) 0);\n C3D_TexEnvFunc(&(render_data.env_playfield), C3D_Both, GPU_MODULATE);\n\n C3D_TexEnvInit(&(render_data.env_playfield_inv));\n C3D_TexEnvSrc(&(render_data.env_playfield_inv), C3D_RGB, (GPU_TEVSRC) 0, GPU_PRIMARY_COLOR, (GPU_TEVSRC) 0);\n C3D_TexEnvSrc(&(render_data.env_playfield_inv), C3D_Alpha, (GPU_TEVSRC) 0, GPU_TEXTURE0, (GPU_TEVSRC) 0);\n C3D_TexEnvOpRgb(&(render_data.env_playfield_inv), (GPU_TEVOP_RGB) 0, GPU_TEVOP_RGB_SRC_ALPHA, (GPU_TEVOP_RGB) 0);\n C3D_TexEnvOpAlpha(&(render_data.env_playfield_inv), (GPU_TEVOP_A) 0, GPU_TEVOP_A_ONE_MINUS_SRC_ALPHA, (GPU_TEVOP_A) 0);\n C3D_TexEnvFunc(&(render_data.env_playfield_inv), C3D_Both, GPU_MODULATE);\n\n C3D_AlphaTest(false, GPU_GREATER, 0x80);\n C3D_DepthTest(false, GPU_GEQUAL, GPU_WRITE_ALL);\n\n graphics->allow_resize = 0;\n graphics->bits_per_pixel = bits_per_pixel;\n\n graphics->resolution_width = 640;\n graphics->resolution_height = 350;\n graphics->window_width = 640;\n graphics->window_height = 350;\n\n ctr_keyboard_init(&render_data);\n return true;\n}\n\nstatic void ctr_free_video(struct graphics_data *graphics)\n{\n // TODO: more freeing!\n struct ctr_render_data *render_data = (struct ctr_render_data *) graphics->render_data;\n int i;\n\n for(i = 0; i < 5; i++)\n {\n C3D_TexDelete(&render_data->charset[i]);\n C3D_TexDelete(&render_data->charset_vram[i]);\n }\n C3D_TexDelete(&render_data->playfield_tex);\n\n C3D_RenderTargetDelete(render_data->playfield);\n C3D_RenderTargetDelete(render_data->target_top);\n C3D_RenderTargetDelete(render_data->target_bottom);\n\n C3D_Fini();\n}\n\nstatic boolean ctr_create_window(struct graphics_data *graphics,\n struct video_window *window)\n{\n return true;\n}\n\nstatic void ctr_update_colors(struct graphics_data *graphics,\n struct rgb_color *palette, unsigned int count)\n{\n unsigned int i;\n\n for(i = 0; i < count; i++)\n {\n graphics->flat_intensity_palette[i] =\n (palette[i].r << 24) | (palette[i].g << 16) |\n (palette[i].b << 8) | 0x000000FF;\n }\n}\n\nstatic inline u32 ctr_get_char_texture_row(u32 chr)\n{\n return chr / CTR_TEXTURE_CHARS_ROW;\n}\n\n/**\n * This method takes a single character line \"c\" for character \"chr\" and\n * Y position \"y\" and writes it to all textures (both MZX and SMZX).\n */\nstatic inline void ctr_char_line_to_texture(\n struct ctr_render_data *render_data, u8 c, u32 chr, int y)\n{\n u8 *p0, *p1, *p2, *p3;\n u8 ch_low, ch_high;\n u32 offset = ((chr%CTR_TEXTURE_CHARS_ROW) * (8 * 8 / 2));\n u32 offset_smzx = (((chr & (~1)) % CTR_TEXTURE_CHARS_ROW) * (4 * 8 / 2));\n\n offset += (chr/CTR_TEXTURE_CHARS_ROW) * (CTR_TEXTURE_WIDTH * CTR_CHAR_H / 2);\n offset_smzx += (chr/CTR_TEXTURE_CHARS_ROW) * (CTR_TEXTURE_WIDTH/2 * CTR_CHAR_H / 2);\n\n // Add the Y position to the offsets, taking into account the 8x8 swizzling\n offset += ((y / 8) * (CTR_TEXTURE_WIDTH * 8 / 2));\n offset += morton_lut4[(y & 7) * 4];\n\n offset_smzx += ((y / 8) * (CTR_TEXTURE_WIDTH / 2 * 8 / 2));\n offset_smzx += morton_lut4[(y & 7) * 4];\n if(chr & 1)\n offset_smzx += 8;\n\n // Write line to MZX texture, taking into account the swizzling\n p0 = ((u8*) render_data->charset[0].data) + offset;\n p0[0] = bitmask_mzx[(c >> 6) ];\n p0[2] = bitmask_mzx[(c >> 4) & 0x03];\n p0[8] = bitmask_mzx[(c >> 2) & 0x03];\n p0[10] = bitmask_mzx[(c ) & 0x03];\n\n // Write line to SMZX texture, taking into account the swizzling\n p0 = ((u8*) render_data->charset[1].data) + offset_smzx;\n p1 = ((u8*) render_data->charset[2].data) + offset_smzx;\n p2 = ((u8*) render_data->charset[3].data) + offset_smzx;\n p3 = ((u8*) render_data->charset[4].data) + offset_smzx;\n\n ch_high = (c >> 4);\n ch_low = (c & 15);\n\n p0[0] = bitmask_smzx[0][ch_high];\n p0[2] = bitmask_smzx[0][ch_low];\n p1[0] = bitmask_smzx[1][ch_high];\n p1[2] = bitmask_smzx[1][ch_low];\n p2[0] = bitmask_smzx[2][ch_high];\n p2[2] = bitmask_smzx[2][ch_low];\n p3[0] = bitmask_smzx[3][ch_high];\n p3[2] = bitmask_smzx[3][ch_low];\n}\n\nstatic void ctr_remap_char_range(struct graphics_data *graphics, uint16_t first,\n uint16_t count)\n{\n struct ctr_render_data *render_data = (struct ctr_render_data *) graphics->render_data;\n u16 end = first + count;\n u8 *charset_pos;\n u32 i, j;\n\n if(end > FULL_CHARSET_SIZE)\n end = FULL_CHARSET_SIZE;\n\n charset_pos = graphics->charset;\n charset_pos += first * CHAR_SIZE;\n\n for(i = first; i < end; i++)\n {\n for(j = 0; j < 14; j++, charset_pos++)\n ctr_char_line_to_texture(render_data, *charset_pos, i, j);\n }\n\n first = ctr_get_char_texture_row(first);\n end = ctr_get_char_texture_row(end - 1);\n\n for(i = first; i <= end; i++)\n render_data->charset_dirty[i] = 1;\n render_data->charset_dirty_set = 1;\n}\n\nstatic void ctr_remap_char(struct graphics_data *graphics, uint16_t chr)\n{\n struct ctr_render_data *render_data = (struct ctr_render_data *) graphics->render_data;\n u16 tex_row = ctr_get_char_texture_row(chr);\n u8 *charset_pos;\n u32 i;\n\n charset_pos = graphics->charset;\n charset_pos += chr * CHAR_SIZE;\n\n for(i = 0; i < 14; i++, charset_pos++)\n ctr_char_line_to_texture(render_data, *charset_pos, chr, i);\n\n render_data->charset_dirty[tex_row] = 1;\n render_data->charset_dirty_set = 1;\n}\n\nstatic void ctr_remap_charbyte(struct graphics_data *graphics, uint16_t chr,\n uint8_t byte)\n{\n struct ctr_render_data *render_data = (struct ctr_render_data *) graphics->render_data;\n u16 tex_row = ctr_get_char_texture_row(chr);\n u8 *charset_pos;\n\n charset_pos = graphics->charset;\n charset_pos += chr * CHAR_SIZE + byte;\n\n ctr_char_line_to_texture(render_data, *charset_pos, chr, byte);\n\n render_data->charset_dirty[tex_row] = 1;\n render_data->charset_dirty_set = 1;\n}\n\nstatic inline void ctr_refresh_charsets(struct ctr_render_data *render_data,\n int from, int to)\n{\n u8 *charset_dirty;\n int coffs = 0;\n int csize = 0;\n int cincr = (CTR_TEXTURE_WIDTH * CTR_CHAR_H) / 2;\n int last_dirty = 0;\n int i;\n\n if(!render_data->charset_dirty_set)\n return;\n\n render_data->charset_dirty_set = 0;\n charset_dirty = render_data->charset_dirty;\n\n for(i = 0; i < NUM_CHARSETS * 2; i++)\n {\n if(charset_dirty[i])\n {\n coffs = cincr * i;\n break;\n }\n }\n\n for(; i < NUM_CHARSETS * 2; i++)\n {\n if(charset_dirty[i])\n {\n charset_dirty[i] = 0;\n last_dirty = i;\n }\n }\n\n csize = (last_dirty + 1) * cincr - coffs;\n if(csize <= 0)\n return;\n\n for(i = from; i < to; i++)\n {\n if(i != 0)\n {\n GSPGPU_FlushDataCache((u8*)(render_data->charset[i].data) + coffs/2, csize/2);\n C3D_SyncTextureCopy((u32*)((u8*)(render_data->charset[i].data) + coffs/2), 0,\n (u32*)((u8*)(render_data->charset_vram[i].data) + coffs/2), 0, csize/2, 8);\n }\n else\n {\n GSPGPU_FlushDataCache((u8*)(render_data->charset[0].data) + coffs, csize);\n C3D_SyncTextureCopy((u32*)((u8*)(render_data->charset[0].data) + coffs), 0,\n (u32*)((u8*)(render_data->charset_vram[0].data) + coffs), 0, csize, 8);\n }\n }\n return;\n}\n\nstatic boolean ctr_should_render(struct ctr_render_data *render_data)\n{\n if(!render_data->rendering_frame)\n {\n // If we aren't currently in control of the GPU, do not draw video.\n if(!gspHasGpuRight())\n return false;\n\n if(wide_requested)\n {\n ctr_set_wide(render_data, wide_new_state);\n wide_requested = false;\n }\n\n if(render_data->checked_frame || !C3D_FrameBegin(C3D_FRAME_NONBLOCK))\n {\n render_data->checked_frame = true;\n return false;\n }\n ctr_refresh_charsets(render_data, 0, 5);\n render_data->rendering_frame = true;\n render_data->layer_num = 0;\n vertex_heap_pos = 0;\n C3D_FrameDrawOn(render_data->playfield);\n ctr_set_2d_projection(render_data, 1024, 512, false);\n }\n return true;\n}\n\nstatic inline u32 ctr_char_texture_uv(u32 ch)\n{\n u16 u = (ch % CTR_TEXTURE_CHARS_ROW) * CHAR_W;\n u16 v = CTR_TEXTURE_HEIGHT - ((ch / CTR_TEXTURE_CHARS_ROW) * CTR_CHAR_H);\n\n return (v << 16) | u;\n}\n\ntemplate\nstatic void ctr_render_layer_inner(struct graphics_data *graphics,\n struct video_layer *vlayer, u32 bufsize)\n{\n struct ctr_layer *layer = (struct ctr_layer *)vlayer->platform_layer_data;\n struct ctr_render_data *render_data = (struct ctr_render_data *) graphics->render_data;\n\n // Flags - dynamically set by the layer generation code.\n boolean draw_background_texture = HAS_BACKGROUND_TEXTURE;\n boolean has_content = false;\n\n // Cached variables.\n u32 transparent_col = vlayer->transparent_col;\n int offset = vlayer->offset;\n u32 protected_pal_position = graphics->protected_pal_position;\n\n // Temporary variables for layer generation.\n struct char_element *src = vlayer->data;\n u32 ix, iy;\n int pos0, pos1, pos2, pos3;\n int pos_bg;\n u32 ch, uv;\n u32 col0, col1, col2, col3;\n\n // SMZX = layer->mode == 0\n // HAS_BACKGROUND_TEXTURE = draw_background_texture\n pos0 = 0;\n pos1 = layer->w * layer->h;\n if(SMZX)\n {\n pos2 = pos1 * 2;\n pos3 = pos1 * 3;\n }\n\n for(iy = 0; iy < layer->h; iy++)\n {\n for(ix = 0; ix < layer->w; ix++, src++)\n {\n if(HAS_BACKGROUND_TEXTURE)\n {\n pos_bg = morton_lut[(ix & 7) + ((iy & 7) << 3)]\n + ((ix & (~7)) << 3) + ((iy & (~7)) * layer->background.width);\n }\n\n ch = src->char_value;\n\n if(ch == INVISIBLE_CHAR)\n {\n if(HAS_BACKGROUND_TEXTURE)\n ((u32*) layer->background.data)[pos_bg] = 0;\n layer->foreground[pos0++].col = 0;\n layer->foreground[pos1++].col = 0;\n if(SMZX)\n {\n layer->foreground[pos2++].col = 0;\n layer->foreground[pos3++].col = 0;\n }\n continue;\n }\n has_content = true;\n\n if(ch >= 0x100)\n ch = (ch & 0xFF) + PROTECTED_CHARSET_POSITION;\n else\n ch = (ch + offset) % PROTECTED_CHARSET_POSITION;\n\n uv = ctr_char_texture_uv(ch);\n\n if(!SMZX)\n {\n col0 = src->bg_color;\n if(HAS_TRANSPARENT_COL && col0 == transparent_col)\n {\n col0 = 0;\n }\n else\n {\n if(col0 >= 16)\n col0 = (col0 & 0xF) + protected_pal_position;\n\n col0 = graphics->flat_intensity_palette[col0];\n }\n\n col1 = src->fg_color;\n if(HAS_TRANSPARENT_COL && col1 == transparent_col)\n {\n col1 = 0;\n draw_background_texture = false;\n }\n else\n {\n if(col1 >= 16)\n col1 = (col1 & 0xF) + protected_pal_position;\n\n col1 = graphics->flat_intensity_palette[col1];\n }\n if(HAS_BACKGROUND_TEXTURE)\n ((u32*) layer->background.data)[pos_bg] = col0;\n layer->foreground[pos0].uv = uv;\n layer->foreground[pos0++].col = col0;\n\n layer->foreground[pos1].uv = uv;\n layer->foreground[pos1++].col = col1;\n }\n else\n {\n u32 idx = ((src->bg_color << 6) | (src->fg_color << 2));\n u32 idx0 = graphics->smzx_indices[idx ];\n u32 idx1 = graphics->smzx_indices[idx + 1];\n u32 idx2 = graphics->smzx_indices[idx + 2];\n u32 idx3 = graphics->smzx_indices[idx + 3];\n\n col0 = idx0 == transparent_col ? 0 : graphics->flat_intensity_palette[(u8) idx0];\n col1 = idx1 == transparent_col ? 0 : graphics->flat_intensity_palette[(u8) idx1];\n col2 = idx2 == transparent_col ? 0 : graphics->flat_intensity_palette[(u8) idx2];\n col3 = idx3 == transparent_col ? 0 : graphics->flat_intensity_palette[(u8) idx3];\n\n if((col1 & col2 & col3) == 0)\n draw_background_texture = false;\n\n if(HAS_BACKGROUND_TEXTURE)\n ((u32*) layer->background.data)[pos_bg] = col0;\n layer->foreground[pos0].uv = uv;\n layer->foreground[pos0++].col = col0;\n layer->foreground[pos1].uv = uv;\n layer->foreground[pos1++].col = col1;\n layer->foreground[pos2].uv = uv;\n layer->foreground[pos2++].col = col2;\n layer->foreground[pos3].uv = uv;\n layer->foreground[pos3++].col = col3;\n }\n }\n }\n\n if(!has_content)\n return;\n\n if(draw_background_texture)\n {\n C3D_TexFlush(&layer->background);\n\n ctr_draw_2d_texture(render_data, &layer->background, 0,\n layer->background.height - layer->h, layer->w, layer->h,\n vlayer->x, vlayer->y, layer->w * 8, layer->h * 14,\n (LAYER_DRAWORDER_MAX - layer->draw_order) + 0.66f, 0xffffffff, false);\n }\n\n ctr_prepare_playfield(render_data, layer->foreground, vlayer->x, vlayer->y, layer->z);\n GSPGPU_FlushDataCache(layer->foreground, sizeof(struct v_char) * bufsize);\n\n if(!SMZX)\n {\n C3D_TexBind(0, &render_data->charset_vram[0]);\n if(!draw_background_texture)\n {\n C3D_SetTexEnv(0, &(render_data->env_playfield_inv));\n C3D_DrawArrays(GPU_GEOMETRY_PRIM, 0, layer->w * layer->h);\n }\n C3D_SetTexEnv(0, &(render_data->env_playfield));\n C3D_DrawArrays(GPU_GEOMETRY_PRIM, layer->w * layer->h, layer->w * layer->h);\n }\n else\n {\n C3D_SetTexEnv(0, &(render_data->env_playfield));\n if(!draw_background_texture)\n {\n C3D_TexBind(0, &render_data->charset_vram[1]);\n C3D_DrawArrays(GPU_GEOMETRY_PRIM, 0, layer->w * layer->h);\n }\n C3D_TexBind(0, &render_data->charset_vram[2]);\n C3D_DrawArrays(GPU_GEOMETRY_PRIM, layer->w * layer->h, layer->w * layer->h);\n C3D_TexBind(0, &render_data->charset_vram[3]);\n C3D_DrawArrays(GPU_GEOMETRY_PRIM, layer->w * layer->h * 2, layer->w * layer->h);\n C3D_TexBind(0, &render_data->charset_vram[4]);\n C3D_DrawArrays(GPU_GEOMETRY_PRIM, layer->w * layer->h * 3, layer->w * layer->h);\n }\n}\n\ntemplate\nstatic inline void ctr_render_layer_inner(struct graphics_data *graphics,\n struct video_layer *vlayer, u32 bufsize)\n{\n if(vlayer->transparent_col != -1)\n ctr_render_layer_inner(graphics, vlayer, bufsize);\n else\n ctr_render_layer_inner(graphics, vlayer, bufsize);\n}\n\ntemplate\nstatic inline void ctr_render_layer_inner(struct graphics_data *graphics,\n struct video_layer *vlayer, u32 bufsize)\n{\n struct ctr_layer *layer = (struct ctr_layer *)vlayer->platform_layer_data;\n if(layer->has_background_texture)\n ctr_render_layer_inner(graphics, vlayer, bufsize);\n else\n ctr_render_layer_inner(graphics, vlayer, bufsize);\n}\n\nstatic inline void ctr_render_layer_inner(struct graphics_data *graphics,\n struct video_layer *vlayer, u32 bufsize)\n{\n struct ctr_layer *layer = (struct ctr_layer *)vlayer->platform_layer_data;\n if(layer->mode > 0)\n ctr_render_layer_inner<1>(graphics, vlayer, bufsize);\n else\n ctr_render_layer_inner<0>(graphics, vlayer, bufsize);\n}\n\nstatic void ctr_render_layer(struct graphics_data *graphics,\n struct video_layer *vlayer)\n{\n struct ctr_layer *layer = (struct ctr_layer *)vlayer->platform_layer_data;\n struct ctr_render_data *render_data = (struct ctr_render_data *) graphics->render_data;\n u32 bufsize = vlayer->w * vlayer->h * (vlayer->mode > 0 ? 4 : 2);\n u32 max_bufsize = vlayer->w * vlayer->h * 4;\n u32 i;\n\n if(!ctr_should_render(render_data))\n return;\n\n if(layer != NULL && (layer->w != vlayer->w || layer->h != vlayer->h))\n {\n linearFree(layer->foreground);\n if(layer->has_background_texture)\n C3D_TexDelete(&(layer->background));\n free(layer);\n layer = NULL;\n }\n\n if(layer != NULL && (layer->draw_order != vlayer->draw_order))\n {\n layer->draw_order = vlayer->draw_order;\n layer->z = (LAYER_DRAWORDER_MAX - layer->draw_order) + 0.33f;\n }\n\n if(layer == NULL)\n {\n layer = (struct ctr_layer *) cmalloc(sizeof(struct ctr_layer));\n layer->w = vlayer->w; layer->h = vlayer->h;\n layer->draw_order = vlayer->draw_order;\n layer->z = (LAYER_DRAWORDER_MAX - layer->draw_order) + 0.33f;\n layer->foreground = (struct v_char *) clinearAlloc(sizeof(struct v_char) * max_bufsize, 0x80);\n\n /**\n * This renderer has two methods to draw char backgrounds. The quicker\n * method is to draw them as single pixels on a texture stretched to the\n * size of the layer. The slower method is to draw the layer an extra time\n * for the background colors.\n *\n * The former method seems to consume a vast amount of buffer space to the\n * point it causes crashes when too many sprites are active. Only use it for\n * the default layers (these are the layers most likely to benefit anyway).\n */\n if((vlayer->draw_order == LAYER_DRAWORDER_BOARD) ||\n (vlayer->draw_order == LAYER_DRAWORDER_OVERLAY) ||\n (vlayer->draw_order == LAYER_DRAWORDER_GAME_UI) ||\n (vlayer->draw_order == LAYER_DRAWORDER_UI))\n {\n layer->has_background_texture = true;\n layer->background.data = NULL;\n C3D_TexInit(&(layer->background), to_texture_size(layer->w),\n to_texture_size(layer->h), GPU_RGBA8);\n C3D_TexSetFilter(&(layer->background), GPU_NEAREST, GPU_NEAREST);\n }\n else\n layer->has_background_texture = false;\n\n vlayer->platform_layer_data = layer;\n\n // Initialize the foreground data.\n for(i = 0; i < max_bufsize; i++)\n {\n layer->foreground[i].x = (i % layer->w);\n layer->foreground[i].y = ((i / layer->w) % layer->h);\n layer->foreground[i].uv = 0xFFFFFFFF;\n }\n }\n\n layer->mode = vlayer->mode;\n\n ctr_render_layer_inner(graphics, vlayer, bufsize);\n\n render_data->layer_num++;\n}\n\nstatic void ctr_render_cursor(struct graphics_data *graphics, unsigned int x,\n unsigned int y, uint16_t color, unsigned int lines, unsigned int offset)\n{\n struct ctr_render_data *render_data = (struct ctr_render_data *) graphics->render_data;\n uint32_t flatcolor = graphics->flat_intensity_palette[color];\n\n if(ctr_should_render(render_data))\n {\n ctr_draw_2d_texture(render_data, NULL, 0, 0, 0, 0,\n x * 8, y * 14 + offset, 8, lines, CTR_LAYER_CURSOR, flatcolor, false);\n }\n}\n\nstatic void ctr_render_mouse(struct graphics_data *graphics,\n unsigned int x, unsigned int y, unsigned int w, unsigned int h)\n{\n struct ctr_render_data *render_data = (struct ctr_render_data *) graphics->render_data;\n uint32_t col = 0xFFFFFFFF;\n\n if(ctr_should_render(render_data))\n {\n C3D_AlphaBlend(GPU_BLEND_SUBTRACT, GPU_BLEND_ADD,\n GPU_SRC_COLOR, GPU_DST_COLOR, GPU_SRC_ALPHA, GPU_DST_ALPHA);\n ctr_draw_2d_texture(render_data, NULL, 0, 0, 0, 0, x, y, w, h, CTR_LAYER_MOUSE, col,\n false);\n C3D_AlphaBlend(GPU_BLEND_ADD, GPU_BLEND_ADD, GPU_SRC_ALPHA,\n GPU_ONE_MINUS_SRC_ALPHA, GPU_SRC_ALPHA, GPU_ONE_MINUS_SRC_ALPHA);\n }\n}\n\nstatic inline void ctr_draw_playfield(struct ctr_render_data *render_data,\n boolean top_screen)\n{\n int x, y;\n int width, height;\n float slider;\n\n ctr_set_2d_projection_screen(render_data, top_screen);\n if(top_screen)\n {\n if(ctr_keyboard_force_zoom_out())\n {\n slider = 1.0f;\n }\n else\n {\n slider = (osGet3DSliderState() * 1.3f) - 0.15f;\n\n if(slider < 0.0f) slider = 0.0f;\n if(slider > 1.0f) slider = 1.0f;\n }\n\n width = 400 + (240 * slider);\n height = 240 + (144 * slider);\n\n x = render_data->focus_x - (width / 2);\n y = render_data->focus_y - (height / 2);\n\n if(x < 0)\n x = 0;\n\n if((x + width) > 640)\n x = 640 - width;\n\n if(height > 350)\n {\n ctr_draw_2d_texture(render_data, &render_data->playfield_tex,\n x, 512 - 350, width, 350, 0, (240 - (240 * 350 / height)) / 2,\n 400, 240 * 350 / height, 2.0f, 0xffffffff, true);\n }\n else\n {\n if(y < 0)\n y = 0;\n\n if((y + height) > 350)\n y = 350 - height;\n\n ctr_draw_2d_texture(render_data, &render_data->playfield_tex,\n x, 512 - y - height, width, height, 0, 0, 400, 240,\n 2.0f, 0xffffffff, true);\n }\n }\n else\n {\n if(get_bottom_screen_mode() == BOTTOM_SCREEN_MODE_KEYBOARD)\n {\n ctr_draw_2d_texture(render_data, &render_data->playfield_tex,\n 0, 512 - 350, 640, 350, 80, 12.75, 160, 87.5, 2.0f, 0xffffffff, true);\n }\n else\n {\n int width = 320, height = ctr_get_subscreen_height();\n ctr_draw_2d_texture(render_data, &render_data->playfield_tex,\n 0, 512 - 350, 640, 350,\n (int) ((320 - width) / 2), (int) ((240 - height) / 2),\n width, height, 2.0f, 0xffffffff, true\n );\n }\n }\n}\n\nstatic void ctr_sync_screen(struct graphics_data *graphics,\n struct video_window *window)\n{\n struct ctr_render_data *render_data = (struct ctr_render_data *) graphics->render_data;\n\n if(!ctr_should_render(render_data))\n {\n render_data->checked_frame = false;\n return;\n }\n\n#ifndef RDR_DEBUG\n C3D_RenderTargetClear(render_data->target_top, C3D_CLEAR_ALL, 0x000000, 0);\n C3D_FrameDrawOn(render_data->target_top);\n ctr_draw_playfield(render_data, true);\n#endif\n\n C3D_RenderTargetClear(render_data->target_bottom, C3D_CLEAR_ALL, 0x000000, 0);\n C3D_FrameDrawOn(render_data->target_bottom);\n if(get_bottom_screen_mode() == BOTTOM_SCREEN_MODE_KEYBOARD)\n {\n ctr_set_2d_projection_screen(render_data, false);\n ctr_keyboard_draw(render_data);\n }\n\n ctr_draw_playfield(render_data, false);\n\n render_data->cursor_on = 0;\n render_data->mouse_on = 0;\n\n C3D_FrameEnd(0);\n render_data->rendering_frame = false;\n render_data->checked_frame = false;\n}\n\nstatic void ctr_focus_pixel(struct graphics_data *graphics,\n unsigned int x, unsigned int y)\n{\n struct ctr_render_data *render_data = (struct ctr_render_data *) graphics->render_data;\n\n switch(get_allow_focus_changes())\n {\n case FOCUS_FORBID:\n return;\n case FOCUS_ALLOW:\n if(render_data->last_focus_x != x || render_data->last_focus_y != y)\n {\n render_data->last_focus_x = x;\n render_data->last_focus_y = y;\n render_data->focus_x = x;\n render_data->focus_y = y;\n }\n break;\n case FOCUS_PASS:\n render_data->focus_x = x;\n render_data->focus_y = y;\n break;\n }\n}\n\nvoid render_ctr_register(struct renderer *renderer)\n{\n memset(renderer, 0, sizeof(struct renderer));\n renderer->init_video = ctr_init_video;\n renderer->free_video = ctr_free_video;\n renderer->create_window = ctr_create_window;\n renderer->set_viewport = set_window_viewport_centered;\n renderer->update_colors = ctr_update_colors;\n renderer->remap_char_range = ctr_remap_char_range;\n renderer->remap_char = ctr_remap_char;\n renderer->remap_charbyte = ctr_remap_charbyte;\n renderer->render_layer = ctr_render_layer;\n renderer->render_cursor = ctr_render_cursor;\n renderer->render_mouse = ctr_render_mouse;\n renderer->sync_screen = ctr_sync_screen;\n renderer->focus_pixel = ctr_focus_pixel;\n}\n\n" }, { "path": "arch/3ds/render.h", "content": "/* MegaZeux\n *\n * Copyright (C) 2004-2006 Gilead Kutnick \n * Copyright (C) 2007 Alistair John Strachan \n * Copyright (C) 2007 Alan Williams \n *\n * This program is free software; you can redistribute it and/or\n * modify it under the terms of the GNU General Public License as\n * published by the Free Software Foundation; either version 2 of\n * the License, or (at your option) any later version.\n *\n * This program is distributed in the hope that it will be useful,\n * but WITHOUT ANY WARRANTY; without even the implied warranty of\n * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n * General Public License for more details.\n *\n * You should have received a copy of the GNU General Public License\n * along with this program; if not, write to the Free Software\n * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n */\n\n#ifndef __3DS_RENDER_H__\n#define __3DS_RENDER_H__\n\n#include \n#include <3ds.h>\n#include \n\n#include \"../../src/compat.h\"\n\n__M_BEGIN_DECLS\n\nstruct ctr_render_data;\n\nC3D_Tex *ctr_load_png(const char *name);\n\nvoid ctr_draw_2d_texture(struct ctr_render_data *render_data, C3D_Tex *texture,\n int tx, int ty, int tw, int th,\n float x, float y, float w, float h, float z, u32 color, boolean flipy);\n\nvoid ctr_request_set_wide(bool wide);\nint ctr_get_subscreen_height(void);\n\n__M_END_DECLS\n\n#endif /* __3DS_RENDER_H__ */\n" }, { "path": "arch/3ds/shader_2d.g.pica", "content": "; MegaZeux\n;\n; Copyright (C) 2004-2006 Gilead Kutnick \n; Copyright (C) 2007 Alistair John Strachan \n; Copyright (C) 2007 Alan Williams \n;\n; This program is free software; you can redistribute it and/or\n; modify it under the terms of the GNU General Public License as\n; published by the Free Software Foundation; either version 2 of\n; the License, or (at your option) any later version.\n;\n; This program is distributed in the hope that it will be useful,\n; but WITHOUT ANY WARRANTY; without even the implied warranty of\n; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n; General Public License for more details.\n;\n; You should have received a copy of the GNU General Public License\n; along with this program; if not, write to the Free Software\n; Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n\n.gsh point c0\n\n.fvec projection[4]\n\n.out outpos position\n.out outtc0 texcoord0\n.out outclr color\n\n.constf CONSTS(1.0, 0.0, 0.0, 0.0)\n\n.entry gmain\n.proc gmain\n\tmov r0.xy, v0.xy\n\tmov r0.z, v1.x \n\tmov r0.w, CONSTS.x\n\tmov r4.xy, v0.zw\n\tmov r8.zw, r0.zw\n\n\tmov r6.xy, v2.xy\n\tmov r6.zw, CONSTS.zw\n\tmov r5.xy, v2.zw\n mov r10.zw, r6.zw\n\n\tsetemit 0\n\tadd r8.xy, r0.xy, r4.xy\n\tmov r10.y, r6.y\n\tadd r10.x, r6.x, r5.x\n\tcall emit_vertex\n\temit\n\n\tsetemit 1\n\tmov r8.x, r0.x\n\tadd r8.y, r0.y, r4.y\n\tmov r10, r6\n\tcall emit_vertex\n\temit\n\n\tsetemit 2, prim\n\tmov r8.xy, r0.xy\n\tmov r10.x, r6.x\n\tadd r10.y, r6.y, r5.y\t\n\tcall emit_vertex\n\temit\n\n\tsetemit 1, prim inv\n\tmov r8.y, r0.y\n\tadd r8.x, r0.x, r4.x\n\tadd r10.xy, r6.xy, r5.xy\n\tcall emit_vertex\n\temit\n\n\tend\n.end\n\n.proc emit_vertex\n\tdp4 outpos.x, projection[0], r8\n\tdp4 outpos.y, projection[1], r8\n\tdp4 outpos.z, projection[2], r8\n\tdp4 outpos.w, projection[3], r8\n\n\tmov outclr, v3\n\tmov outtc0, r10\n.end\n\n" }, { "path": "arch/3ds/shader_2d.v.pica", "content": "; MegaZeux\n;\n; Copyright (C) 2004-2006 Gilead Kutnick \n; Copyright (C) 2007 Alistair John Strachan \n; Copyright (C) 2007 Alan Williams \n;\n; This program is free software; you can redistribute it and/or\n; modify it under the terms of the GNU General Public License as\n; published by the Free Software Foundation; either version 2 of\n; the License, or (at your option) any later version.\n;\n; This program is distributed in the hope that it will be useful,\n; but WITHOUT ANY WARRANTY; without even the implied warranty of\n; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n; General Public License for more details.\n;\n; You should have received a copy of the GNU General Public License\n; along with this program; if not, write to the Free Software\n; Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n\n.constf RGBS(0.00392156862745098, 0.00392156862745098, 0.00392156862745098, 0.00392156862745098)\n\n.out - dummy o0\n.out - dummy o1\n.out - dummy o2\n.out - dummy o3\n\n.proc main\n\tmov o0, v0\n\tmov o1, v1\n\tmov o2, v2\n\n mov r1, RGBS\n\tmul o3, v3.wzyx, r1.x\n\n\tend\n.end\n\n\n" }, { "path": "arch/3ds/shader_playfield.g.pica", "content": "; MegaZeux\n;\n; Copyright (C) 2004-2006 Gilead Kutnick \n; Copyright (C) 2007 Alistair John Strachan \n; Copyright (C) 2007 Alan Williams \n;\n; This program is free software; you can redistribute it and/or\n; modify it under the terms of the GNU General Public License as\n; published by the Free Software Foundation; either version 2 of\n; the License, or (at your option) any later version.\n;\n; This program is distributed in the hope that it will be useful,\n; but WITHOUT ANY WARRANTY; without even the implied warranty of\n; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n; General Public License for more details.\n;\n; You should have received a copy of the GNU General Public License\n; along with this program; if not, write to the Free Software\n; Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n\n.gsh point c0\n\n.fvec projection[4]\n.fvec offset\n\n.out outpos position\n.out outtc0 texcoord0\n.out outclr color\n\n.alias inpos v0\n.alias intc0 v1\n.alias inclr v2\n\n.constf SCALES(0.0009765625, 0.001953125, -1, 1)\n.constf UVOFF(8, -14, 0, 0)\n.constf POSSCALE(8.0, 14.0, 1.0, 1.0)\n\n.entry gmain\n.proc gmain\n\tmov r4, POSSCALE\n\tmov r2, intc0\n\tmov r3.xy, inpos\n\tmov r3.z, UVOFF.z\n\tmad r0, r3, r4, offset\n\n\tmov r11, SCALES\n\tmov r0.w, POSSCALE.w\n\tmul r5.xy, UVOFF.xy, r11.xy\n\tmul r6, r2, r11\n\n\tsetemit 0\n\tadd r8.xy, r0.xy, r4.xy\n\tadd r10.xy, r6.xy, r5.xy\n\tcall emit_vertex\n\temit\n\n\tsetemit 1\n\tmov r8.y, r0.y\n\tadd r8.x, r0.x, r4.x\n\tmov r10.y, r6.y\n\tadd r10.x, r6.x, r5.x\n\tcall emit_vertex\n\temit\n\n\tsetemit 2, prim\n\tmov r8, r0\n\tmov r10, r6\n\tcall emit_vertex\n\temit\n\n\tsetemit 1, prim inv\n\tmov r8.x, r0.x\n\tadd r8.y, r0.y, r4.y\n\tmov r10.x, r6.x\n\tadd r10.y, r6.y, r5.y\n\tcall emit_vertex\n\temit\n\n\tend\n.end\n\n.proc emit_vertex\n\tdp4 outpos.x, projection[0], r8\n\tdp4 outpos.y, projection[1], r8\n\tdp4 outpos.z, projection[2], r8\n\tdp4 outpos.w, projection[3], r8\n\n\tmov outclr, inclr\n\tmov outtc0, r10\n.end\n\n" }, { "path": "arch/3ds/shader_playfield.v.pica", "content": "; MegaZeux\n;\n; Copyright (C) 2004-2006 Gilead Kutnick \n; Copyright (C) 2007 Alistair John Strachan \n; Copyright (C) 2007 Alan Williams \n;\n; This program is free software; you can redistribute it and/or\n; modify it under the terms of the GNU General Public License as\n; published by the Free Software Foundation; either version 2 of\n; the License, or (at your option) any later version.\n;\n; This program is distributed in the hope that it will be useful,\n; but WITHOUT ANY WARRANTY; without even the implied warranty of\n; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n; General Public License for more details.\n;\n; You should have received a copy of the GNU General Public License\n; along with this program; if not, write to the Free Software\n; Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n\n.out outpos position\n.out outtc0 texcoord0\n.out outclr color\n\n.alias inpos v0\n.alias intc0 v1\n.alias inclr v2\n\n.constf RGBS(0.00392156862745098, 0.00392156862745098, 0.00392156862745098, 0.00392156862745098)\n\n.proc main\n\tmov outpos, inpos\n\tmov outtc0, intc0\n mov r1, RGBS\n\tmul outclr, inclr.wzyx, r1.x\n\n\tend\n.end\n\n\n" }, { "path": "arch/3ds/thread.h", "content": "/* MegaZeux\n *\n * Copyright (C) 2016, 2018 Adrian Siekierka \n *\n * This program is free software; you can redistribute it and/or\n * modify it under the terms of the GNU General Public License as\n * published by the Free Software Foundation; either version 2 of\n * the License, or (at your option) any later version.\n *\n * This program is distributed in the hope that it will be useful,\n * but WITHOUT ANY WARRANTY; without even the implied warranty of\n * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n * General Public License for more details.\n *\n * You should have received a copy of the GNU General Public License\n * along with this program; if not, write to the Free Software\n * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n */\n\n#ifndef __THREAD_3DS_H\n#define __THREAD_3DS_H\n\n#include \"../../src/compat.h\"\n\n#define STACK_SIZE_CTR 8096\n\n__M_BEGIN_DECLS\n\n#include <3ds.h>\n\n#define THREAD_RES void\n#define THREAD_RETURN do { return; } while(0)\n\ntypedef CondVar platform_cond;\ntypedef LightLock platform_mutex;\ntypedef LightSemaphore platform_sem;\ntypedef Thread platform_thread;\ntypedef Thread platform_thread_id;\ntypedef ThreadFunc platform_thread_fn;\n\nstatic inline boolean platform_mutex_init(platform_mutex *mutex)\n{\n LightLock_Init(mutex);\n return true;\n}\n\nstatic inline boolean platform_mutex_destroy(platform_mutex *mutex)\n{\n return true;\n}\n\nstatic inline boolean platform_mutex_lock(platform_mutex *mutex)\n{\n LightLock_Lock(mutex);\n return true;\n}\n\nstatic inline boolean platform_mutex_unlock(platform_mutex *mutex)\n{\n LightLock_Unlock(mutex);\n return true;\n}\n\nstatic inline boolean platform_cond_init(platform_cond *cond)\n{\n CondVar_Init(cond);\n return true;\n}\n\nstatic inline boolean platform_cond_destroy(platform_cond *cond)\n{\n return true;\n}\n\nstatic inline boolean platform_cond_wait(platform_cond *cond,\n platform_mutex *mutex)\n{\n CondVar_Wait(cond, mutex);\n return true;\n}\n\nstatic inline boolean platform_cond_timedwait(platform_cond *cond,\n platform_mutex *mutex, unsigned int timeout_ms)\n{\n s64 timeout_ns = (s64)timeout_ms * 1000000;\n if(CondVar_WaitTimeout(cond, mutex, timeout_ns))\n return false;\n return true;\n}\n\nstatic inline boolean platform_cond_signal(platform_cond *cond)\n{\n CondVar_Signal(cond);\n return true;\n}\n\nstatic inline boolean platform_cond_broadcast(platform_cond *cond)\n{\n CondVar_Broadcast(cond);\n return true;\n}\n\nstatic inline boolean platform_sem_init(platform_sem *sem, unsigned init_value)\n{\n if(init_value > INT16_MAX)\n return false;\n LightSemaphore_Init(sem, init_value, INT16_MAX);\n return true;\n}\n\nstatic inline boolean platform_sem_destroy(platform_sem *sem)\n{\n return true;\n}\n\nstatic inline boolean platform_sem_wait(platform_sem *sem)\n{\n LightSemaphore_Acquire(sem, 1);\n return true;\n}\n\nstatic inline boolean platform_sem_post(platform_sem *sem)\n{\n LightSemaphore_Release(sem, 1);\n return true;\n}\n\nstatic inline boolean platform_thread_create(platform_thread *thread,\n platform_thread_fn start_function, void *data)\n{\n Thread t;\n s32 priority;\n\n svcGetThreadPriority(&priority, CUR_THREAD_HANDLE);\n t = threadCreate(start_function, data, STACK_SIZE_CTR, priority-1, -1,\n true);\n if(t)\n {\n *thread = t;\n return true;\n }\n return false;\n}\n\nstatic inline boolean platform_thread_join(platform_thread *thread)\n{\n // Return value not documented...\n threadJoin(*thread, U64_MAX);\n return true;\n}\n\nstatic inline platform_thread_id platform_get_thread_id(void)\n{\n return threadGetCurrent();\n}\n\nstatic inline boolean platform_is_same_thread(platform_thread_id a,\n platform_thread_id b)\n{\n return a == b;\n}\n\n__M_END_DECLS\n\n#endif // __THREAD_3DS_H\n" }, { "path": "arch/LICENSE.3rd", "content": "----------------------------------------------------------------\n Third party software licenses for MegaZeux\n----------------------------------------------------------------\n\nThe licenses here applicable to a given build of MegaZeux will\nvary. Typically one C standard library (glibc/Newlib/musl/etc.),\none module playback library (libxmp/libmodplug/MikMod/Maxmod),\nSDL, and several other libraries will be linked. The ports that\nuse each library by default will be indicated below. Not all\nlibcs are accounted for here, but the ones most often linked by\nMegaZeux are.\n\nSome particularly verbose licenses are only provided as URL.\nFor MegaZeux's license, see LICENSE.\n\n\n----------------------------------------------------------------\n glibc\n----------------------------------------------------------------\n\nglibc is available under the GNU Lesser General Public License 2.1.\nSee LICENSE.LGPL2 or /usr/share/licenses/glibc for more information.\n\nUsed by ports: Most Linux distributions.\nHome page: https://www.gnu.org/software/libc/\nLicense URL: https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html\n\n\n----------------------------------------------------------------\n MSVCRT.DLL, WS2_32.DLL, WSOCK.DLL\n----------------------------------------------------------------\n\nThese Microsoft Windows libraries are proprietary software.\nLinking them is permitted under the GPL system library exception.\n\nUsed by ports: MinGW and MSVC.\nHome page: https://www.microsoft.com/\n\n\n----------------------------------------------------------------\n Apple libc\n----------------------------------------------------------------\n\nApple libc is available under the Apple Public Source License 2.0.\n\nUsed by ports: Darwin and Xcode.\nHome page: https://opensource.apple.com/source/Libc/\nLicense URL: https://opensource.apple.com/license/apsl/\n\n\n----------------------------------------------------------------\n Newlib\n----------------------------------------------------------------\n\nNewlib is available under a collection of BSD-like licenses.\nSee LICENSE.Newlib or for more information.\n\nUsed by ports: NDS, 3DS, Wii, Wii U, Switch, PSP, PS Vita,\n Dreamcast, AmigaOS 4.\nHome page: https://sourceware.org/newlib/\nLicense URL: https://sourceware.org/newlib/COPYING.NEWLIB\n\n\n----------------------------------------------------------------\n musl\n----------------------------------------------------------------\n\nmusl is available under the MIT license.\n\nUsed by ports: Emscripten (also the default libc on some distributions).\nHome page: https://musl.libc.org/\nLicense URL: https://git.musl-libc.org/cgit/musl/tree/COPYRIGHT\n\nCopyright © 2005-2020 Rich Felker, et al.\n\nPermission is hereby granted, free of charge, to any person obtaining\na copy of this software and associated documentation files (the\n\"Software\"), to deal in the Software without restriction, including\nwithout limitation the rights to use, copy, modify, merge, publish,\ndistribute, sublicense, and/or sell copies of the Software, and to\npermit persons to whom the Software is furnished to do so, subject to\nthe following conditions:\n\nThe above copyright notice and this permission notice shall be\nincluded in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\nEXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\nMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.\nIN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY\nCLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,\nTORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE\nSOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n\n\n----------------------------------------------------------------\n Bionic libc\n----------------------------------------------------------------\n\nBionic is available under a collection of BSD-like licenses.\n\nUsed by ports: Android.\nHome page: https://android.googlesource.com/platform/bionic/\nLicense URL:\n https://android.googlesource.com/platform/bionic/+/master/libc/NOTICE\n\n\n----------------------------------------------------------------\n DJGPP libc, libm, and crt0\n----------------------------------------------------------------\n\nDJGPP libc and crt0 are available under the GNU Lesser General\nPublic License 2.1. DJGPP libm is *probably* available under the\nGNU General Public License 2.0. DJGPP also contains contributed\ncode under various permissive licenses. See LICENSE.DJGPP,\nLICENSE.LGPL2, and LICENSE for more information.\n\nUsed by ports: DJGPP.\nHome page: http://www.delorie.com/djgpp/\nSource URL: http://www.delorie.com/pub/djgpp/ (djlsr205.zip)\n\n\n----------------------------------------------------------------\n SDL\n----------------------------------------------------------------\n\nSDL is available under the zlib license.\ngamecontrollerdb.txt is available under an identical license.\n\nUsed by ports: Most.\nHome page: https://www.libsdl.org/\n\nCopyright (C) 1997-2024 Sam Lantinga \n \nThis software is provided 'as-is', without any express or implied\nwarranty. In no event will the authors be held liable for any damages\narising from the use of this software.\n\nPermission is granted to anyone to use this software for any purpose,\nincluding commercial applications, and to alter it and redistribute it\nfreely, subject to the following restrictions:\n \n1. The origin of this software must not be misrepresented; you must not\n claim that you wrote the original software. If you use this software\n in a product, an acknowledgment in the product documentation would be\n appreciated but is not required. \n2. Altered source versions must be plainly marked as such, and must not be\n misrepresented as being the original software.\n3. This notice may not be removed or altered from any source distribution.\n\n\n----------------------------------------------------------------\n SDL 1.2\n----------------------------------------------------------------\n\nSDL 1.2 is available under the GNU Lesser General Public License 2.1.\nSee LICENSE.LGPL2 or /usr/share/licenses/SDL for more information.\n\nUsed by ports: Mac OS X PowerPC, PSP, GP2X, Pandora, AmigaOS 4.\nHome page: https://www.libsdl.org/\nLicense URL: https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html\n\n\n----------------------------------------------------------------\n khash\n----------------------------------------------------------------\n\nMZX uses a heavily modified khash which is available under the MIT license.\n\nUsed by ports: All.\nHome page: https://attractivechaos.github.io/klib/\n\n The MIT License\n\n Copyright (c) 2008, 2009, 2011 by Attractive Chaos \n\n Permission is hereby granted, free of charge, to any person obtaining\n a copy of this software and associated documentation files (the\n \"Software\"), to deal in the Software without restriction, including\n without limitation the rights to use, copy, modify, merge, publish,\n distribute, sublicense, and/or sell copies of the Software, and to\n permit persons to whom the Software is furnished to do so, subject to\n the following conditions:\n\n The above copyright notice and this permission notice shall be\n included in all copies or substantial portions of the Software.\n\n THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\n MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS\n BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN\n ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\n CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n SOFTWARE.\n\n\n----------------------------------------------------------------\n zlib\n----------------------------------------------------------------\n\nzlib is available under the zlib license.\n\nUsed by ports: All.\nHome page: https://zlib.net/\n\n zlib.h -- interface of the 'zlib' general purpose compression library\n version 1.2.11, January 15th, 2017\n\n Copyright (C) 1995-2017 Jean-loup Gailly and Mark Adler\n\n This software is provided 'as-is', without any express or implied\n warranty. In no event will the authors be held liable for any damages\n arising from the use of this software.\n\n Permission is granted to anyone to use this software for any purpose,\n including commercial applications, and to alter it and redistribute it\n freely, subject to the following restrictions:\n\n 1. The origin of this software must not be misrepresented; you must not\n claim that you wrote the original software. If you use this software\n in a product, an acknowledgment in the product documentation would be\n appreciated but is not required.\n 2. Altered source versions must be plainly marked as such, and must not be\n misrepresented as being the original software.\n 3. This notice may not be removed or altered from any source distribution.\n\n Jean-loup Gailly Mark Adler\n jloup@gzip.org madler@alumni.caltech.edu\n\n\n----------------------------------------------------------------\n libpng\n----------------------------------------------------------------\n\nlibpng is available under a zlib-like license.\n\nUsed by ports: Most.\nHome page: https://www.libpng.org/\n\nPNG Reference Library License version 2\n---------------------------------------\n\n * Copyright (c) 1995-2019 The PNG Reference Library Authors.\n * Copyright (c) 2018-2019 Cosmin Truta.\n * Copyright (c) 2000-2002, 2004, 2006-2018 Glenn Randers-Pehrson.\n * Copyright (c) 1996-1997 Andreas Dilger.\n * Copyright (c) 1995-1996 Guy Eric Schalnat, Group 42, Inc.\n\nThe software is supplied \"as is\", without warranty of any kind,\nexpress or implied, including, without limitation, the warranties\nof merchantability, fitness for a particular purpose, title, and\nnon-infringement. In no event shall the Copyright owners, or\nanyone distributing the software, be liable for any damages or\nother liability, whether in contract, tort or otherwise, arising\nfrom, out of, or in connection with the software, or the use or\nother dealings in the software, even if advised of the possibility\nof such damage.\n\nPermission is hereby granted to use, copy, modify, and distribute\nthis software, or portions hereof, for any purpose, without fee,\nsubject to the following restrictions:\n\n 1. The origin of this software must not be misrepresented; you\n must not claim that you wrote the original software. If you\n use this software in a product, an acknowledgment in the product\n documentation would be appreciated, but is not required.\n\n 2. Altered source versions must be plainly marked as such, and must\n not be misrepresented as being the original software.\n\n 3. This Copyright notice may not be removed or altered from any\n source or altered source distribution.\n\n\n----------------------------------------------------------------\n libogg, libvorbis, and Tremor\n----------------------------------------------------------------\n\nlibogg, libvorbis, and Tremor are all available under the\nBSD-3-clause license.\n\nUsed by ports: All except DJGPP, NDS.\nHome page: https://xiph.org/ogg/\nHome page: https://xiph.org/vorbis/\n\nCopyright (c) 2002-2020 Xiph.org Foundation\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions\nare met:\n\n- Redistributions of source code must retain the above copyright\nnotice, this list of conditions and the following disclaimer.\n\n- Redistributions in binary form must reproduce the above copyright\nnotice, this list of conditions and the following disclaimer in the\ndocumentation and/or other materials provided with the distribution.\n\n- Neither the name of the Xiph.org Foundation nor the names of its\ncontributors may be used to endorse or promote products derived from\nthis software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\nLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\nA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION\nOR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\nSPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\nLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\nDATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\nTHEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n\n----------------------------------------------------------------\n stb_vorbis\n----------------------------------------------------------------\n\nstb_vorbis is available under a dual MIT/Unlicense license.\nMegaZeux uses a fork of stb_vorbis maintained by sezero as some\nof the required patches have not been merged upstream yet.\n\nUsed by ports: DJGPP\nHome page: https://github.com/nothings/stb\nsezero fork: https://github.com/sezero/stb\n\n------------------------------------------------------------------------------\nThis software is available under 2 licenses -- choose whichever you prefer.\n------------------------------------------------------------------------------\nALTERNATIVE A - MIT License\nCopyright (c) 2017 Sean Barrett\nPermission is hereby granted, free of charge, to any person obtaining a copy of\nthis software and associated documentation files (the \"Software\"), to deal in\nthe Software without restriction, including without limitation the rights to\nuse, copy, modify, merge, publish, distribute, sublicense, and/or sell copies\nof the Software, and to permit persons to whom the Software is furnished to do\nso, subject to the following conditions:\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n------------------------------------------------------------------------------\nALTERNATIVE B - Public Domain (www.unlicense.org)\nThis is free and unencumbered software released into the public domain.\nAnyone is free to copy, modify, publish, use, compile, sell, or distribute this\nsoftware, either in source code form or as a compiled binary, for any purpose,\ncommercial or non-commercial, and by any means.\nIn jurisdictions that recognize copyright laws, the author or authors of this\nsoftware dedicate any and all copyright interest in the software to the public\ndomain. We make this dedication for the benefit of the public at large and to\nthe detriment of our heirs and successors. We intend this dedication to be an\novert act of relinquishment in perpetuity of all present and future rights to\nthis software under copyright law.\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN\nACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION\nWITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n------------------------------------------------------------------------------\n\n\n----------------------------------------------------------------\n libxmp\n----------------------------------------------------------------\n\nThe subset of libxmp used by MegaZeux is available under the MIT license.\n\nUsed by ports: All except NDS. \nHome page: http://xmp.sourceforge.net/\n\nExtended Module Player\nCopyright (C) 1996-2021 Claudio Matsuoka and Hipolito Carraro Jr\n\nPermission is hereby granted, free of charge, to any person obtaining a\ncopy of this software and associated documentation files (the \"Software\"),\nto deal in the Software without restriction, including without limitation\nthe rights to use, copy, modify, merge, publish, distribute, sublicense,\nand/or sell copies of the Software, and to permit persons to whom the\nSoftware is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n\n\n----------------------------------------------------------------\n libmodplug\n----------------------------------------------------------------\n\nlibmodplug is available in the public domain.\n\nUsed by ports: None (non-default compile-time option).\nHome page: https://github.com/Konstanty/libmodplug\n\n\n----------------------------------------------------------------\n MikMod\n----------------------------------------------------------------\n\nlibmikmod is available under the GNU Lesser General Public License 2.1.\nSee LICENSE.LGPL2 for more information.\n\nUsed by ports: None (non-default compile-time option).\nHome page: http://mikmod.sourceforge.net/\nLicense URL: https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html\n\n\n----------------------------------------------------------------\n OpenMPT\n----------------------------------------------------------------\n\nlibopenmpt is available under the BSD-3-clause license.\n\nUsed by ports: None (non-default compile-time option).\nHome page: https://lib.openmpt.org/libopenmpt/\n\nCopyright (c) 2004-2022, OpenMPT Project Developers and Contributors\nCopyright (c) 1997-2003, Olivier Lapicque\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are met:\n * Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n * Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n * Neither the name of the OpenMPT project nor the\n names of its contributors may be used to endorse or promote products\n derived from this software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\"\nAND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\nIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\nDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE\nFOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR\nSERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER\nCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,\nOR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n\n----------------------------------------------------------------\n Reality Adlib Tracker v2\n----------------------------------------------------------------\n\nThe Reality Adlib Tracker v2 playercode is available in the public domain.\n\nUsed by ports: All except NDS.\nHome page: https://www.3eality.com/productions/reality-adlib-tracker\n\n\n----------------------------------------------------------------\n Maxmod\n----------------------------------------------------------------\n\nMaxmod is available under the ISC license.\n\nUsed by ports: NDS.\nHome page: https://maxmod.org\n\n/****************************************************************************\n * __ *\n * ____ ___ ____ __ ______ ___ ____ ____/ / *\n * / __ `__ \\/ __ `/ |/ / __ `__ \\/ __ \\/ __ / *\n * / / / / / / /_/ /> \n *\n * This software may be used freely so long as this copyright notice is\n * left intact. There is no warranty on this software.\n */\n\n\n4) Regents of the University of California (stdlib)\n\n/*\n * Copyright (c) 1983 Regents of the University of California.\n * All rights reserved.\n *\n * Redistribution and use in source and binary forms are permitted\n * provided that: (1) source distributions retain this entire copyright\n * notice and comment, and (2) distributions including binaries display\n * the following acknowledgement: ``This product includes software\n * developed by the University of California, Berkeley and its contributors''\n * in the documentation or other materials provided with the distribution\n * and in all advertising materials mentioning features or use of this\n * software. Neither the name of the University nor the names of its\n * contributors may be used to endorse or promote products derived\n * from this software without specific prior written permission.\n * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR\n * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED\n * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.\n */\n\n\n5) Regents of the University of California (ctime)\n\n/*\n * Copyright (c) 1987, 1989 Regents of the University of California.\n * All rights reserved.\n *\n * This code is derived from software contributed to Berkeley by\n * Arthur David Olson of the National Cancer Institute.\n *\n * Redistribution and use in source and binary forms are permitted provided\n * that: (1) source distributions retain this entire copyright notice and\n * comment, and (2) distributions including binaries display the following\n * acknowledgement: ``This product includes software developed by the\n * University of California, Berkeley and its contributors'' in the\n * documentation or other materials provided with the distribution and in\n * all advertising materials mentioning features or use of this software.\n * Neither the name of the University nor the names of its contributors may\n * be used to endorse or promote products derived from this software without\n * specific prior written permission.\n * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED\n * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF\n * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.\n */\n\n\n6) Martin Strömberg (libc)\n\n * Copyright (C) 2003 Martin Str@\"omberg .\n *\n * This software may be used freely so long as this copyright notice is\n * left intact. There is no warranty on this software.\n\n\n7) Eli Zaretskii (libc)\n\n * Copyright (c) 1995-98 Eli Zaretskii \n *\n * This software may be used freely so long as this copyright notice is\n * left intact. There is no warranty on this software.\n\n\n8) Morten Welinder (libc)\n\n Copyright 1995 by Morten Welinder\n This file maybe freely distributed and modified as long as the\n copyright notice remains.\n\n\n9) Borca Daniel and Andrew Zabolotny (libc)\n\n/* Copyright (C) 2003 Borca Daniel \n * Copyright (C) 2000 Andrew Zabolotny \n * Partly based on work by Charles Sandmann and DJ Delorie.\n * Usage of this library is not restricted in any way. \n * ABSOLUTELY no warranties. Contributed to the DJGPP project.\n */\n\n\n10) Charles Sandmann (libc)\n\n/* Copyright (C) 1995 Charles Sandmann (sandmann@clio.rice.edu)\n This software may be freely distributed with above copyright, no warranty.\n Based on code by DJ Delorie, it's really his, enhanced, bugs fixed. */\n\n/* Copyright (C) 1994, 1995 Charles Sandmann (sandmann@clio.rice.edu)\n * ...\n * This file maybe freely distributed, no warranty. */\n\n/* Copyright (C) 1994, 1995 Charles Sandmann (sandmann@clio.rice.edu)\n * This file maybe freely distributed and modified as long as copyright remains.\n */\n\n/* Copyright (C) 1995 Charles Sandmann (sandmann@clio.rice.edu)\n This software may be freely distributed, no warranty.\n\n\n11) Henry Spencer (regex)\n\nCopyright 1992, 1993, 1994, 1997 Henry Spencer. All rights reserved.\nThis software is not subject to any license of the American Telephone\nand Telegraph Company or of the Regents of the University of California.\n\nPermission is granted to anyone to use this software for any purpose on\nany computer system, and to alter it and redistribute it, subject\nto the following restrictions:\n\n1. The author is not responsible for the consequences of use of this\n software, no matter how awful, even if they arise from flaws in it.\n\n2. The origin of this software must not be misrepresented, either by\n explicit claim or by omission. Since few users ever read sources,\n credits must appear in the documentation.\n\n3. Altered versions must be plainly marked as such, and must not be\n misrepresented as being the original software. Since few users\n ever read sources, credits must appear in the documentation.\n\n4. This notice may not be removed or altered.\n\n\n12) Eric Backus (xstat)\n\n/*\n (c) Copyright 1992 Eric Backus\n\n This software may be used freely so long as this copyright notice is\n left intact. There is no warranty on this software.\n*/\n" }, { "path": "arch/LICENSE.LGPL2", "content": " GNU LESSER GENERAL PUBLIC LICENSE\n Version 2.1, February 1999\n\n Copyright (C) 1991, 1999 Free Software Foundation, Inc.\n 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n Everyone is permitted to copy and distribute verbatim copies\n of this license document, but changing it is not allowed.\n\n[This is the first released version of the Lesser GPL. It also counts\n as the successor of the GNU Library Public License, version 2, hence\n the version number 2.1.]\n\n Preamble\n\n The licenses for most software are designed to take away your\nfreedom to share and change it. By contrast, the GNU General Public\nLicenses are intended to guarantee your freedom to share and change\nfree software--to make sure the software is free for all its users.\n\n This license, the Lesser General Public License, applies to some\nspecially designated software packages--typically libraries--of the\nFree Software Foundation and other authors who decide to use it. You\ncan use it too, but we suggest you first think carefully about whether\nthis license or the ordinary General Public License is the better\nstrategy to use in any particular case, based on the explanations below.\n\n When we speak of free software, we are referring to freedom of use,\nnot price. Our General Public Licenses are designed to make sure that\nyou have the freedom to distribute copies of free software (and charge\nfor this service if you wish); that you receive source code or can get\nit if you want it; that you can change the software and use pieces of\nit in new free programs; and that you are informed that you can do\nthese things.\n\n To protect your rights, we need to make restrictions that forbid\ndistributors to deny you these rights or to ask you to surrender these\nrights. These restrictions translate to certain responsibilities for\nyou if you distribute copies of the library or if you modify it.\n\n For example, if you distribute copies of the library, whether gratis\nor for a fee, you must give the recipients all the rights that we gave\nyou. You must make sure that they, too, receive or can get the source\ncode. If you link other code with the library, you must provide\ncomplete object files to the recipients, so that they can relink them\nwith the library after making changes to the library and recompiling\nit. And you must show them these terms so they know their rights.\n\n We protect your rights with a two-step method: (1) we copyright the\nlibrary, and (2) we offer you this license, which gives you legal\npermission to copy, distribute and/or modify the library.\n\n To protect each distributor, we want to make it very clear that\nthere is no warranty for the free library. Also, if the library is\nmodified by someone else and passed on, the recipients should know\nthat what they have is not the original version, so that the original\nauthor's reputation will not be affected by problems that might be\nintroduced by others.\n\f\n Finally, software patents pose a constant threat to the existence of\nany free program. We wish to make sure that a company cannot\neffectively restrict the users of a free program by obtaining a\nrestrictive license from a patent holder. Therefore, we insist that\nany patent license obtained for a version of the library must be\nconsistent with the full freedom of use specified in this license.\n\n Most GNU software, including some libraries, is covered by the\nordinary GNU General Public License. This license, the GNU Lesser\nGeneral Public License, applies to certain designated libraries, and\nis quite different from the ordinary General Public License. We use\nthis license for certain libraries in order to permit linking those\nlibraries into non-free programs.\n\n When a program is linked with a library, whether statically or using\na shared library, the combination of the two is legally speaking a\ncombined work, a derivative of the original library. The ordinary\nGeneral Public License therefore permits such linking only if the\nentire combination fits its criteria of freedom. The Lesser General\nPublic License permits more lax criteria for linking other code with\nthe library.\n\n We call this license the \"Lesser\" General Public License because it\ndoes Less to protect the user's freedom than the ordinary General\nPublic License. It also provides other free software developers Less\nof an advantage over competing non-free programs. These disadvantages\nare the reason we use the ordinary General Public License for many\nlibraries. However, the Lesser license provides advantages in certain\nspecial circumstances.\n\n For example, on rare occasions, there may be a special need to\nencourage the widest possible use of a certain library, so that it becomes\na de-facto standard. To achieve this, non-free programs must be\nallowed to use the library. A more frequent case is that a free\nlibrary does the same job as widely used non-free libraries. In this\ncase, there is little to gain by limiting the free library to free\nsoftware only, so we use the Lesser General Public License.\n\n In other cases, permission to use a particular library in non-free\nprograms enables a greater number of people to use a large body of\nfree software. For example, permission to use the GNU C Library in\nnon-free programs enables many more people to use the whole GNU\noperating system, as well as its variant, the GNU/Linux operating\nsystem.\n\n Although the Lesser General Public License is Less protective of the\nusers' freedom, it does ensure that the user of a program that is\nlinked with the Library has the freedom and the wherewithal to run\nthat program using a modified version of the Library.\n\n The precise terms and conditions for copying, distribution and\nmodification follow. Pay close attention to the difference between a\n\"work based on the library\" and a \"work that uses the library\". The\nformer contains code derived from the library, whereas the latter must\nbe combined with the library in order to run.\n\f\n GNU LESSER GENERAL PUBLIC LICENSE\n TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION\n\n 0. This License Agreement applies to any software library or other\nprogram which contains a notice placed by the copyright holder or\nother authorized party saying it may be distributed under the terms of\nthis Lesser General Public License (also called \"this License\").\nEach licensee is addressed as \"you\".\n\n A \"library\" means a collection of software functions and/or data\nprepared so as to be conveniently linked with application programs\n(which use some of those functions and data) to form executables.\n\n The \"Library\", below, refers to any such software library or work\nwhich has been distributed under these terms. A \"work based on the\nLibrary\" means either the Library or any derivative work under\ncopyright law: that is to say, a work containing the Library or a\nportion of it, either verbatim or with modifications and/or translated\nstraightforwardly into another language. (Hereinafter, translation is\nincluded without limitation in the term \"modification\".)\n\n \"Source code\" for a work means the preferred form of the work for\nmaking modifications to it. For a library, complete source code means\nall the source code for all modules it contains, plus any associated\ninterface definition files, plus the scripts used to control compilation\nand installation of the library.\n\n Activities other than copying, distribution and modification are not\ncovered by this License; they are outside its scope. The act of\nrunning a program using the Library is not restricted, and output from\nsuch a program is covered only if its contents constitute a work based\non the Library (independent of the use of the Library in a tool for\nwriting it). Whether that is true depends on what the Library does\nand what the program that uses the Library does.\n\n 1. You may copy and distribute verbatim copies of the Library's\ncomplete source code as you receive it, in any medium, provided that\nyou conspicuously and appropriately publish on each copy an\nappropriate copyright notice and disclaimer of warranty; keep intact\nall the notices that refer to this License and to the absence of any\nwarranty; and distribute a copy of this License along with the\nLibrary.\n\n You may charge a fee for the physical act of transferring a copy,\nand you may at your option offer warranty protection in exchange for a\nfee.\n\f\n 2. You may modify your copy or copies of the Library or any portion\nof it, thus forming a work based on the Library, and copy and\ndistribute such modifications or work under the terms of Section 1\nabove, provided that you also meet all of these conditions:\n\n a) The modified work must itself be a software library.\n\n b) You must cause the files modified to carry prominent notices\n stating that you changed the files and the date of any change.\n\n c) You must cause the whole of the work to be licensed at no\n charge to all third parties under the terms of this License.\n\n d) If a facility in the modified Library refers to a function or a\n table of data to be supplied by an application program that uses\n the facility, other than as an argument passed when the facility\n is invoked, then you must make a good faith effort to ensure that,\n in the event an application does not supply such function or\n table, the facility still operates, and performs whatever part of\n its purpose remains meaningful.\n\n (For example, a function in a library to compute square roots has\n a purpose that is entirely well-defined independent of the\n application. Therefore, Subsection 2d requires that any\n application-supplied function or table used by this function must\n be optional: if the application does not supply it, the square\n root function must still compute square roots.)\n\nThese requirements apply to the modified work as a whole. If\nidentifiable sections of that work are not derived from the Library,\nand can be reasonably considered independent and separate works in\nthemselves, then this License, and its terms, do not apply to those\nsections when you distribute them as separate works. But when you\ndistribute the same sections as part of a whole which is a work based\non the Library, the distribution of the whole must be on the terms of\nthis License, whose permissions for other licensees extend to the\nentire whole, and thus to each and every part regardless of who wrote\nit.\n\nThus, it is not the intent of this section to claim rights or contest\nyour rights to work written entirely by you; rather, the intent is to\nexercise the right to control the distribution of derivative or\ncollective works based on the Library.\n\nIn addition, mere aggregation of another work not based on the Library\nwith the Library (or with a work based on the Library) on a volume of\na storage or distribution medium does not bring the other work under\nthe scope of this License.\n\n 3. You may opt to apply the terms of the ordinary GNU General Public\nLicense instead of this License to a given copy of the Library. To do\nthis, you must alter all the notices that refer to this License, so\nthat they refer to the ordinary GNU General Public License, version 2,\ninstead of to this License. (If a newer version than version 2 of the\nordinary GNU General Public License has appeared, then you can specify\nthat version instead if you wish.) Do not make any other change in\nthese notices.\n\f\n Once this change is made in a given copy, it is irreversible for\nthat copy, so the ordinary GNU General Public License applies to all\nsubsequent copies and derivative works made from that copy.\n\n This option is useful when you wish to copy part of the code of\nthe Library into a program that is not a library.\n\n 4. You may copy and distribute the Library (or a portion or\nderivative of it, under Section 2) in object code or executable form\nunder the terms of Sections 1 and 2 above provided that you accompany\nit with the complete corresponding machine-readable source code, which\nmust be distributed under the terms of Sections 1 and 2 above on a\nmedium customarily used for software interchange.\n\n If distribution of object code is made by offering access to copy\nfrom a designated place, then offering equivalent access to copy the\nsource code from the same place satisfies the requirement to\ndistribute the source code, even though third parties are not\ncompelled to copy the source along with the object code.\n\n 5. A program that contains no derivative of any portion of the\nLibrary, but is designed to work with the Library by being compiled or\nlinked with it, is called a \"work that uses the Library\". Such a\nwork, in isolation, is not a derivative work of the Library, and\ntherefore falls outside the scope of this License.\n\n However, linking a \"work that uses the Library\" with the Library\ncreates an executable that is a derivative of the Library (because it\ncontains portions of the Library), rather than a \"work that uses the\nlibrary\". The executable is therefore covered by this License.\nSection 6 states terms for distribution of such executables.\n\n When a \"work that uses the Library\" uses material from a header file\nthat is part of the Library, the object code for the work may be a\nderivative work of the Library even though the source code is not.\nWhether this is true is especially significant if the work can be\nlinked without the Library, or if the work is itself a library. The\nthreshold for this to be true is not precisely defined by law.\n\n If such an object file uses only numerical parameters, data\nstructure layouts and accessors, and small macros and small inline\nfunctions (ten lines or less in length), then the use of the object\nfile is unrestricted, regardless of whether it is legally a derivative\nwork. (Executables containing this object code plus portions of the\nLibrary will still fall under Section 6.)\n\n Otherwise, if the work is a derivative of the Library, you may\ndistribute the object code for the work under the terms of Section 6.\nAny executables containing that work also fall under Section 6,\nwhether or not they are linked directly with the Library itself.\n\f\n 6. As an exception to the Sections above, you may also combine or\nlink a \"work that uses the Library\" with the Library to produce a\nwork containing portions of the Library, and distribute that work\nunder terms of your choice, provided that the terms permit\nmodification of the work for the customer's own use and reverse\nengineering for debugging such modifications.\n\n You must give prominent notice with each copy of the work that the\nLibrary is used in it and that the Library and its use are covered by\nthis License. You must supply a copy of this License. If the work\nduring execution displays copyright notices, you must include the\ncopyright notice for the Library among them, as well as a reference\ndirecting the user to the copy of this License. Also, you must do one\nof these things:\n\n a) Accompany the work with the complete corresponding\n machine-readable source code for the Library including whatever\n changes were used in the work (which must be distributed under\n Sections 1 and 2 above); and, if the work is an executable linked\n with the Library, with the complete machine-readable \"work that\n uses the Library\", as object code and/or source code, so that the\n user can modify the Library and then relink to produce a modified\n executable containing the modified Library. (It is understood\n that the user who changes the contents of definitions files in the\n Library will not necessarily be able to recompile the application\n to use the modified definitions.)\n\n b) Use a suitable shared library mechanism for linking with the\n Library. A suitable mechanism is one that (1) uses at run time a\n copy of the library already present on the user's computer system,\n rather than copying library functions into the executable, and (2)\n will operate properly with a modified version of the library, if\n the user installs one, as long as the modified version is\n interface-compatible with the version that the work was made with.\n\n c) Accompany the work with a written offer, valid for at\n least three years, to give the same user the materials\n specified in Subsection 6a, above, for a charge no more\n than the cost of performing this distribution.\n\n d) If distribution of the work is made by offering access to copy\n from a designated place, offer equivalent access to copy the above\n specified materials from the same place.\n\n e) Verify that the user has already received a copy of these\n materials or that you have already sent this user a copy.\n\n For an executable, the required form of the \"work that uses the\nLibrary\" must include any data and utility programs needed for\nreproducing the executable from it. However, as a special exception,\nthe materials to be distributed need not include anything that is\nnormally distributed (in either source or binary form) with the major\ncomponents (compiler, kernel, and so on) of the operating system on\nwhich the executable runs, unless that component itself accompanies\nthe executable.\n\n It may happen that this requirement contradicts the license\nrestrictions of other proprietary libraries that do not normally\naccompany the operating system. Such a contradiction means you cannot\nuse both them and the Library together in an executable that you\ndistribute.\n\f\n 7. You may place library facilities that are a work based on the\nLibrary side-by-side in a single library together with other library\nfacilities not covered by this License, and distribute such a combined\nlibrary, provided that the separate distribution of the work based on\nthe Library and of the other library facilities is otherwise\npermitted, and provided that you do these two things:\n\n a) Accompany the combined library with a copy of the same work\n based on the Library, uncombined with any other library\n facilities. This must be distributed under the terms of the\n Sections above.\n\n b) Give prominent notice with the combined library of the fact\n that part of it is a work based on the Library, and explaining\n where to find the accompanying uncombined form of the same work.\n\n 8. You may not copy, modify, sublicense, link with, or distribute\nthe Library except as expressly provided under this License. Any\nattempt otherwise to copy, modify, sublicense, link with, or\ndistribute the Library is void, and will automatically terminate your\nrights under this License. However, parties who have received copies,\nor rights, from you under this License will not have their licenses\nterminated so long as such parties remain in full compliance.\n\n 9. You are not required to accept this License, since you have not\nsigned it. However, nothing else grants you permission to modify or\ndistribute the Library or its derivative works. These actions are\nprohibited by law if you do not accept this License. Therefore, by\nmodifying or distributing the Library (or any work based on the\nLibrary), you indicate your acceptance of this License to do so, and\nall its terms and conditions for copying, distributing or modifying\nthe Library or works based on it.\n\n 10. Each time you redistribute the Library (or any work based on the\nLibrary), the recipient automatically receives a license from the\noriginal licensor to copy, distribute, link with or modify the Library\nsubject to these terms and conditions. You may not impose any further\nrestrictions on the recipients' exercise of the rights granted herein.\nYou are not responsible for enforcing compliance by third parties with\nthis License.\n\f\n 11. If, as a consequence of a court judgment or allegation of patent\ninfringement or for any other reason (not limited to patent issues),\nconditions are imposed on you (whether by court order, agreement or\notherwise) that contradict the conditions of this License, they do not\nexcuse you from the conditions of this License. If you cannot\ndistribute so as to satisfy simultaneously your obligations under this\nLicense and any other pertinent obligations, then as a consequence you\nmay not distribute the Library at all. For example, if a patent\nlicense would not permit royalty-free redistribution of the Library by\nall those who receive copies directly or indirectly through you, then\nthe only way you could satisfy both it and this License would be to\nrefrain entirely from distribution of the Library.\n\nIf any portion of this section is held invalid or unenforceable under any\nparticular circumstance, the balance of the section is intended to apply,\nand the section as a whole is intended to apply in other circumstances.\n\nIt is not the purpose of this section to induce you to infringe any\npatents or other property right claims or to contest validity of any\nsuch claims; this section has the sole purpose of protecting the\nintegrity of the free software distribution system which is\nimplemented by public license practices. Many people have made\ngenerous contributions to the wide range of software distributed\nthrough that system in reliance on consistent application of that\nsystem; it is up to the author/donor to decide if he or she is willing\nto distribute software through any other system and a licensee cannot\nimpose that choice.\n\nThis section is intended to make thoroughly clear what is believed to\nbe a consequence of the rest of this License.\n\n 12. If the distribution and/or use of the Library is restricted in\ncertain countries either by patents or by copyrighted interfaces, the\noriginal copyright holder who places the Library under this License may add\nan explicit geographical distribution limitation excluding those countries,\nso that distribution is permitted only in or among countries not thus\nexcluded. In such case, this License incorporates the limitation as if\nwritten in the body of this License.\n\n 13. The Free Software Foundation may publish revised and/or new\nversions of the Lesser General Public License from time to time.\nSuch new versions will be similar in spirit to the present version,\nbut may differ in detail to address new problems or concerns.\n\nEach version is given a distinguishing version number. If the Library\nspecifies a version number of this License which applies to it and\n\"any later version\", you have the option of following the terms and\nconditions either of that version or of any later version published by\nthe Free Software Foundation. If the Library does not specify a\nlicense version number, you may choose any version ever published by\nthe Free Software Foundation.\n\f\n 14. If you wish to incorporate parts of the Library into other free\nprograms whose distribution conditions are incompatible with these,\nwrite to the author to ask for permission. For software which is\ncopyrighted by the Free Software Foundation, write to the Free\nSoftware Foundation; we sometimes make exceptions for this. Our\ndecision will be guided by the two goals of preserving the free status\nof all derivatives of our free software and of promoting the sharing\nand reuse of software generally.\n\n NO WARRANTY\n\n 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO\nWARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.\nEXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR\nOTHER PARTIES PROVIDE THE LIBRARY \"AS IS\" WITHOUT WARRANTY OF ANY\nKIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE\nIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR\nPURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE\nLIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME\nTHE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.\n\n 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN\nWRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY\nAND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU\nFOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR\nCONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE\nLIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING\nRENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A\nFAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF\nSUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH\nDAMAGES.\n\n END OF TERMS AND CONDITIONS\n\f\n How to Apply These Terms to Your New Libraries\n\n If you develop a new library, and you want it to be of the greatest\npossible use to the public, we recommend making it free software that\neveryone can redistribute and change. You can do so by permitting\nredistribution under these terms (or, alternatively, under the terms of the\nordinary General Public License).\n\n To apply these terms, attach the following notices to the library. It is\nsafest to attach them to the start of each source file to most effectively\nconvey the exclusion of warranty; and each file should have at least the\n\"copyright\" line and a pointer to where the full notice is found.\n\n \n Copyright (C) \n\n This library is free software; you can redistribute it and/or\n modify it under the terms of the GNU Lesser General Public\n License as published by the Free Software Foundation; either\n version 2.1 of the License, or (at your option) any later version.\n\n This library is distributed in the hope that it will be useful,\n but WITHOUT ANY WARRANTY; without even the implied warranty of\n MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n Lesser General Public License for more details.\n\n You should have received a copy of the GNU Lesser General Public\n License along with this library; if not, write to the Free Software\n Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n\nAlso add information on how to contact you by electronic and paper mail.\n\nYou should also get your employer (if you work as a programmer) or your\nschool, if any, to sign a \"copyright disclaimer\" for the library, if\nnecessary. Here is a sample; alter the names:\n\n Yoyodyne, Inc., hereby disclaims all copyright interest in the\n library `Frob' (a library for tweaking knobs) written by James Random Hacker.\n\n , 1 April 1990\n Ty Coon, President of Vice\n\nThat's all there is to it!\n" }, { "path": "arch/LICENSE.MPL2", "content": "Mozilla Public License Version 2.0\n==================================\n\n1. Definitions\n--------------\n\n1.1. \"Contributor\"\n means each individual or legal entity that creates, contributes to\n the creation of, or owns Covered Software.\n\n1.2. \"Contributor Version\"\n means the combination of the Contributions of others (if any) used\n by a Contributor and that particular Contributor's Contribution.\n\n1.3. \"Contribution\"\n means Covered Software of a particular Contributor.\n\n1.4. \"Covered Software\"\n means Source Code Form to which the initial Contributor has attached\n the notice in Exhibit A, the Executable Form of such Source Code\n Form, and Modifications of such Source Code Form, in each case\n including portions thereof.\n\n1.5. \"Incompatible With Secondary Licenses\"\n means\n\n (a) that the initial Contributor has attached the notice described\n in Exhibit B to the Covered Software; or\n\n (b) that the Covered Software was made available under the terms of\n version 1.1 or earlier of the License, but not also under the\n terms of a Secondary License.\n\n1.6. \"Executable Form\"\n means any form of the work other than Source Code Form.\n\n1.7. \"Larger Work\"\n means a work that combines Covered Software with other material, in \n a separate file or files, that is not Covered Software.\n\n1.8. \"License\"\n means this document.\n\n1.9. \"Licensable\"\n means having the right to grant, to the maximum extent possible,\n whether at the time of the initial grant or subsequently, any and\n all of the rights conveyed by this License.\n\n1.10. \"Modifications\"\n means any of the following:\n\n (a) any file in Source Code Form that results from an addition to,\n deletion from, or modification of the contents of Covered\n Software; or\n\n (b) any new file in Source Code Form that contains any Covered\n Software.\n\n1.11. \"Patent Claims\" of a Contributor\n means any patent claim(s), including without limitation, method,\n process, and apparatus claims, in any patent Licensable by such\n Contributor that would be infringed, but for the grant of the\n License, by the making, using, selling, offering for sale, having\n made, import, or transfer of either its Contributions or its\n Contributor Version.\n\n1.12. \"Secondary License\"\n means either the GNU General Public License, Version 2.0, the GNU\n Lesser General Public License, Version 2.1, the GNU Affero General\n Public License, Version 3.0, or any later versions of those\n licenses.\n\n1.13. \"Source Code Form\"\n means the form of the work preferred for making modifications.\n\n1.14. \"You\" (or \"Your\")\n means an individual or a legal entity exercising rights under this\n License. For legal entities, \"You\" includes any entity that\n controls, is controlled by, or is under common control with You. For\n purposes of this definition, \"control\" means (a) the power, direct\n or indirect, to cause the direction or management of such entity,\n whether by contract or otherwise, or (b) ownership of more than\n fifty percent (50%) of the outstanding shares or beneficial\n ownership of such entity.\n\n2. License Grants and Conditions\n--------------------------------\n\n2.1. Grants\n\nEach Contributor hereby grants You a world-wide, royalty-free,\nnon-exclusive license:\n\n(a) under intellectual property rights (other than patent or trademark)\n Licensable by such Contributor to use, reproduce, make available,\n modify, display, perform, distribute, and otherwise exploit its\n Contributions, either on an unmodified basis, with Modifications, or\n as part of a Larger Work; and\n\n(b) under Patent Claims of such Contributor to make, use, sell, offer\n for sale, have made, import, and otherwise transfer either its\n Contributions or its Contributor Version.\n\n2.2. Effective Date\n\nThe licenses granted in Section 2.1 with respect to any Contribution\nbecome effective for each Contribution on the date the Contributor first\ndistributes such Contribution.\n\n2.3. Limitations on Grant Scope\n\nThe licenses granted in this Section 2 are the only rights granted under\nthis License. No additional rights or licenses will be implied from the\ndistribution or licensing of Covered Software under this License.\nNotwithstanding Section 2.1(b) above, no patent license is granted by a\nContributor:\n\n(a) for any code that a Contributor has removed from Covered Software;\n or\n\n(b) for infringements caused by: (i) Your and any other third party's\n modifications of Covered Software, or (ii) the combination of its\n Contributions with other software (except as part of its Contributor\n Version); or\n\n(c) under Patent Claims infringed by Covered Software in the absence of\n its Contributions.\n\nThis License does not grant any rights in the trademarks, service marks,\nor logos of any Contributor (except as may be necessary to comply with\nthe notice requirements in Section 3.4).\n\n2.4. Subsequent Licenses\n\nNo Contributor makes additional grants as a result of Your choice to\ndistribute the Covered Software under a subsequent version of this\nLicense (see Section 10.2) or under the terms of a Secondary License (if\npermitted under the terms of Section 3.3).\n\n2.5. Representation\n\nEach Contributor represents that the Contributor believes its\nContributions are its original creation(s) or it has sufficient rights\nto grant the rights to its Contributions conveyed by this License.\n\n2.6. Fair Use\n\nThis License is not intended to limit any rights You have under\napplicable copyright doctrines of fair use, fair dealing, or other\nequivalents.\n\n2.7. Conditions\n\nSections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted\nin Section 2.1.\n\n3. Responsibilities\n-------------------\n\n3.1. Distribution of Source Form\n\nAll distribution of Covered Software in Source Code Form, including any\nModifications that You create or to which You contribute, must be under\nthe terms of this License. You must inform recipients that the Source\nCode Form of the Covered Software is governed by the terms of this\nLicense, and how they can obtain a copy of this License. You may not\nattempt to alter or restrict the recipients' rights in the Source Code\nForm.\n\n3.2. Distribution of Executable Form\n\nIf You distribute Covered Software in Executable Form then:\n\n(a) such Covered Software must also be made available in Source Code\n Form, as described in Section 3.1, and You must inform recipients of\n the Executable Form how they can obtain a copy of such Source Code\n Form by reasonable means in a timely manner, at a charge no more\n than the cost of distribution to the recipient; and\n\n(b) You may distribute such Executable Form under the terms of this\n License, or sublicense it under different terms, provided that the\n license for the Executable Form does not attempt to limit or alter\n the recipients' rights in the Source Code Form under this License.\n\n3.3. Distribution of a Larger Work\n\nYou may create and distribute a Larger Work under terms of Your choice,\nprovided that You also comply with the requirements of this License for\nthe Covered Software. If the Larger Work is a combination of Covered\nSoftware with a work governed by one or more Secondary Licenses, and the\nCovered Software is not Incompatible With Secondary Licenses, this\nLicense permits You to additionally distribute such Covered Software\nunder the terms of such Secondary License(s), so that the recipient of\nthe Larger Work may, at their option, further distribute the Covered\nSoftware under the terms of either this License or such Secondary\nLicense(s).\n\n3.4. Notices\n\nYou may not remove or alter the substance of any license notices\n(including copyright notices, patent notices, disclaimers of warranty,\nor limitations of liability) contained within the Source Code Form of\nthe Covered Software, except that You may alter any license notices to\nthe extent required to remedy known factual inaccuracies.\n\n3.5. Application of Additional Terms\n\nYou may choose to offer, and to charge a fee for, warranty, support,\nindemnity or liability obligations to one or more recipients of Covered\nSoftware. However, You may do so only on Your own behalf, and not on\nbehalf of any Contributor. You must make it absolutely clear that any\nsuch warranty, support, indemnity, or liability obligation is offered by\nYou alone, and You hereby agree to indemnify every Contributor for any\nliability incurred by such Contributor as a result of warranty, support,\nindemnity or liability terms You offer. You may include additional\ndisclaimers of warranty and limitations of liability specific to any\njurisdiction.\n\n4. Inability to Comply Due to Statute or Regulation\n---------------------------------------------------\n\nIf it is impossible for You to comply with any of the terms of this\nLicense with respect to some or all of the Covered Software due to\nstatute, judicial order, or regulation then You must: (a) comply with\nthe terms of this License to the maximum extent possible; and (b)\ndescribe the limitations and the code they affect. Such description must\nbe placed in a text file included with all distributions of the Covered\nSoftware under this License. Except to the extent prohibited by statute\nor regulation, such description must be sufficiently detailed for a\nrecipient of ordinary skill to be able to understand it.\n\n5. Termination\n--------------\n\n5.1. The rights granted under this License will terminate automatically\nif You fail to comply with any of its terms. However, if You become\ncompliant, then the rights granted under this License from a particular\nContributor are reinstated (a) provisionally, unless and until such\nContributor explicitly and finally terminates Your grants, and (b) on an\nongoing basis, if such Contributor fails to notify You of the\nnon-compliance by some reasonable means prior to 60 days after You have\ncome back into compliance. Moreover, Your grants from a particular\nContributor are reinstated on an ongoing basis if such Contributor\nnotifies You of the non-compliance by some reasonable means, this is the\nfirst time You have received notice of non-compliance with this License\nfrom such Contributor, and You become compliant prior to 30 days after\nYour receipt of the notice.\n\n5.2. If You initiate litigation against any entity by asserting a patent\ninfringement claim (excluding declaratory judgment actions,\ncounter-claims, and cross-claims) alleging that a Contributor Version\ndirectly or indirectly infringes any patent, then the rights granted to\nYou by any and all Contributors for the Covered Software under Section\n2.1 of this License shall terminate.\n\n5.3. In the event of termination under Sections 5.1 or 5.2 above, all\nend user license agreements (excluding distributors and resellers) which\nhave been validly granted by You or Your distributors under this License\nprior to termination shall survive termination.\n\n************************************************************************\n* *\n* 6. Disclaimer of Warranty *\n* ------------------------- *\n* *\n* Covered Software is provided under this License on an \"as is\" *\n* basis, without warranty of any kind, either expressed, implied, or *\n* statutory, including, without limitation, warranties that the *\n* Covered Software is free of defects, merchantable, fit for a *\n* particular purpose or non-infringing. The entire risk as to the *\n* quality and performance of the Covered Software is with You. *\n* Should any Covered Software prove defective in any respect, You *\n* (not any Contributor) assume the cost of any necessary servicing, *\n* repair, or correction. This disclaimer of warranty constitutes an *\n* essential part of this License. No use of any Covered Software is *\n* authorized under this License except under this disclaimer. *\n* *\n************************************************************************\n\n************************************************************************\n* *\n* 7. Limitation of Liability *\n* -------------------------- *\n* *\n* Under no circumstances and under no legal theory, whether tort *\n* (including negligence), contract, or otherwise, shall any *\n* Contributor, or anyone who distributes Covered Software as *\n* permitted above, be liable to You for any direct, indirect, *\n* special, incidental, or consequential damages of any character *\n* including, without limitation, damages for lost profits, loss of *\n* goodwill, work stoppage, computer failure or malfunction, or any *\n* and all other commercial damages or losses, even if such party *\n* shall have been informed of the possibility of such damages. This *\n* limitation of liability shall not apply to liability for death or *\n* personal injury resulting from such party's negligence to the *\n* extent applicable law prohibits such limitation. Some *\n* jurisdictions do not allow the exclusion or limitation of *\n* incidental or consequential damages, so this exclusion and *\n* limitation may not apply to You. *\n* *\n************************************************************************\n\n8. Litigation\n-------------\n\nAny litigation relating to this License may be brought only in the\ncourts of a jurisdiction where the defendant maintains its principal\nplace of business and such litigation shall be governed by laws of that\njurisdiction, without reference to its conflict-of-law provisions.\nNothing in this Section shall prevent a party's ability to bring\ncross-claims or counter-claims.\n\n9. Miscellaneous\n----------------\n\nThis License represents the complete agreement concerning the subject\nmatter hereof. If any provision of this License is held to be\nunenforceable, such provision shall be reformed only to the extent\nnecessary to make it enforceable. Any law or regulation which provides\nthat the language of a contract shall be construed against the drafter\nshall not be used to construe this License against a Contributor.\n\n10. Versions of the License\n---------------------------\n\n10.1. New Versions\n\nMozilla Foundation is the license steward. Except as provided in Section\n10.3, no one other than the license steward has the right to modify or\npublish new versions of this License. Each version will be given a\ndistinguishing version number.\n\n10.2. Effect of New Versions\n\nYou may distribute the Covered Software under the terms of the version\nof the License under which You originally received the Covered Software,\nor under the terms of any subsequent version published by the license\nsteward.\n\n10.3. Modified Versions\n\nIf you create software not governed by this License, and you want to\ncreate a new license for such software, you may create and use a\nmodified version of this License if you rename the license and remove\nany references to the name of the license steward (except to note that\nsuch modified license differs from this License).\n\n10.4. Distributing Source Code Form that is Incompatible With Secondary\nLicenses\n\nIf You choose to distribute Source Code Form that is Incompatible With\nSecondary Licenses under the terms of this version of the License, the\nnotice described in Exhibit B of this License must be attached.\n\nExhibit A - Source Code Form License Notice\n-------------------------------------------\n\n This Source Code Form is subject to the terms of the Mozilla Public\n License, v. 2.0. If a copy of the MPL was not distributed with this\n file, You can obtain one at http://mozilla.org/MPL/2.0/.\n\nIf it is not possible or desirable to put the notice in a particular\nfile, then You may include the notice in a location (such as a LICENSE\nfile in a relevant directory) where a recipient would be likely to look\nfor such a notice.\n\nYou may add additional accurate notices of copyright ownership.\n\nExhibit B - \"Incompatible With Secondary Licenses\" Notice\n---------------------------------------------------------\n\n This Source Code Form is \"Incompatible With Secondary Licenses\", as\n defined by the Mozilla Public License, v. 2.0.\n" }, { "path": "arch/LICENSE.Newlib", "content": "The newlib subdirectory is a collection of software from several sources.\n\nEach file may have its own copyright/license that is embedded in the source \nfile. Unless otherwise noted in the body of the source file(s), the following copyright\nnotices will apply to the contents of the newlib subdirectory:\n\n(1) Red Hat Incorporated\n\nCopyright (c) 1994-2009 Red Hat, Inc. All rights reserved.\n\nThis copyrighted material is made available to anyone wishing to use,\nmodify, copy, or redistribute it subject to the terms and conditions\nof the BSD License. This program is distributed in the hope that \nit will be useful, but WITHOUT ANY WARRANTY expressed or implied, \nincluding the implied warranties of MERCHANTABILITY or FITNESS FOR \nA PARTICULAR PURPOSE. A copy of this license is available at \nhttp://www.opensource.org/licenses. Any Red Hat trademarks that are\nincorporated in the source code or documentation are not subject to\nthe BSD License and may only be used or replicated with the express\npermission of Red Hat, Inc.\n\n(2) University of California, Berkeley\n\nCopyright (c) 1981-2000 The Regents of the University of California.\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without modification,\nare permitted provided that the following conditions are met:\n\n * Redistributions of source code must retain the above copyright notice, \n this list of conditions and the following disclaimer.\n * Redistributions in binary form must reproduce the above copyright notice,\n this list of conditions and the following disclaimer in the documentation\n and/or other materials provided with the distribution.\n * Neither the name of the University nor the names of its contributors \n may be used to endorse or promote products derived from this software \n without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" \nAND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED \nWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. \nIN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, \nINDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT \nNOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR \nPROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, \nWHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) \nARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY\nOF SUCH DAMAGE.\n\n(3) David M. Gay (AT&T 1991, Lucent 1998)\n\nThe author of this software is David M. Gay.\n\nCopyright (c) 1991 by AT&T.\n\nPermission to use, copy, modify, and distribute this software for any\npurpose without fee is hereby granted, provided that this entire notice\nis included in all copies of any software which is or includes a copy\nor modification of this software and in all copies of the supporting\ndocumentation for such software.\n\nTHIS SOFTWARE IS BEING PROVIDED \"AS IS\", WITHOUT ANY EXPRESS OR IMPLIED\nWARRANTY. IN PARTICULAR, NEITHER THE AUTHOR NOR AT&T MAKES ANY\nREPRESENTATION OR WARRANTY OF ANY KIND CONCERNING THE MERCHANTABILITY\nOF THIS SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR PURPOSE.\n\n-------------------------------------------------------------------\n\nThe author of this software is David M. Gay.\n\nCopyright (C) 1998-2001 by Lucent Technologies\nAll Rights Reserved\n\nPermission to use, copy, modify, and distribute this software and\nits documentation for any purpose and without fee is hereby\ngranted, provided that the above copyright notice appear in all\ncopies and that both that the copyright notice and this\npermission notice and warranty disclaimer appear in supporting\ndocumentation, and that the name of Lucent or any of its entities\nnot be used in advertising or publicity pertaining to\ndistribution of the software without specific, written prior\npermission.\n\nLUCENT DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,\nINCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS.\nIN NO EVENT SHALL LUCENT OR ANY OF ITS ENTITIES BE LIABLE FOR ANY\nSPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES\nWHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER\nIN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,\nARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF\nTHIS SOFTWARE.\n\n\n(4) Advanced Micro Devices\n\nCopyright 1989, 1990 Advanced Micro Devices, Inc.\n\nThis software is the property of Advanced Micro Devices, Inc (AMD) which\nspecifically grants the user the right to modify, use and distribute this\nsoftware provided this notice is not removed or altered. All other rights\nare reserved by AMD.\n\nAMD MAKES NO WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, WITH REGARD TO THIS\nSOFTWARE. IN NO EVENT SHALL AMD BE LIABLE FOR INCIDENTAL OR CONSEQUENTIAL\nDAMAGES IN CONNECTION WITH OR ARISING FROM THE FURNISHING, PERFORMANCE, OR\nUSE OF THIS SOFTWARE.\n\nSo that all may benefit from your experience, please report any problems\nor suggestions about this software to the 29K Technical Support Center at\n800-29-29-AMD (800-292-9263) in the USA, or 0800-89-1131 in the UK, or\n0031-11-1129 in Japan, toll free. The direct dial number is 512-462-4118.\n\nAdvanced Micro Devices, Inc.\n29K Support Products\nMail Stop 573\n5900 E. Ben White Blvd.\nAustin, TX 78741\n800-292-9263\n\n(5) \n\n(6)\n\n(7) Sun Microsystems\n\nCopyright (C) 1993 by Sun Microsystems, Inc. All rights reserved.\n\nDeveloped at SunPro, a Sun Microsystems, Inc. business.\nPermission to use, copy, modify, and distribute this\nsoftware is freely granted, provided that this notice is preserved.\n\n(8) Hewlett Packard\n\n(c) Copyright 1986 HEWLETT-PACKARD COMPANY\n\nTo anyone who acknowledges that this file is provided \"AS IS\"\nwithout any express or implied warranty:\n permission to use, copy, modify, and distribute this file\nfor any purpose is hereby granted without fee, provided that\nthe above copyright notice and this notice appears in all\ncopies, and that the name of Hewlett-Packard Company not be\nused in advertising or publicity pertaining to distribution\nof the software without specific, written prior permission.\nHewlett-Packard Company makes no representations about the\nsuitability of this software for any purpose.\n\n(9) Hans-Peter Nilsson\n\nCopyright (C) 2001 Hans-Peter Nilsson\n\nPermission to use, copy, modify, and distribute this software is\nfreely granted, provided that the above copyright notice, this notice\nand the following disclaimer are preserved with no changes.\n\nTHIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR\nIMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED\nWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR\nPURPOSE.\n\n(10) Stephane Carrez (m68hc11-elf/m68hc12-elf targets only)\n\nCopyright (C) 1999, 2000, 2001, 2002 Stephane Carrez (stcarrez@nerim.fr)\n\nThe authors hereby grant permission to use, copy, modify, distribute,\nand license this software and its documentation for any purpose, provided\nthat existing copyright notices are retained in all copies and that this\nnotice is included verbatim in any distributions. No written agreement,\nlicense, or royalty fee is required for any of the authorized uses.\nModifications to this software may be copyrighted by their authors\nand need not follow the licensing terms described here, provided that\nthe new terms are clearly indicated on the first page of each file where\nthey apply.\n\n(11) Christopher G. Demetriou\n\nCopyright (c) 2001 Christopher G. Demetriou\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions\nare met:\n1. Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n2. Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n3. The name of the author may not be used to endorse or promote products\n derived from this software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR\nIMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES\nOF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.\nIN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,\nINCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT\nNOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\nDATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\nTHEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF\nTHIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n(12) SuperH, Inc.\n\nCopyright 2002 SuperH, Inc. All rights reserved\n\nThis software is the property of SuperH, Inc (SuperH) which specifically\ngrants the user the right to modify, use and distribute this software\nprovided this notice is not removed or altered. All other rights are\nreserved by SuperH.\n\nSUPERH MAKES NO WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, WITH REGARD TO\nTHIS SOFTWARE. IN NO EVENT SHALL SUPERH BE LIABLE FOR INDIRECT, SPECIAL,\nINCIDENTAL OR CONSEQUENTIAL DAMAGES IN CONNECTION WITH OR ARISING FROM\nTHE FURNISHING, PERFORMANCE, OR USE OF THIS SOFTWARE.\n\nSo that all may benefit from your experience, please report any problems\nor suggestions about this software to the SuperH Support Center via\ne-mail at softwaresupport@superh.com .\n\nSuperH, Inc.\n405 River Oaks Parkway\nSan Jose\nCA 95134\nUSA\n\n(13) Royal Institute of Technology\n\nCopyright (c) 1999 Kungliga Tekniska Högskolan\n(Royal Institute of Technology, Stockholm, Sweden).\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions\nare met:\n\n1. Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n\n2. Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n\n3. Neither the name of KTH nor the names of its contributors may be\n used to endorse or promote products derived from this software without\n specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY KTH AND ITS CONTRIBUTORS ``AS IS'' AND ANY\nEXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\nIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR\nPURPOSE ARE DISCLAIMED. IN NO EVENT SHALL KTH OR ITS CONTRIBUTORS BE\nLIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR\nCONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF\nSUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR\nBUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,\nWHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR\nOTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF\nADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n(14) Alexey Zelkin\n\nCopyright (c) 2000, 2001 Alexey Zelkin \nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions\nare met:\n1. Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n2. Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n\nTHIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\nIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE\nARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE\nFOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS\nOR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)\nHOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT\nLIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY\nOUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF\nSUCH DAMAGE.\n\n(15) Andrey A. Chernov\n\nCopyright (C) 1997 by Andrey A. Chernov, Moscow, Russia.\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions\nare met:\n1. Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n2. Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n\nTHIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\nIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE\nARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE\nFOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS\nOR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)\nHOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT\nLIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY\nOUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF\nSUCH DAMAGE.\n\n(16) FreeBSD\n\nCopyright (c) 1997-2002 FreeBSD Project.\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions\nare met:\n1. Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n2. Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n\nTHIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\nIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE\nARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE\nFOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS\nOR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)\nHOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT\nLIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY\nOUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF\nSUCH DAMAGE.\n\n(17) S. L. Moshier\n\nAuthor: S. L. Moshier.\n\nCopyright (c) 1984,2000 S.L. Moshier\n\nPermission to use, copy, modify, and distribute this software for any\npurpose without fee is hereby granted, provided that this entire notice\nis included in all copies of any software which is or includes a copy\nor modification of this software and in all copies of the supporting\ndocumentation for such software.\n\nTHIS SOFTWARE IS BEING PROVIDED \"AS IS\", WITHOUT ANY EXPRESS OR IMPLIED\nWARRANTY. IN PARTICULAR, THE AUTHOR MAKES NO REPRESENTATION\nOR WARRANTY OF ANY KIND CONCERNING THE MERCHANTABILITY OF THIS\nSOFTWARE OR ITS FITNESS FOR ANY PARTICULAR PURPOSE.\n\n(18) Citrus Project\n\nCopyright (c)1999 Citrus Project,\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions\nare met:\n1. Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n2. Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n\nTHIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\nIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE\nARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE\nFOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS\nOR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)\nHOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT\nLIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY\nOUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF\nSUCH DAMAGE.\n\n(19) Todd C. Miller\n\nCopyright (c) 1998 Todd C. Miller \nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions\nare met:\n1. Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n2. Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n3. The name of the author may not be used to endorse or promote products\n derived from this software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,\nINCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY\nAND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL\nTHE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,\nEXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,\nPROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;\nOR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,\nWHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR\nOTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF\nADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n(20) DJ Delorie (i386)\nCopyright (C) 1991 DJ Delorie\nAll rights reserved.\n\nRedistribution, modification, and use in source and binary forms is permitted\nprovided that the above copyright notice and following paragraph are\nduplicated in all such forms.\n\nThis file is distributed WITHOUT ANY WARRANTY; without even the implied\nwarranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.\n\n(21) Free Software Foundation LGPL License (*-linux* targets only)\n\n Copyright (C) 1990-1999, 2000, 2001 Free Software Foundation, Inc.\n This file is part of the GNU C Library.\n Contributed by Mark Kettenis , 1997.\n\n The GNU C Library is free software; you can redistribute it and/or\n modify it under the terms of the GNU Lesser General Public\n License as published by the Free Software Foundation; either\n version 2.1 of the License, or (at your option) any later version.\n\n The GNU C Library is distributed in the hope that it will be useful,\n but WITHOUT ANY WARRANTY; without even the implied warranty of\n MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n Lesser General Public License for more details.\n\n You should have received a copy of the GNU Lesser General Public\n License along with the GNU C Library; if not, write to the Free\n Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA\n 02110-1301 USA.\n\n(22) Xavier Leroy LGPL License (i[3456]86-*-linux* targets only)\n\nCopyright (C) 1996 Xavier Leroy (Xavier.Leroy@inria.fr)\n\nThis program is free software; you can redistribute it and/or\nmodify it under the terms of the GNU Library General Public License\nas published by the Free Software Foundation; either version 2\nof the License, or (at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\nGNU Library General Public License for more details.\n\n(23) Intel (i960)\n\nCopyright (c) 1993 Intel Corporation\n\nIntel hereby grants you permission to copy, modify, and distribute this\nsoftware and its documentation. Intel grants this permission provided\nthat the above copyright notice appears in all copies and that both the\ncopyright notice and this permission notice appear in supporting\ndocumentation. In addition, Intel grants this permission provided that\nyou prominently mark as \"not part of the original\" any modifications\nmade to this software or documentation, and that the name of Intel\nCorporation not be used in advertising or publicity pertaining to\ndistribution of the software or the documentation without specific,\nwritten prior permission.\n\nIntel Corporation provides this AS IS, WITHOUT ANY WARRANTY, EXPRESS OR\nIMPLIED, INCLUDING, WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY\nOR FITNESS FOR A PARTICULAR PURPOSE. Intel makes no guarantee or\nrepresentations regarding the use of, or the results of the use of,\nthe software and documentation in terms of correctness, accuracy,\nreliability, currentness, or otherwise; and you rely on the software,\ndocumentation and results solely at your own risk.\n\nIN NO EVENT SHALL INTEL BE LIABLE FOR ANY LOSS OF USE, LOSS OF BUSINESS,\nLOSS OF PROFITS, INDIRECT, INCIDENTAL, SPECIAL OR CONSEQUENTIAL DAMAGES\nOF ANY KIND. IN NO EVENT SHALL INTEL'S TOTAL LIABILITY EXCEED THE SUM\nPAID TO INTEL FOR THE PRODUCT LICENSED HEREUNDER.\n\n(24) Hewlett-Packard (hppa targets only)\n\n(c) Copyright 1986 HEWLETT-PACKARD COMPANY\n\nTo anyone who acknowledges that this file is provided \"AS IS\"\nwithout any express or implied warranty:\n permission to use, copy, modify, and distribute this file\nfor any purpose is hereby granted without fee, provided that\nthe above copyright notice and this notice appears in all\ncopies, and that the name of Hewlett-Packard Company not be\nused in advertising or publicity pertaining to distribution\nof the software without specific, written prior permission.\nHewlett-Packard Company makes no representations about the\nsuitability of this software for any purpose.\n\n(25) Henry Spencer (only *-linux targets)\n\nCopyright 1992, 1993, 1994 Henry Spencer. All rights reserved.\nThis software is not subject to any license of the American Telephone\nand Telegraph Company or of the Regents of the University of California.\n\nPermission is granted to anyone to use this software for any purpose on\nany computer system, and to alter it and redistribute it, subject\nto the following restrictions:\n\n1. The author is not responsible for the consequences of use of this\n software, no matter how awful, even if they arise from flaws in it.\n\n2. The origin of this software must not be misrepresented, either by\n explicit claim or by omission. Since few users ever read sources,\n credits must appear in the documentation.\n\n3. Altered versions must be plainly marked as such, and must not be\n misrepresented as being the original software. Since few users\n ever read sources, credits must appear in the documentation.\n\n4. This notice may not be removed or altered.\n\n(26) Mike Barcroft\n\nCopyright (c) 2001 Mike Barcroft \nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions\nare met:\n1. Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n2. Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n\nTHIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\nIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE\nARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE\nFOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS\nOR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)\nHOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT\nLIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY\nOUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF\nSUCH DAMAGE.\n\n(27) Konstantin Chuguev (--enable-newlib-iconv)\n\nCopyright (c) 1999, 2000\n Konstantin Chuguev. All rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions\nare met:\n1. Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n2. Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n\nTHIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\nIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE\nARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE\nFOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS\nOR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)\nHOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT\nLIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY\nOUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF\nSUCH DAMAGE.\n\n iconv (Charset Conversion Library) v2.0\n\n(28) Artem Bityuckiy (--enable-newlib-iconv)\n\nCopyright (c) 2003, Artem B. Bityuckiy, SoftMine Corporation.\nRights transferred to Franklin Electronic Publishers.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions\nare met:\n1. Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n2. Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n\nTHIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\nIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE\nARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE\nFOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS\nOR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)\nHOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT\nLIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY\nOUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF\nSUCH DAMAGE.\n\n(29) IBM, Sony, Toshiba (only spu-* targets)\n\n (C) Copyright 2001,2006,\n International Business Machines Corporation,\n Sony Computer Entertainment, Incorporated,\n Toshiba Corporation,\n\n All rights reserved.\n\n Redistribution and use in source and binary forms, with or without\n modification, are permitted provided that the following conditions are met:\n\n * Redistributions of source code must retain the above copyright notice,\n this list of conditions and the following disclaimer.\n * Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n * Neither the names of the copyright holders nor the names of their\n contributors may be used to endorse or promote products derived from this\n software without specific prior written permission.\n\n THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\"\n AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\n IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE\n ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE\n LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR\n CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF\n SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS\n INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN\n CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)\n ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE\n POSSIBILITY OF SUCH DAMAGE.\n\n(30) - Alex Tatmanjants (targets using libc/posix)\n\n Copyright (c) 1995 Alex Tatmanjants \n \t\tat Electronni Visti IA, Kiev, Ukraine.\n \t\t\tAll rights reserved.\n \n Redistribution and use in source and binary forms, with or without\n modification, are permitted provided that the following conditions\n are met:\n 1. Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n 2. Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n \n THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND\n ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\n IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE\n ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE\n FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\n DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS\n OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)\n HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT\n LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY\n OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF\n SUCH DAMAGE.\n\n(31) - M. Warner Losh (targets using libc/posix)\n\n Copyright (c) 1998, M. Warner Losh \n All rights reserved.\n \n Redistribution and use in source and binary forms, with or without\n modification, are permitted provided that the following conditions\n are met:\n 1. Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n 2. Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n \n THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND\n ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\n IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE\n ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE\n FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\n DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS\n OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)\n HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT\n LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY\n OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF\n SUCH DAMAGE.\n\n(32) - Andrey A. Chernov (targets using libc/posix)\n\n Copyright (C) 1996 by Andrey A. Chernov, Moscow, Russia.\n All rights reserved.\n \n Redistribution and use in source and binary forms, with or without\n modification, are permitted provided that the following conditions\n are met:\n 1. Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n 2. Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n \n THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND\n ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\n IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE\n ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE\n FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\n DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS\n OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)\n HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT\n LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY\n OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF\n SUCH DAMAGE.\n\n(33) - Daniel Eischen (targets using libc/posix)\n\n Copyright (c) 2001 Daniel Eischen .\n All rights reserved.\n \n Redistribution and use in source and binary forms, with or without\n modification, are permitted provided that the following conditions\n are met:\n 1. Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n 2. Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n \n THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND\n ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\n IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE\n ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE\n FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\n DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS\n OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)\n HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT\n LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY\n OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF\n SUCH DAMAGE.\n\n\n(34) - Jon Beniston (only lm32-* targets)\n\n Contributed by Jon Beniston \n\n Redistribution and use in source and binary forms, with or without\n modification, are permitted provided that the following conditions\n are met:\n 1. Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n 2. Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n\n THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND\n ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\n IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE\n ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE\n FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\n DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS\n OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)\n HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT\n LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY\n OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF\n SUCH DAMAGE.\n\n\n(35) - ARM Ltd (arm and thumb variant targets only)\n\n Copyright (c) 2009 ARM Ltd\n All rights reserved.\n \n Redistribution and use in source and binary forms, with or without\n modification, are permitted provided that the following conditions\n are met:\n 1. Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n 2. Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n 3. The name of the company may not be used to endorse or promote\n products derived from this software without specific prior written\n permission.\n\n THIS SOFTWARE IS PROVIDED BY ARM LTD ``AS IS'' AND ANY EXPRESS OR IMPLIED\n WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF\n MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.\n IN NO EVENT SHALL ARM LTD BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\n SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED\n TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR\n PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF\n LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING\n NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS\n SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n(36) - Xilinx, Inc. (microblaze-* and powerpc-* targets)\n\nCopyright (c) 2004, 2009 Xilinx, Inc. All rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\n1. Redistributions source code must retain the above copyright notice,\nthis list of conditions and the following disclaimer.\n\n2. Redistributions in binary form must reproduce the above copyright\nnotice, this list of conditions and the following disclaimer in the\ndocumentation and/or other materials provided with the distribution.\n\n3. Neither the name of Xilinx nor the names of its contributors may be\nused to endorse or promote products derived from this software without\nspecific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS \"AS\nIS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED\nTO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A\nPARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT\nHOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\nSPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED\nTO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR\nPROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF\nLIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING\nNEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS\nSOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n\n(37) Texas Instruments Incorporated (tic6x-*, *-tirtos targets)\n\nCopyright (c) 1996-2010,2014 Texas Instruments Incorporated\nhttp://www.ti.com/\n\n Redistribution and use in source and binary forms, with or without\n modification, are permitted provided that the following conditions\n are met:\n\n Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n\n Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in\n the documentation and/or other materials provided with the\n distribution.\n\n Neither the name of Texas Instruments Incorporated nor the names\n of its contributors may be used to endorse or promote products\n derived from this software without specific prior written\n permission.\n\n THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\n LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\n A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT\n OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\n SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\n LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\n DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\n THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\n OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n(38) National Semiconductor (cr16-* and crx-* targets)\n\nCopyright (c) 2004 National Semiconductor Corporation\n\nThe authors hereby grant permission to use, copy, modify, distribute,\nand license this software and its documentation for any purpose, provided\nthat existing copyright notices are retained in all copies and that this\nnotice is included verbatim in any distributions. No written agreement,\nlicense, or royalty fee is required for any of the authorized uses.\nModifications to this software may be copyrighted by their authors\nand need not follow the licensing terms described here, provided that\nthe new terms are clearly indicated on the first page of each file where\nthey apply. \n\n(39) - Adapteva, Inc. (epiphany-* targets)\n\nCopyright (c) 2011, Adapteva, Inc.\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are met:\n * Redistributions of source code must retain the above copyright notice, this\n list of conditions and the following disclaimer.\n * Redistributions in binary form must reproduce the above copyright notice,\n this list of conditions and the following disclaimer in the documentation\n and/or other materials provided with the distribution.\n * Neither the name of Adapteva nor the names of its contributors may be used\n to endorse or promote products derived from this software without specific\n prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED\nWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\nDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE\nFOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR\nSERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER\nCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,\nOR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\n(40) - Altera Corportion (nios2-* targets)\n\nCopyright (c) 2003 Altera Corporation\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions\nare met:\n\n o Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer. \n o Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the \n documentation and/or other materials provided with the distribution. \n o Neither the name of Altera Corporation nor the names of its \n contributors may be used to endorse or promote products derived from\n this software without specific prior written permission. \n \nTHIS SOFTWARE IS PROVIDED BY ALTERA CORPORATION, THE COPYRIGHT HOLDER,\nAND ITS CONTRIBUTORS \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES,\nINCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY\nAND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL\nTHE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,\nINCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,\nBUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS\nOF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND\nON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR\nTORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE\nUSE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. \n\n(41) Ed Schouten - Free BSD\n\nCopyright (c) 2008 Ed Schouten \nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions\nare met:\n1. Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n2. Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n\nTHIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\nIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE\nARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE\nFOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS\nOR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)\nHOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT\nLIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY\nOUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF\nSUCH DAMAGE.\n" }, { "path": "arch/README", "content": "MULTI-PLATFORM SUPPORT FOR MEGAZEUX\n\nThe arch/ directory structure contains any code/machinery which is platform\nspecific. Though is it dubiously named \"arch\" this refers to the platform\n\"architecture\" rather than the CPU architecture. For example, although GP2X\nand NDS both use ARM CPUs, they require different library and build system\nmachinery to work correctly.\n\nDIRECTORY LAYOUT\n\nMost directories here contain at least a README file describing what toolchain\nand dependencies they require to work correctly. Some might also define\nadditional targets, for post-processing binaries or installing them on the\nsystem.\n\nAdditionally, all of these directories must have a Makefile.in which the build\nsystem will automatically include. This file should initialize any variables\nthat can be tweaked, for example the location of libraries or compiler flags.\nThe existing Makefile.in files should be a reasonable guide to this\nfunctionality.\n\nADDING A PLATFORM TO MEGAZEUX\n\nAdding support for a new platform is trivial. Think of a short name for the\nplatform (for example, Nintendo Dual-Screen is \"nds\") then create a directory\nin arch/ with that name. Create a Makefile.in for your platform. Initially,\nyou may find configuring for \"unix\" and then manually altering the\n\"platform.inc\" in the top level is enough to get your build to succeed.\n\nThen, some changes must be made to config.sh to automatically generate both\nthe src/config.h header (which is fully generic) and the platform.inc. This\nscript is what users of your port will invoke to build the package.\n\nYou may also want to make sure the \"build\" and \"archive\" targets do something\nfor your platform. These targets make auto-builds and shipping binary\npackages much easier.\n\nLICENSES\n\nIf your port requires reporting extra software licenses, you should put a\nnotification in LICENSE.3rd. If the boilerplate isn't reasonably small, it\nshould go in this folder named in the format \"LICENSE.[license here]\". In this\nsituation, add the license filename to EXTRA_LICENSES so it will be shipped\nwith relevant builds.\n" }, { "path": "arch/amiga/CONFIG.AMIGA", "content": "#!/bin/sh\n\n./config.sh --platform amiga --prefix /usr/local/amiga \\\n --disable-libpng --disable-utils --enable-release \"$@\"\n" }, { "path": "arch/amiga/MZXRun", "content": "STACK 1000000\n\nAssign >NIL: \"USR:\" EXISTS\nIF NOT WARN\nELSE\nAssign USR: RAM:\nENDIF\n\nAssign >NIL: \"ETC:\" EXISTS\nIF NOT WARN\nELSE\nAssign ETC: RAM:\nENDIF\n\nrun >NIL: mzxrun.exe;\n" }, { "path": "arch/amiga/Makefile.in", "content": "#\n# amiga makefile generics\n#\n\nCC = ppc-amigaos-gcc -mcrt=clib2 -I${PREFIX}/clib2/include\nCXX = ppc-amigaos-g++ -mcrt=clib2 -I${PREFIX}/clib2/include\nSTRIP = ppc-amigaos-strip\nOBJCOPY = true\nCHMOD = true\n\nBINEXT = .exe\n\nDSOLDFLAGS = -shared\nDSOPRE = lib\nDSOPOST = .so\nDSORPATH = -Wl,-rpath,${LIBDIR}\nDSOSONAME = -Wl,-soname,\n\n# Block --host, which will break things.\nCROSS_COMPILE =\n\nifeq (${BUILD_MODULAR},1)\nARCH_CFLAGS += -fPIC\nARCH_CXXFLAGS += -fPIC\nARCH_LDFLAGS += -use-dynld -lunix\nendif\n\n# MZX breaks this optimisation on Amiga\nARCH_CFLAGS += -fno-strict-aliasing\nARCH_CXXFLAGS += -fno-strict-aliasing\n\n# Amiga needs PNG to be statically linked (inc. zlib)\nLIBPNG_LDFLAGS = $(shell libpng12-config --static --ldflags)\n\n#\n# Need to nest Amiga binaries in a subdir\n#\nbuild := ${build_root}/MegaZeux\nbuild: ${build}\n\t${CP} arch/amiga/MegaZeux.info ${build}\n\t${CP} arch/amiga/MegaZeux.info ${build}/MZXRun.info\n\t${CP} arch/amiga/MegaZeux.info ${build_root}\n\t${CP} arch/amiga/MegaZeux arch/amiga/MZXRun ${build}\n\t${RM} ${build}/*.debug\n\ninclude arch/lha.inc\n" }, { "path": "arch/amiga/MegaZeux", "content": "STACK 1000000\n\nAssign >NIL: \"USR:\" EXISTS\nIF NOT WARN\nELSE\nAssign USR: RAM:\nENDIF\n\nAssign >NIL: \"ETC:\" EXISTS\nIF NOT WARN\nELSE\nAssign ETC: RAM:\nENDIF\n\nrun >NIL: megazeux.exe;\n" }, { "path": "arch/amiga/README", "content": "MEGAZEUX ON AMIGA OS 4\n\nSince 2.82b, MegaZeux supports cross compilation to Amiga OS 4. You will\nrequire a valid copy of the operating system software in order to run the\nfinal result; this is not a bare-metal Amiga binary.\n\nThe only supported toolchain is for OS 4 and PPC Amigas.\nm68k Amigas are not supported.\n\nPREPARATION\n\nThe port requires that the Amiga OS 4 SDK and toolchain is installed. There\nare several pre-built toolchains available from:\n\n\thttp://cross.zerohero.se/os4.html\n\nThere is an excellent guide for linking your toolchain and the platform SDK\ntogether here:\n\n\thttp://utilitybase.com/article/show/2007/06/23/231/Installing+an+AmigaOS+4+cross+compiler\n\nThe SDL library for AmigaOS 4 (clib2) must be installed. I got my copy from:\n\n\thttp://www.rcdrummond.net/sdl/index.html\n\nBUILDING MEGAZEUX\n\nFirst, configure MZX. A suitable config.sh command line is provided in\nCONFIG.AMIGA present in this subdirectory. Please note that --prefix MUST\ncorrectly point to the AmigaOS 4 SDK (otherwise it tries to use /usr's\nstub headers and fails).\n\nThen start the build with \"make\".\n\nINSTALLING MEGAZEUX\n\nThe usual \"make archive\" works to generate an LHA compilation of MegaZeux\nbinaries and Amiga specific scripts. Icons are provided where appropriate.\n\n--ajs\n" }, { "path": "arch/android/CONFIG.ANDROID", "content": "#!/bin/sh\n\n# TODO: GL fixed renderers don't work. Probably not worth fixing.\n\n[ -z \"$NDK_PATH\" ] && { echo \"Must define NDK_PATH!\"; exit 1; }\n\n./config.sh --platform android --enable-release --enable-lto \\\n --disable-utils --disable-libpng --disable-gl-fixed \"$@\"\n" }, { "path": "arch/android/Makefile.deps", "content": "#\n# Makefile fragment for building, installing, or uninstalling Android dependencies.\n# Dependencies are installed into the project JNI libs dir and arch/android/includes.\n#\n# This should not be used directly, but should be used from Makefile.in.\n# This file relies on several variables defined by Makefile.in.\n#\n\n.PHONY: deps-build deps-install deps-uninstall\n\nifeq (${NDK_PATH},)\n$(error \"Must define $$NDK_PATH!\")\nendif\n\n#\n# NOTE: when updating the SDL_VERSION field here, the SDL android project code\n# in arch/android/project/app/src/main/org/libsdl/app/ needs to be updated with\n# the android project from the new SDL release (SDL/android-project/app/src/...).\n#\n\nSDL_VERSION ?= 2.30.9\nLIBOGG_VERSION ?= 1.3.5\nLIBVORBIS_VERSION ?= 1.3.7\nWGET ?= wget\nTAR ?= tar\nPATCH ?= patch\n\nDEPS := arch/android/deps\nDEPS_BUILD := arch/android/deps/.build\nNDK_BUILD := ${NDK_PATH}/ndk-build\n\nifeq (${HOST},${HOST_WIN32})\nNDK_BUILD := ${NDK_PATH}/ndk-build.cmd\nendif\nifeq (${HOST},${HOST_WIN64})\nNDK_BUILD := ${NDK_PATH}/ndk-build.cmd\nendif\n\nifneq (${V},1)\nWGET := @${WGET}\nTAR := @${TAR}\nNDK_BUILD := @${NDK_BUILD}\nendif\n\n${DEPS} ${JNI_INCLUDES}:\n\t$(if @{V},,@echo \" MKDIR \" $@)\n\t${MKDIR} -p $@\n\nifeq (${ANDROID_TARGET},)\n\n${DEPS}/SDL2-${SDL_VERSION}: | ${DEPS}\n\t$(if ${V},,@echo \" WGET \" $@)\n\t${RM} -f $@.tar.gz\n\t${WGET} https://www.libsdl.org/release/SDL2-${SDL_VERSION}.tar.gz -O$@.tar.gz\n\t${TAR} -xzf $@.tar.gz -C ${DEPS}/\n\t${PATCH} -i ../../SDL2-page-sizes.patch -p1 -d ${DEPS}/SDL2-${SDL_VERSION}\n\n${DEPS}/libogg-${LIBOGG_VERSION}: | ${DEPS}\n\t$(if ${V},,@echo \" WGET \" $@)\n\t${RM} -f $@.tar.gz\n\t${WGET} http://downloads.xiph.org/releases/ogg/libogg-${LIBOGG_VERSION}.tar.gz -O$@.tar.gz\n\t${TAR} -xzf $@.tar.gz -C ${DEPS}/\n\n${DEPS}/libvorbis-${LIBVORBIS_VERSION}: | ${DEPS}\n\t$(if ${V},,@echo \" WGET \" $@)\n\t${RM} -f $@.tar.gz\n\t${WGET} http://downloads.xiph.org/releases/vorbis/libvorbis-${LIBVORBIS_VERSION}.tar.gz -O$@.tar.gz\n\t${TAR} -xzf $@.tar.gz -C ${DEPS}/\n\n${DEPS_BUILD}:\n\t$(if ${V},,@echo \" MKDIR \" $@)\n\t${MKDIR} -p ${DEPS_BUILD}\n\n${DEPS_BUILD}/libogg: ${DEPS}/libogg-${LIBOGG_VERSION} | ${DEPS_BUILD}\n\t${RM} -rf $@\n\t${CP} -r $< $@\n\t${CP} arch/android/libogg-Android.mk \"$@/Android.mk\"\n\t${CP} arch/android/config_types.h \"$@/include/ogg/\"\n\n${DEPS_BUILD}/libvorbis: ${DEPS}/libvorbis-${LIBVORBIS_VERSION} | ${DEPS_BUILD}\n\t${RM} -rf $@\n\t${CP} -r $< $@\n\t${CP} arch/android/libvorbis-Android.mk \"$@/Android.mk\"\n\n${DEPS_BUILD}/SDL2: ${DEPS}/SDL2-${SDL_VERSION} | ${DEPS_BUILD}\n\t${RM} -rf $@\n\t${CP} -r $< $@\n\n${DEPS_BUILD}/out: ${DEPS_BUILD}/libogg ${DEPS_BUILD}/libvorbis ${DEPS_BUILD}/SDL2\n\t${CP} ${JNI_DIR}/Android.mk ${DEPS_BUILD}\n\t$(if ${V},,@echo \" NDKBUILD\")\n\t${NDK_BUILD} \\\n\t NDK_PROJECT_PATH=\"${DEPS_BUILD}\" \\\n\t NDK_LIBS_OUT=\"${DEPS_BUILD}/out\" \\\n\t APP_BUILD_SCRIPT=\"${DEPS_BUILD}/Android.mk\" \\\n\t APP_ABI=\"armeabi-v7a arm64-v8a x86 x86_64\" \\\n\t APP_PLATFORM=\"android-16\"\n\ndeps-build: ${DEPS_BUILD}/out\n\nelse\n\ndep_targets := \\\n ${JNI_INCLUDES}/SDL2 \\\n ${JNI_INCLUDES}/ogg \\\n ${JNI_INCLUDES}/vorbis \\\n ${JNI_LIBS}/libSDL2.so \\\n ${JNI_LIBS}/libogg.so \\\n ${JNI_LIBS}/libvorbis.so \\\n ${JNI_LIBS}/libvorbisfile.so\n\n${DEPS_BUILD}/out/${ABI}/%.so:\n\t@test -f $@ || { echo \"Missing $@! Aborting...\"; exit 1; }\n\n${JNI_LIBS}/%.so: ${DEPS_BUILD}/out/${ABI}/%.so | ${JNI_LIBS}\n\t$(if ${V},,@echo \" CP \" $< \" \" $@)\n\t${CP} $< $@\n\n${JNI_INCLUDES}/SDL2: ${DEPS_BUILD}/SDL2 | ${JNI_INCLUDES}\n\t$(if ${V},,@echo \" CP \" \"$\n\ntypedef int16_t ogg_int16_t;\ntypedef uint16_t ogg_uint16_t;\ntypedef int32_t ogg_int32_t;\ntypedef uint32_t ogg_uint32_t;\ntypedef int64_t ogg_int64_t;\ntypedef uint64_t ogg_uint64_t;\n\n#endif\n" }, { "path": "arch/android/libogg-Android.mk", "content": "LOCAL_PATH := $(call my-dir)\n\ninclude $(CLEAR_VARS)\n\nLOCAL_MODULE := libogg\nLOCAL_C_INCLUDES := $(LOCAL_PATH)/include\nLOCAL_EXPORT_C_INCLUDES := $(LOCAL_C_INCLUDES)\n\n# https://developer.android.com/guide/practices/page-sizes\nLOCAL_LDFLAGS += \"-Wl,-z,max-page-size=16384\"\n\nLOCAL_SRC_FILES := src/bitwise.c src/framing.c\n\ninclude $(BUILD_SHARED_LIBRARY)\n" }, { "path": "arch/android/libvorbis-Android.mk", "content": "LOCAL_PATH := $(call my-dir)\n\ninclude $(CLEAR_VARS)\n\nLOCAL_MODULE := libvorbis\nLOCAL_C_INCLUDES := $(LOCAL_PATH)/include $(LOCAL_PATH)/lib\nLOCAL_EXPORT_C_INCLUDES := $(LOCAL_PATH)/include\nLOCAL_SHARED_LIBRARIES := libogg\n\n# https://developer.android.com/guide/practices/page-sizes\nLOCAL_LDFLAGS += \"-Wl,-z,max-page-size=16384\"\n\nLOCAL_SRC_FILES := lib/mdct.c lib/smallft.c lib/block.c lib/envelope.c lib/window.c lib/lsp.c \\\n\t\t\tlib/lpc.c lib/analysis.c lib/synthesis.c lib/psy.c lib/info.c \\\n\t\t\tlib/floor1.c lib/floor0.c \\\n\t\t\tlib/res0.c lib/mapping0.c lib/registry.c lib/codebook.c lib/sharedbook.c \\\n\t\t\tlib/lookup.c lib/bitrate.c\n\ninclude $(BUILD_SHARED_LIBRARY)\ninclude $(CLEAR_VARS)\n\nLOCAL_MODULE := libvorbisfile\nLOCAL_C_INCLUDES := $(LOCAL_PATH)/include $(LOCAL_PATH)/lib\nLOCAL_EXPORT_C_INCLUDES := $(LOCAL_PATH)/include\nLOCAL_SHARED_LIBRARIES := libogg libvorbis\n\n# https://developer.android.com/guide/practices/page-sizes\nLOCAL_LDFLAGS += \"-Wl,-z,max-page-size=16384\"\n\nLOCAL_SRC_FILES := lib/vorbisfile.c\n\ninclude $(BUILD_SHARED_LIBRARY)\n" }, { "path": "arch/android/project/app/build.gradle", "content": "def buildAsLibrary = project.hasProperty('BUILD_AS_LIBRARY');\ndef buildAsApplication = !buildAsLibrary\nif (buildAsApplication) {\n apply plugin: 'com.android.application'\n} else {\n apply plugin: 'com.android.library'\n}\n\n// Create a variable called keystorePropertiesFile, and initialize it to your\n// keystore.properties file, in the rootProject folder.\ndef keystorePropertiesFile = rootProject.file(\"keystore.properties\")\n\n// Initialize a new Properties() object called keystoreProperties.\ndef keystoreProperties = new Properties()\n\n// Load your keystore.properties file into the keystoreProperties object.\nkeystoreProperties.load(new FileInputStream(keystorePropertiesFile))\n\nandroid {\n signingConfigs {\n release {\n storeFile file(keystoreProperties['storeFile'])\n storePassword keystoreProperties['storePassword']\n keyAlias keystoreProperties['keyAlias']\n keyPassword keystoreProperties['keyPassword']\n }\n }\n namespace \"net.digitalmzx.megazeux\"\n ndkVersion \"23.2.8568313\"\n compileSdkVersion 34\n buildToolsVersion \"34.0.0\"\n defaultConfig {\n if (buildAsApplication) {\n applicationId \"net.digitalmzx.megazeux\"\n }\n minSdkVersion 16\n targetSdkVersion 34\n versionCode 1\n versionName \"1.0\"\n externalNativeBuild {\n ndkBuild {\n arguments \"APP_PLATFORM=android-16\"\n abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'\n }\n }\n testInstrumentationRunner \"android.support.test.runner.AndroidJUnitRunner\"\n }\n buildTypes {\n release {\n minifyEnabled false\n proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'\n signingConfig signingConfigs.release\n }\n }\n if (!project.hasProperty('EXCLUDE_NATIVE_LIBS')) {\n sourceSets.main {\n jniLibs.srcDir 'jni/lib'\n }\n externalNativeBuild {\n ndkBuild {\n path 'jni/Android.mk'\n }\n }\n\n }\n lint {\n abortOnError false\n }\n\n compileOptions {\n sourceCompatibility JavaVersion.VERSION_1_7\n targetCompatibility JavaVersion.VERSION_1_7\n }\n\n if (buildAsLibrary) {\n libraryVariants.all { variant ->\n variant.outputs.each { output ->\n def outputFile = output.outputFile\n if (outputFile != null && outputFile.name.endsWith(\".aar\")) {\n def fileName = \"org.libsdl.app.aar\";\n output.outputFile = new File(outputFile.parent, fileName);\n }\n }\n }\n }\n}\n\ndependencies {\n}\n" }, { "path": "arch/android/project/app/jni/Android.mk", "content": "include $(call all-subdir-makefiles)\n" }, { "path": "arch/android/project/app/jni/Application.mk", "content": "# Uncomment this if you're using STL in your project\n# See CPLUSPLUS-SUPPORT.html in the NDK documentation for more information\n# APP_STL := stlport_static\n\n# Min runtime API level\nAPP_PLATFORM=android-16\n" }, { "path": "arch/android/project/app/jni/main/Android.mk", "content": "LOCAL_PATH := $(call my-dir)\n\ninclude $(CLEAR_VARS)\n\nLOCAL_MODULE := main\nLOCAL_SRC_FILES := ../lib/$(TARGET_ARCH_ABI)/libmain.so\nLOCAL_SHARED_LIBRARIES := SDL2 ogg vorbis\n\ninclude $(PREBUILT_SHARED_LIBRARY)\n" }, { "path": "arch/android/project/app/proguard-rules.pro", "content": "# Add project specific ProGuard rules here.\n# By default, the flags in this file are appended to flags specified\n# in [sdk]/tools/proguard/proguard-android.txt\n# You can edit the include path and order by changing the proguardFiles\n# directive in build.gradle.\n#\n# For more details, see\n# http://developer.android.com/guide/developing/tools/proguard.html\n\n# Add any project specific keep options here:\n\n# If your project uses WebView with JS, uncomment the following\n# and specify the fully qualified class name to the JavaScript interface\n# class:\n#-keepclassmembers class fqcn.of.javascript.interface.for.webview {\n# public *;\n#}\n" }, { "path": "arch/android/project/app/src/main/AndroidManifest.xml", "content": "\n\n\n \n \n\n \n \n\n \n \n \n \n\n \n \n\n \n \n \n \n \n \n \n \n\n\n \n \n\n \n \n \n \n \n\n \n \n \n \n \n \n\n\n" }, { "path": "arch/android/project/app/src/main/java/net/digitalmzx/megazeux/GameActivity.java", "content": "/* MegaZeux\n *\n * Copyright (C) 2019 Adrian Siekierka \n *\n * This program is free software; you can redistribute it and/or\n * modify it under the terms of the GNU General Public License as\n * published by the Free Software Foundation; either version 2 of\n * the License, or (at your option) any later version.\n *\n * This program is distributed in the hope that it will be useful,\n * but WITHOUT ANY WARRANTY; without even the implied warranty of\n * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n * General Public License for more details.\n *\n * You should have received a copy of the GNU General Public License\n * along with this program; if not, write to the Free Software\n * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n */\n\npackage net.digitalmzx.megazeux;\n\nimport android.app.Activity;\nimport android.os.Build;\nimport android.os.Environment;\nimport android.view.View;\n\nimport org.libsdl.app.SDLActivity;\n\nimport java.io.File;\n\npublic class GameActivity extends SDLActivity\n{\n static File getAssetPath(Activity activity)\n {\n File extDir = activity.getExternalFilesDir(null);\n if(extDir == null)\n {\n extDir = new File(Environment.getExternalStorageDirectory(), \"data/megazeux\");\n if(!extDir.exists())\n {\n //noinspection StatementWithEmptyBody\n if(!extDir.mkdirs())\n {\n // pass\n }\n }\n }\n\n return extDir;\n }\n\n @Override\n protected String[] getArguments()\n {\n return new String[] { new File(getAssetPath(this), \"megazeux\").getAbsolutePath() };\n }\n}\n" }, { "path": "arch/android/project/app/src/main/java/net/digitalmzx/megazeux/MainActivity.java", "content": "/* MegaZeux\n *\n * Copyright (C) 2019 Adrian Siekierka \n *\n * This program is free software; you can redistribute it and/or\n * modify it under the terms of the GNU General Public License as\n * published by the Free Software Foundation; either version 2 of\n * the License, or (at your option) any later version.\n *\n * This program is distributed in the hope that it will be useful,\n * but WITHOUT ANY WARRANTY; without even the implied warranty of\n * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n * General Public License for more details.\n *\n * You should have received a copy of the GNU General Public License\n * along with this program; if not, write to the Free Software\n * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n */\n\npackage net.digitalmzx.megazeux;\n\nimport android.Manifest;\nimport android.content.Intent;\nimport android.content.pm.PackageManager;\nimport android.net.Uri;\nimport android.os.Build;\nimport android.os.Bundle;\nimport android.app.Activity;\nimport android.os.Environment;\nimport android.provider.Settings;\nimport android.view.View;\n\nimport java.io.File;\nimport java.io.FileOutputStream;\nimport java.io.IOError;\nimport java.io.IOException;\nimport java.io.InputStream;\nimport java.util.zip.ZipEntry;\nimport java.util.zip.ZipInputStream;\n\npublic class MainActivity extends Activity\n{\n private static final int MANAGE_EXTERNAL_STORAGE_INTENT_CODE = 100;\n\n @Override\n protected void onCreate(Bundle savedInstanceState)\n {\n super.onCreate(savedInstanceState);\n\n // Ensure all necessary permissions are present\n if(Build.VERSION.SDK_INT >= 30 /* Android 11.0 */)\n {\n if(!Environment.isExternalStorageManager())\n {\n try\n {\n Intent intent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION, Uri.parse(\"package:\" + getPackageName()));\n startActivityForResult(intent, MANAGE_EXTERNAL_STORAGE_INTENT_CODE);\n }\n catch (Exception e)\n {\n Intent intent = new Intent(Settings.ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION);\n startActivityForResult(intent, MANAGE_EXTERNAL_STORAGE_INTENT_CODE);\n }\n return;\n }\n }\n else\n\n if(Build.VERSION.SDK_INT >= 23 /* Android 6.0 */)\n {\n if(checkSelfPermission(android.Manifest.permission.WRITE_EXTERNAL_STORAGE)\n != PackageManager.PERMISSION_GRANTED)\n {\n requestPermissions(new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, 1000);\n return;\n }\n }\n\n launchGame();\n }\n\n @Override\n public void onActivityResult(int requestCode, int resultCode, Intent data) {\n super.onActivityResult(requestCode, resultCode, data);\n if(Build.VERSION.SDK_INT >= 30 /* Android 11.0 */)\n {\n if(requestCode == MANAGE_EXTERNAL_STORAGE_INTENT_CODE)\n {\n if(Environment.isExternalStorageManager())\n launchGame();\n }\n }\n }\n\n private void launchGame()\n {\n // unzip assets\n File targetPath = GameActivity.getAssetPath(this);\n InputStream assetStream = getResources().openRawResource(R.raw.assets);\n ZipInputStream assetZip = new ZipInputStream(assetStream);\n byte[] buffer = new byte[8192];\n FileOutputStream output = null;\n\n try\n {\n ZipEntry entry;\n while((entry = assetZip.getNextEntry()) != null)\n {\n File target = new File(targetPath, entry.getName());\n\n if(entry.isDirectory())\n {\n if(target.exists())\n continue;\n\n target.mkdirs();\n }\n else\n {\n if(target.exists())\n {\n if(target.lastModified() >= entry.getTime())\n continue;\n }\n\n int read;\n output = new FileOutputStream(target);\n\n while((read = assetZip.read(buffer, 0, buffer.length)) >= 0)\n {\n output.write(buffer, 0, read);\n }\n\n output.close();\n output = null;\n\n target.setLastModified(entry.getTime());\n }\n\n assetZip.closeEntry();\n }\n }\n catch(IOException e)\n {\n throw new RuntimeException(e);\n }\n finally\n {\n if(output != null)\n {\n try\n {\n output.close();\n }\n catch(IOException e)\n {\n // pass\n }\n }\n\n try\n {\n assetZip.close();\n }\n catch(IOException e)\n {\n // pass\n }\n\n try\n {\n assetStream.close();\n }\n catch(IOException e)\n {\n // pass\n }\n }\n\n // launch game\n startActivity(new Intent(getApplicationContext(), GameActivity.class));\n }\n\n @Override\n public void onRequestPermissionsResult(int requestCode, String[] permissions,\n int[] grantResults)\n {\n super.onRequestPermissionsResult(requestCode, permissions, grantResults);\n if(grantResults.length > 0 &&\n grantResults[0] == PackageManager.PERMISSION_GRANTED)\n {\n launchGame();\n }\n }\n}\n" }, { "path": "arch/android/project/app/src/main/java/org/libsdl/app/HIDDevice.java", "content": "package org.libsdl.app;\n\nimport android.hardware.usb.UsbDevice;\n\ninterface HIDDevice\n{\n public int getId();\n public int getVendorId();\n public int getProductId();\n public String getSerialNumber();\n public int getVersion();\n public String getManufacturerName();\n public String getProductName();\n public UsbDevice getDevice();\n public boolean open();\n public int sendFeatureReport(byte[] report);\n public int sendOutputReport(byte[] report);\n public boolean getFeatureReport(byte[] report);\n public void setFrozen(boolean frozen);\n public void close();\n public void shutdown();\n}\n" }, { "path": "arch/android/project/app/src/main/java/org/libsdl/app/HIDDeviceBLESteamController.java", "content": "package org.libsdl.app;\n\nimport android.content.Context;\nimport android.bluetooth.BluetoothDevice;\nimport android.bluetooth.BluetoothGatt;\nimport android.bluetooth.BluetoothGattCallback;\nimport android.bluetooth.BluetoothGattCharacteristic;\nimport android.bluetooth.BluetoothGattDescriptor;\nimport android.bluetooth.BluetoothManager;\nimport android.bluetooth.BluetoothProfile;\nimport android.bluetooth.BluetoothGattService;\nimport android.hardware.usb.UsbDevice;\nimport android.os.Handler;\nimport android.os.Looper;\nimport android.util.Log;\nimport android.os.*;\n\n//import com.android.internal.util.HexDump;\n\nimport java.lang.Runnable;\nimport java.util.Arrays;\nimport java.util.LinkedList;\nimport java.util.UUID;\n\nclass HIDDeviceBLESteamController extends BluetoothGattCallback implements HIDDevice {\n\n private static final String TAG = \"hidapi\";\n private HIDDeviceManager mManager;\n private BluetoothDevice mDevice;\n private int mDeviceId;\n private BluetoothGatt mGatt;\n private boolean mIsRegistered = false;\n private boolean mIsConnected = false;\n private boolean mIsChromebook = false;\n private boolean mIsReconnecting = false;\n private boolean mFrozen = false;\n private LinkedList mOperations;\n GattOperation mCurrentOperation = null;\n private Handler mHandler;\n\n private static final int TRANSPORT_AUTO = 0;\n private static final int TRANSPORT_BREDR = 1;\n private static final int TRANSPORT_LE = 2;\n\n private static final int CHROMEBOOK_CONNECTION_CHECK_INTERVAL = 10000;\n\n static public final UUID steamControllerService = UUID.fromString(\"100F6C32-1735-4313-B402-38567131E5F3\");\n static public final UUID inputCharacteristic = UUID.fromString(\"100F6C33-1735-4313-B402-38567131E5F3\");\n static public final UUID reportCharacteristic = UUID.fromString(\"100F6C34-1735-4313-B402-38567131E5F3\");\n static private final byte[] enterValveMode = new byte[] { (byte)0xC0, (byte)0x87, 0x03, 0x08, 0x07, 0x00 };\n\n static class GattOperation {\n private enum Operation {\n CHR_READ,\n CHR_WRITE,\n ENABLE_NOTIFICATION\n }\n\n Operation mOp;\n UUID mUuid;\n byte[] mValue;\n BluetoothGatt mGatt;\n boolean mResult = true;\n\n private GattOperation(BluetoothGatt gatt, GattOperation.Operation operation, UUID uuid) {\n mGatt = gatt;\n mOp = operation;\n mUuid = uuid;\n }\n\n private GattOperation(BluetoothGatt gatt, GattOperation.Operation operation, UUID uuid, byte[] value) {\n mGatt = gatt;\n mOp = operation;\n mUuid = uuid;\n mValue = value;\n }\n\n public void run() {\n // This is executed in main thread\n BluetoothGattCharacteristic chr;\n\n switch (mOp) {\n case CHR_READ:\n chr = getCharacteristic(mUuid);\n //Log.v(TAG, \"Reading characteristic \" + chr.getUuid());\n if (!mGatt.readCharacteristic(chr)) {\n Log.e(TAG, \"Unable to read characteristic \" + mUuid.toString());\n mResult = false;\n break;\n }\n mResult = true;\n break;\n case CHR_WRITE:\n chr = getCharacteristic(mUuid);\n //Log.v(TAG, \"Writing characteristic \" + chr.getUuid() + \" value=\" + HexDump.toHexString(value));\n chr.setValue(mValue);\n if (!mGatt.writeCharacteristic(chr)) {\n Log.e(TAG, \"Unable to write characteristic \" + mUuid.toString());\n mResult = false;\n break;\n }\n mResult = true;\n break;\n case ENABLE_NOTIFICATION:\n chr = getCharacteristic(mUuid);\n //Log.v(TAG, \"Writing descriptor of \" + chr.getUuid());\n if (chr != null) {\n BluetoothGattDescriptor cccd = chr.getDescriptor(UUID.fromString(\"00002902-0000-1000-8000-00805f9b34fb\"));\n if (cccd != null) {\n int properties = chr.getProperties();\n byte[] value;\n if ((properties & BluetoothGattCharacteristic.PROPERTY_NOTIFY) == BluetoothGattCharacteristic.PROPERTY_NOTIFY) {\n value = BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE;\n } else if ((properties & BluetoothGattCharacteristic.PROPERTY_INDICATE) == BluetoothGattCharacteristic.PROPERTY_INDICATE) {\n value = BluetoothGattDescriptor.ENABLE_INDICATION_VALUE;\n } else {\n Log.e(TAG, \"Unable to start notifications on input characteristic\");\n mResult = false;\n return;\n }\n\n mGatt.setCharacteristicNotification(chr, true);\n cccd.setValue(value);\n if (!mGatt.writeDescriptor(cccd)) {\n Log.e(TAG, \"Unable to write descriptor \" + mUuid.toString());\n mResult = false;\n return;\n }\n mResult = true;\n }\n }\n }\n }\n\n public boolean finish() {\n return mResult;\n }\n\n private BluetoothGattCharacteristic getCharacteristic(UUID uuid) {\n BluetoothGattService valveService = mGatt.getService(steamControllerService);\n if (valveService == null)\n return null;\n return valveService.getCharacteristic(uuid);\n }\n\n static public GattOperation readCharacteristic(BluetoothGatt gatt, UUID uuid) {\n return new GattOperation(gatt, Operation.CHR_READ, uuid);\n }\n\n static public GattOperation writeCharacteristic(BluetoothGatt gatt, UUID uuid, byte[] value) {\n return new GattOperation(gatt, Operation.CHR_WRITE, uuid, value);\n }\n\n static public GattOperation enableNotification(BluetoothGatt gatt, UUID uuid) {\n return new GattOperation(gatt, Operation.ENABLE_NOTIFICATION, uuid);\n }\n }\n\n public HIDDeviceBLESteamController(HIDDeviceManager manager, BluetoothDevice device) {\n mManager = manager;\n mDevice = device;\n mDeviceId = mManager.getDeviceIDForIdentifier(getIdentifier());\n mIsRegistered = false;\n mIsChromebook = mManager.getContext().getPackageManager().hasSystemFeature(\"org.chromium.arc.device_management\");\n mOperations = new LinkedList();\n mHandler = new Handler(Looper.getMainLooper());\n\n mGatt = connectGatt();\n // final HIDDeviceBLESteamController finalThis = this;\n // mHandler.postDelayed(new Runnable() {\n // @Override\n // public void run() {\n // finalThis.checkConnectionForChromebookIssue();\n // }\n // }, CHROMEBOOK_CONNECTION_CHECK_INTERVAL);\n }\n\n public String getIdentifier() {\n return String.format(\"SteamController.%s\", mDevice.getAddress());\n }\n\n public BluetoothGatt getGatt() {\n return mGatt;\n }\n\n // Because on Chromebooks we show up as a dual-mode device, it will attempt to connect TRANSPORT_AUTO, which will use TRANSPORT_BREDR instead\n // of TRANSPORT_LE. Let's force ourselves to connect low energy.\n private BluetoothGatt connectGatt(boolean managed) {\n if (Build.VERSION.SDK_INT >= 23 /* Android 6.0 (M) */) {\n try {\n return mDevice.connectGatt(mManager.getContext(), managed, this, TRANSPORT_LE);\n } catch (Exception e) {\n return mDevice.connectGatt(mManager.getContext(), managed, this);\n }\n } else {\n return mDevice.connectGatt(mManager.getContext(), managed, this);\n }\n }\n\n private BluetoothGatt connectGatt() {\n return connectGatt(false);\n }\n\n protected int getConnectionState() {\n\n Context context = mManager.getContext();\n if (context == null) {\n // We are lacking any context to get our Bluetooth information. We'll just assume disconnected.\n return BluetoothProfile.STATE_DISCONNECTED;\n }\n\n BluetoothManager btManager = (BluetoothManager)context.getSystemService(Context.BLUETOOTH_SERVICE);\n if (btManager == null) {\n // This device doesn't support Bluetooth. We should never be here, because how did\n // we instantiate a device to start with?\n return BluetoothProfile.STATE_DISCONNECTED;\n }\n\n return btManager.getConnectionState(mDevice, BluetoothProfile.GATT);\n }\n\n public void reconnect() {\n\n if (getConnectionState() != BluetoothProfile.STATE_CONNECTED) {\n mGatt.disconnect();\n mGatt = connectGatt();\n }\n\n }\n\n protected void checkConnectionForChromebookIssue() {\n if (!mIsChromebook) {\n // We only do this on Chromebooks, because otherwise it's really annoying to just attempt\n // over and over.\n return;\n }\n\n int connectionState = getConnectionState();\n\n switch (connectionState) {\n case BluetoothProfile.STATE_CONNECTED:\n if (!mIsConnected) {\n // We are in the Bad Chromebook Place. We can force a disconnect\n // to try to recover.\n Log.v(TAG, \"Chromebook: We are in a very bad state; the controller shows as connected in the underlying Bluetooth layer, but we never received a callback. Forcing a reconnect.\");\n mIsReconnecting = true;\n mGatt.disconnect();\n mGatt = connectGatt(false);\n break;\n }\n else if (!isRegistered()) {\n if (mGatt.getServices().size() > 0) {\n Log.v(TAG, \"Chromebook: We are connected to a controller, but never got our registration. Trying to recover.\");\n probeService(this);\n }\n else {\n Log.v(TAG, \"Chromebook: We are connected to a controller, but never discovered services. Trying to recover.\");\n mIsReconnecting = true;\n mGatt.disconnect();\n mGatt = connectGatt(false);\n break;\n }\n }\n else {\n Log.v(TAG, \"Chromebook: We are connected, and registered. Everything's good!\");\n return;\n }\n break;\n\n case BluetoothProfile.STATE_DISCONNECTED:\n Log.v(TAG, \"Chromebook: We have either been disconnected, or the Chromebook BtGatt.ContextMap bug has bitten us. Attempting a disconnect/reconnect, but we may not be able to recover.\");\n\n mIsReconnecting = true;\n mGatt.disconnect();\n mGatt = connectGatt(false);\n break;\n\n case BluetoothProfile.STATE_CONNECTING:\n Log.v(TAG, \"Chromebook: We're still trying to connect. Waiting a bit longer.\");\n break;\n }\n\n final HIDDeviceBLESteamController finalThis = this;\n mHandler.postDelayed(new Runnable() {\n @Override\n public void run() {\n finalThis.checkConnectionForChromebookIssue();\n }\n }, CHROMEBOOK_CONNECTION_CHECK_INTERVAL);\n }\n\n private boolean isRegistered() {\n return mIsRegistered;\n }\n\n private void setRegistered() {\n mIsRegistered = true;\n }\n\n private boolean probeService(HIDDeviceBLESteamController controller) {\n\n if (isRegistered()) {\n return true;\n }\n\n if (!mIsConnected) {\n return false;\n }\n\n Log.v(TAG, \"probeService controller=\" + controller);\n\n for (BluetoothGattService service : mGatt.getServices()) {\n if (service.getUuid().equals(steamControllerService)) {\n Log.v(TAG, \"Found Valve steam controller service \" + service.getUuid());\n\n for (BluetoothGattCharacteristic chr : service.getCharacteristics()) {\n if (chr.getUuid().equals(inputCharacteristic)) {\n Log.v(TAG, \"Found input characteristic\");\n // Start notifications\n BluetoothGattDescriptor cccd = chr.getDescriptor(UUID.fromString(\"00002902-0000-1000-8000-00805f9b34fb\"));\n if (cccd != null) {\n enableNotification(chr.getUuid());\n }\n }\n }\n return true;\n }\n }\n\n if ((mGatt.getServices().size() == 0) && mIsChromebook && !mIsReconnecting) {\n Log.e(TAG, \"Chromebook: Discovered services were empty; this almost certainly means the BtGatt.ContextMap bug has bitten us.\");\n mIsConnected = false;\n mIsReconnecting = true;\n mGatt.disconnect();\n mGatt = connectGatt(false);\n }\n\n return false;\n }\n\n //////////////////////////////////////////////////////////////////////////////////////////////////////\n //////////////////////////////////////////////////////////////////////////////////////////////////////\n //////////////////////////////////////////////////////////////////////////////////////////////////////\n\n private void finishCurrentGattOperation() {\n GattOperation op = null;\n synchronized (mOperations) {\n if (mCurrentOperation != null) {\n op = mCurrentOperation;\n mCurrentOperation = null;\n }\n }\n if (op != null) {\n boolean result = op.finish(); // TODO: Maybe in main thread as well?\n\n // Our operation failed, let's add it back to the beginning of our queue.\n if (!result) {\n mOperations.addFirst(op);\n }\n }\n executeNextGattOperation();\n }\n\n private void executeNextGattOperation() {\n synchronized (mOperations) {\n if (mCurrentOperation != null)\n return;\n\n if (mOperations.isEmpty())\n return;\n\n mCurrentOperation = mOperations.removeFirst();\n }\n\n // Run in main thread\n mHandler.post(new Runnable() {\n @Override\n public void run() {\n synchronized (mOperations) {\n if (mCurrentOperation == null) {\n Log.e(TAG, \"Current operation null in executor?\");\n return;\n }\n\n mCurrentOperation.run();\n // now wait for the GATT callback and when it comes, finish this operation\n }\n }\n });\n }\n\n private void queueGattOperation(GattOperation op) {\n synchronized (mOperations) {\n mOperations.add(op);\n }\n executeNextGattOperation();\n }\n\n private void enableNotification(UUID chrUuid) {\n GattOperation op = HIDDeviceBLESteamController.GattOperation.enableNotification(mGatt, chrUuid);\n queueGattOperation(op);\n }\n\n public void writeCharacteristic(UUID uuid, byte[] value) {\n GattOperation op = HIDDeviceBLESteamController.GattOperation.writeCharacteristic(mGatt, uuid, value);\n queueGattOperation(op);\n }\n\n public void readCharacteristic(UUID uuid) {\n GattOperation op = HIDDeviceBLESteamController.GattOperation.readCharacteristic(mGatt, uuid);\n queueGattOperation(op);\n }\n\n //////////////////////////////////////////////////////////////////////////////////////////////////////\n ////////////// BluetoothGattCallback overridden methods\n //////////////////////////////////////////////////////////////////////////////////////////////////////\n\n public void onConnectionStateChange(BluetoothGatt g, int status, int newState) {\n //Log.v(TAG, \"onConnectionStateChange status=\" + status + \" newState=\" + newState);\n mIsReconnecting = false;\n if (newState == 2) {\n mIsConnected = true;\n // Run directly, without GattOperation\n if (!isRegistered()) {\n mHandler.post(new Runnable() {\n @Override\n public void run() {\n mGatt.discoverServices();\n }\n });\n }\n }\n else if (newState == 0) {\n mIsConnected = false;\n }\n\n // Disconnection is handled in SteamLink using the ACTION_ACL_DISCONNECTED Intent.\n }\n\n public void onServicesDiscovered(BluetoothGatt gatt, int status) {\n //Log.v(TAG, \"onServicesDiscovered status=\" + status);\n if (status == 0) {\n if (gatt.getServices().size() == 0) {\n Log.v(TAG, \"onServicesDiscovered returned zero services; something has gone horribly wrong down in Android's Bluetooth stack.\");\n mIsReconnecting = true;\n mIsConnected = false;\n gatt.disconnect();\n mGatt = connectGatt(false);\n }\n else {\n probeService(this);\n }\n }\n }\n\n public void onCharacteristicRead(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {\n //Log.v(TAG, \"onCharacteristicRead status=\" + status + \" uuid=\" + characteristic.getUuid());\n\n if (characteristic.getUuid().equals(reportCharacteristic) && !mFrozen) {\n mManager.HIDDeviceFeatureReport(getId(), characteristic.getValue());\n }\n\n finishCurrentGattOperation();\n }\n\n public void onCharacteristicWrite(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) {\n //Log.v(TAG, \"onCharacteristicWrite status=\" + status + \" uuid=\" + characteristic.getUuid());\n\n if (characteristic.getUuid().equals(reportCharacteristic)) {\n // Only register controller with the native side once it has been fully configured\n if (!isRegistered()) {\n Log.v(TAG, \"Registering Steam Controller with ID: \" + getId());\n mManager.HIDDeviceConnected(getId(), getIdentifier(), getVendorId(), getProductId(), getSerialNumber(), getVersion(), getManufacturerName(), getProductName(), 0, 0, 0, 0);\n setRegistered();\n }\n }\n\n finishCurrentGattOperation();\n }\n\n public void onCharacteristicChanged(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic) {\n // Enable this for verbose logging of controller input reports\n //Log.v(TAG, \"onCharacteristicChanged uuid=\" + characteristic.getUuid() + \" data=\" + HexDump.dumpHexString(characteristic.getValue()));\n\n if (characteristic.getUuid().equals(inputCharacteristic) && !mFrozen) {\n mManager.HIDDeviceInputReport(getId(), characteristic.getValue());\n }\n }\n\n public void onDescriptorRead(BluetoothGatt gatt, BluetoothGattDescriptor descriptor, int status) {\n //Log.v(TAG, \"onDescriptorRead status=\" + status);\n }\n\n public void onDescriptorWrite(BluetoothGatt gatt, BluetoothGattDescriptor descriptor, int status) {\n BluetoothGattCharacteristic chr = descriptor.getCharacteristic();\n //Log.v(TAG, \"onDescriptorWrite status=\" + status + \" uuid=\" + chr.getUuid() + \" descriptor=\" + descriptor.getUuid());\n\n if (chr.getUuid().equals(inputCharacteristic)) {\n boolean hasWrittenInputDescriptor = true;\n BluetoothGattCharacteristic reportChr = chr.getService().getCharacteristic(reportCharacteristic);\n if (reportChr != null) {\n Log.v(TAG, \"Writing report characteristic to enter valve mode\");\n reportChr.setValue(enterValveMode);\n gatt.writeCharacteristic(reportChr);\n }\n }\n\n finishCurrentGattOperation();\n }\n\n public void onReliableWriteCompleted(BluetoothGatt gatt, int status) {\n //Log.v(TAG, \"onReliableWriteCompleted status=\" + status);\n }\n\n public void onReadRemoteRssi(BluetoothGatt gatt, int rssi, int status) {\n //Log.v(TAG, \"onReadRemoteRssi status=\" + status);\n }\n\n public void onMtuChanged(BluetoothGatt gatt, int mtu, int status) {\n //Log.v(TAG, \"onMtuChanged status=\" + status);\n }\n\n //////////////////////////////////////////////////////////////////////////////////////////////////////\n //////// Public API\n //////////////////////////////////////////////////////////////////////////////////////////////////////\n\n @Override\n public int getId() {\n return mDeviceId;\n }\n\n @Override\n public int getVendorId() {\n // Valve Corporation\n final int VALVE_USB_VID = 0x28DE;\n return VALVE_USB_VID;\n }\n\n @Override\n public int getProductId() {\n // We don't have an easy way to query from the Bluetooth device, but we know what it is\n final int D0G_BLE2_PID = 0x1106;\n return D0G_BLE2_PID;\n }\n\n @Override\n public String getSerialNumber() {\n // This will be read later via feature report by Steam\n return \"12345\";\n }\n\n @Override\n public int getVersion() {\n return 0;\n }\n\n @Override\n public String getManufacturerName() {\n return \"Valve Corporation\";\n }\n\n @Override\n public String getProductName() {\n return \"Steam Controller\";\n }\n\n @Override\n public UsbDevice getDevice() {\n return null;\n }\n\n @Override\n public boolean open() {\n return true;\n }\n\n @Override\n public int sendFeatureReport(byte[] report) {\n if (!isRegistered()) {\n Log.e(TAG, \"Attempted sendFeatureReport before Steam Controller is registered!\");\n if (mIsConnected) {\n probeService(this);\n }\n return -1;\n }\n\n // We need to skip the first byte, as that doesn't go over the air\n byte[] actual_report = Arrays.copyOfRange(report, 1, report.length - 1);\n //Log.v(TAG, \"sendFeatureReport \" + HexDump.dumpHexString(actual_report));\n writeCharacteristic(reportCharacteristic, actual_report);\n return report.length;\n }\n\n @Override\n public int sendOutputReport(byte[] report) {\n if (!isRegistered()) {\n Log.e(TAG, \"Attempted sendOutputReport before Steam Controller is registered!\");\n if (mIsConnected) {\n probeService(this);\n }\n return -1;\n }\n\n //Log.v(TAG, \"sendFeatureReport \" + HexDump.dumpHexString(report));\n writeCharacteristic(reportCharacteristic, report);\n return report.length;\n }\n\n @Override\n public boolean getFeatureReport(byte[] report) {\n if (!isRegistered()) {\n Log.e(TAG, \"Attempted getFeatureReport before Steam Controller is registered!\");\n if (mIsConnected) {\n probeService(this);\n }\n return false;\n }\n\n //Log.v(TAG, \"getFeatureReport\");\n readCharacteristic(reportCharacteristic);\n return true;\n }\n\n @Override\n public void close() {\n }\n\n @Override\n public void setFrozen(boolean frozen) {\n mFrozen = frozen;\n }\n\n @Override\n public void shutdown() {\n close();\n\n BluetoothGatt g = mGatt;\n if (g != null) {\n g.disconnect();\n g.close();\n mGatt = null;\n }\n mManager = null;\n mIsRegistered = false;\n mIsConnected = false;\n mOperations.clear();\n }\n\n}\n\n" }, { "path": "arch/android/project/app/src/main/java/org/libsdl/app/HIDDeviceManager.java", "content": "package org.libsdl.app;\n\nimport android.app.Activity;\nimport android.app.AlertDialog;\nimport android.app.PendingIntent;\nimport android.bluetooth.BluetoothAdapter;\nimport android.bluetooth.BluetoothDevice;\nimport android.bluetooth.BluetoothManager;\nimport android.bluetooth.BluetoothProfile;\nimport android.os.Build;\nimport android.util.Log;\nimport android.content.BroadcastReceiver;\nimport android.content.Context;\nimport android.content.DialogInterface;\nimport android.content.Intent;\nimport android.content.IntentFilter;\nimport android.content.SharedPreferences;\nimport android.content.pm.PackageManager;\nimport android.hardware.usb.*;\nimport android.os.Handler;\nimport android.os.Looper;\n\nimport java.util.ArrayList;\nimport java.util.HashMap;\nimport java.util.Iterator;\nimport java.util.List;\n\npublic class HIDDeviceManager {\n private static final String TAG = \"hidapi\";\n private static final String ACTION_USB_PERMISSION = \"org.libsdl.app.USB_PERMISSION\";\n\n private static HIDDeviceManager sManager;\n private static int sManagerRefCount = 0;\n\n public static HIDDeviceManager acquire(Context context) {\n if (sManagerRefCount == 0) {\n sManager = new HIDDeviceManager(context);\n }\n ++sManagerRefCount;\n return sManager;\n }\n\n public static void release(HIDDeviceManager manager) {\n if (manager == sManager) {\n --sManagerRefCount;\n if (sManagerRefCount == 0) {\n sManager.close();\n sManager = null;\n }\n }\n }\n\n private Context mContext;\n private HashMap mDevicesById = new HashMap();\n private HashMap mBluetoothDevices = new HashMap();\n private int mNextDeviceId = 0;\n private SharedPreferences mSharedPreferences = null;\n private boolean mIsChromebook = false;\n private UsbManager mUsbManager;\n private Handler mHandler;\n private BluetoothManager mBluetoothManager;\n private List mLastBluetoothDevices;\n\n private final BroadcastReceiver mUsbBroadcast = new BroadcastReceiver() {\n @Override\n public void onReceive(Context context, Intent intent) {\n String action = intent.getAction();\n if (action.equals(UsbManager.ACTION_USB_DEVICE_ATTACHED)) {\n UsbDevice usbDevice = intent.getParcelableExtra(UsbManager.EXTRA_DEVICE);\n handleUsbDeviceAttached(usbDevice);\n } else if (action.equals(UsbManager.ACTION_USB_DEVICE_DETACHED)) {\n UsbDevice usbDevice = intent.getParcelableExtra(UsbManager.EXTRA_DEVICE);\n handleUsbDeviceDetached(usbDevice);\n } else if (action.equals(HIDDeviceManager.ACTION_USB_PERMISSION)) {\n UsbDevice usbDevice = intent.getParcelableExtra(UsbManager.EXTRA_DEVICE);\n handleUsbDevicePermission(usbDevice, intent.getBooleanExtra(UsbManager.EXTRA_PERMISSION_GRANTED, false));\n }\n }\n };\n\n private final BroadcastReceiver mBluetoothBroadcast = new BroadcastReceiver() {\n @Override\n public void onReceive(Context context, Intent intent) {\n String action = intent.getAction();\n // Bluetooth device was connected. If it was a Steam Controller, handle it\n if (action.equals(BluetoothDevice.ACTION_ACL_CONNECTED)) {\n BluetoothDevice device = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE);\n Log.d(TAG, \"Bluetooth device connected: \" + device);\n\n if (isSteamController(device)) {\n connectBluetoothDevice(device);\n }\n }\n\n // Bluetooth device was disconnected, remove from controller manager (if any)\n if (action.equals(BluetoothDevice.ACTION_ACL_DISCONNECTED)) {\n BluetoothDevice device = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE);\n Log.d(TAG, \"Bluetooth device disconnected: \" + device);\n\n disconnectBluetoothDevice(device);\n }\n }\n };\n\n private HIDDeviceManager(final Context context) {\n mContext = context;\n\n HIDDeviceRegisterCallback();\n\n mSharedPreferences = mContext.getSharedPreferences(\"hidapi\", Context.MODE_PRIVATE);\n mIsChromebook = mContext.getPackageManager().hasSystemFeature(\"org.chromium.arc.device_management\");\n\n// if (shouldClear) {\n// SharedPreferences.Editor spedit = mSharedPreferences.edit();\n// spedit.clear();\n// spedit.commit();\n// }\n// else\n {\n mNextDeviceId = mSharedPreferences.getInt(\"next_device_id\", 0);\n }\n }\n\n public Context getContext() {\n return mContext;\n }\n\n public int getDeviceIDForIdentifier(String identifier) {\n SharedPreferences.Editor spedit = mSharedPreferences.edit();\n\n int result = mSharedPreferences.getInt(identifier, 0);\n if (result == 0) {\n result = mNextDeviceId++;\n spedit.putInt(\"next_device_id\", mNextDeviceId);\n }\n\n spedit.putInt(identifier, result);\n spedit.commit();\n return result;\n }\n\n private void initializeUSB() {\n mUsbManager = (UsbManager)mContext.getSystemService(Context.USB_SERVICE);\n if (mUsbManager == null) {\n return;\n }\n\n /*\n // Logging\n for (UsbDevice device : mUsbManager.getDeviceList().values()) {\n Log.i(TAG,\"Path: \" + device.getDeviceName());\n Log.i(TAG,\"Manufacturer: \" + device.getManufacturerName());\n Log.i(TAG,\"Product: \" + device.getProductName());\n Log.i(TAG,\"ID: \" + device.getDeviceId());\n Log.i(TAG,\"Class: \" + device.getDeviceClass());\n Log.i(TAG,\"Protocol: \" + device.getDeviceProtocol());\n Log.i(TAG,\"Vendor ID \" + device.getVendorId());\n Log.i(TAG,\"Product ID: \" + device.getProductId());\n Log.i(TAG,\"Interface count: \" + device.getInterfaceCount());\n Log.i(TAG,\"---------------------------------------\");\n\n // Get interface details\n for (int index = 0; index < device.getInterfaceCount(); index++) {\n UsbInterface mUsbInterface = device.getInterface(index);\n Log.i(TAG,\" ***** *****\");\n Log.i(TAG,\" Interface index: \" + index);\n Log.i(TAG,\" Interface ID: \" + mUsbInterface.getId());\n Log.i(TAG,\" Interface class: \" + mUsbInterface.getInterfaceClass());\n Log.i(TAG,\" Interface subclass: \" + mUsbInterface.getInterfaceSubclass());\n Log.i(TAG,\" Interface protocol: \" + mUsbInterface.getInterfaceProtocol());\n Log.i(TAG,\" Endpoint count: \" + mUsbInterface.getEndpointCount());\n\n // Get endpoint details\n for (int epi = 0; epi < mUsbInterface.getEndpointCount(); epi++)\n {\n UsbEndpoint mEndpoint = mUsbInterface.getEndpoint(epi);\n Log.i(TAG,\" ++++ ++++ ++++\");\n Log.i(TAG,\" Endpoint index: \" + epi);\n Log.i(TAG,\" Attributes: \" + mEndpoint.getAttributes());\n Log.i(TAG,\" Direction: \" + mEndpoint.getDirection());\n Log.i(TAG,\" Number: \" + mEndpoint.getEndpointNumber());\n Log.i(TAG,\" Interval: \" + mEndpoint.getInterval());\n Log.i(TAG,\" Packet size: \" + mEndpoint.getMaxPacketSize());\n Log.i(TAG,\" Type: \" + mEndpoint.getType());\n }\n }\n }\n Log.i(TAG,\" No more devices connected.\");\n */\n\n // Register for USB broadcasts and permission completions\n IntentFilter filter = new IntentFilter();\n filter.addAction(UsbManager.ACTION_USB_DEVICE_ATTACHED);\n filter.addAction(UsbManager.ACTION_USB_DEVICE_DETACHED);\n filter.addAction(HIDDeviceManager.ACTION_USB_PERMISSION);\n mContext.registerReceiver(mUsbBroadcast, filter);\n\n for (UsbDevice usbDevice : mUsbManager.getDeviceList().values()) {\n handleUsbDeviceAttached(usbDevice);\n }\n }\n\n UsbManager getUSBManager() {\n return mUsbManager;\n }\n\n private void shutdownUSB() {\n try {\n mContext.unregisterReceiver(mUsbBroadcast);\n } catch (Exception e) {\n // We may not have registered, that's okay\n }\n }\n\n private boolean isHIDDeviceInterface(UsbDevice usbDevice, UsbInterface usbInterface) {\n if (usbInterface.getInterfaceClass() == UsbConstants.USB_CLASS_HID) {\n return true;\n }\n if (isXbox360Controller(usbDevice, usbInterface) || isXboxOneController(usbDevice, usbInterface)) {\n return true;\n }\n return false;\n }\n\n private boolean isXbox360Controller(UsbDevice usbDevice, UsbInterface usbInterface) {\n final int XB360_IFACE_SUBCLASS = 93;\n final int XB360_IFACE_PROTOCOL = 1; // Wired\n final int XB360W_IFACE_PROTOCOL = 129; // Wireless\n final int[] SUPPORTED_VENDORS = {\n 0x0079, // GPD Win 2\n 0x044f, // Thrustmaster\n 0x045e, // Microsoft\n 0x046d, // Logitech\n 0x056e, // Elecom\n 0x06a3, // Saitek\n 0x0738, // Mad Catz\n 0x07ff, // Mad Catz\n 0x0e6f, // PDP\n 0x0f0d, // Hori\n 0x1038, // SteelSeries\n 0x11c9, // Nacon\n 0x12ab, // Unknown\n 0x1430, // RedOctane\n 0x146b, // BigBen\n 0x1532, // Razer Sabertooth\n 0x15e4, // Numark\n 0x162e, // Joytech\n 0x1689, // Razer Onza\n 0x1949, // Lab126, Inc.\n 0x1bad, // Harmonix\n 0x20d6, // PowerA\n 0x24c6, // PowerA\n 0x2c22, // Qanba\n 0x2dc8, // 8BitDo\n 0x9886, // ASTRO Gaming\n };\n\n if (usbInterface.getInterfaceClass() == UsbConstants.USB_CLASS_VENDOR_SPEC &&\n usbInterface.getInterfaceSubclass() == XB360_IFACE_SUBCLASS &&\n (usbInterface.getInterfaceProtocol() == XB360_IFACE_PROTOCOL ||\n usbInterface.getInterfaceProtocol() == XB360W_IFACE_PROTOCOL)) {\n int vendor_id = usbDevice.getVendorId();\n for (int supportedVid : SUPPORTED_VENDORS) {\n if (vendor_id == supportedVid) {\n return true;\n }\n }\n }\n return false;\n }\n\n private boolean isXboxOneController(UsbDevice usbDevice, UsbInterface usbInterface) {\n final int XB1_IFACE_SUBCLASS = 71;\n final int XB1_IFACE_PROTOCOL = 208;\n final int[] SUPPORTED_VENDORS = {\n 0x03f0, // HP\n 0x044f, // Thrustmaster\n 0x045e, // Microsoft\n 0x0738, // Mad Catz\n 0x0b05, // ASUS\n 0x0e6f, // PDP\n 0x0f0d, // Hori\n 0x10f5, // Turtle Beach\n 0x1532, // Razer Wildcat\n 0x20d6, // PowerA\n 0x24c6, // PowerA\n 0x2dc8, // 8BitDo\n 0x2e24, // Hyperkin\n 0x3537, // Gamesir\n };\n\n if (usbInterface.getId() == 0 &&\n usbInterface.getInterfaceClass() == UsbConstants.USB_CLASS_VENDOR_SPEC &&\n usbInterface.getInterfaceSubclass() == XB1_IFACE_SUBCLASS &&\n usbInterface.getInterfaceProtocol() == XB1_IFACE_PROTOCOL) {\n int vendor_id = usbDevice.getVendorId();\n for (int supportedVid : SUPPORTED_VENDORS) {\n if (vendor_id == supportedVid) {\n return true;\n }\n }\n }\n return false;\n }\n\n private void handleUsbDeviceAttached(UsbDevice usbDevice) {\n connectHIDDeviceUSB(usbDevice);\n }\n\n private void handleUsbDeviceDetached(UsbDevice usbDevice) {\n List devices = new ArrayList();\n for (HIDDevice device : mDevicesById.values()) {\n if (usbDevice.equals(device.getDevice())) {\n devices.add(device.getId());\n }\n }\n for (int id : devices) {\n HIDDevice device = mDevicesById.get(id);\n mDevicesById.remove(id);\n device.shutdown();\n HIDDeviceDisconnected(id);\n }\n }\n\n private void handleUsbDevicePermission(UsbDevice usbDevice, boolean permission_granted) {\n for (HIDDevice device : mDevicesById.values()) {\n if (usbDevice.equals(device.getDevice())) {\n boolean opened = false;\n if (permission_granted) {\n opened = device.open();\n }\n HIDDeviceOpenResult(device.getId(), opened);\n }\n }\n }\n\n private void connectHIDDeviceUSB(UsbDevice usbDevice) {\n synchronized (this) {\n int interface_mask = 0;\n for (int interface_index = 0; interface_index < usbDevice.getInterfaceCount(); interface_index++) {\n UsbInterface usbInterface = usbDevice.getInterface(interface_index);\n if (isHIDDeviceInterface(usbDevice, usbInterface)) {\n // Check to see if we've already added this interface\n // This happens with the Xbox Series X controller which has a duplicate interface 0, which is inactive\n int interface_id = usbInterface.getId();\n if ((interface_mask & (1 << interface_id)) != 0) {\n continue;\n }\n interface_mask |= (1 << interface_id);\n\n HIDDeviceUSB device = new HIDDeviceUSB(this, usbDevice, interface_index);\n int id = device.getId();\n mDevicesById.put(id, device);\n HIDDeviceConnected(id, device.getIdentifier(), device.getVendorId(), device.getProductId(), device.getSerialNumber(), device.getVersion(), device.getManufacturerName(), device.getProductName(), usbInterface.getId(), usbInterface.getInterfaceClass(), usbInterface.getInterfaceSubclass(), usbInterface.getInterfaceProtocol());\n }\n }\n }\n }\n\n private void initializeBluetooth() {\n Log.d(TAG, \"Initializing Bluetooth\");\n\n if (Build.VERSION.SDK_INT >= 31 /* Android 12 */ &&\n mContext.getPackageManager().checkPermission(android.Manifest.permission.BLUETOOTH_CONNECT, mContext.getPackageName()) != PackageManager.PERMISSION_GRANTED) {\n Log.d(TAG, \"Couldn't initialize Bluetooth, missing android.permission.BLUETOOTH_CONNECT\");\n return;\n }\n\n if (Build.VERSION.SDK_INT <= 30 /* Android 11.0 (R) */ &&\n mContext.getPackageManager().checkPermission(android.Manifest.permission.BLUETOOTH, mContext.getPackageName()) != PackageManager.PERMISSION_GRANTED) {\n Log.d(TAG, \"Couldn't initialize Bluetooth, missing android.permission.BLUETOOTH\");\n return;\n }\n\n if (!mContext.getPackageManager().hasSystemFeature(PackageManager.FEATURE_BLUETOOTH_LE) || (Build.VERSION.SDK_INT < 18 /* Android 4.3 (JELLY_BEAN_MR2) */)) {\n Log.d(TAG, \"Couldn't initialize Bluetooth, this version of Android does not support Bluetooth LE\");\n return;\n }\n\n // Find bonded bluetooth controllers and create SteamControllers for them\n mBluetoothManager = (BluetoothManager)mContext.getSystemService(Context.BLUETOOTH_SERVICE);\n if (mBluetoothManager == null) {\n // This device doesn't support Bluetooth.\n return;\n }\n\n BluetoothAdapter btAdapter = mBluetoothManager.getAdapter();\n if (btAdapter == null) {\n // This device has Bluetooth support in the codebase, but has no available adapters.\n return;\n }\n\n // Get our bonded devices.\n for (BluetoothDevice device : btAdapter.getBondedDevices()) {\n\n Log.d(TAG, \"Bluetooth device available: \" + device);\n if (isSteamController(device)) {\n connectBluetoothDevice(device);\n }\n\n }\n\n // NOTE: These don't work on Chromebooks, to my undying dismay.\n IntentFilter filter = new IntentFilter();\n filter.addAction(BluetoothDevice.ACTION_ACL_CONNECTED);\n filter.addAction(BluetoothDevice.ACTION_ACL_DISCONNECTED);\n mContext.registerReceiver(mBluetoothBroadcast, filter);\n\n if (mIsChromebook) {\n mHandler = new Handler(Looper.getMainLooper());\n mLastBluetoothDevices = new ArrayList();\n\n // final HIDDeviceManager finalThis = this;\n // mHandler.postDelayed(new Runnable() {\n // @Override\n // public void run() {\n // finalThis.chromebookConnectionHandler();\n // }\n // }, 5000);\n }\n }\n\n private void shutdownBluetooth() {\n try {\n mContext.unregisterReceiver(mBluetoothBroadcast);\n } catch (Exception e) {\n // We may not have registered, that's okay\n }\n }\n\n // Chromebooks do not pass along ACTION_ACL_CONNECTED / ACTION_ACL_DISCONNECTED properly.\n // This function provides a sort of dummy version of that, watching for changes in the\n // connected devices and attempting to add controllers as things change.\n public void chromebookConnectionHandler() {\n if (!mIsChromebook) {\n return;\n }\n\n ArrayList disconnected = new ArrayList();\n ArrayList connected = new ArrayList();\n\n List currentConnected = mBluetoothManager.getConnectedDevices(BluetoothProfile.GATT);\n\n for (BluetoothDevice bluetoothDevice : currentConnected) {\n if (!mLastBluetoothDevices.contains(bluetoothDevice)) {\n connected.add(bluetoothDevice);\n }\n }\n for (BluetoothDevice bluetoothDevice : mLastBluetoothDevices) {\n if (!currentConnected.contains(bluetoothDevice)) {\n disconnected.add(bluetoothDevice);\n }\n }\n\n mLastBluetoothDevices = currentConnected;\n\n for (BluetoothDevice bluetoothDevice : disconnected) {\n disconnectBluetoothDevice(bluetoothDevice);\n }\n for (BluetoothDevice bluetoothDevice : connected) {\n connectBluetoothDevice(bluetoothDevice);\n }\n\n final HIDDeviceManager finalThis = this;\n mHandler.postDelayed(new Runnable() {\n @Override\n public void run() {\n finalThis.chromebookConnectionHandler();\n }\n }, 10000);\n }\n\n public boolean connectBluetoothDevice(BluetoothDevice bluetoothDevice) {\n Log.v(TAG, \"connectBluetoothDevice device=\" + bluetoothDevice);\n synchronized (this) {\n if (mBluetoothDevices.containsKey(bluetoothDevice)) {\n Log.v(TAG, \"Steam controller with address \" + bluetoothDevice + \" already exists, attempting reconnect\");\n\n HIDDeviceBLESteamController device = mBluetoothDevices.get(bluetoothDevice);\n device.reconnect();\n\n return false;\n }\n HIDDeviceBLESteamController device = new HIDDeviceBLESteamController(this, bluetoothDevice);\n int id = device.getId();\n mBluetoothDevices.put(bluetoothDevice, device);\n mDevicesById.put(id, device);\n\n // The Steam Controller will mark itself connected once initialization is complete\n }\n return true;\n }\n\n public void disconnectBluetoothDevice(BluetoothDevice bluetoothDevice) {\n synchronized (this) {\n HIDDeviceBLESteamController device = mBluetoothDevices.get(bluetoothDevice);\n if (device == null)\n return;\n\n int id = device.getId();\n mBluetoothDevices.remove(bluetoothDevice);\n mDevicesById.remove(id);\n device.shutdown();\n HIDDeviceDisconnected(id);\n }\n }\n\n public boolean isSteamController(BluetoothDevice bluetoothDevice) {\n // Sanity check. If you pass in a null device, by definition it is never a Steam Controller.\n if (bluetoothDevice == null) {\n return false;\n }\n\n // If the device has no local name, we really don't want to try an equality check against it.\n if (bluetoothDevice.getName() == null) {\n return false;\n }\n\n return bluetoothDevice.getName().equals(\"SteamController\") && ((bluetoothDevice.getType() & BluetoothDevice.DEVICE_TYPE_LE) != 0);\n }\n\n private void close() {\n shutdownUSB();\n shutdownBluetooth();\n synchronized (this) {\n for (HIDDevice device : mDevicesById.values()) {\n device.shutdown();\n }\n mDevicesById.clear();\n mBluetoothDevices.clear();\n HIDDeviceReleaseCallback();\n }\n }\n\n public void setFrozen(boolean frozen) {\n synchronized (this) {\n for (HIDDevice device : mDevicesById.values()) {\n device.setFrozen(frozen);\n }\n }\n }\n\n //////////////////////////////////////////////////////////////////////////////////////////////////////\n //////////////////////////////////////////////////////////////////////////////////////////////////////\n //////////////////////////////////////////////////////////////////////////////////////////////////////\n\n private HIDDevice getDevice(int id) {\n synchronized (this) {\n HIDDevice result = mDevicesById.get(id);\n if (result == null) {\n Log.v(TAG, \"No device for id: \" + id);\n Log.v(TAG, \"Available devices: \" + mDevicesById.keySet());\n }\n return result;\n }\n }\n\n //////////////////////////////////////////////////////////////////////////////////////////////////////\n ////////// JNI interface functions\n //////////////////////////////////////////////////////////////////////////////////////////////////////\n\n public boolean initialize(boolean usb, boolean bluetooth) {\n Log.v(TAG, \"initialize(\" + usb + \", \" + bluetooth + \")\");\n\n if (usb) {\n initializeUSB();\n }\n if (bluetooth) {\n initializeBluetooth();\n }\n return true;\n }\n\n public boolean openDevice(int deviceID) {\n Log.v(TAG, \"openDevice deviceID=\" + deviceID);\n HIDDevice device = getDevice(deviceID);\n if (device == null) {\n HIDDeviceDisconnected(deviceID);\n return false;\n }\n\n // Look to see if this is a USB device and we have permission to access it\n UsbDevice usbDevice = device.getDevice();\n if (usbDevice != null && !mUsbManager.hasPermission(usbDevice)) {\n HIDDeviceOpenPending(deviceID);\n try {\n final int FLAG_MUTABLE = 0x02000000; // PendingIntent.FLAG_MUTABLE, but don't require SDK 31\n int flags;\n if (Build.VERSION.SDK_INT >= 31 /* Android 12.0 (S) */) {\n flags = FLAG_MUTABLE;\n } else {\n flags = 0;\n }\n if (Build.VERSION.SDK_INT >= 33 /* Android 14.0 (U) */) {\n Intent intent = new Intent(HIDDeviceManager.ACTION_USB_PERMISSION);\n intent.setPackage(mContext.getPackageName());\n mUsbManager.requestPermission(usbDevice, PendingIntent.getBroadcast(mContext, 0, intent, flags));\n } else {\n mUsbManager.requestPermission(usbDevice, PendingIntent.getBroadcast(mContext, 0, new Intent(HIDDeviceManager.ACTION_USB_PERMISSION), flags));\n }\n } catch (Exception e) {\n Log.v(TAG, \"Couldn't request permission for USB device \" + usbDevice);\n HIDDeviceOpenResult(deviceID, false);\n }\n return false;\n }\n\n try {\n return device.open();\n } catch (Exception e) {\n Log.e(TAG, \"Got exception: \" + Log.getStackTraceString(e));\n }\n return false;\n }\n\n public int sendOutputReport(int deviceID, byte[] report) {\n try {\n //Log.v(TAG, \"sendOutputReport deviceID=\" + deviceID + \" length=\" + report.length);\n HIDDevice device;\n device = getDevice(deviceID);\n if (device == null) {\n HIDDeviceDisconnected(deviceID);\n return -1;\n }\n\n return device.sendOutputReport(report);\n } catch (Exception e) {\n Log.e(TAG, \"Got exception: \" + Log.getStackTraceString(e));\n }\n return -1;\n }\n\n public int sendFeatureReport(int deviceID, byte[] report) {\n try {\n //Log.v(TAG, \"sendFeatureReport deviceID=\" + deviceID + \" length=\" + report.length);\n HIDDevice device;\n device = getDevice(deviceID);\n if (device == null) {\n HIDDeviceDisconnected(deviceID);\n return -1;\n }\n\n return device.sendFeatureReport(report);\n } catch (Exception e) {\n Log.e(TAG, \"Got exception: \" + Log.getStackTraceString(e));\n }\n return -1;\n }\n\n public boolean getFeatureReport(int deviceID, byte[] report) {\n try {\n //Log.v(TAG, \"getFeatureReport deviceID=\" + deviceID);\n HIDDevice device;\n device = getDevice(deviceID);\n if (device == null) {\n HIDDeviceDisconnected(deviceID);\n return false;\n }\n\n return device.getFeatureReport(report);\n } catch (Exception e) {\n Log.e(TAG, \"Got exception: \" + Log.getStackTraceString(e));\n }\n return false;\n }\n\n public void closeDevice(int deviceID) {\n try {\n Log.v(TAG, \"closeDevice deviceID=\" + deviceID);\n HIDDevice device;\n device = getDevice(deviceID);\n if (device == null) {\n HIDDeviceDisconnected(deviceID);\n return;\n }\n\n device.close();\n } catch (Exception e) {\n Log.e(TAG, \"Got exception: \" + Log.getStackTraceString(e));\n }\n }\n\n\n //////////////////////////////////////////////////////////////////////////////////////////////////////\n /////////////// Native methods\n //////////////////////////////////////////////////////////////////////////////////////////////////////\n\n private native void HIDDeviceRegisterCallback();\n private native void HIDDeviceReleaseCallback();\n\n native void HIDDeviceConnected(int deviceID, String identifier, int vendorId, int productId, String serial_number, int release_number, String manufacturer_string, String product_string, int interface_number, int interface_class, int interface_subclass, int interface_protocol);\n native void HIDDeviceOpenPending(int deviceID);\n native void HIDDeviceOpenResult(int deviceID, boolean opened);\n native void HIDDeviceDisconnected(int deviceID);\n\n native void HIDDeviceInputReport(int deviceID, byte[] report);\n native void HIDDeviceFeatureReport(int deviceID, byte[] report);\n}\n" }, { "path": "arch/android/project/app/src/main/java/org/libsdl/app/HIDDeviceUSB.java", "content": "package org.libsdl.app;\n\nimport android.hardware.usb.*;\nimport android.os.Build;\nimport android.util.Log;\nimport java.util.Arrays;\n\nclass HIDDeviceUSB implements HIDDevice {\n\n private static final String TAG = \"hidapi\";\n\n protected HIDDeviceManager mManager;\n protected UsbDevice mDevice;\n protected int mInterfaceIndex;\n protected int mInterface;\n protected int mDeviceId;\n protected UsbDeviceConnection mConnection;\n protected UsbEndpoint mInputEndpoint;\n protected UsbEndpoint mOutputEndpoint;\n protected InputThread mInputThread;\n protected boolean mRunning;\n protected boolean mFrozen;\n\n public HIDDeviceUSB(HIDDeviceManager manager, UsbDevice usbDevice, int interface_index) {\n mManager = manager;\n mDevice = usbDevice;\n mInterfaceIndex = interface_index;\n mInterface = mDevice.getInterface(mInterfaceIndex).getId();\n mDeviceId = manager.getDeviceIDForIdentifier(getIdentifier());\n mRunning = false;\n }\n\n public String getIdentifier() {\n return String.format(\"%s/%x/%x/%d\", mDevice.getDeviceName(), mDevice.getVendorId(), mDevice.getProductId(), mInterfaceIndex);\n }\n\n @Override\n public int getId() {\n return mDeviceId;\n }\n\n @Override\n public int getVendorId() {\n return mDevice.getVendorId();\n }\n\n @Override\n public int getProductId() {\n return mDevice.getProductId();\n }\n\n @Override\n public String getSerialNumber() {\n String result = null;\n if (Build.VERSION.SDK_INT >= 21 /* Android 5.0 (LOLLIPOP) */) {\n try {\n result = mDevice.getSerialNumber();\n }\n catch (SecurityException exception) {\n //Log.w(TAG, \"App permissions mean we cannot get serial number for device \" + getDeviceName() + \" message: \" + exception.getMessage());\n }\n }\n if (result == null) {\n result = \"\";\n }\n return result;\n }\n\n @Override\n public int getVersion() {\n return 0;\n }\n\n @Override\n public String getManufacturerName() {\n String result = null;\n if (Build.VERSION.SDK_INT >= 21 /* Android 5.0 (LOLLIPOP) */) {\n result = mDevice.getManufacturerName();\n }\n if (result == null) {\n result = String.format(\"%x\", getVendorId());\n }\n return result;\n }\n\n @Override\n public String getProductName() {\n String result = null;\n if (Build.VERSION.SDK_INT >= 21 /* Android 5.0 (LOLLIPOP) */) {\n result = mDevice.getProductName();\n }\n if (result == null) {\n result = String.format(\"%x\", getProductId());\n }\n return result;\n }\n\n @Override\n public UsbDevice getDevice() {\n return mDevice;\n }\n\n public String getDeviceName() {\n return getManufacturerName() + \" \" + getProductName() + \"(0x\" + String.format(\"%x\", getVendorId()) + \"/0x\" + String.format(\"%x\", getProductId()) + \")\";\n }\n\n @Override\n public boolean open() {\n mConnection = mManager.getUSBManager().openDevice(mDevice);\n if (mConnection == null) {\n Log.w(TAG, \"Unable to open USB device \" + getDeviceName());\n return false;\n }\n\n // Force claim our interface\n UsbInterface iface = mDevice.getInterface(mInterfaceIndex);\n if (!mConnection.claimInterface(iface, true)) {\n Log.w(TAG, \"Failed to claim interfaces on USB device \" + getDeviceName());\n close();\n return false;\n }\n\n // Find the endpoints\n for (int j = 0; j < iface.getEndpointCount(); j++) {\n UsbEndpoint endpt = iface.getEndpoint(j);\n switch (endpt.getDirection()) {\n case UsbConstants.USB_DIR_IN:\n if (mInputEndpoint == null) {\n mInputEndpoint = endpt;\n }\n break;\n case UsbConstants.USB_DIR_OUT:\n if (mOutputEndpoint == null) {\n mOutputEndpoint = endpt;\n }\n break;\n }\n }\n\n // Make sure the required endpoints were present\n if (mInputEndpoint == null || mOutputEndpoint == null) {\n Log.w(TAG, \"Missing required endpoint on USB device \" + getDeviceName());\n close();\n return false;\n }\n\n // Start listening for input\n mRunning = true;\n mInputThread = new InputThread();\n mInputThread.start();\n\n return true;\n }\n\n @Override\n public int sendFeatureReport(byte[] report) {\n int res = -1;\n int offset = 0;\n int length = report.length;\n boolean skipped_report_id = false;\n byte report_number = report[0];\n\n if (report_number == 0x0) {\n ++offset;\n --length;\n skipped_report_id = true;\n }\n\n res = mConnection.controlTransfer(\n UsbConstants.USB_TYPE_CLASS | 0x01 /*RECIPIENT_INTERFACE*/ | UsbConstants.USB_DIR_OUT,\n 0x09/*HID set_report*/,\n (3/*HID feature*/ << 8) | report_number,\n mInterface,\n report, offset, length,\n 1000/*timeout millis*/);\n\n if (res < 0) {\n Log.w(TAG, \"sendFeatureReport() returned \" + res + \" on device \" + getDeviceName());\n return -1;\n }\n\n if (skipped_report_id) {\n ++length;\n }\n return length;\n }\n\n @Override\n public int sendOutputReport(byte[] report) {\n int r = mConnection.bulkTransfer(mOutputEndpoint, report, report.length, 1000);\n if (r != report.length) {\n Log.w(TAG, \"sendOutputReport() returned \" + r + \" on device \" + getDeviceName());\n }\n return r;\n }\n\n @Override\n public boolean getFeatureReport(byte[] report) {\n int res = -1;\n int offset = 0;\n int length = report.length;\n boolean skipped_report_id = false;\n byte report_number = report[0];\n\n if (report_number == 0x0) {\n /* Offset the return buffer by 1, so that the report ID\n will remain in byte 0. */\n ++offset;\n --length;\n skipped_report_id = true;\n }\n\n res = mConnection.controlTransfer(\n UsbConstants.USB_TYPE_CLASS | 0x01 /*RECIPIENT_INTERFACE*/ | UsbConstants.USB_DIR_IN,\n 0x01/*HID get_report*/,\n (3/*HID feature*/ << 8) | report_number,\n mInterface,\n report, offset, length,\n 1000/*timeout millis*/);\n\n if (res < 0) {\n Log.w(TAG, \"getFeatureReport() returned \" + res + \" on device \" + getDeviceName());\n return false;\n }\n\n if (skipped_report_id) {\n ++res;\n ++length;\n }\n\n byte[] data;\n if (res == length) {\n data = report;\n } else {\n data = Arrays.copyOfRange(report, 0, res);\n }\n mManager.HIDDeviceFeatureReport(mDeviceId, data);\n\n return true;\n }\n\n @Override\n public void close() {\n mRunning = false;\n if (mInputThread != null) {\n while (mInputThread.isAlive()) {\n mInputThread.interrupt();\n try {\n mInputThread.join();\n } catch (InterruptedException e) {\n // Keep trying until we're done\n }\n }\n mInputThread = null;\n }\n if (mConnection != null) {\n UsbInterface iface = mDevice.getInterface(mInterfaceIndex);\n mConnection.releaseInterface(iface);\n mConnection.close();\n mConnection = null;\n }\n }\n\n @Override\n public void shutdown() {\n close();\n mManager = null;\n }\n\n @Override\n public void setFrozen(boolean frozen) {\n mFrozen = frozen;\n }\n\n protected class InputThread extends Thread {\n @Override\n public void run() {\n int packetSize = mInputEndpoint.getMaxPacketSize();\n byte[] packet = new byte[packetSize];\n while (mRunning) {\n int r;\n try\n {\n r = mConnection.bulkTransfer(mInputEndpoint, packet, packetSize, 1000);\n }\n catch (Exception e)\n {\n Log.v(TAG, \"Exception in UsbDeviceConnection bulktransfer: \" + e);\n break;\n }\n if (r < 0) {\n // Could be a timeout or an I/O error\n }\n if (r > 0) {\n byte[] data;\n if (r == packetSize) {\n data = packet;\n } else {\n data = Arrays.copyOfRange(packet, 0, r);\n }\n\n if (!mFrozen) {\n mManager.HIDDeviceInputReport(mDeviceId, data);\n }\n }\n }\n }\n }\n}\n" }, { "path": "arch/android/project/app/src/main/java/org/libsdl/app/SDL.java", "content": "package org.libsdl.app;\n\nimport android.content.Context;\n\nimport java.lang.Class;\nimport java.lang.reflect.Method;\n\n/**\n SDL library initialization\n*/\npublic class SDL {\n\n // This function should be called first and sets up the native code\n // so it can call into the Java classes\n public static void setupJNI() {\n SDLActivity.nativeSetupJNI();\n SDLAudioManager.nativeSetupJNI();\n SDLControllerManager.nativeSetupJNI();\n }\n\n // This function should be called each time the activity is started\n public static void initialize() {\n setContext(null);\n\n SDLActivity.initialize();\n SDLAudioManager.initialize();\n SDLControllerManager.initialize();\n }\n\n // This function stores the current activity (SDL or not)\n public static void setContext(Context context) {\n SDLAudioManager.setContext(context);\n mContext = context;\n }\n\n public static Context getContext() {\n return mContext;\n }\n\n public static void loadLibrary(String libraryName) throws UnsatisfiedLinkError, SecurityException, NullPointerException {\n loadLibrary(libraryName, mContext);\n }\n\n public static void loadLibrary(String libraryName, Context context) throws UnsatisfiedLinkError, SecurityException, NullPointerException {\n if (libraryName == null) {\n throw new NullPointerException(\"No library name provided.\");\n }\n\n try {\n // Let's see if we have ReLinker available in the project. This is necessary for \n // some projects that have huge numbers of local libraries bundled, and thus may \n // trip a bug in Android's native library loader which ReLinker works around. (If\n // loadLibrary works properly, ReLinker will simply use the normal Android method\n // internally.)\n //\n // To use ReLinker, just add it as a dependency. For more information, see \n // https://github.com/KeepSafe/ReLinker for ReLinker's repository.\n //\n Class relinkClass = context.getClassLoader().loadClass(\"com.getkeepsafe.relinker.ReLinker\");\n Class relinkListenerClass = context.getClassLoader().loadClass(\"com.getkeepsafe.relinker.ReLinker$LoadListener\");\n Class contextClass = context.getClassLoader().loadClass(\"android.content.Context\");\n Class stringClass = context.getClassLoader().loadClass(\"java.lang.String\");\n\n // Get a 'force' instance of the ReLinker, so we can ensure libraries are reinstalled if \n // they've changed during updates.\n Method forceMethod = relinkClass.getDeclaredMethod(\"force\");\n Object relinkInstance = forceMethod.invoke(null);\n Class relinkInstanceClass = relinkInstance.getClass();\n\n // Actually load the library!\n Method loadMethod = relinkInstanceClass.getDeclaredMethod(\"loadLibrary\", contextClass, stringClass, stringClass, relinkListenerClass);\n loadMethod.invoke(relinkInstance, context, libraryName, null, null);\n }\n catch (final Throwable e) {\n // Fall back\n try {\n System.loadLibrary(libraryName);\n }\n catch (final UnsatisfiedLinkError ule) {\n throw ule;\n }\n catch (final SecurityException se) {\n throw se;\n }\n }\n }\n\n protected static Context mContext;\n}\n" }, { "path": "arch/android/project/app/src/main/java/org/libsdl/app/SDLActivity.java", "content": "package org.libsdl.app;\n\nimport android.app.Activity;\nimport android.app.AlertDialog;\nimport android.app.Dialog;\nimport android.app.UiModeManager;\nimport android.content.ClipboardManager;\nimport android.content.ClipData;\nimport android.content.Context;\nimport android.content.DialogInterface;\nimport android.content.Intent;\nimport android.content.pm.ActivityInfo;\nimport android.content.pm.ApplicationInfo;\nimport android.content.pm.PackageManager;\nimport android.content.res.Configuration;\nimport android.graphics.Bitmap;\nimport android.graphics.Color;\nimport android.graphics.PorterDuff;\nimport android.graphics.drawable.Drawable;\nimport android.hardware.Sensor;\nimport android.net.Uri;\nimport android.os.Build;\nimport android.os.Bundle;\nimport android.os.Handler;\nimport android.os.Message;\nimport android.text.Editable;\nimport android.text.InputType;\nimport android.text.Selection;\nimport android.util.DisplayMetrics;\nimport android.util.Log;\nimport android.util.SparseArray;\nimport android.view.Display;\nimport android.view.Gravity;\nimport android.view.InputDevice;\nimport android.view.KeyEvent;\nimport android.view.PointerIcon;\nimport android.view.Surface;\nimport android.view.View;\nimport android.view.ViewGroup;\nimport android.view.Window;\nimport android.view.WindowManager;\nimport android.view.inputmethod.BaseInputConnection;\nimport android.view.inputmethod.EditorInfo;\nimport android.view.inputmethod.InputConnection;\nimport android.view.inputmethod.InputMethodManager;\nimport android.widget.Button;\nimport android.widget.EditText;\nimport android.widget.LinearLayout;\nimport android.widget.RelativeLayout;\nimport android.widget.TextView;\nimport android.widget.Toast;\n\nimport java.util.Hashtable;\nimport java.util.Locale;\n\n\n/**\n SDL Activity\n*/\npublic class SDLActivity extends Activity implements View.OnSystemUiVisibilityChangeListener {\n private static final String TAG = \"SDL\";\n private static final int SDL_MAJOR_VERSION = 2;\n private static final int SDL_MINOR_VERSION = 30;\n private static final int SDL_MICRO_VERSION = 9;\n/*\n // Display InputType.SOURCE/CLASS of events and devices\n //\n // SDLActivity.debugSource(device.getSources(), \"device[\" + device.getName() + \"]\");\n // SDLActivity.debugSource(event.getSource(), \"event\");\n public static void debugSource(int sources, String prefix) {\n int s = sources;\n int s_copy = sources;\n String cls = \"\";\n String src = \"\";\n int tst = 0;\n int FLAG_TAINTED = 0x80000000;\n\n if ((s & InputDevice.SOURCE_CLASS_BUTTON) != 0) cls += \" BUTTON\";\n if ((s & InputDevice.SOURCE_CLASS_JOYSTICK) != 0) cls += \" JOYSTICK\";\n if ((s & InputDevice.SOURCE_CLASS_POINTER) != 0) cls += \" POINTER\";\n if ((s & InputDevice.SOURCE_CLASS_POSITION) != 0) cls += \" POSITION\";\n if ((s & InputDevice.SOURCE_CLASS_TRACKBALL) != 0) cls += \" TRACKBALL\";\n\n\n int s2 = s_copy & ~InputDevice.SOURCE_ANY; // keep class bits\n s2 &= ~( InputDevice.SOURCE_CLASS_BUTTON\n | InputDevice.SOURCE_CLASS_JOYSTICK\n | InputDevice.SOURCE_CLASS_POINTER\n | InputDevice.SOURCE_CLASS_POSITION\n | InputDevice.SOURCE_CLASS_TRACKBALL);\n\n if (s2 != 0) cls += \"Some_Unknown\";\n\n s2 = s_copy & InputDevice.SOURCE_ANY; // keep source only, no class;\n\n if (Build.VERSION.SDK_INT >= 23) {\n tst = InputDevice.SOURCE_BLUETOOTH_STYLUS;\n if ((s & tst) == tst) src += \" BLUETOOTH_STYLUS\";\n s2 &= ~tst;\n }\n\n tst = InputDevice.SOURCE_DPAD;\n if ((s & tst) == tst) src += \" DPAD\";\n s2 &= ~tst;\n\n tst = InputDevice.SOURCE_GAMEPAD;\n if ((s & tst) == tst) src += \" GAMEPAD\";\n s2 &= ~tst;\n\n if (Build.VERSION.SDK_INT >= 21) {\n tst = InputDevice.SOURCE_HDMI;\n if ((s & tst) == tst) src += \" HDMI\";\n s2 &= ~tst;\n }\n\n tst = InputDevice.SOURCE_JOYSTICK;\n if ((s & tst) == tst) src += \" JOYSTICK\";\n s2 &= ~tst;\n\n tst = InputDevice.SOURCE_KEYBOARD;\n if ((s & tst) == tst) src += \" KEYBOARD\";\n s2 &= ~tst;\n\n tst = InputDevice.SOURCE_MOUSE;\n if ((s & tst) == tst) src += \" MOUSE\";\n s2 &= ~tst;\n\n if (Build.VERSION.SDK_INT >= 26) {\n tst = InputDevice.SOURCE_MOUSE_RELATIVE;\n if ((s & tst) == tst) src += \" MOUSE_RELATIVE\";\n s2 &= ~tst;\n\n tst = InputDevice.SOURCE_ROTARY_ENCODER;\n if ((s & tst) == tst) src += \" ROTARY_ENCODER\";\n s2 &= ~tst;\n }\n tst = InputDevice.SOURCE_STYLUS;\n if ((s & tst) == tst) src += \" STYLUS\";\n s2 &= ~tst;\n\n tst = InputDevice.SOURCE_TOUCHPAD;\n if ((s & tst) == tst) src += \" TOUCHPAD\";\n s2 &= ~tst;\n\n tst = InputDevice.SOURCE_TOUCHSCREEN;\n if ((s & tst) == tst) src += \" TOUCHSCREEN\";\n s2 &= ~tst;\n\n if (Build.VERSION.SDK_INT >= 18) {\n tst = InputDevice.SOURCE_TOUCH_NAVIGATION;\n if ((s & tst) == tst) src += \" TOUCH_NAVIGATION\";\n s2 &= ~tst;\n }\n\n tst = InputDevice.SOURCE_TRACKBALL;\n if ((s & tst) == tst) src += \" TRACKBALL\";\n s2 &= ~tst;\n\n tst = InputDevice.SOURCE_ANY;\n if ((s & tst) == tst) src += \" ANY\";\n s2 &= ~tst;\n\n if (s == FLAG_TAINTED) src += \" FLAG_TAINTED\";\n s2 &= ~FLAG_TAINTED;\n\n if (s2 != 0) src += \" Some_Unknown\";\n\n Log.v(TAG, prefix + \"int=\" + s_copy + \" CLASS={\" + cls + \" } source(s):\" + src);\n }\n*/\n\n public static boolean mIsResumedCalled, mHasFocus;\n public static final boolean mHasMultiWindow = (Build.VERSION.SDK_INT >= 24 /* Android 7.0 (N) */);\n\n // Cursor types\n // private static final int SDL_SYSTEM_CURSOR_NONE = -1;\n private static final int SDL_SYSTEM_CURSOR_ARROW = 0;\n private static final int SDL_SYSTEM_CURSOR_IBEAM = 1;\n private static final int SDL_SYSTEM_CURSOR_WAIT = 2;\n private static final int SDL_SYSTEM_CURSOR_CROSSHAIR = 3;\n private static final int SDL_SYSTEM_CURSOR_WAITARROW = 4;\n private static final int SDL_SYSTEM_CURSOR_SIZENWSE = 5;\n private static final int SDL_SYSTEM_CURSOR_SIZENESW = 6;\n private static final int SDL_SYSTEM_CURSOR_SIZEWE = 7;\n private static final int SDL_SYSTEM_CURSOR_SIZENS = 8;\n private static final int SDL_SYSTEM_CURSOR_SIZEALL = 9;\n private static final int SDL_SYSTEM_CURSOR_NO = 10;\n private static final int SDL_SYSTEM_CURSOR_HAND = 11;\n\n protected static final int SDL_ORIENTATION_UNKNOWN = 0;\n protected static final int SDL_ORIENTATION_LANDSCAPE = 1;\n protected static final int SDL_ORIENTATION_LANDSCAPE_FLIPPED = 2;\n protected static final int SDL_ORIENTATION_PORTRAIT = 3;\n protected static final int SDL_ORIENTATION_PORTRAIT_FLIPPED = 4;\n\n protected static int mCurrentOrientation;\n protected static Locale mCurrentLocale;\n\n // Handle the state of the native layer\n public enum NativeState {\n INIT, RESUMED, PAUSED\n }\n\n public static NativeState mNextNativeState;\n public static NativeState mCurrentNativeState;\n\n /** If shared libraries (e.g. SDL or the native application) could not be loaded. */\n public static boolean mBrokenLibraries = true;\n\n // Main components\n protected static SDLActivity mSingleton;\n protected static SDLSurface mSurface;\n protected static DummyEdit mTextEdit;\n protected static boolean mScreenKeyboardShown;\n protected static ViewGroup mLayout;\n protected static SDLClipboardHandler mClipboardHandler;\n protected static Hashtable mCursors;\n protected static int mLastCursorID;\n protected static SDLGenericMotionListener_API12 mMotionListener;\n protected static HIDDeviceManager mHIDDeviceManager;\n\n // This is what SDL runs in. It invokes SDL_main(), eventually\n protected static Thread mSDLThread;\n\n protected static SDLGenericMotionListener_API12 getMotionListener() {\n if (mMotionListener == null) {\n if (Build.VERSION.SDK_INT >= 26 /* Android 8.0 (O) */) {\n mMotionListener = new SDLGenericMotionListener_API26();\n } else if (Build.VERSION.SDK_INT >= 24 /* Android 7.0 (N) */) {\n mMotionListener = new SDLGenericMotionListener_API24();\n } else {\n mMotionListener = new SDLGenericMotionListener_API12();\n }\n }\n\n return mMotionListener;\n }\n\n /**\n * This method returns the name of the shared object with the application entry point\n * It can be overridden by derived classes.\n */\n protected String getMainSharedObject() {\n String library;\n String[] libraries = SDLActivity.mSingleton.getLibraries();\n if (libraries.length > 0) {\n library = \"lib\" + libraries[libraries.length - 1] + \".so\";\n } else {\n library = \"libmain.so\";\n }\n return getContext().getApplicationInfo().nativeLibraryDir + \"/\" + library;\n }\n\n /**\n * This method returns the name of the application entry point\n * It can be overridden by derived classes.\n */\n protected String getMainFunction() {\n return \"SDL_main\";\n }\n\n /**\n * This method is called by SDL before loading the native shared libraries.\n * It can be overridden to provide names of shared libraries to be loaded.\n * The default implementation returns the defaults. It never returns null.\n * An array returned by a new implementation must at least contain \"SDL2\".\n * Also keep in mind that the order the libraries are loaded may matter.\n * @return names of shared libraries to be loaded (e.g. \"SDL2\", \"main\").\n */\n protected String[] getLibraries() {\n return new String[] {\n \"SDL2\",\n // \"SDL2_image\",\n // \"SDL2_mixer\",\n // \"SDL2_net\",\n // \"SDL2_ttf\",\n \"main\"\n };\n }\n\n // Load the .so\n public void loadLibraries() {\n for (String lib : getLibraries()) {\n SDL.loadLibrary(lib, this);\n }\n }\n\n /**\n * This method is called by SDL before starting the native application thread.\n * It can be overridden to provide the arguments after the application name.\n * The default implementation returns an empty array. It never returns null.\n * @return arguments for the native application.\n */\n protected String[] getArguments() {\n return new String[0];\n }\n\n public static void initialize() {\n // The static nature of the singleton and Android quirkyness force us to initialize everything here\n // Otherwise, when exiting the app and returning to it, these variables *keep* their pre exit values\n mSingleton = null;\n mSurface = null;\n mTextEdit = null;\n mLayout = null;\n mClipboardHandler = null;\n mCursors = new Hashtable();\n mLastCursorID = 0;\n mSDLThread = null;\n mIsResumedCalled = false;\n mHasFocus = true;\n mNextNativeState = NativeState.INIT;\n mCurrentNativeState = NativeState.INIT;\n }\n \n protected SDLSurface createSDLSurface(Context context) {\n return new SDLSurface(context);\n }\n\n // Setup\n @Override\n protected void onCreate(Bundle savedInstanceState) {\n Log.v(TAG, \"Device: \" + Build.DEVICE);\n Log.v(TAG, \"Model: \" + Build.MODEL);\n Log.v(TAG, \"onCreate()\");\n super.onCreate(savedInstanceState);\n\n try {\n Thread.currentThread().setName(\"SDLActivity\");\n } catch (Exception e) {\n Log.v(TAG, \"modify thread properties failed \" + e.toString());\n }\n\n // Load shared libraries\n String errorMsgBrokenLib = \"\";\n try {\n loadLibraries();\n mBrokenLibraries = false; /* success */\n } catch(UnsatisfiedLinkError e) {\n System.err.println(e.getMessage());\n mBrokenLibraries = true;\n errorMsgBrokenLib = e.getMessage();\n } catch(Exception e) {\n System.err.println(e.getMessage());\n mBrokenLibraries = true;\n errorMsgBrokenLib = e.getMessage();\n }\n\n if (!mBrokenLibraries) {\n String expected_version = String.valueOf(SDL_MAJOR_VERSION) + \".\" +\n String.valueOf(SDL_MINOR_VERSION) + \".\" +\n String.valueOf(SDL_MICRO_VERSION);\n String version = nativeGetVersion();\n if (!version.equals(expected_version)) {\n mBrokenLibraries = true;\n errorMsgBrokenLib = \"SDL C/Java version mismatch (expected \" + expected_version + \", got \" + version + \")\";\n }\n }\n\n if (mBrokenLibraries) {\n mSingleton = this;\n AlertDialog.Builder dlgAlert = new AlertDialog.Builder(this);\n dlgAlert.setMessage(\"An error occurred while trying to start the application. Please try again and/or reinstall.\"\n + System.getProperty(\"line.separator\")\n + System.getProperty(\"line.separator\")\n + \"Error: \" + errorMsgBrokenLib);\n dlgAlert.setTitle(\"SDL Error\");\n dlgAlert.setPositiveButton(\"Exit\",\n new DialogInterface.OnClickListener() {\n @Override\n public void onClick(DialogInterface dialog,int id) {\n // if this button is clicked, close current activity\n SDLActivity.mSingleton.finish();\n }\n });\n dlgAlert.setCancelable(false);\n dlgAlert.create().show();\n\n return;\n }\n\n // Set up JNI\n SDL.setupJNI();\n\n // Initialize state\n SDL.initialize();\n\n // So we can call stuff from static callbacks\n mSingleton = this;\n SDL.setContext(this);\n\n mClipboardHandler = new SDLClipboardHandler();\n\n mHIDDeviceManager = HIDDeviceManager.acquire(this);\n\n // Set up the surface\n mSurface = createSDLSurface(this);\n\n mLayout = new RelativeLayout(this);\n mLayout.addView(mSurface);\n\n // Get our current screen orientation and pass it down.\n mCurrentOrientation = SDLActivity.getCurrentOrientation();\n // Only record current orientation\n SDLActivity.onNativeOrientationChanged(mCurrentOrientation);\n\n try {\n if (Build.VERSION.SDK_INT < 24 /* Android 7.0 (N) */) {\n mCurrentLocale = getContext().getResources().getConfiguration().locale;\n } else {\n mCurrentLocale = getContext().getResources().getConfiguration().getLocales().get(0);\n }\n } catch(Exception ignored) {\n }\n\n setContentView(mLayout);\n\n setWindowStyle(false);\n\n getWindow().getDecorView().setOnSystemUiVisibilityChangeListener(this);\n\n // Get filename from \"Open with\" of another application\n Intent intent = getIntent();\n if (intent != null && intent.getData() != null) {\n String filename = intent.getData().getPath();\n if (filename != null) {\n Log.v(TAG, \"Got filename: \" + filename);\n SDLActivity.onNativeDropFile(filename);\n }\n }\n }\n\n protected void pauseNativeThread() {\n mNextNativeState = NativeState.PAUSED;\n mIsResumedCalled = false;\n\n if (SDLActivity.mBrokenLibraries) {\n return;\n }\n\n SDLActivity.handleNativeState();\n }\n\n protected void resumeNativeThread() {\n mNextNativeState = NativeState.RESUMED;\n mIsResumedCalled = true;\n\n if (SDLActivity.mBrokenLibraries) {\n return;\n }\n\n SDLActivity.handleNativeState();\n }\n\n // Events\n @Override\n protected void onPause() {\n Log.v(TAG, \"onPause()\");\n super.onPause();\n\n if (mHIDDeviceManager != null) {\n mHIDDeviceManager.setFrozen(true);\n }\n if (!mHasMultiWindow) {\n pauseNativeThread();\n }\n }\n\n @Override\n protected void onResume() {\n Log.v(TAG, \"onResume()\");\n super.onResume();\n\n if (mHIDDeviceManager != null) {\n mHIDDeviceManager.setFrozen(false);\n }\n if (!mHasMultiWindow) {\n resumeNativeThread();\n }\n }\n\n @Override\n protected void onStop() {\n Log.v(TAG, \"onStop()\");\n super.onStop();\n if (mHasMultiWindow) {\n pauseNativeThread();\n }\n }\n\n @Override\n protected void onStart() {\n Log.v(TAG, \"onStart()\");\n super.onStart();\n if (mHasMultiWindow) {\n resumeNativeThread();\n }\n }\n\n public static int getCurrentOrientation() {\n int result = SDL_ORIENTATION_UNKNOWN;\n\n Activity activity = (Activity)getContext();\n if (activity == null) {\n return result;\n }\n Display display = activity.getWindowManager().getDefaultDisplay();\n\n switch (display.getRotation()) {\n case Surface.ROTATION_0:\n result = SDL_ORIENTATION_PORTRAIT;\n break;\n\n case Surface.ROTATION_90:\n result = SDL_ORIENTATION_LANDSCAPE;\n break;\n\n case Surface.ROTATION_180:\n result = SDL_ORIENTATION_PORTRAIT_FLIPPED;\n break;\n\n case Surface.ROTATION_270:\n result = SDL_ORIENTATION_LANDSCAPE_FLIPPED;\n break;\n }\n\n return result;\n }\n\n @Override\n public void onWindowFocusChanged(boolean hasFocus) {\n super.onWindowFocusChanged(hasFocus);\n Log.v(TAG, \"onWindowFocusChanged(): \" + hasFocus);\n\n if (SDLActivity.mBrokenLibraries) {\n return;\n }\n\n mHasFocus = hasFocus;\n if (hasFocus) {\n mNextNativeState = NativeState.RESUMED;\n SDLActivity.getMotionListener().reclaimRelativeMouseModeIfNeeded();\n\n SDLActivity.handleNativeState();\n nativeFocusChanged(true);\n\n } else {\n nativeFocusChanged(false);\n if (!mHasMultiWindow) {\n mNextNativeState = NativeState.PAUSED;\n SDLActivity.handleNativeState();\n }\n }\n }\n\n @Override\n public void onLowMemory() {\n Log.v(TAG, \"onLowMemory()\");\n super.onLowMemory();\n\n if (SDLActivity.mBrokenLibraries) {\n return;\n }\n\n SDLActivity.nativeLowMemory();\n }\n\n @Override\n public void onConfigurationChanged(Configuration newConfig) {\n Log.v(TAG, \"onConfigurationChanged()\");\n super.onConfigurationChanged(newConfig);\n\n if (SDLActivity.mBrokenLibraries) {\n return;\n }\n\n if (mCurrentLocale == null || !mCurrentLocale.equals(newConfig.locale)) {\n mCurrentLocale = newConfig.locale;\n SDLActivity.onNativeLocaleChanged();\n }\n }\n\n @Override\n protected void onDestroy() {\n Log.v(TAG, \"onDestroy()\");\n\n if (mHIDDeviceManager != null) {\n HIDDeviceManager.release(mHIDDeviceManager);\n mHIDDeviceManager = null;\n }\n\n SDLAudioManager.release(this);\n\n if (SDLActivity.mBrokenLibraries) {\n super.onDestroy();\n return;\n }\n\n if (SDLActivity.mSDLThread != null) {\n\n // Send Quit event to \"SDLThread\" thread\n SDLActivity.nativeSendQuit();\n\n // Wait for \"SDLThread\" thread to end\n try {\n SDLActivity.mSDLThread.join();\n } catch(Exception e) {\n Log.v(TAG, \"Problem stopping SDLThread: \" + e);\n }\n }\n\n SDLActivity.nativeQuit();\n\n super.onDestroy();\n }\n\n @Override\n public void onBackPressed() {\n // Check if we want to block the back button in case of mouse right click.\n //\n // If we do, the normal hardware back button will no longer work and people have to use home,\n // but the mouse right click will work.\n //\n boolean trapBack = SDLActivity.nativeGetHintBoolean(\"SDL_ANDROID_TRAP_BACK_BUTTON\", false);\n if (trapBack) {\n // Exit and let the mouse handler handle this button (if appropriate)\n return;\n }\n\n // Default system back button behavior.\n if (!isFinishing()) {\n super.onBackPressed();\n }\n }\n\n // Called by JNI from SDL.\n public static void manualBackButton() {\n mSingleton.pressBackButton();\n }\n\n // Used to get us onto the activity's main thread\n public void pressBackButton() {\n runOnUiThread(new Runnable() {\n @Override\n public void run() {\n if (!SDLActivity.this.isFinishing()) {\n SDLActivity.this.superOnBackPressed();\n }\n }\n });\n }\n\n // Used to access the system back behavior.\n public void superOnBackPressed() {\n super.onBackPressed();\n }\n\n @Override\n public boolean dispatchKeyEvent(KeyEvent event) {\n\n if (SDLActivity.mBrokenLibraries) {\n return false;\n }\n\n int keyCode = event.getKeyCode();\n // Ignore certain special keys so they're handled by Android\n if (keyCode == KeyEvent.KEYCODE_VOLUME_DOWN ||\n keyCode == KeyEvent.KEYCODE_VOLUME_UP ||\n keyCode == KeyEvent.KEYCODE_CAMERA ||\n keyCode == KeyEvent.KEYCODE_ZOOM_IN || /* API 11 */\n keyCode == KeyEvent.KEYCODE_ZOOM_OUT /* API 11 */\n ) {\n return false;\n }\n return super.dispatchKeyEvent(event);\n }\n\n /* Transition to next state */\n public static void handleNativeState() {\n\n if (mNextNativeState == mCurrentNativeState) {\n // Already in same state, discard.\n return;\n }\n\n // Try a transition to init state\n if (mNextNativeState == NativeState.INIT) {\n\n mCurrentNativeState = mNextNativeState;\n return;\n }\n\n // Try a transition to paused state\n if (mNextNativeState == NativeState.PAUSED) {\n if (mSDLThread != null) {\n nativePause();\n }\n if (mSurface != null) {\n mSurface.handlePause();\n }\n mCurrentNativeState = mNextNativeState;\n return;\n }\n\n // Try a transition to resumed state\n if (mNextNativeState == NativeState.RESUMED) {\n if (mSurface.mIsSurfaceReady && mHasFocus && mIsResumedCalled) {\n if (mSDLThread == null) {\n // This is the entry point to the C app.\n // Start up the C app thread and enable sensor input for the first time\n // FIXME: Why aren't we enabling sensor input at start?\n\n mSDLThread = new Thread(new SDLMain(), \"SDLThread\");\n mSurface.enableSensor(Sensor.TYPE_ACCELEROMETER, true);\n mSDLThread.start();\n\n // No nativeResume(), don't signal Android_ResumeSem\n } else {\n nativeResume();\n }\n mSurface.handleResume();\n\n mCurrentNativeState = mNextNativeState;\n }\n }\n }\n\n // Messages from the SDLMain thread\n static final int COMMAND_CHANGE_TITLE = 1;\n static final int COMMAND_CHANGE_WINDOW_STYLE = 2;\n static final int COMMAND_TEXTEDIT_HIDE = 3;\n static final int COMMAND_SET_KEEP_SCREEN_ON = 5;\n\n protected static final int COMMAND_USER = 0x8000;\n\n protected static boolean mFullscreenModeActive;\n\n /**\n * This method is called by SDL if SDL did not handle a message itself.\n * This happens if a received message contains an unsupported command.\n * Method can be overwritten to handle Messages in a different class.\n * @param command the command of the message.\n * @param param the parameter of the message. May be null.\n * @return if the message was handled in overridden method.\n */\n protected boolean onUnhandledMessage(int command, Object param) {\n return false;\n }\n\n /**\n * A Handler class for Messages from native SDL applications.\n * It uses current Activities as target (e.g. for the title).\n * static to prevent implicit references to enclosing object.\n */\n protected static class SDLCommandHandler extends Handler {\n @Override\n public void handleMessage(Message msg) {\n Context context = SDL.getContext();\n if (context == null) {\n Log.e(TAG, \"error handling message, getContext() returned null\");\n return;\n }\n switch (msg.arg1) {\n case COMMAND_CHANGE_TITLE:\n if (context instanceof Activity) {\n ((Activity) context).setTitle((String)msg.obj);\n } else {\n Log.e(TAG, \"error handling message, getContext() returned no Activity\");\n }\n break;\n case COMMAND_CHANGE_WINDOW_STYLE:\n if (Build.VERSION.SDK_INT >= 19 /* Android 4.4 (KITKAT) */) {\n if (context instanceof Activity) {\n Window window = ((Activity) context).getWindow();\n if (window != null) {\n if ((msg.obj instanceof Integer) && ((Integer) msg.obj != 0)) {\n int flags = View.SYSTEM_UI_FLAG_FULLSCREEN |\n View.SYSTEM_UI_FLAG_HIDE_NAVIGATION |\n View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY |\n View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN |\n View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION |\n View.SYSTEM_UI_FLAG_LAYOUT_STABLE | View.INVISIBLE;\n window.getDecorView().setSystemUiVisibility(flags);\n window.addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN);\n window.clearFlags(WindowManager.LayoutParams.FLAG_FORCE_NOT_FULLSCREEN);\n SDLActivity.mFullscreenModeActive = true;\n } else {\n int flags = View.SYSTEM_UI_FLAG_LAYOUT_STABLE | View.SYSTEM_UI_FLAG_VISIBLE;\n window.getDecorView().setSystemUiVisibility(flags);\n window.addFlags(WindowManager.LayoutParams.FLAG_FORCE_NOT_FULLSCREEN);\n window.clearFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN);\n SDLActivity.mFullscreenModeActive = false;\n }\n }\n } else {\n Log.e(TAG, \"error handling message, getContext() returned no Activity\");\n }\n }\n break;\n case COMMAND_TEXTEDIT_HIDE:\n if (mTextEdit != null) {\n // Note: On some devices setting view to GONE creates a flicker in landscape.\n // Setting the View's sizes to 0 is similar to GONE but without the flicker.\n // The sizes will be set to useful values when the keyboard is shown again.\n mTextEdit.setLayoutParams(new RelativeLayout.LayoutParams(0, 0));\n\n InputMethodManager imm = (InputMethodManager) context.getSystemService(Context.INPUT_METHOD_SERVICE);\n imm.hideSoftInputFromWindow(mTextEdit.getWindowToken(), 0);\n\n mScreenKeyboardShown = false;\n\n mSurface.requestFocus();\n }\n break;\n case COMMAND_SET_KEEP_SCREEN_ON:\n {\n if (context instanceof Activity) {\n Window window = ((Activity) context).getWindow();\n if (window != null) {\n if ((msg.obj instanceof Integer) && ((Integer) msg.obj != 0)) {\n window.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);\n } else {\n window.clearFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);\n }\n }\n }\n break;\n }\n default:\n if ((context instanceof SDLActivity) && !((SDLActivity) context).onUnhandledMessage(msg.arg1, msg.obj)) {\n Log.e(TAG, \"error handling message, command is \" + msg.arg1);\n }\n }\n }\n }\n\n // Handler for the messages\n Handler commandHandler = new SDLCommandHandler();\n\n // Send a message from the SDLMain thread\n boolean sendCommand(int command, Object data) {\n Message msg = commandHandler.obtainMessage();\n msg.arg1 = command;\n msg.obj = data;\n boolean result = commandHandler.sendMessage(msg);\n\n if (Build.VERSION.SDK_INT >= 19 /* Android 4.4 (KITKAT) */) {\n if (command == COMMAND_CHANGE_WINDOW_STYLE) {\n // Ensure we don't return until the resize has actually happened,\n // or 500ms have passed.\n\n boolean bShouldWait = false;\n\n if (data instanceof Integer) {\n // Let's figure out if we're already laid out fullscreen or not.\n Display display = ((WindowManager) getSystemService(Context.WINDOW_SERVICE)).getDefaultDisplay();\n DisplayMetrics realMetrics = new DisplayMetrics();\n display.getRealMetrics(realMetrics);\n\n boolean bFullscreenLayout = ((realMetrics.widthPixels == mSurface.getWidth()) &&\n (realMetrics.heightPixels == mSurface.getHeight()));\n\n if ((Integer) data == 1) {\n // If we aren't laid out fullscreen or actively in fullscreen mode already, we're going\n // to change size and should wait for surfaceChanged() before we return, so the size\n // is right back in native code. If we're already laid out fullscreen, though, we're\n // not going to change size even if we change decor modes, so we shouldn't wait for\n // surfaceChanged() -- which may not even happen -- and should return immediately.\n bShouldWait = !bFullscreenLayout;\n } else {\n // If we're laid out fullscreen (even if the status bar and nav bar are present),\n // or are actively in fullscreen, we're going to change size and should wait for\n // surfaceChanged before we return, so the size is right back in native code.\n bShouldWait = bFullscreenLayout;\n }\n }\n\n if (bShouldWait && (SDLActivity.getContext() != null)) {\n // We'll wait for the surfaceChanged() method, which will notify us\n // when called. That way, we know our current size is really the\n // size we need, instead of grabbing a size that's still got\n // the navigation and/or status bars before they're hidden.\n //\n // We'll wait for up to half a second, because some devices\n // take a surprisingly long time for the surface resize, but\n // then we'll just give up and return.\n //\n synchronized (SDLActivity.getContext()) {\n try {\n SDLActivity.getContext().wait(500);\n } catch (InterruptedException ie) {\n ie.printStackTrace();\n }\n }\n }\n }\n }\n\n return result;\n }\n\n // C functions we call\n public static native String nativeGetVersion();\n public static native int nativeSetupJNI();\n public static native int nativeRunMain(String library, String function, Object arguments);\n public static native void nativeLowMemory();\n public static native void nativeSendQuit();\n public static native void nativeQuit();\n public static native void nativePause();\n public static native void nativeResume();\n public static native void nativeFocusChanged(boolean hasFocus);\n public static native void onNativeDropFile(String filename);\n public static native void nativeSetScreenResolution(int surfaceWidth, int surfaceHeight, int deviceWidth, int deviceHeight, float rate);\n public static native void onNativeResize();\n public static native void onNativeKeyDown(int keycode);\n public static native void onNativeKeyUp(int keycode);\n public static native boolean onNativeSoftReturnKey();\n public static native void onNativeKeyboardFocusLost();\n public static native void onNativeMouse(int button, int action, float x, float y, boolean relative);\n public static native void onNativeTouch(int touchDevId, int pointerFingerId,\n int action, float x,\n float y, float p);\n public static native void onNativeAccel(float x, float y, float z);\n public static native void onNativeClipboardChanged();\n public static native void onNativeSurfaceCreated();\n public static native void onNativeSurfaceChanged();\n public static native void onNativeSurfaceDestroyed();\n public static native String nativeGetHint(String name);\n public static native boolean nativeGetHintBoolean(String name, boolean default_value);\n public static native void nativeSetenv(String name, String value);\n public static native void onNativeOrientationChanged(int orientation);\n public static native void nativeAddTouch(int touchId, String name);\n public static native void nativePermissionResult(int requestCode, boolean result);\n public static native void onNativeLocaleChanged();\n\n /**\n * This method is called by SDL using JNI.\n */\n public static boolean setActivityTitle(String title) {\n // Called from SDLMain() thread and can't directly affect the view\n return mSingleton.sendCommand(COMMAND_CHANGE_TITLE, title);\n }\n\n /**\n * This method is called by SDL using JNI.\n */\n public static void setWindowStyle(boolean fullscreen) {\n // Called from SDLMain() thread and can't directly affect the view\n mSingleton.sendCommand(COMMAND_CHANGE_WINDOW_STYLE, fullscreen ? 1 : 0);\n }\n\n /**\n * This method is called by SDL using JNI.\n * This is a static method for JNI convenience, it calls a non-static method\n * so that is can be overridden\n */\n public static void setOrientation(int w, int h, boolean resizable, String hint)\n {\n if (mSingleton != null) {\n mSingleton.setOrientationBis(w, h, resizable, hint);\n }\n }\n\n /**\n * This can be overridden\n */\n public void setOrientationBis(int w, int h, boolean resizable, String hint)\n {\n int orientation_landscape = -1;\n int orientation_portrait = -1;\n\n /* If set, hint \"explicitly controls which UI orientations are allowed\". */\n if (hint.contains(\"LandscapeRight\") && hint.contains(\"LandscapeLeft\")) {\n orientation_landscape = ActivityInfo.SCREEN_ORIENTATION_SENSOR_LANDSCAPE;\n } else if (hint.contains(\"LandscapeLeft\")) {\n orientation_landscape = ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE;\n } else if (hint.contains(\"LandscapeRight\")) {\n orientation_landscape = ActivityInfo.SCREEN_ORIENTATION_REVERSE_LANDSCAPE;\n }\n\n /* exact match to 'Portrait' to distinguish with PortraitUpsideDown */\n boolean contains_Portrait = hint.contains(\"Portrait \") || hint.endsWith(\"Portrait\");\n\n if (contains_Portrait && hint.contains(\"PortraitUpsideDown\")) {\n orientation_portrait = ActivityInfo.SCREEN_ORIENTATION_SENSOR_PORTRAIT;\n } else if (contains_Portrait) {\n orientation_portrait = ActivityInfo.SCREEN_ORIENTATION_PORTRAIT;\n } else if (hint.contains(\"PortraitUpsideDown\")) {\n orientation_portrait = ActivityInfo.SCREEN_ORIENTATION_REVERSE_PORTRAIT;\n }\n\n boolean is_landscape_allowed = (orientation_landscape != -1);\n boolean is_portrait_allowed = (orientation_portrait != -1);\n int req; /* Requested orientation */\n\n /* No valid hint, nothing is explicitly allowed */\n if (!is_portrait_allowed && !is_landscape_allowed) {\n if (resizable) {\n /* All orientations are allowed, respecting user orientation lock setting */\n req = ActivityInfo.SCREEN_ORIENTATION_FULL_USER;\n } else {\n /* Fixed window and nothing specified. Get orientation from w/h of created window */\n req = (w > h ? ActivityInfo.SCREEN_ORIENTATION_SENSOR_LANDSCAPE : ActivityInfo.SCREEN_ORIENTATION_SENSOR_PORTRAIT);\n }\n } else {\n /* At least one orientation is allowed */\n if (resizable) {\n if (is_portrait_allowed && is_landscape_allowed) {\n /* hint allows both landscape and portrait, promote to full user */\n req = ActivityInfo.SCREEN_ORIENTATION_FULL_USER;\n } else {\n /* Use the only one allowed \"orientation\" */\n req = (is_landscape_allowed ? orientation_landscape : orientation_portrait);\n }\n } else {\n /* Fixed window and both orientations are allowed. Choose one. */\n if (is_portrait_allowed && is_landscape_allowed) {\n req = (w > h ? orientation_landscape : orientation_portrait);\n } else {\n /* Use the only one allowed \"orientation\" */\n req = (is_landscape_allowed ? orientation_landscape : orientation_portrait);\n }\n }\n }\n\n Log.v(TAG, \"setOrientation() requestedOrientation=\" + req + \" width=\" + w +\" height=\"+ h +\" resizable=\" + resizable + \" hint=\" + hint);\n mSingleton.setRequestedOrientation(req);\n }\n\n /**\n * This method is called by SDL using JNI.\n */\n public static void minimizeWindow() {\n\n if (mSingleton == null) {\n return;\n }\n\n Intent startMain = new Intent(Intent.ACTION_MAIN);\n startMain.addCategory(Intent.CATEGORY_HOME);\n startMain.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);\n mSingleton.startActivity(startMain);\n }\n\n /**\n * This method is called by SDL using JNI.\n */\n public static boolean shouldMinimizeOnFocusLoss() {\n/*\n if (Build.VERSION.SDK_INT >= 24) {\n if (mSingleton == null) {\n return true;\n }\n\n if (mSingleton.isInMultiWindowMode()) {\n return false;\n }\n\n if (mSingleton.isInPictureInPictureMode()) {\n return false;\n }\n }\n\n return true;\n*/\n return false;\n }\n\n /**\n * This method is called by SDL using JNI.\n */\n public static boolean isScreenKeyboardShown()\n {\n if (mTextEdit == null) {\n return false;\n }\n\n if (!mScreenKeyboardShown) {\n return false;\n }\n\n InputMethodManager imm = (InputMethodManager) SDL.getContext().getSystemService(Context.INPUT_METHOD_SERVICE);\n return imm.isAcceptingText();\n\n }\n\n /**\n * This method is called by SDL using JNI.\n */\n public static boolean supportsRelativeMouse()\n {\n // DeX mode in Samsung Experience 9.0 and earlier doesn't support relative mice properly under\n // Android 7 APIs, and simply returns no data under Android 8 APIs.\n //\n // This is fixed in Samsung Experience 9.5, which corresponds to Android 8.1.0, and\n // thus SDK version 27. If we are in DeX mode and not API 27 or higher, as a result,\n // we should stick to relative mode.\n //\n if (Build.VERSION.SDK_INT < 27 /* Android 8.1 (O_MR1) */ && isDeXMode()) {\n return false;\n }\n\n return SDLActivity.getMotionListener().supportsRelativeMouse();\n }\n\n /**\n * This method is called by SDL using JNI.\n */\n public static boolean setRelativeMouseEnabled(boolean enabled)\n {\n if (enabled && !supportsRelativeMouse()) {\n return false;\n }\n\n return SDLActivity.getMotionListener().setRelativeMouseEnabled(enabled);\n }\n\n /**\n * This method is called by SDL using JNI.\n */\n public static boolean sendMessage(int command, int param) {\n if (mSingleton == null) {\n return false;\n }\n return mSingleton.sendCommand(command, param);\n }\n\n /**\n * This method is called by SDL using JNI.\n */\n public static Context getContext() {\n return SDL.getContext();\n }\n\n /**\n * This method is called by SDL using JNI.\n */\n public static boolean isAndroidTV() {\n UiModeManager uiModeManager = (UiModeManager) getContext().getSystemService(UI_MODE_SERVICE);\n if (uiModeManager.getCurrentModeType() == Configuration.UI_MODE_TYPE_TELEVISION) {\n return true;\n }\n if (Build.MANUFACTURER.equals(\"MINIX\") && Build.MODEL.equals(\"NEO-U1\")) {\n return true;\n }\n if (Build.MANUFACTURER.equals(\"Amlogic\") && Build.MODEL.equals(\"X96-W\")) {\n return true;\n }\n return Build.MANUFACTURER.equals(\"Amlogic\") && Build.MODEL.startsWith(\"TV\");\n }\n\n public static double getDiagonal()\n {\n DisplayMetrics metrics = new DisplayMetrics();\n Activity activity = (Activity)getContext();\n if (activity == null) {\n return 0.0;\n }\n activity.getWindowManager().getDefaultDisplay().getMetrics(metrics);\n\n double dWidthInches = metrics.widthPixels / (double)metrics.xdpi;\n double dHeightInches = metrics.heightPixels / (double)metrics.ydpi;\n\n return Math.sqrt((dWidthInches * dWidthInches) + (dHeightInches * dHeightInches));\n }\n\n /**\n * This method is called by SDL using JNI.\n */\n public static boolean isTablet() {\n // If our diagonal size is seven inches or greater, we consider ourselves a tablet.\n return (getDiagonal() >= 7.0);\n }\n\n /**\n * This method is called by SDL using JNI.\n */\n public static boolean isChromebook() {\n if (getContext() == null) {\n return false;\n }\n return getContext().getPackageManager().hasSystemFeature(\"org.chromium.arc.device_management\");\n }\n\n /**\n * This method is called by SDL using JNI.\n */\n public static boolean isDeXMode() {\n if (Build.VERSION.SDK_INT < 24 /* Android 7.0 (N) */) {\n return false;\n }\n try {\n final Configuration config = getContext().getResources().getConfiguration();\n final Class configClass = config.getClass();\n return configClass.getField(\"SEM_DESKTOP_MODE_ENABLED\").getInt(configClass)\n == configClass.getField(\"semDesktopModeEnabled\").getInt(config);\n } catch(Exception ignored) {\n return false;\n }\n }\n\n /**\n * This method is called by SDL using JNI.\n */\n public static DisplayMetrics getDisplayDPI() {\n return getContext().getResources().getDisplayMetrics();\n }\n\n /**\n * This method is called by SDL using JNI.\n */\n public static boolean getManifestEnvironmentVariables() {\n try {\n if (getContext() == null) {\n return false;\n }\n\n ApplicationInfo applicationInfo = getContext().getPackageManager().getApplicationInfo(getContext().getPackageName(), PackageManager.GET_META_DATA);\n Bundle bundle = applicationInfo.metaData;\n if (bundle == null) {\n return false;\n }\n String prefix = \"SDL_ENV.\";\n final int trimLength = prefix.length();\n for (String key : bundle.keySet()) {\n if (key.startsWith(prefix)) {\n String name = key.substring(trimLength);\n String value = bundle.get(key).toString();\n nativeSetenv(name, value);\n }\n }\n /* environment variables set! */\n return true;\n } catch (Exception e) {\n Log.v(TAG, \"exception \" + e.toString());\n }\n return false;\n }\n\n // This method is called by SDLControllerManager's API 26 Generic Motion Handler.\n public static View getContentView() {\n return mLayout;\n }\n\n static class ShowTextInputTask implements Runnable {\n /*\n * This is used to regulate the pan&scan method to have some offset from\n * the bottom edge of the input region and the top edge of an input\n * method (soft keyboard)\n */\n static final int HEIGHT_PADDING = 15;\n\n public int x, y, w, h;\n\n public ShowTextInputTask(int x, int y, int w, int h) {\n this.x = x;\n this.y = y;\n this.w = w;\n this.h = h;\n\n /* Minimum size of 1 pixel, so it takes focus. */\n if (this.w <= 0) {\n this.w = 1;\n }\n if (this.h + HEIGHT_PADDING <= 0) {\n this.h = 1 - HEIGHT_PADDING;\n }\n }\n\n @Override\n public void run() {\n RelativeLayout.LayoutParams params = new RelativeLayout.LayoutParams(w, h + HEIGHT_PADDING);\n params.leftMargin = x;\n params.topMargin = y;\n\n if (mTextEdit == null) {\n mTextEdit = new DummyEdit(SDL.getContext());\n\n mLayout.addView(mTextEdit, params);\n } else {\n mTextEdit.setLayoutParams(params);\n }\n\n mTextEdit.setVisibility(View.VISIBLE);\n mTextEdit.requestFocus();\n\n InputMethodManager imm = (InputMethodManager) SDL.getContext().getSystemService(Context.INPUT_METHOD_SERVICE);\n imm.showSoftInput(mTextEdit, 0);\n\n mScreenKeyboardShown = true;\n }\n }\n\n /**\n * This method is called by SDL using JNI.\n */\n public static boolean showTextInput(int x, int y, int w, int h) {\n // Transfer the task to the main thread as a Runnable\n return mSingleton.commandHandler.post(new ShowTextInputTask(x, y, w, h));\n }\n\n public static boolean isTextInputEvent(KeyEvent event) {\n\n // Key pressed with Ctrl should be sent as SDL_KEYDOWN/SDL_KEYUP and not SDL_TEXTINPUT\n if (event.isCtrlPressed()) {\n return false;\n }\n\n return event.isPrintingKey() || event.getKeyCode() == KeyEvent.KEYCODE_SPACE;\n }\n\n public static boolean handleKeyEvent(View v, int keyCode, KeyEvent event, InputConnection ic) {\n int deviceId = event.getDeviceId();\n int source = event.getSource();\n\n if (source == InputDevice.SOURCE_UNKNOWN) {\n InputDevice device = InputDevice.getDevice(deviceId);\n if (device != null) {\n source = device.getSources();\n }\n }\n\n// if (event.getAction() == KeyEvent.ACTION_DOWN) {\n// Log.v(\"SDL\", \"key down: \" + keyCode + \", deviceId = \" + deviceId + \", source = \" + source);\n// } else if (event.getAction() == KeyEvent.ACTION_UP) {\n// Log.v(\"SDL\", \"key up: \" + keyCode + \", deviceId = \" + deviceId + \", source = \" + source);\n// }\n\n // Dispatch the different events depending on where they come from\n // Some SOURCE_JOYSTICK, SOURCE_DPAD or SOURCE_GAMEPAD are also SOURCE_KEYBOARD\n // So, we try to process them as JOYSTICK/DPAD/GAMEPAD events first, if that fails we try them as KEYBOARD\n //\n // Furthermore, it's possible a game controller has SOURCE_KEYBOARD and\n // SOURCE_JOYSTICK, while its key events arrive from the keyboard source\n // So, retrieve the device itself and check all of its sources\n if (SDLControllerManager.isDeviceSDLJoystick(deviceId)) {\n // Note that we process events with specific key codes here\n if (event.getAction() == KeyEvent.ACTION_DOWN) {\n if (SDLControllerManager.onNativePadDown(deviceId, keyCode) == 0) {\n return true;\n }\n } else if (event.getAction() == KeyEvent.ACTION_UP) {\n if (SDLControllerManager.onNativePadUp(deviceId, keyCode) == 0) {\n return true;\n }\n }\n }\n\n if ((source & InputDevice.SOURCE_MOUSE) == InputDevice.SOURCE_MOUSE) {\n // on some devices key events are sent for mouse BUTTON_BACK/FORWARD presses\n // they are ignored here because sending them as mouse input to SDL is messy\n if ((keyCode == KeyEvent.KEYCODE_BACK) || (keyCode == KeyEvent.KEYCODE_FORWARD)) {\n switch (event.getAction()) {\n case KeyEvent.ACTION_DOWN:\n case KeyEvent.ACTION_UP:\n // mark the event as handled or it will be handled by system\n // handling KEYCODE_BACK by system will call onBackPressed()\n return true;\n }\n }\n }\n\n if (event.getAction() == KeyEvent.ACTION_DOWN) {\n if (isTextInputEvent(event)) {\n if (ic != null) {\n ic.commitText(String.valueOf((char) event.getUnicodeChar()), 1);\n } else {\n SDLInputConnection.nativeCommitText(String.valueOf((char) event.getUnicodeChar()), 1);\n }\n }\n onNativeKeyDown(keyCode);\n return true;\n } else if (event.getAction() == KeyEvent.ACTION_UP) {\n onNativeKeyUp(keyCode);\n return true;\n }\n\n return false;\n }\n\n /**\n * This method is called by SDL using JNI.\n */\n public static Surface getNativeSurface() {\n if (SDLActivity.mSurface == null) {\n return null;\n }\n return SDLActivity.mSurface.getNativeSurface();\n }\n\n // Input\n\n /**\n * This method is called by SDL using JNI.\n */\n public static void initTouch() {\n int[] ids = InputDevice.getDeviceIds();\n\n for (int id : ids) {\n InputDevice device = InputDevice.getDevice(id);\n /* Allow SOURCE_TOUCHSCREEN and also Virtual InputDevices because they can send TOUCHSCREEN events */\n if (device != null && ((device.getSources() & InputDevice.SOURCE_TOUCHSCREEN) == InputDevice.SOURCE_TOUCHSCREEN\n || device.isVirtual())) {\n\n int touchDevId = device.getId();\n /*\n * Prevent id to be -1, since it's used in SDL internal for synthetic events\n * Appears when using Android emulator, eg:\n * adb shell input mouse tap 100 100\n * adb shell input touchscreen tap 100 100\n */\n if (touchDevId < 0) {\n touchDevId -= 1;\n }\n nativeAddTouch(touchDevId, device.getName());\n }\n }\n }\n\n // Messagebox\n\n /** Result of current messagebox. Also used for blocking the calling thread. */\n protected final int[] messageboxSelection = new int[1];\n\n /**\n * This method is called by SDL using JNI.\n * Shows the messagebox from UI thread and block calling thread.\n * buttonFlags, buttonIds and buttonTexts must have same length.\n * @param buttonFlags array containing flags for every button.\n * @param buttonIds array containing id for every button.\n * @param buttonTexts array containing text for every button.\n * @param colors null for default or array of length 5 containing colors.\n * @return button id or -1.\n */\n public int messageboxShowMessageBox(\n final int flags,\n final String title,\n final String message,\n final int[] buttonFlags,\n final int[] buttonIds,\n final String[] buttonTexts,\n final int[] colors) {\n\n messageboxSelection[0] = -1;\n\n // sanity checks\n\n if ((buttonFlags.length != buttonIds.length) && (buttonIds.length != buttonTexts.length)) {\n return -1; // implementation broken\n }\n\n // collect arguments for Dialog\n\n final Bundle args = new Bundle();\n args.putInt(\"flags\", flags);\n args.putString(\"title\", title);\n args.putString(\"message\", message);\n args.putIntArray(\"buttonFlags\", buttonFlags);\n args.putIntArray(\"buttonIds\", buttonIds);\n args.putStringArray(\"buttonTexts\", buttonTexts);\n args.putIntArray(\"colors\", colors);\n\n // trigger Dialog creation on UI thread\n\n runOnUiThread(new Runnable() {\n @Override\n public void run() {\n messageboxCreateAndShow(args);\n }\n });\n\n // block the calling thread\n\n synchronized (messageboxSelection) {\n try {\n messageboxSelection.wait();\n } catch (InterruptedException ex) {\n ex.printStackTrace();\n return -1;\n }\n }\n\n // return selected value\n\n return messageboxSelection[0];\n }\n\n protected void messageboxCreateAndShow(Bundle args) {\n\n // TODO set values from \"flags\" to messagebox dialog\n\n // get colors\n\n int[] colors = args.getIntArray(\"colors\");\n int backgroundColor;\n int textColor;\n int buttonBorderColor;\n int buttonBackgroundColor;\n int buttonSelectedColor;\n if (colors != null) {\n int i = -1;\n backgroundColor = colors[++i];\n textColor = colors[++i];\n buttonBorderColor = colors[++i];\n buttonBackgroundColor = colors[++i];\n buttonSelectedColor = colors[++i];\n } else {\n backgroundColor = Color.TRANSPARENT;\n textColor = Color.TRANSPARENT;\n buttonBorderColor = Color.TRANSPARENT;\n buttonBackgroundColor = Color.TRANSPARENT;\n buttonSelectedColor = Color.TRANSPARENT;\n }\n\n // create dialog with title and a listener to wake up calling thread\n\n final AlertDialog dialog = new AlertDialog.Builder(this).create();\n dialog.setTitle(args.getString(\"title\"));\n dialog.setCancelable(false);\n dialog.setOnDismissListener(new DialogInterface.OnDismissListener() {\n @Override\n public void onDismiss(DialogInterface unused) {\n synchronized (messageboxSelection) {\n messageboxSelection.notify();\n }\n }\n });\n\n // create text\n\n TextView message = new TextView(this);\n message.setGravity(Gravity.CENTER);\n message.setText(args.getString(\"message\"));\n if (textColor != Color.TRANSPARENT) {\n message.setTextColor(textColor);\n }\n\n // create buttons\n\n int[] buttonFlags = args.getIntArray(\"buttonFlags\");\n int[] buttonIds = args.getIntArray(\"buttonIds\");\n String[] buttonTexts = args.getStringArray(\"buttonTexts\");\n\n final SparseArray