web port (#82)

* web port

a few misc changes were made to the core and other frontends

core:
- audio callback now requires a buffer to be set for the samples to be written to.
  this is much more optimal than spamming the audio callback and pushing 2 samples at a
  time to the sdl_audio_stream.

frontend:
- added the layer viewer back to imgui frontend, there's some UB involved though, see the comments!
- added a sdl2 base which sdl2 frontends will inherit from. not really sure if this was a good idea or not
- sdl2 frontend implements my hacky audio catch-up thing (idk what to name it) where it will tick the core
  if not enough samples are generated.
- zlib/minizip is now linked publically in the frontend_base. i don't like having to do this, but its due
  to a bug in emsdk with std::filesystem::directory_iterator() with -pthread linked. the wasm32-ld will have
  a meltdown ad fail to link. only work around is to enable lto and to use directory_iterator in the exe
  file.
  i haven't yet reported the bug.

.gitignore

@@ -19,3 +19,5 @@ imgui.ini
 CMakeUserPresets.json
 rtc.md
 n64-emu
+deploy_netlify.yml
+deploy_pages.yml

CMakeLists.txt

@@ -1,5 +1,37 @@
 cmake_minimum_required(VERSION 3.20.0)
 
+if (VCPKG)
+    # checks the documented env variable for vcpkg
+    if (DEFINED ENV{VCPKG_ROOT} AND EXISTS $ENV{VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake)
+        message(STATUS "found VCPKG_ROOT, using system installed vcpkg at: $ENV{VCPKG_ROOT}")
+        set(vcpkg_toolchain_file $ENV{VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake)
+
+    # this checks for github actions installed vcpkg
+    elseif (DEFINED ENV{VCPKG_INSTALLATION_ROOT} AND EXISTS $ENV{VCPKG_INSTALLATION_ROOT}/scripts/buildsystems/vcpkg.cmake)
+        message(STATUS "found VCPKG_INSTALLATION_ROOT, using system installed vcpkg at: $ENV{VCPKG_INSTALLATION_ROOT}")
+        set(vcpkg_toolchain_file $ENV{VCPKG_INSTALLATION_ROOT}/scripts/buildsystems/vcpkg.cmake)
+
+    # fallback to fetching latest vcpkg from git
+    else()
+        message(STATUS "installing latest vcpkg from git root: $ENV{VCPKG_ROOT} insta: $ENV{VCPKG_INSTALLATION_ROOT}")
+
+        include(FetchContent)
+        FetchContent_Declare(vcpkg GIT_REPOSITORY https://github.com/microsoft/vcpkg.git)
+        FetchContent_MakeAvailable(vcpkg)
+
+        set(vcpkg_toolchain_file ${vcpkg_SOURCE_DIR}/scripts/buildsystems/vcpkg.cmake)
+    endif()
+
+    # if this was already set, then we need to chainload the toolchain file
+    # vcpkg offers support for this, which basically does include(toolchain)
+    # need to make sure that we don't chainload our own toolchain file!
+    if (CMAKE_TOOLCHAIN_FILE AND NOT ${CMAKE_TOOLCHAIN_FILE} STREQUAL ${vcpkg_toolchain_file})
+        set(VCPKG_CHAINLOAD_TOOLCHAIN_FILE ${CMAKE_TOOLCHAIN_FILE})
+    endif()
+
+    set(CMAKE_TOOLCHAIN_FILE ${vcpkg_toolchain_file})
+endif()
+
 project(notorious_beeg
     VERSION 0.0.3
     DESCRIPTION "GBA emulator written in c++23"

CMakePresets.json

@@ -29,23 +29,17 @@
         {
             "name": "vcpkg",
             "displayName": "vcpkg",
-            "binaryDir": "${sourceDir}/build/${presetName}",
-            "toolchainFile": "$env{VCPKG_INSTALLATION_ROOT}/scripts/buildsystems/vcpkg.cmake",
+            "inherits": ["imgui"],
             "cacheVariables": {
-                "CMAKE_BUILD_TYPE": "Release",
-                "SINGLE_FILE": true,
-                "IMGUI": true
+                "VCPKG": true
             }
         },
         {
             "name": "vcpkg-dev",
             "displayName": "vcpkg-dev",
-            "binaryDir": "${sourceDir}/build/${presetName}",
-            "toolchainFile": "$env{VCPKG_INSTALLATION_ROOT}/scripts/buildsystems/vcpkg.cmake",
+            "inherits": ["imgui-dev"],
             "cacheVariables": {
-                "CMAKE_BUILD_TYPE": "Debug",
-                "GBA_DEV": true,
-                "IMGUI": true
+                "VCPKG": true
             }
         },
         {
@@ -90,6 +84,26 @@
                 "GBA_DEV": true,
                 "SDL2": true
             }
+        },
+        {
+            "name": "emsdk",
+            "displayName": "emsdk",
+            "binaryDir": "${sourceDir}/build/${presetName}",
+            "toolchainFile": "$env{EMSDK}/upstream/emscripten/cmake/Modules/Platform/Emscripten.cmake",
+            "cacheVariables": {
+                "CMAKE_BUILD_TYPE": "Release",
+                "SINGLE_FILE": true
+            }
+        },
+        {
+            "name": "emsdk-dev",
+            "displayName": "emsdk-dev",
+            "binaryDir": "${sourceDir}/build/${presetName}",
+            "toolchainFile": "$env{EMSDK}/upstream/emscripten/cmake/Modules/Platform/Emscripten.cmake",
+            "cacheVariables": {
+                "CMAKE_BUILD_TYPE": "Debug",
+                "EMRUN": true
+            }
         }
     ],
     "buildPresets": [
@@ -124,6 +138,14 @@
         {
             "name": "vcpkg-sdl2-dev",
             "configurePreset": "vcpkg-sdl2-dev"
+        },
+        {
+            "name": "emsdk",
+            "configurePreset": "emsdk"
+        },
+        {
+            "name": "emsdk-dev",
+            "configurePreset": "emsdk-dev"
         }
     ]
 }

README.md

@@ -3,6 +3,18 @@ v0.0.3-dev
 
 gba emulator witten in c++23.
 
+[![Netlify Status](https://api.netlify.com/api/v1/badges/bfd72dd6-557d-41a3-87ac-480c686624a2/deploy-status)](https://app.netlify.com/sites/notorious-beeg/deploys)
+
+---
+
+## web builds
+
+web builds are the easiest way to quickly test a game. builds are automatically built from master. please report any bugs you find, giving as much info as possible such as browser, os, game etc.
+
+gh-pages version doesn't support threads / mutexs. may crash.
+
+netlify version supports threads / mutexes, won't crash.
+
 ---
 
 ## changelog
@@ -198,3 +210,4 @@ gba emulator witten in c++23.
 - xproger for openlara (fixed several bugs in my emu) <https://github.com/XProger/OpenLara>
 - zayd for info on rtc <https://beanmachine.alt.icu/post/rtc/>
 - pokeemerald for a being a good reference <https://github.com/pret/pokeemerald>
+- kenney for the onscreen control buttons <https://www.kenney.nl/assets/onscreen-controls>

assets/buttons/license.txt

@@ -0,0 +1,14 @@
+
+###############################################################################
+
+	Onscreen Controls by Kenney Vleugels (www.kenney.nl)
+
+	------------------------------
+
+		License (CC0)
+	http://creativecommons.org/publicdomain/zero/1.0/
+
+	You may use these graphics in personal and commercial projects.
+	Credit (Kenney or www.kenney.nl) would be nice but is not mandatory.
+
+###############################################################################

assets/web/README.md

@@ -0,0 +1,25 @@
+# Your Favicon Package
+
+This package was generated with [RealFaviconGenerator](https://realfavicongenerator.net/) [v0.16](https://realfavicongenerator.net/change_log#v0.16)
+
+## Install instructions
+
+To install this package:
+
+Extract this package in the root of your web site. If your site is <code>http://www.example.com</code>, you should be able to access a file named <code>http://www.example.com/favicon.ico</code>.
+
+Insert the following code in the `head` section of your pages:
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">
+    <link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png">
+    <link rel="icon" type="image/png" sizes="192x192" href="/android-chrome-192x192.png">
+    <link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png">
+    <link rel="manifest" href="/site.webmanifest">
+    <link rel="mask-icon" href="/safari-pinned-tab.svg" color="#0075c0">
+    <meta name="apple-mobile-web-app-title" content="TotalGBA">
+    <meta name="application-name" content="TotalGBA">
+    <meta name="msapplication-TileColor" content="#0075c0">
+    <meta name="msapplication-TileImage" content="/mstile-144x144.png">
+    <meta name="theme-color" content="#ffffff">
+
+*Optional* - Check your favicon with the [favicon checker](https://realfavicongenerator.net/favicon_checker)

assets/web/browserconfig.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<browserconfig>
+    <msapplication>
+        <tile>
+            <square150x150logo src="/mstile-150x150.png"/>
+            <square310x310logo src="/mstile-310x310.png"/>
+            <TileColor>#0075c0</TileColor>
+        </tile>
+    </msapplication>
+</browserconfig>