chore(release): publish packages

- thermion_dart@0.3.0
 - thermion_flutter@0.3.0
 - thermion_flutter_method_channel@0.3.0
 - thermion_flutter_web@0.3.0
 - thermion_flutter_platform_interface@0.3.0

.github/actions/setup-build-env/action.yml

@@ -0,0 +1,29 @@
+name: 'Setup Build Environment'
+description: 'Set up LLVM, MESA, and Flutter for builds'
+runs:
+  using: 'composite'
+  steps:
+    - uses: actions/checkout@v4
+    - name: Setup LLVM
+      uses: KyleMayes/install-llvm-action@v1
+      with:
+        version: "16"
+    - name: Add LLVM to PATH
+      shell: bash
+      run: |
+        echo "${{ github.workspace }}/llvm/bin" >> $GITHUB_PATH
+        echo "LD_LIBRARY_PATH=${{ github.workspace }}/llvm/lib/x86_64-unknown-linux-gnu/" >> $GITHUB_ENV
+    - name: Verify installation
+      shell: bash
+      run: clang --version
+    - name: Install MESA
+      shell: bash
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y xvfb
+        sudo apt-get install -y libosmesa6-dev
+    - name: Set up Flutter
+      uses: subosito/flutter-action@v2
+      with:
+        channel: master
+        architecture: X64

.github/workflows/dart.yml

@@ -1,7 +1,3 @@
-# This workflow uses actions that are not certified by GitHub.
-# They are provided by a third-party and are governed by
-# separate terms of service, privacy policy, and support
-# documentation.
 name: Dart
 
 on:
@@ -11,72 +7,164 @@ on:
     branches: [ "develop" ]
 
 jobs:
-  thermion_dart:
-    name: thermion_dart
-    runs-on: self-hosted
-    defaults:
-      run:
-        working-directory: thermion_dart  # Adjust this path
-
+  dart-tests:
+    runs-on: ubuntu-22.04
     steps:
       - uses: actions/checkout@v4
-      - name: Install dependencies
-        run: flutter pub get # even though this is a Dart package, it has as dev_dependency on objective_c for testing which for some reason has a Flutter dependency
-
-      # Uncomment this step to verify the use of 'dart format' on each commit.
-      # - name: Verify formatting
-      #   run: dart format --output=none --set-exit-if-changed .
-
-      #- name: Analyze project source
-      #  run: dart analyze
-
-      - name: Build and Test
-        shell: cmd
-        run: dart --enable-experiment=native-assets test
-
-      # Upload logs on failure
+      - uses: ./.github/actions/setup-build-env
+      - run: |
+          cd thermion_dart
+          dart pub get 
+          xvfb-run dart --enable-experiment=native-assets test \
+            test/asset_tests.dart \
+            test/instancing_tests.dart \
+            test/light_tests.dart \
+            test/entity_tests.dart \
+            test/geometry_tests.dart \
+            test/view_tests.dart \
+            test/postprocessing_tests.dart \
+            test/scene_tests.dart  \
+            test/picking_tests.dart \
+            --concurrency=1
+      #test/overlay_tests.dart  \
+      - name: Zip output
+        run: zip -r output.zip ./thermion_dart/test/output
+      - name: Upload test output
+        uses: actions/upload-artifact@v4
+        with:
+          name: golden-images-${{ github.sha }}
+          path: output.zip
+      - name: Download golden images from previous run
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh run download 15990504915 \
+            --name golden-images-4b9870244a529bf086280331d38c55e294425b4f \
+            --dir ./thermion_dart/test/golden-downloads
+      - name: Unzip golden images
+        run: |
+          cd thermion_dart/test/golden-downloads && unzip output.zip
+      - name: Install Python dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install Pillow numpy
+      - name: Compare golden images
+        run: cd thermion_dart/test && python compare_goldens.py
       - name: Upload logs
         if: failure() || steps.build.outcome == 'failure'
         uses: actions/upload-artifact@v4
         with:
           name: build-logs
           path: |
-            D:\a\thermion\thermion\thermion_dart\.dart_tool\thermion_dart\log\build.log
-            # /Users/runner/work/thermion/thermion/thermion_dart//.dart_tool/thermion_dart/log/build.log
+            ${{ github.workspace }}/thermion_dart/.dart_tool/thermion_dart/log/build.log
           retention-days: 5
 
-      # Capture crash dumps if they exist
-      - name: Collect crash dumps
-        if: failure()
-        uses: actions/upload-artifact@v3
+  flutter_examples:
+    name: flutter_examples
+    runs-on: macos-latest
+    defaults:
+      run:
+        working-directory: examples/flutter 
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Flutter
+        uses: subosito/flutter-action@v2
         with:
-          name: crash-dumps
+          channel: master
+          architecture: ARM64
+      - name: Set up JDK 17
+        uses: actions/setup-java@v4
+        with:
+          java-version: '17'
+          distribution: 'temurin'
+      - name: Install Android SDK
+        uses: android-actions/setup-android@v3
+        with:
+          api-level: 34
+          build-tools: 34.0.0
+          cmake-version: 3.22.1
+          ndk-version: 25.1.893739
+      - name: Accept Android SDK licenses
+        run: |
+          yes | $ANDROID_SDK_ROOT/cmdline-tools/latest/bin/sdkmanager --licenses
+      - run: cd quickstart && flutter pub get && flutter build macos 
+      # - run: cd quickstart && flutter pub get && flutter build ios 
+      - run: cd quickstart && flutter pub get && flutter build appbundle
+      - run: cd quickstart && flutter build web 
+      - run: cd picking && flutter pub get && flutter build macos 
+      # - run: cd picking && flutter pub get && flutter build ios 
+      - run: cd picking && flutter pub get && flutter build appbundle
+      - run: cd picking && flutter build web 
+      - name: Upload logs
+        if: failure() || steps.build.outcome == 'failure'
+        uses: actions/upload-artifact@v4
+        with:
+          name: build-logs
           path: |
-            ${{ runner.temp }}/*.dmp
-            ${{ env.LOCALAPPDATA }}/Temp/*.dmp
-            ${{ env.LOCALAPPDATA }}/CrashDumps/*.dmp
+            # D:\a\thermion\thermion\thermion_dart\.dart_tool\thermion_dart\log\build.log
+            /Users/runner/work/thermion/thermion/thermion_dart/.dart_tool/thermion_dart/log/build.log
+          retention-days: 5
 
+
+            # thermion_dart:
+  #   name: thermion_dart
+  #   runs-on: macos-latest
+  #   defaults:
+  #     run:
+  #       working-directory: thermion_dart 
+  #   steps:
+  #     - uses: actions/checkout@v4
+  #     - name: Set up Flutter
+  #       uses: subosito/flutter-action@v2
+  #       with:
+  #         channel: master
+  #     - run: flutter pub get
+  #     - run: dart --enable-experiment=native-assets test -j1 test/light_tests.dart
   # thermion_flutter:
   #   name: thermion_flutter
   #   runs-on: macos-13
   #   defaults:
   #     run:
   #       working-directory: thermion_flutter/thermion_flutter  # Adjust this path
-
   #   steps:
   #     - uses: actions/checkout@v4
-      
   #     - uses: dart-lang/setup-dart@9a04e6d73cca37bd455e0608d7e5092f881fd603
-
   #     - name: Install dependencies
   #       run: dart pub get
+  #
+  #
+  ##- uses: actions/checkout@v4
+      #- name: Setup LLVM
+      #  uses: KyleMayes/install-llvm-action@v1
+      #  with:
+      #    version: "16"  
+      #- name: Add LLVM to PATH
+      #  run: |
+      #    echo "${{ github.workspace }}/llvm/bin" >> $GITHUB_PATH
+      #    echo "LD_LIBRARY_PATH=${{ github.workspace }}/llvm/lib/x86_64-unknown-linux-gnu/" >> $GITHUB_ENV
+      #- name: Verify installation
+      #  run: clang --version
+      #- name: Install MESA
+      #  run: |
+      #    sudo apt-get update
+      #    sudo apt-get install -y xvfb
+      #    sudo apt-get install -y libosmesa6-dev
+      #    #sudo apt-get -y build-dep mesa
+      #    #git clone https://gitlab.freedesktop.org/mesa/mesa.git
+      #    #cd mesa
+      #    #git checkout mesa-23.2.1
+      #    #mkdir -p out
+      #    #meson setup builddir/ -Dprefix="$(pwd)/out" -Dosmesa=true -Dglx=xlib -Dgallium-drivers=swrast -Dvulkan-drivers=swrast
+      #    #meson install -C builddir/
+      #- name: Install Vulkan SDK and dependencies
+      #  run: |
+      #    wget -qO - https://packages.lunarg.com/lunarg-signing-key-pub.asc | sudo apt-key add -
+      #    sudo wget -qO /etc/apt/sources.list.d/lunarg-vulkan-jammy.list https://packages.lunarg.com/vulkan/lunarg-vulkan-jammy.list
+      #    sudo apt-get update
+      #    sudo apt-get install -y vulkan-sdk
+      #- name: Set up Flutter
+      #  uses: subosito/flutter-action@v2
+      #  with:
+      #    channel: master
+      #    architecture: X64
 
-  #     # Uncomment this step to verify the use of 'dart format' on each commit.
-  #     # - name: Verify formatting
-  #     #   run: dart format --output=none --set-exit-if-changed .
-
-  #     - name: Analyze project source
-  #       run: dart analyze
-
-  #     - name: Run tests
-  #       run: dart --enable-experiment=native-assets test

.gitignore

@@ -1,5 +1,4 @@
 **/*/.cxx
-**/.github
 **/.idea
 .dart_tool
 **/.dart_tool
@@ -10,3 +9,4 @@
 pubspec_overrides.yaml
 /pubspec.lock
 *.iml
+**/*/*.filamat

CHANGELOG.md

@@ -3,6 +3,218 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## 2025-07-03
+
+### Changes
+
+---
+
+Packages with breaking changes:
+
+ - [`thermion_dart` - `v0.3.0`](#thermion_dart---v030)
+ - [`thermion_flutter` - `v0.3.0`](#thermion_flutter---v030)
+ - [`thermion_flutter_method_channel` - `v0.3.0`](#thermion_flutter_method_channel---v030)
+
+Packages with other changes:
+
+ - [`thermion_flutter_web` - `v0.3.0`](#thermion_flutter_web---v030)
+ - [`thermion_flutter_platform_interface` - `v0.3.0`](#thermion_flutter_platform_interface---v030)
+
+---
+
+#### `thermion_dart` - `v0.3.0`
+
+ - **REFACTOR**: gizmo/input handler improvements.
+ - **REFACTOR**: add createGizmoRenderThread.
+ - **REFACTOR**: Gizmo internals.
+ - **REFACTOR**: dont require GizmoInputHandler to wrap an existing InputHandler (you can do this by creating your own InputHandler that wraps two children.
+ - **FIX**: glTF instancing when loaded via buffer.
+ - **FIX**: don't return entity from SceneManager_addLightRenderThread.
+ - **FIX**: return light entity from SceneManager.
+ - **FIX**: store reference to material instances in ThermionViewer so they can be cleaned up on dispose.
+ - **FIX**: remove MaterialInstance from SceneManager storage when destroyed.
+ - **FIX**: add destroyCamera to ThermionViewer interface.
+ - **FIX**: UV calculation for geometry.
+ - **FIX**: use createGizmoRenderThread.
+ - **FIX**: remove MaterialInstance from SceneManager storage when destroyed.
+ - **FIX**: move removeIbl to render thread.
+ - **FIX**: move material/instance creation to render thread.
+ - **FIX**: allow destroying instances independently of owner.
+ - **FIX**: remove MaterialInstance from SceneManager storage when destroyed.
+ - **FIX**: use render thread methods for grid overlay creation and create ubershader instance.
+ - **FIX**: only use Windows-style ndkRoot when building on Windows.
+ - **FIX**: set overlay layer visibility when adding grid.
+ - **FIX**: only use Windows-style ndkRoot when building on Windows.
+ - **FIX**: when creating geometry, normals/uvs are set to false by default. remove wirefame camera container (can now be replaced by bounding box methods.
+ - **FIX**: fix highlights after first.
+ - **FEAT**: remove bounding box from SceneAsset and create renderable wireframe bounding box in ThermionAsset.
+ - **FEAT**: add setTransparencyMode to Dart Material class.
+ - **FEAT**: expose attached entity as Stream on GizmoInputHandler.
+ - **FEAT**: allow custom material for grid overlay, and material creation from Uint8List.
+ - **FEAT**: allow setting material instance directly on ThermionAsset.
+ - **FEAT**: allow passing custom material for grid overlay.
+ - **FEAT**: allow passing custom material for grid overlay.
+ - **FEAT**: allow passing custom material for grid overlay.
+ - **FEAT**: more rotation gizmo improvements.
+ - **FEAT**: rotation gizmo improvements.
+ - **FEAT**: add rotation gizmo.
+ - **FEAT**: add rotation gizmo asset + resource file.
+ - **FEAT**: add rotation gizmo asset + resource file.
+ - **FEAT**: use existing material instances when creating an instance of GeometrySceneAsset and no material instance is passed.
+ - **FEAT**: re-implement grid overlay.
+ - **FEAT**: add gizmo.glb to assets/resources.
+ - **FEAT**: add TRACE macro.
+ - **FEAT**: update Filament to v1.56.4.
+ - **FEAT**: expose setCastShadows/setReceiveShadows.
+ - **FEAT**: re-add uvScale, vertexScale to unlit material.
+ - **FEAT**: re-add uvScale, vertexScale to unlit material.
+ - **BREAKING** **REFACTOR**: move light methods from FilamentViewer to SceneManager/TLightManager and rename clearLights/clearAssets to destroyLights/destroyAssets.
+ - **BREAKING** **REFACTOR**: rename removeAsset to destroyAsset.
+ - **BREAKING** **FIX**: rename removeEntity to removeAsset.
+ - **BREAKING** **FEAT**: change default near/far to 0.1/100.0.
+ - **BREAKING** **FEAT**: use raw pointer scale (>1 meaning zoom in, <1 meaning zoom out) rather than binary -1/1 for DelegateInputHandler.
+ - **BREAKING** **FEAT**: remove Viewer setRenderTarget method (use the View method instead).
+
+#### `thermion_flutter` - `v0.3.0`
+
+ - **REFACTOR**: rename ThermionFlutterTexture->PlatformTextureDescriptor.
+ - **FIX**: rename msPerFrame property.
+ - **FEAT**: add FocusNode to ThermionListenerWidget.
+ - **FEAT**: use new createTextureAndBindToView in ThermionTextureWidget.
+ - **BREAKING** **REFACTOR**: move light methods from FilamentViewer to SceneManager/TLightManager and rename clearLights/clearAssets to destroyLights/destroyAssets.
+ - **BREAKING** **FEAT**: remove superseded ThermionWindows widget.
+ - **BREAKING** **FEAT**: rename thermion_flutter_ffi package to thermion_flutter_method_channel.
+
+#### `thermion_flutter_method_channel` - `v0.3.0`
+
+ - **REFACTOR**: rename ThermionFlutterTexture->PlatformTextureDescriptor.
+ - **BREAKING** **FEAT**: rename thermion_flutter_ffi package to thermion_flutter_method_channel.
+
+#### `thermion_flutter_web` - `v0.3.0`
+
+ - **REFACTOR**: rename ThermionFlutterTexture->PlatformTextureDescriptor.
+
+#### `thermion_flutter_platform_interface` - `v0.3.0`
+
+ - **REFACTOR**: rename ThermionFlutterTexture->PlatformTextureDescriptor.
+ - **FEAT**: create separate createTexture and createTextureAndBindToView interface methods.
+
+
+## 2025-01-08
+
+### Changes
+
+---
+
+Packages with breaking changes:
+
+ - There are no breaking changes in this release.
+
+Packages with other changes:
+
+ - [`thermion_dart` - `v0.2.1-dev.20.0`](#thermion_dart---v021-dev200)
+ - [`thermion_flutter` - `v0.2.1-dev.20.0`](#thermion_flutter---v021-dev200)
+ - [`thermion_flutter_platform_interface` - `v0.2.1-dev.20.0`](#thermion_flutter_platform_interface---v021-dev200)
+ - [`thermion_flutter_ffi` - `v0.2.1-dev.20.0`](#thermion_flutter_ffi---v021-dev200)
+ - [`thermion_flutter_web` - `v0.2.0+11`](#thermion_flutter_web---v02011)
+
+Packages with dependency updates only:
+
+> Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
+
+ - `thermion_flutter_web` - `v0.2.0+11`
+
+---
+
+#### `thermion_dart` - `v0.2.1-dev.20.0`
+
+ - **FIX**: only use Windows-style ndkRoot when building on Windows.
+
+#### `thermion_flutter` - `v0.2.1-dev.20.0`
+
+ - Bump "thermion_flutter" to `0.2.1-dev.20.0`.
+
+#### `thermion_flutter_platform_interface` - `v0.2.1-dev.20.0`
+
+ - Bump "thermion_flutter_platform_interface" to `0.2.1-dev.20.0`.
+
+#### `thermion_flutter_ffi` - `v0.2.1-dev.20.0`
+
+ - Bump "thermion_flutter_ffi" to `0.2.1-dev.20.0`.
+
+
+## 2024-11-21
+
+### Changes
+
+---
+
+Packages with breaking changes:
+
+ - [`thermion_dart` - `v0.2.1-dev.19.0`](#thermion_dart---v021-dev190)
+
+Packages with other changes:
+
+ - [`thermion_flutter` - `v0.2.1-dev.19.0`](#thermion_flutter---v021-dev190)
+ - [`thermion_flutter_web` - `v0.2.0+10`](#thermion_flutter_web---v02010)
+ - [`thermion_flutter_platform_interface` - `v0.2.1-dev.19.0`](#thermion_flutter_platform_interface---v021-dev190)
+ - [`thermion_flutter_ffi` - `v0.2.1-dev.19.0`](#thermion_flutter_ffi---v021-dev190)
+
+Packages with dependency updates only:
+
+> Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
+
+ - `thermion_flutter` - `v0.2.1-dev.19.0`
+ - `thermion_flutter_web` - `v0.2.0+10`
+ - `thermion_flutter_platform_interface` - `v0.2.1-dev.19.0`
+ - `thermion_flutter_ffi` - `v0.2.1-dev.19.0`
+
+---
+
+#### `thermion_dart` - `v0.2.1-dev.19.0`
+
+ - **FEAT**: use InputAction.ZOOM for scroll wheel in free flight handler.
+ - **FEAT**: free flight camera improvements.
+ - **BREAKING** **FIX**: update Makefile & rebuild materials for Vulkan.
+
+
+## 2024-11-18
+
+### Changes
+
+---
+
+Packages with breaking changes:
+
+ - There are no breaking changes in this release.
+
+Packages with other changes:
+
+ - [`thermion_dart` - `v0.2.1-dev.18.0`](#thermion_dart---v021-dev180)
+ - [`thermion_flutter` - `v0.2.1-dev.18.0`](#thermion_flutter---v021-dev180)
+ - [`thermion_flutter_web` - `v0.2.0+9`](#thermion_flutter_web---v0209)
+ - [`thermion_flutter_platform_interface` - `v0.2.1-dev.18.0`](#thermion_flutter_platform_interface---v021-dev180)
+ - [`thermion_flutter_ffi` - `v0.2.1-dev.18.0`](#thermion_flutter_ffi---v021-dev180)
+
+Packages with dependency updates only:
+
+> Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
+
+ - `thermion_flutter_web` - `v0.2.0+9`
+ - `thermion_flutter_platform_interface` - `v0.2.1-dev.18.0`
+ - `thermion_flutter_ffi` - `v0.2.1-dev.18.0`
+
+---
+
+#### `thermion_dart` - `v0.2.1-dev.18.0`
+
+ - **FEAT**: add MaterialInstance.setDepthFunc.
+
+#### `thermion_flutter` - `v0.2.1-dev.18.0`
+
+ - **FIX**: fix windows import header.
+
+
 ## 2024-11-15
 
 ### Changes

Dockerfile

@@ -0,0 +1,76 @@
+FROM ubuntu:22.04
+
+# Set non-interactive mode for apt
+ENV DEBIAN_FRONTEND=noninteractive
+
+# Install dependencies and add LLVM repository
+RUN apt-get update && apt-get install -y \
+    git \
+    build-essential \
+    cmake \
+    ninja-build \
+    libgl1-mesa-dev \
+    libc++-dev \
+    libc++abi-dev \
+    libsdl2-dev \
+    libxi-dev \
+    libtbb-dev \
+    libassimp-dev \
+    python3 \
+    python3-pip \
+    curl \
+    wget \
+    software-properties-common \
+    lsb-release \
+    && rm -rf /var/lib/apt/lists/*
+
+# Add LLVM repository and install Clang 16
+RUN wget -O - https://apt.llvm.org/llvm-snapshot.gpg.key | apt-key add - \
+    && add-apt-repository "deb http://apt.llvm.org/jammy/ llvm-toolchain-jammy-16 main" \
+    && apt-get update \
+    && apt-get install -y \
+    clang-16 \
+    clang++-16 \
+    libc++-16-dev \
+    libc++abi-16-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+# Set Clang 16 as default
+RUN update-alternatives --install /usr/bin/clang clang /usr/bin/clang-16 100 \
+    && update-alternatives --install /usr/bin/clang++ clang++ /usr/bin/clang++-16 100
+
+# Set environment variables for Clang
+ENV CC=clang-16
+ENV CXX=clang++-16
+
+# Set working directory
+WORKDIR /opt
+
+# Clone the filament repository
+RUN git clone https://github.com/google/filament.git
+
+# Change to filament directory
+WORKDIR /opt/filament
+
+# Checkout the specific version
+RUN git checkout v1.58.0
+
+# Add CMAKE_POSITION_INDEPENDENT_CODE setting after project() line
+RUN sed -i '/^project(/a set(CMAKE_POSITION_INDEPENDENT_CODE ON)\nadd_compile_definitions(GLTFIO_USE_FILESYSTEM=0)' CMakeLists.txt
+RUN sed -i -e '/^#define GLTFIO_USE_FILESYSTEM 1$/i\
+#ifndef GLTFIO_USE_FILESYSTEM' -e '/^#define GLTFIO_USE_FILESYSTEM 1$/a\
+#endif' libs/gltfio/src/FFilamentAsset.h
+
+# Make build script executable
+RUN chmod +x build.sh
+
+# Run the build commands
+RUN ./build.sh -l -i -f -p desktop release
+RUN ./build.sh -l -i -f -p desktop release zstd
+RUN ./build.sh -l -i -f -p desktop release tinyexr
+RUN ./build.sh -l -i -f -p desktop release imageio
+RUN zip -r filament-v1.58.0-linux-release.zip /opt/filament/out/release/filament/lib/x86_64/*.a /opt/filament/out/cmake-release/third_party/tinyexr/tnt/libtinyexr.a /opt/filament/out/cmake-release/libs/imageio/libimageio.a 
+# Set the working directory to the build output
+WORKDIR /opt/filament/out/release
+
+CMD ["/bin/bash"]

Makefile

@@ -1,36 +1,50 @@
-dart-web:
-	cd thermion_dart/native/web; mkdir -p build && cd build && emcmake cmake .. && emmake make
-dart-web-clean:
+wasm:
+	cd thermion_dart/native/web &&\
+    mkdir -p build &&\
+	cd build &&\
+	emcmake cmake .. &&\
+	emmake make
+wasm-clean:
 	cd thermion_dart/native/web && rm -rf build
-dart-wasm-cli-example: dart-web-clean dart-web
-	cd thermion_dart/examples/cli_wasm/bin && dart compile wasm example_cli.dart && node main.js
-dart-web-example: dart-web
-	cp thermion_dart/native/web/build/build/out/thermion_dart* examples/web_wasm/bin
-	cd thermion_dart/examples/web_wasm/bin && dart compile wasm example_web.dart
+wasm-example-web: 
+	cd examples/dart/js_wasm
+	mkdir -p build
+	dart compile js web/example.dart -o build/example.dart.js
+
 flutter-example-web: dart-web-clean dart-web
 	cd thermion_flutter_federated/thermion_flutter/example/web && dart compile wasm main.dart && cd .. && flutter build web --wasm --profile
 flutter-example-macos:
 	cd thermion_flutter_federated/thermion_flutter/example/web && flutter run -d macos
 swift-bindings:
-	swiftc -c thermion_flutter/thermion_flutter/macos/Classes/ThermionTexture.swift -module-name swift_module -emit-objc-header-path thermion_dart/native/include/generated/ThermionTextureSwiftObjCAPI.h -emit-library -o thermion_dart/test/libThermionTextureSwift.dylib
+	swiftc -c thermion_dart/native/macos/ThermionTexture.swift -module-name swift_module -emit-objc-header-path thermion_dart/native/include/generated/ThermionTextureSwiftObjCAPI.h -emit-library -o thermion_dart/test/generated/libThermionTextureSwift.dylib
 	cd thermion_dart/ && dart --enable-experiment=native-assets run ffigen --config ffigen/swift.yaml
 bindings:
 	cd thermion_dart/ && dart --enable-experiment=native-assets run ffigen --config ffigen/native.yaml
+shared:
+	cd thermion_dart/native && make
 
 # We compile a small set of custom materials for various helpers (background image, gizmo, etc)
 # You must specify the `FILAMENT_PATH` environment variable, either the path /out/release
 # eg: FILAMENT_PATH=/path/to/filament/out/release/bin make materials
 # 
 materials: FORCE
+ifndef FILAMENT_PATH
+	@echo "FILAMENT_PATH is not set"
+else
 	@echo "Using Filament build from ${FILAMENT_PATH}"
-	@for material in unlit image unlit_fixed_size grid; do \
-		${FILAMENT_PATH}/matc -a opengl -a metal -o materials/$$material.filamat materials/$$material.mat; \
-		$(FILAMENT_PATH)/resgen -c -p $$material -x thermion_dart/native/include/material/ materials/$$material.filamat; \
-		echo '#include "'$$material'.h"' | cat - thermion_dart/native/include/material/$$material.c > thermion_dart/native/include/material/$$material.c.new; \
-		mv thermion_dart/native/include/material/$$material.c.new thermion_dart/native/include/material/$$material.c; \
-	done
+	./materials/build.sh	
+endif
 
-	#rm materials/*.filamat
+resources: FORCE
+ifndef FILAMENT_PATH
+	@echo "FILAMENT_PATH is not set"
+else
+	@echo "Using Filament build from ${FILAMENT_PATH}"
+	@for gizmo in translation rotation; do \
+		$(FILAMENT_PATH)/resgen -c -p $${gizmo}_gizmo_glb -x thermion_dart/native/include/resources assets/$${gizmo}_gizmo.glb || exit 1; \
+		echo '#include "'$${gizmo}_gizmo_glb.h'"' | cat - thermion_dart/native/include/resources/$${gizmo}_gizmo_glb.c > thermion_dart/native/include/resources/$${gizmo}_gizmo_glb.c.new; \
+		mv thermion_dart/native/include/resources/$${gizmo}_gizmo_glb.c.new thermion_dart/native/include/resources/$${gizmo}_gizmo_glb.c; \
+	done
+endif
 
 FORCE: ;
-	

README.md

@@ -15,6 +15,8 @@
 <a href="https://discord.gg/h2VdDK3EAQ"><img src="https://img.shields.io/discord/993167615587520602?logo=discord&logoColor=fff&labelColor=333940" alt="discord"></a>
 <a href="https://github.com/nmfisher/thermion"><img src="https://img.shields.io/github/contributors/nmfisher/flutter_filament?logo=github&labelColor=333940" alt="contributors"></a>
 
+https://github.com/user-attachments/assets/b0c07b5a-6156-4e42-a09b-5f9bd85fbf32
+
 ### Features
 
 - Supports iOS (arm64), MacOS (arm64/x64), Android (arm64), Windows (x64) (>= 10), Web/WASM 
@@ -22,6 +24,8 @@
 - camera/entity manipulation with mouse (desktop) and gestures (mobile)
 - skinning + morph animations
 
+Uses the Filament PBR engine (currently v1.56.4).
+
 ### Quickstart (Flutter)
 
 From the command line:
@@ -35,50 +39,32 @@ flutter config --enable-native-assets
 In your Flutter app:
 
 ```dart
-_thermionViewer = await ThermionFlutterPlugin.createViewer();
-
-// Geometry and models are represented as "entities". Here, we load a glTF
-// file containing a plain cube.
-// By default, all paths are treated as asset paths. To load from a file 
-// instead, use file:// URIs.
-var entity =
-    await _thermionViewer!.loadGlb("assets/cube.glb", keepData: true);
-
-// Thermion uses a right-handed coordinate system where +Y is up and -Z is
-// "into" the screen.
-// By default, the camera is located at (0,0,0) looking at (0,0,-1); this
-// would place it directly inside the cube we just loaded.
-//
-// Let's move the camera to (0,0,10) to ensure the cube is visible in the
-// viewport.
-await _thermionViewer!.setCameraPosition(0, 0, 10);
-
-// Without a light source, your scene will be totally black. Let's load a skybox
-// (a cubemap image that is rendered behind everything else in the scene)
-// and an image-based indirect light that has been precomputed from the same
-// skybox.
-await _thermionViewer!.loadSkybox("assets/default_env_skybox.ktx");
-await _thermionViewer!.loadIbl("assets/default_env_ibl.ktx");
-
-// Finally, you need to explicitly enable rendering. Setting rendering to
-// false is designed to allow you to pause rendering to conserve battery life
-await _thermionViewer!.setRendering(true);
-```
-
-and then in your widget tree:
-```dart
- @override
+@override
   Widget build(BuildContext context) {
-    return Stack(children: [
-      if (_thermionViewer != null)
+    return Scaffold(
+        body: Stack(children: [
         Positioned.fill(
-            child: ThermionWidget(
-          viewer: _thermionViewer!,
-        )),
-    ]);
+            child: ViewerWidget(
+          assetPath: "assets/cube.glb",
+          skyboxPath: "assets/default_env_skybox.ktx",
+          iblPath: "assets/default_env_ibl.ktx",
+          transformToUnitCube: true,
+          initialCameraPosition: Vector3(0, 0, 6),
+          background: Colors.blue,
+          manipulatorType: ManipulatorType.ORBIT,
+          onViewerAvailable: (viewer) async {
+            await Future.delayed(const Duration(seconds: 5));
+            await viewer.removeSkybox();
+          },
+          initial: Container(
+            color: Colors.red,
+          ),
+        ))]));
   }
 ```
 
+> the first time you build an app that consumes this package, the Dart native-assets build system will download static binaries from Cloudflare. This may take a few minutes (depending on which platform you are compiling for). These will be cached, so subsequent builds will be much faster.
+
 ### Sponsors, Contributors & Acknowledgments
 
 Thermion uses the [Filament](https://github.com/google/filament) Physically Based Rendering engine under the hood.
@@ -92,4 +78,5 @@ Thank you to the following people:
 - @daverin for MacOS library contributions
 - @LukasPoque for CI/refactoring work
 - @alexmercerind for his work on integrating ANGLE textures on Flutter Windows
+- @BrutalCoding for documentation fixes
 

docs.json

@@ -8,14 +8,19 @@
       [
         ["Overview", "/"],
         ["Quick Start", "/quickstart"],
+        ["Viewer", "/viewer"],
         ["Camera Manipulation", "/camera_manipulation"]
       ]
     ],
     ["Misc.", [
+      ["Debugging", "/debugging"],
       ["Playground", "https://dartpad.thermion.dev"],
       ["Showcase", "/showcase"],
       ["Windows", "/windows"],
       ["Android", "/android"],
+      ["iOS", "/ios"],
+      ["Web", "/web"],
+      ["Linux", "/linux"],
       ["Contributing", "/contributing"],
       ["Discord", "https://discord.gg/h2VdDK3EAQ"]
       ]]

docs/android.mdx

@@ -12,15 +12,3 @@ Thermion requires Android SDK version 22, so change your `app/android/build.grad
     }
 ```
 
-### Shrink/Minify Resources
-
-In release mode, you must add the following to your `app/build.gradle`:
-
-```
-    buildTypes {
-        release {
-            shrinkResources false
-            minifyEnabled false
-        }
-    }
-```

docs/debugging.mdx

@@ -0,0 +1,27 @@
+# Debugging
+
+If something is crashing or not working as expected, you can enable verbose logging and/or debug builds (particularly useful for debugging with lldb or getting legible stack traces):
+
+Add a `hooks` section to your app's `pubspec.yaml`, e.g.
+```
+name: example_cli
+description: A sample command-line application.
+version: 1.0.0
+
+environment:
+  sdk: ^3.3.0
+
+# Add the below
+hooks:
+  user_defines:
+    thermion_dart: 
+      mode: debug
+      tracing: enabled
+```
+
+After changing the `hooks` section, make sure you run `flutter clean` to propagate the changes correctly.
+
+> [!CAUTION]
+> Debug builds won't work for Android. This is a known upstream issue with Filament.
+
+Unless `mode: debug` is specified in your `pubspec.yaml`, Thermion will use release builds under the hood, even if your app is compiled/runing in debug mode.

docs/index.mdx

@@ -16,7 +16,7 @@ Thermion is divided into two packages:
 
 With this structure, the Flutter-specific components are not coupled to the Dart components, meaning Thermion can be used for rendering in both Flutter and non-Flutter applications.
 
-For example, Thermion ships with examples for rendering with Dart only (no Flutter) with a CLI/headless application on MacOS, and with a Javascript/WASM/HTML applicaiton in browsers.
+For example, Thermion ships with examples for rendering with Dart only (no Flutter) with a CLI/headless application on MacOS, and with a Javascript/WASM/HTML application in browsers.
 
 `thermion_flutter` exports `thermion_dart`, so if you are working with a Flutter application, you will only need to import `thermion_fluttter`.
 

docs/ios.mdx

@@ -0,0 +1,55 @@
+## iOS
+
+### Min iOS version
+
+Thermion requires a minimum iOS version of 13.0. When building a Flutter application, ensure your application's `ios/Podfile` contains the following:
+
+```ruby
+platform :ios, '13.0'
+```
+
+and in ios/Info.plist:
+
+```xml
+<key>LSMinimumSystemVersion</key>
+<string>13.0</string>
+```
+
+When submitting to the App Store, you may encounter an error saying `thermion_dart.framework does not supported the minimum deployment target in Info.plist`. 
+
+This is because Flutter hardcodes a deployment target of iOS 12.0 when invoking the native assets build, which conflicts with actual requirement.
+
+After running `flutter build ios` (but before archiving the build and submitting to the App Store), run the following script to replace the `MinimumOSVersion`:
+
+```
+#!/bin/zsh
+
+# Array of directories containing Info.plist files
+directories=(
+    "./build/ios/iphoneos/Runner.app/Frameworks/thermion_dart.framework"
+    "./build/ios/Release-iphoneos/Runner.app/Frameworks/thermion_dart.framework"
+    "./build/native_assets/ios/thermion_dart.framework"
+)
+
+# Loop through each directory
+for dir in "${directories[@]}"; do
+    plist_path="$dir/Info.plist"
+    
+    # Check if Info.plist exists in the directory
+    if [[ -f "$plist_path" ]]; then
+        echo "Processing: $plist_path"
+        
+        # Use PlistBuddy to change the MinimumOSVersion
+        /usr/libexec/PlistBuddy -c "Set :MinimumOSVersion 13.0" "$plist_path" 2>/dev/null
+        
+        if [[ $? -eq 0 ]]; then
+            echo "✓ Successfully updated version to 13.0"
+        else
+            echo "✗ Failed to update version in $plist_path"
+        fi
+    else
+        echo "✗ Info.plist not found in $dir"
+    fi
+done
+```
+

docs/linux.mdx

@@ -0,0 +1,10 @@
+## Linux support
+
+Currently, only the Dart package (`thermion_dart`) will work on Linux (primarily for the automated build/testing pipeline). 
+
+Filament has been built for Ubuntu 22.04; other distributions may work, but YMMV.
+
+The Flutter package (`thermion_flutter`) won't work; it's missing the platform glue code necessary to set up the render target.  Support will eventually be added, but there is currently no estimated timeline.
+
+Contributions are welcome and it's actually not a lot of work. Join the Discord if you want to help out.
+

docs/quickstart.mdx

@@ -1,216 +1,202 @@
-## Quickstart (Flutter)
+# ViewerWidget Documentation
 
-> You can find the entire project below in the [flutter/quickstart](https://github.com/nmfisher/thermion_examples/tree/master/flutter/quickstart) folder of the `thermion_examples` repository.
+`ViewerWidget` is a simplified wrapper around the Thermion 3D viewer that makes it easy to display 3D models in your Flutter application.
 
-1. Switch to Flutter master channel, upgrade Flutter, create a new project, then add `thermion_flutter` as a dependency
+## Overview
 
-```bash
-$ flutter channel master
-$ flutter upgrade
-$ flutter config --enable-native-assets  
-$ flutter create thermion_sample_project && cd thermion_sample_project
-$ flutter pub add thermion_flutter
-```
+`ViewerWidget` handles the setup and configuration of a Thermion viewer, including:
+- Loading 3D models (glTF assets)
+- Configuring skyboxes and image-based lighting
+- Setting up camera positions and manipulators
+- Managing the rendering lifecycle
 
-2. If running on iOS or MacOS, change the minimum deployment target to OSX 13
+## Installation
 
-<Accordion title="Click to open iOS/MacOS instructions">
-
-Make sure the `platform` entry refers to `13.0` in your Podfile.
-
-In `macos/Podfile` (for macOS):
-```
-platform :osx, '13.0'
-```
-
-In `ios/Podfile`, (for iOS):
-```
-platform :ios, '13.0'
-```
-
-Then open XCode:
-```
-open macos/Runner.xcworkspace
-```
-
-and change the minimum deployment target to 13.0:
-
-![XCode screenshot](images/macos_min_deployment.png)
-
-</Accordion>
-
-2. Add a folder containing your assets (glTF model + skybox ktx) to your `pubspec.yaml` asset list
+First, make sure you have the Thermion Flutter plugin added to your dependencies:
 
 ```yaml
-...
-flutter
-  uses-material-design: true
-  assets:
-    - assets/
+dependencies:
+  thermion_flutter: ^latest_version
 ```
 
-3. Create an instance of `ThermionFlutterPlugin` in your app.
+## Basic Usage
 
 ```dart
+import 'package:flutter/material.dart';
+import 'package:thermion_flutter/thermion_flutter.dart';
+import 'path_to_your_viewer_widget.dart';
 
-class _MyAppState extends State<MyApp> {
-  late ThermionFlutterPlugin _thermionFlutterPlugin;  
-  late Future<ThermionViewer> _thermionViewer;
-  void initState() {    
-    _thermionFlutterPlugin = ThermionFlutterPlugin();    
-    _thermionViewer = _thermionFlutterPlugin.createViewer();  
+class MyApp extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return MaterialApp(
+      home: Scaffold(
+        body: ViewerWidget(
+          assetPath: 'assets/my_model.glb',
+          initialCameraPosition: Vector3(0, 0, 5),
+          manipulatorType: ManipulatorType.ORBIT,
+        ),
+      ),
+    );
   }
 }
-
 ```
 
+## Properties
 
-4. Add a `ThermionWidget` to your widget hierarchy 
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `initial` | `Widget` | Red decorated box | Widget to display while the viewer is loading |
+| `initialCameraPosition` | `Vector3` | `Vector3(0, 0, 5)` | The starting position for the camera (looking towards origin) |
+| `showFpsCounter` | `bool` | `false` | Whether to show an FPS counter overlay |
+| `assetPath` | `String?` | `null` | Path to the glTF asset to load |
+| `skyboxPath` | `String?` | `null` | Path to a KTX skybox image |
+| `iblPath` | `String?` | `null` | Path to a KTX image for image-based lighting |
+| `directLightType` | `LightType?` | `null` | Type of direct light to add to the scene |
+| `transformToUnitCube` | `bool` | `true` | If true, rescales the model to fit within a 1x1x1 cube |
+| `postProcessing` | `bool` | `true` | Enables ACES tone mapping and basic anti-aliasing |
+| `background` | `Color?` | `null` | Background color (not visible when skybox is provided) |
+| `destroyEngineOnUnload` | `bool` | `false` | If true, disposes the engine when widget is disposed |
+| `manipulatorType` | `ManipulatorType` | `ORBIT` | Type of camera control to use |
+| `onViewerAvailable` | `Future Function(ThermionViewer)?` | `null` | Callback when viewer is ready |
+
+## Camera Manipulators
+
+`ViewerWidget` supports three different camera manipulation modes:
+
+- `ManipulatorType.NONE`: No camera controls, static view
+- `ManipulatorType.ORBIT`: Orbit controls (pinch to zoom, swipe to rotate)
+- `ManipulatorType.FREE_FLIGHT`: Free flight controls for unrestricted movement
+
+Example:
 
 ```dart
+ViewerWidget(
+  assetPath: 'assets/model.glb',
+  manipulatorType: ManipulatorType.FREE_FLIGHT,
+)
+```
 
-class _MyAppState extends State<MyApp> {
+## Lighting
+
+You can set up lighting in multiple ways:
+
+### Image-Based Lighting
+
+```dart
+ViewerWidget(
+  assetPath: 'assets/model.glb',
+  iblPath: 'assets/environment.ktx',
+)
+```
+
+### Direct Light
+
+```dart
+ViewerWidget(
+  assetPath: 'assets/model.glb',
+  directLightType: LightType.SUN,
+)
+```
+
+## Advanced Usage
+
+### Accessing the Viewer
+
+You can get access to the underlying `ThermionViewer` object for more advanced control:
+
+```dart
+ViewerWidget(
+  assetPath: 'assets/model.glb',
+  onViewerAvailable: (viewer) async {
+    // Now you can use the viewer directly
+    final camera = await viewer.getActiveCamera();
+    await camera.lookAt(Vector3(0, 1, 5));
     
-    ThermionViewer? _thermionViewer;
-    void initState() {    
-        _thermionFlutterPlugin.createViewer().then((viewer) {
-            setState(() {
-                _thermionViewer = viewer;
-            });
-        });
-    }    
+    // Add custom lights, manipulate materials, etc.
+  },
+)
+```
 
-    Widget build(BuildContext context) {
-        return Stack(children:[
-            if(_thermionViewer != null)
-            Positioned.fill(
-                child:ThermionWidget(
-                    plugin:_thermionViewer!
-                ) 
-            )
-        ]);  
-    }
+### Changing Manipulator at Runtime
+
+The `manipulatorType` is the only property that can be changed after the widget is created:
+
+```dart
+class _MyWidgetState extends State<MyWidget> {
+  ManipulatorType _manipulatorType = ManipulatorType.ORBIT;
+  
+  @override
+  Widget build(BuildContext context) {
+    return Column(
+      children: [
+        Expanded(
+          child: ViewerWidget(
+            assetPath: 'assets/model.glb',
+            manipulatorType: _manipulatorType,
+          ),
+        ),
+        Row(
+          children: [
+            ElevatedButton(
+              onPressed: () {
+                setState(() {
+                  _manipulatorType = ManipulatorType.ORBIT;
+                });
+              },
+              child: Text('Orbit'),
+            ),
+            ElevatedButton(
+              onPressed: () {
+                setState(() {
+                  _manipulatorType = ManipulatorType.FREE_FLIGHT;
+                });
+              },
+              child: Text('Free Flight'),
+            ),
+          ],
+        ),
+      ],
+    );
+  }
 }
-
 ```
 
-4. Add a button to load the model when pressed
+## Limitations
+
+- Only the `manipulatorType` property can be changed at runtime. For any other property changes, create a new widget.
+- The widget requires that you have the correct environment setup for Thermion (Flutter master channel with native assets enabled).
+
+## Example
+
+Here's a complete example showing how to use `ViewerWidget` with multiple configuration options:
 
 ```dart
+import 'package:flutter/material.dart';
+import 'package:thermion_flutter/thermion_flutter.dart';
+import 'package:vector_math/vector_math_64.dart';
 
-...
-
-class _MyAppState extends State<MyApp> {
-    
-...
-    
-    bool _loaded = false;
-
-    Widget build(BuildContext context) {
-        return Stack(children:[
-            if(_thermionViewer != null)
-            Positioned.fill(
-                child:ThermionWidget(
-                    plugin:_thermionViewer!
-                ) 
-            ),
-            if (!_loaded)
-                Center(
-                    child: ElevatedButton(
-                        child: const Text("Load"),
-                        onPressed: () async {
-                            // TODO 
-                            _loaded = true;
-                            setState(() {});
-                        }))
-        ]);  
-}}
-```
-
-5. When the button is pressed, load a skybox, lighting and the glb asset
-
-You will need to import the `dart:math` and `package:vector_math` libraries.
-
-```dart
-import 'package:vector_math/vector_math_64.dart' as v;
-import 'dart:math';
-
-...
-
-class _MyAppState extends State<MyApp> {
-
-    ...
-
-    Widget build(BuildContext context) {
-        return Stack(children:[
-            ...
-            if(!_loaded)
-                Center(
-                    child: ElevatedButton(
-                        child: const Text("Load"),
-                        onPressed: () async {
-                            var viewer = await _thermionViewer;
-                            await viewer.loadIbl("assets/default_env_ibl.ktx");
-                            await viewer.loadSkybox("assets/default_env_skybox.ktx");
-                            await viewer.loadGlb("assets/cube.glb");
-
-                            await viewer.setCameraPosition(0, 1, 10);
-                            await viewer.setCameraRotation(v.Quaternion.axisAngle(
-                                    v.Vector3(1, 0, 0), -30 / 180 * pi) *
-                                v.Quaternion.axisAngle(v.Vector3(0, 1, 0), 15 / 180 * pi));
-                            await viewer.addLight(
-                                LightType.SUN, 7500, 50000, 0, 0, 0, 1, -1, -1);
-                            await viewer.setRendering(true);
-                            _loaded = true;
-                            setState(() {});
-                        }
-                    )
-                )
-        ]);
-    }
+class ModelViewer extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      appBar: AppBar(title: Text('3D Model Viewer')),
+      body: ViewerWidget(
+        assetPath: 'assets/robot.glb',
+        skyboxPath: 'assets/studio_skybox.ktx',
+        iblPath: 'assets/studio_ibl.ktx',
+        initialCameraPosition: Vector3(0, 1.5, 3),
+        manipulatorType: ManipulatorType.ORBIT,
+        showFpsCounter: true,
+        background: Colors.grey,
+        postProcessing: true,
+        transformToUnitCube: true,
+        onViewerAvailable: (viewer) async {
+          // You can perform additional setup here
+          print('Viewer is ready!');
+        },
+      ),
+    );
+  }
 }
-```           
-
-Here, we've added a skybox (the background (cube) image rendered behind all other elements in the scene), image-based lighting (where an image is used to determine the direction and intensity of a light source) and a directional light (Sun).
-
-Anything added to the scene is referred to as an "entity" (including lights and cameras).
-
-Entities are always added to the scene at position (0,0,0).
-
-The default scene camera is located at (0,0,0) (and is looking at -Z, or "into" the screen), so by adding a cube at (0,0,0), the camera will now be inside the cube. 
-
-We need to move the camera outside the cube so it's visible. 
-
-6. Change the camera orientation
-```dart
-   var viewer = await _thermionViewer;
-    await viewer.loadSkybox("assets/default_env_skybox.ktx");
-    await viewer.loadGlb("assets/cube.glb");
-
-    await viewer.setCameraPosition(0, 1, 10);
-    await viewer.setCameraRotation(v.Quaternion.axisAngle(
-                        v.Vector3(1, 0, 0), -30 / 180 * pi) *
-                    v.Quaternion.axisAngle(v.Vector3(0, 1, 0), 15 / 180 * pi));
-```
-
-The cube still won't be visible until we add a light to the scene and tell Thermion to start rendering.
-
-7. Add a light and turn rendering on
-```dart 
-    ...
-    await viewer.addLight(
-                    LightType.SUN, 7500, 50000, 0, 0, 0, 1, -1, -1);
-    await viewer.setRendering(true);
-    ...
-````
-
-8. Run the project
-```
-$ flutter run -d macos
-```
-
-> You may experience a noticeable delay the very first time you run the project. Don't panic, it's not frozen! This is due to the build system downloading the prebuilt Filament binaries from Cloudflare, which can take some time (particularly on Windows). These binaries will be cached after first download, so subsequent runs will be much faster (though every time you run flutter clean, the binaries will be re-downloaded).
-
-![Screenshot of Thermion Quickstart project](images/thermion_sample_project.png)
-
-Your first Thermion project is complete!
+```

docs/viewer.mdx

@@ -0,0 +1,215 @@
+## Quickstart (Flutter)
+
+> You can find the entire project below in the [examples/flutter/quickstart](https://github.com/nmfisher/thermion/tree/master/examples/flutter/quickstart) folder of the repository.
+
+1. Switch to Flutter master channel, upgrade Flutter, create a new project, then add `thermion_flutter` as a dependency
+
+```bash
+$ flutter channel master
+$ flutter upgrade
+$ flutter config --enable-native-assets  
+$ flutter create thermion_sample_project && cd thermion_sample_project
+$ flutter pub add thermion_flutter
+```
+
+2. If running on iOS or MacOS, change the minimum deployment target to OSX 13
+
+<Accordion title="Click to open iOS/MacOS instructions">
+
+Make sure the `platform` entry refers to `13.0` in your Podfile.
+
+In `macos/Podfile` (for macOS):
+```
+platform :osx, '13.0'
+```
+
+In `ios/Podfile`, (for iOS):
+```
+platform :ios, '13.0'
+```
+
+Then open XCode:
+```
+open macos/Runner.xcworkspace
+```
+
+and change the minimum deployment target to 13.0:
+
+![XCode screenshot](images/macos_min_deployment.png)
+
+</Accordion>
+
+2. Add a folder containing your assets (glTF model + skybox ktx) to your `pubspec.yaml` asset list
+
+```yaml
+...
+flutter
+  assets:
+    - assets/
+```
+
+3. Create an instance of `ThermionFlutterPlugin` in your app.
+
+```dart
+
+class _MyAppState extends State<MyApp> {
+  late ThermionFlutterPlugin _thermionFlutterPlugin;  
+  late Future<ThermionViewer> _thermionViewer;
+  void initState() {    
+    _thermionFlutterPlugin = ThermionFlutterPlugin();    
+    _thermionViewer = _thermionFlutterPlugin.createViewer();  
+  }
+}
+
+```
+
+
+4. Add a `ThermionWidget` to your widget hierarchy 
+
+```dart
+
+class _MyAppState extends State<MyApp> {
+    
+    ThermionViewer? _thermionViewer;
+    void initState() {    
+        _thermionFlutterPlugin.createViewer().then((viewer) {
+            setState(() {
+                _thermionViewer = viewer;
+            });
+        });
+    }    
+
+    Widget build(BuildContext context) {
+        return Stack(children:[
+            if(_thermionViewer != null)
+            Positioned.fill(
+                child:ThermionWidget(
+                    plugin:_thermionViewer!
+                ) 
+            )
+        ]);  
+    }
+}
+
+```
+
+4. Add a button to load the model when pressed
+
+```dart
+
+...
+
+class _MyAppState extends State<MyApp> {
+    
+...
+    
+    bool _loaded = false;
+
+    Widget build(BuildContext context) {
+        return Stack(children:[
+            if(_thermionViewer != null)
+            Positioned.fill(
+                child:ThermionWidget(
+                    plugin:_thermionViewer!
+                ) 
+            ),
+            if (!_loaded)
+                Center(
+                    child: ElevatedButton(
+                        child: const Text("Load"),
+                        onPressed: () async {
+                            // TODO 
+                            _loaded = true;
+                            setState(() {});
+                        }))
+        ]);  
+}}
+```
+
+5. When the button is pressed, load a skybox, lighting and the glb asset
+
+You will need to import the `dart:math` and `package:vector_math` libraries.
+
+```dart
+import 'package:vector_math/vector_math_64.dart' as v;
+import 'dart:math';
+
+...
+
+class _MyAppState extends State<MyApp> {
+
+    ...
+
+    Widget build(BuildContext context) {
+        return Stack(children:[
+            ...
+            if(!_loaded)
+                Center(
+                    child: ElevatedButton(
+                        child: const Text("Load"),
+                        onPressed: () async {
+                            var viewer = await _thermionViewer;
+                            await viewer.loadIbl("assets/default_env_ibl.ktx");
+                            await viewer.loadSkybox("assets/default_env_skybox.ktx");
+                            await viewer.loadGlb("assets/cube.glb");
+
+                            await viewer.setCameraPosition(0, 1, 10);
+                            await viewer.setCameraRotation(v.Quaternion.axisAngle(
+                                    v.Vector3(1, 0, 0), -30 / 180 * pi) *
+                                v.Quaternion.axisAngle(v.Vector3(0, 1, 0), 15 / 180 * pi));
+                            await viewer.addLight(
+                                LightType.SUN, 7500, 50000, 0, 0, 0, 1, -1, -1);
+                            await viewer.setRendering(true);
+                            _loaded = true;
+                            setState(() {});
+                        }
+                    )
+                )
+        ]);
+    }
+}
+```           
+
+Here, we've added a skybox (the background (cube) image rendered behind all other elements in the scene), image-based lighting (where an image is used to determine the direction and intensity of a light source) and a directional light (Sun).
+
+Anything added to the scene is referred to as an "entity" (including lights and cameras).
+
+Entities are always added to the scene at position (0,0,0).
+
+The default scene camera is located at (0,0,0) (and is looking at -Z, or "into" the screen), so by adding a cube at (0,0,0), the camera will now be inside the cube. 
+
+We need to move the camera outside the cube so it's visible. 
+
+6. Change the camera orientation
+```dart
+   var viewer = await _thermionViewer;
+    await viewer.loadSkybox("assets/default_env_skybox.ktx");
+    await viewer.loadGlb("assets/cube.glb");
+
+    await viewer.setCameraPosition(0, 1, 10);
+    await viewer.setCameraRotation(v.Quaternion.axisAngle(
+                        v.Vector3(1, 0, 0), -30 / 180 * pi) *
+                    v.Quaternion.axisAngle(v.Vector3(0, 1, 0), 15 / 180 * pi));
+```
+
+The cube still won't be visible until we add a light to the scene and tell Thermion to start rendering.
+
+7. Add a light and turn rendering on
+```dart 
+    ...
+    await viewer.addLight(
+                    LightType.SUN, 7500, 50000, 0, 0, 0, 1, -1, -1);
+    await viewer.setRendering(true);
+    ...
+````
+
+8. Run the project
+```
+$ flutter run -d macos
+```
+
+> You may experience a noticeable delay the very first time you run the project. Don't panic, it's not frozen! This is due to the build system downloading the prebuilt Filament binaries from Cloudflare, which can take some time (particularly on Windows). These binaries will be cached after first download, so subsequent runs will be much faster (though every time you run flutter clean, the binaries will be re-downloaded).
+
+![Screenshot of Thermion Quickstart project](images/thermion_sample_project.png)
+
+Your first Thermion project is complete!

docs/web.mdx

@@ -0,0 +1,27 @@
+## Web
+
+First, you must manually compile the wasm+javascript module. This requires:
+
+1) GNU Make
+2) CMake
+3) Emscripten 
+
+```
+make wasm
+```
+
+### Flutter
+
+Thermion requires Android SDK version 22, so change your `app/android/build.gradle` to match this version or higher：
+
+```groovy
+ defaultConfig {
+    ...
+        minSdk = 22
+    ...
+    }
+```
+
+```
+flutter run -d chrome --web-header Cross-Origin-Embedder-Policy=require-corp --web-header Cross-Origin-Opener-Policy=same-origin
+```

examples/assets/cube.gltf

@@ -0,0 +1,121 @@
+{
+	"asset":{
+		"generator":"Khronos glTF Blender I/O v4.2.60",
+		"version":"2.0"
+	},
+	"scene":0,
+	"scenes":[
+		{
+			"name":"Scene",
+			"nodes":[
+				0
+			]
+		}
+	],
+	"nodes":[
+		{
+			"mesh":0,
+			"name":"Cube"
+		}
+	],
+	"materials":[
+		{
+			"doubleSided":true,
+			"name":"Material",
+			"pbrMetallicRoughness":{
+				"baseColorFactor":[
+					0.800000011920929,
+					0.800000011920929,
+					0.800000011920929,
+					1
+				],
+				"metallicFactor":0,
+				"roughnessFactor":0.5
+			}
+		}
+	],
+	"meshes":[
+		{
+			"name":"Cube",
+			"primitives":[
+				{
+					"attributes":{
+						"POSITION":0,
+						"NORMAL":1,
+						"TEXCOORD_0":2
+					},
+					"indices":3,
+					"material":0
+				}
+			]
+		}
+	],
+	"accessors":[
+		{
+			"bufferView":0,
+			"componentType":5126,
+			"count":24,
+			"max":[
+				1,
+				1,
+				1
+			],
+			"min":[
+				-1,
+				-1,
+				-1
+			],
+			"type":"VEC3"
+		},
+		{
+			"bufferView":1,
+			"componentType":5126,
+			"count":24,
+			"type":"VEC3"
+		},
+		{
+			"bufferView":2,
+			"componentType":5126,
+			"count":24,
+			"type":"VEC2"
+		},
+		{
+			"bufferView":3,
+			"componentType":5123,
+			"count":36,
+			"type":"SCALAR"
+		}
+	],
+	"bufferViews":[
+		{
+			"buffer":0,
+			"byteLength":288,
+			"byteOffset":0,
+			"target":34962
+		},
+		{
+			"buffer":0,
+			"byteLength":288,
+			"byteOffset":288,
+			"target":34962
+		},
+		{
+			"buffer":0,
+			"byteLength":192,
+			"byteOffset":576,
+			"target":34962
+		},
+		{
+			"buffer":0,
+			"byteLength":72,
+			"byteOffset":768,
+			"target":34963
+		}
+	],
+	"buffers":[
+		{
+			"byteLength":840,
+			"uri":"cube.bin"
+		}
+	]
+}

examples/assets/cube_texture2.svg

@@ -0,0 +1,183 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   width="200"
+   height="200"
+   viewBox="0 0 1 1"
+   version="1.1"
+   id="svg10"
+   sodipodi:docname="cube_texture2.svg"
+   inkscape:export-filename="cube_texture_512x512.png"
+   inkscape:export-xdpi="245.75999"
+   inkscape:export-ydpi="245.75999"
+   inkscape:version="1.4 (e7c3feb1, 2024-10-09)"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <defs
+     id="defs10" />
+  <sodipodi:namedview
+     id="namedview10"
+     pagecolor="#ffffff"
+     bordercolor="#000000"
+     borderopacity="0.25"
+     inkscape:showpageshadow="2"
+     inkscape:pageopacity="0.0"
+     inkscape:pagecheckerboard="0"
+     inkscape:deskcolor="#d1d1d1"
+     inkscape:zoom="1.5185118"
+     inkscape:cx="255.18405"
+     inkscape:cy="172.86662"
+     inkscape:window-width="1920"
+     inkscape:window-height="964"
+     inkscape:window-x="0"
+     inkscape:window-y="25"
+     inkscape:window-maximized="1"
+     inkscape:current-layer="svg10"
+     showgrid="false" />
+  <!-- Background Grid (optional, for visual aid) -->
+  <rect
+     x="0"
+     y="0"
+     width="1"
+     height="1"
+     fill="#f0f0f0"
+     id="rect1" />
+  <line
+     x1="0.333"
+     y1="0"
+     x2="0.333"
+     y2="1"
+     stroke="#ccc"
+     stroke-width="0.005"
+     id="line1" />
+  <line
+     x1="0.666"
+     y1="0"
+     x2="0.666"
+     y2="1"
+     stroke="#ccc"
+     stroke-width="0.005"
+     id="line2" />
+  <line
+     y1="0.25"
+     x1="0"
+     y2="0.25"
+     x2="1"
+     stroke="#ccc"
+     stroke-width="0.005"
+     id="line3" />
+  <line
+     y1="0.5"
+     x1="0"
+     y2="0.5"
+     x2="1"
+     stroke="#ccc"
+     stroke-width="0.005"
+     id="line4" />
+  <line
+     y1="0.75"
+     x1="0"
+     y2="0.75"
+     x2="1"
+     stroke="#ccc"
+     stroke-width="0.005"
+     id="line5" />
+  <!-- Front Face -->
+  <rect
+     x="0.333"
+     y="0"
+     width="0.333"
+     height="0.25"
+     fill="#ff0000"
+     id="rect5" />
+  <text
+     x="0.5"
+     y="0.125"
+     text-anchor="middle"
+     dominant-baseline="middle"
+     font-size="0.1"
+     fill="white"
+     id="text5">Front</text>
+  <!-- Back Face -->
+  <rect
+     x="0.333"
+     y="0.5"
+     width="0.333"
+     height="0.25"
+     fill="#00ff00"
+     id="rect6" />
+  <text
+     x="0.5"
+     y="0.625"
+     text-anchor="middle"
+     dominant-baseline="middle"
+     font-size="0.1"
+     fill="white"
+     id="text6">Back</text>
+  <!-- Top Face -->
+  <rect
+     x="0.666"
+     y="0.25"
+     width="0.333"
+     height="0.25"
+     fill="#0000ff"
+     id="rect7" />
+  <text
+     x="0.833"
+     y="0.375"
+     text-anchor="middle"
+     dominant-baseline="middle"
+     font-size="0.1"
+     fill="white"
+     id="text7">Top</text>
+  <!-- Bottom Face -->
+  <rect
+     x="0"
+     y="0.25"
+     width="0.333"
+     height="0.25"
+     fill="#ffff00"
+     id="rect8" />
+  <text
+     x="0.15610458"
+     y="0.37936932"
+     text-anchor="middle"
+     dominant-baseline="middle"
+     font-size="0.0733811px"
+     fill="#000000"
+     id="text8"
+     style="stroke-width:0.733811">Bottom</text>
+  <!-- Right Face -->
+  <rect
+     x="0.333"
+     y="0.25"
+     width="0.333"
+     height="0.25"
+     fill="#ff00ff"
+     id="rect9" />
+  <text
+     x="0.5"
+     y="0.375"
+     text-anchor="middle"
+     dominant-baseline="middle"
+     font-size="0.1"
+     fill="white"
+     id="text9">Right</text>
+  <!-- Left Face -->
+  <rect
+     x="0.333"
+     y="0.75"
+     width="0.333"
+     height="0.25"
+     fill="#00ffff"
+     id="rect10" />
+  <text
+     x="0.5"
+     y="0.875"
+     text-anchor="middle"
+     dominant-baseline="middle"
+     font-size="0.1"
+     fill="black"
+     id="text10">Left</text>
+</svg>

examples/dart/cli_headless/.gitignore

@@ -0,0 +1,4 @@
+# https://dart.dev/guides/libraries/private-files
+# Created by `dart pub`
+.dart_tool/
+output/**

examples/dart/cli_headless/CHANGELOG.md

@@ -0,0 +1,3 @@
+## 1.0.0
+
+- Initial version.

examples/dart/cli_headless/README.md

@@ -0,0 +1,9 @@
+# cli_headless
+
+A simple headless Dart CLI app using Thermion to render to a bitmap.
+
+To run:
+`dart --enable-experiment=native-assets run bin/example.dart`
+
+Currently, this will probably only work  on a non-virtualized macOS host. 
+

examples/dart/cli_headless/analysis_options.yaml

@@ -0,0 +1,30 @@
+# This file configures the static analysis results for your project (errors,
+# warnings, and lints).
+#
+# This enables the 'recommended' set of lints from `package:lints`.
+# This set helps identify many issues that may lead to problems when running
+# or consuming Dart code, and enforces writing Dart using a single, idiomatic
+# style and format.
+#
+# If you want a smaller set of lints you can change this to specify
+# 'package:lints/core.yaml'. These are just the most critical lints
+# (the recommended set includes the core lints).
+# The core lints are also what is used by pub.dev for scoring packages.
+
+include: package:lints/recommended.yaml
+
+# Uncomment the following section to specify additional rules.
+
+# linter:
+#   rules:
+#     - camel_case_types
+
+# analyzer:
+#   exclude:
+#     - path/to/excluded/files/**
+
+# For more information about the core and recommended set of lints, see
+# https://dart.dev/go/core-lints
+
+# For additional information about configuring this file, see
+# https://dart.dev/guides/language/analysis-options

examples/dart/cli_headless/bin/example.dart

@@ -0,0 +1,32 @@
+import 'dart:io';
+import 'dart:isolate';
+
+import 'package:thermion_dart/thermion_dart.dart';
+import 'package:thermion_dart/src/filament/src/implementation/ffi_filament_app.dart';
+
+void main() async {
+  await FFIFilamentApp.create();
+  final (width, height) = (500, 500);
+  final sc = await FilamentApp.instance!.createHeadlessSwapChain(width, height);
+  var viewer = ThermionViewerFFI();
+  await viewer.initialized;
+
+  await FilamentApp.instance!.register(sc, viewer.view);
+
+  await viewer.view.setFrustumCullingEnabled(false);
+  await viewer.setBackgroundColor(1, 0, 1, 1);
+  await viewer.setViewport(width, height);
+  final result = await FilamentApp.instance!.capture(
+    sc,
+    view: viewer.view,
+  );
+
+  final bitmap = await pixelBufferToBmp(result.first.$2, width, height,
+      hasAlpha: true, isFloat: true);
+
+  var outfile = File("output/render.bmp");
+  outfile.parent.create();
+  outfile.writeAsBytesSync(bitmap);
+  await FilamentApp.instance!.destroy();
+  Isolate.current.kill();
+}

examples/dart/cli_headless/pubspec.yaml

@@ -0,0 +1,21 @@
+name: example_cli
+description: A sample command-line application.
+version: 1.0.0
+
+environment:
+  sdk: ^3.3.0
+
+hooks:
+  user_defines:
+    thermion_dart: 
+      mode: debug
+      tracing: enabled
+
+dependencies:
+  thermion_dart: 
+    path: ../../../thermion_dart
+
+dev_dependencies:
+  ffigen: ^11.0.0
+  lints: ^3.0.0
+  test: ^1.24.0

examples/dart/cli_windows/bin/cli_windows.dart

@@ -1,9 +1,8 @@
 import 'dart:ffi';
 import 'dart:io';
 import 'dart:math';
-
 import 'package:ffi/ffi.dart';
-import 'package:thermion_dart/src/utils/src/dart_resources.dart';
+import 'package:thermion_dart/src/viewer/src/ffi/src/ffi_filament_app.dart';
 import 'package:thermion_dart/src/viewer/src/ffi/src/thermion_viewer_ffi.dart';
 import 'package:thermion_dart/src/viewer/src/ffi/src/thermion_dart.g.dart';
 import 'package:thermion_dart/thermion_dart.dart';
@@ -13,29 +12,17 @@ import 'package:cli_windows/thermion_window.g.dart';
 void main(List<String> arguments) async {
   var hwnd = create_thermion_window(500, 500, 0, 0);
   update();
-
-  final resourceLoader = calloc<ResourceLoaderWrapper>(1);
-  
-  var loadToOut = NativeCallable<
-      Void Function(Pointer<Char>,
-          Pointer<ResourceBuffer>)>.listener(DartResourceLoader.loadResource);
-
-  resourceLoader.ref.loadToOut = loadToOut.nativeFunction;
-  var freeResource = NativeCallable<Void Function(ResourceBuffer)>.listener(
-      DartResourceLoader.freeResource);
-  resourceLoader.ref.freeResource = freeResource.nativeFunction;
-
-  var viewer = ThermionViewerFFI(  
-    resourceLoader: resourceLoader.cast<Void>());
+  await FFIFilamentApp.create();
+  var viewer = ThermionViewerFFI(
+    loadAssetFromUri: (path) async => File(path.replaceAll("file://", "")).readAsBytesSync());
 
   await viewer.initialized;
-  var swapChain = await viewer.createHeadlessSwapChain(500,500);
-  var view = await viewer.getViewAt(0);
-  await view.updateViewport(500, 500);
-  var camera = await viewer.getMainCamera();
+  var swapChain = await FilamentApp.instance!.createSwapChain(Pointer<Void>.fromAddress(hwnd));
+  var view = viewer.view;
+  await view.setViewport(500, 500);
+  var camera = await viewer.getActiveCamera();
   await camera.setLensProjection();
-  
-  await view.setRenderable(true, swapChain);
+  await FilamentApp.instance!.register(swapChain, view);
   
   await viewer.setBackgroundColor(1.0, 0.0, 0.0, 1.0);
 
@@ -49,15 +36,15 @@ void main(List<String> arguments) async {
 
   var last = 0;
 
-  await viewer.setCameraPosition(0, 0, 10);
+  await camera.lookAt(Vector3(0, 0, 10));
 
   while(true) {  
     var angle = (stopwatch.elapsedMilliseconds / 1000) * 2 * pi;
     var rotation = Quaternion.axisAngle(Vector3(0,1,0), angle);
     var position = Vector3(10 * sin(angle), 0, 10 * cos(angle));
     var modelMatrix = Matrix4.compose(position, rotation, Vector3.all(1));
-    await viewer.setCameraModelMatrix4(modelMatrix);
-    await viewer.render();
+    await camera.setModelMatrix(modelMatrix);
+    await FilamentApp.instance!.requestFrame();
     update();
     await Future.delayed(Duration(milliseconds: 17));
   }

examples/dart/cli_windows/hook/build.dart

@@ -1,5 +1,3 @@
-import 'dart:io';
-import 'package:archive/archive.dart';
 import 'package:logging/logging.dart';
 import 'package:native_assets_cli/native_assets_cli.dart';
 import 'package:native_toolchain_c/native_toolchain_c.dart';
@@ -10,23 +8,22 @@ void main(List<String> args) async {
       ..level = Level.ALL
       ..onRecord.listen((record) => print(
           record.message + "\n"));
-
-  await build(args, (config, output) async {
-
+  await build(args, (input, output) async {
     final cbuilder = CBuilder.library(
-      name: "thermion_window",
+      name: input.packageName,
       language: Language.cpp,
-      assetName: 'thermion_window.dart',
+      assetName: 'cli_windows.dart',
       sources: ['native/thermion_window.cpp'],
       includes: ['native', '../../../thermion_dart/native/include'],
       defines: {"UNICODE":"1"},
       flags:[],
       dartBuildFiles: ['hook/build.dart'],
+      
     );
 
     await cbuilder.run(
-      buildConfig: config,
-      buildOutput: output,
+      input: input,
+      output: output,
       logger: logger,
     );
 

examples/dart/cli_windows/lib/thermion_window.g.dart

@@ -2,7 +2,7 @@
 //
 // Generated by `package:ffigen`.
 // ignore_for_file: type=lint
-@ffi.DefaultAsset('package:cli_windows/thermion_window.dart')
+@ffi.DefaultAsset('package:cli_windows/cli_windows.dart')
 library;
 
 import 'dart:ffi' as ffi;

examples/dart/cli_windows/pubspec.yaml

@@ -1,42 +1,21 @@
 name: cli_windows
 description: A sample command-line application with basic argument parsing.
 version: 0.0.1
-# repository: https://github.com/my_org/my_repo
 
 environment:
   sdk: ^3.6.0-326.0.dev
 
-# Add regular dependencies here.
 dependencies:
   args: ^2.5.0
   thermion_dart:
     path: ../../../thermion_dart
   ffi: ^2.1.3
   vector_math: ^2.1.4
-  native_toolchain_c: ^0.4.2
-  native_assets_cli: ^0.6.1
+  native_toolchain_c: ^0.9.0
+  native_assets_cli: ^0.12.0
 
 dev_dependencies:
   lints: ^5.0.0
   test: ^1.24.0
-  ffigen: ^13.0.0
-ffigen:
-  output: 'lib/thermion_window.g.dart'
-  headers:
-    entry-points:
-      - 'native/thermion_window.h'
-    include-directives:
-      - 'native/thermion_window.h'
-  ffi-native:
-    assetId: package:cli_windows/thermion_window.dart
-  ignore-source-errors: true
-  llvm-path: 
-  - E:\clang+llvm-19.1.3-x86_64-pc-windows-msvc\bin
-  - E:\clang+llvm-19.1.3-x86_64-pc-windows-msvc\
-  - E:\clang+llvm-19.1.3-x86_64-pc-windows-msvc\lib
-  functions:
-    leaf:
-      include:
-        - '.*'
 
 

examples/dart/js_wasm/pubspec.yaml

@@ -0,0 +1,19 @@
+name: example_web
+description: A sample command-line application.
+version: 1.0.0
+# repository: https://github.com/my_org/my_repo
+
+environment:
+  sdk: ^3.3.0
+
+dependencies:
+  thermion_dart: 
+    path: ../../../thermion_dart
+  logging: ^1.3.0
+
+dev_dependencies:
+  lints: ^3.0.0
+  test: ^1.24.0
+  build_runner: ^2.4.13
+  build_test: ^2.2.2
+  build_web_compilers: ^4.1.5

examples/dart/js_wasm/web/assets

@@ -0,0 +1 @@
+../../../assets/

examples/dart/js_wasm/web/example.dart

@@ -0,0 +1,101 @@
+import 'dart:async';
+import 'dart:js_interop';
+import 'dart:math';
+import 'package:web/web.dart';
+import 'package:logging/logging.dart';
+import 'package:thermion_dart/thermion_dart.dart'
+    hide NativeLibrary, Image_decode;
+import 'package:thermion_dart/src/filament/src/implementation/ffi_filament_app.dart';
+import 'web_input_handler.dart';
+import 'package:thermion_dart/src/bindings/src/thermion_dart_js_interop.g.dart';
+
+void main(List<String> arguments) async {
+  Logger.root.onRecord.listen((record) {
+    print(record);
+  });
+
+  NativeLibrary.initBindings("thermion_dart");
+
+  final canvas =
+      document.getElementById("thermion_canvas") as HTMLCanvasElement;
+  try {
+    canvas.width = canvas.clientWidth;
+    canvas.height = canvas.clientHeight;
+  } catch (err) {
+    print(err.toString());
+  }
+
+  final config = FFIFilamentConfig(backend: Backend.OPENGL);
+
+  await FFIFilamentApp.create(config: config);
+
+  var swapChain = await FilamentApp.instance!
+      .createHeadlessSwapChain(canvas.width, canvas.height);
+  final viewer = ThermionViewerFFI();
+  await viewer.initialized;
+  await FilamentApp.instance!.setClearOptions(1.0, 0.0, 0.0, 1.0);
+  await FilamentApp.instance!.register(swapChain, viewer.view);
+  await viewer.setViewport(canvas.width, canvas.height);
+  await viewer.setRendering(true);
+  final rnd = Random();
+  // ignore: prefer_function_declarations_over_variables
+  bool resizing = false;
+  // ignore: prefer_function_declarations_over_variables
+  final resizer = () async {
+    if (resizing) {
+      return;
+    }
+    try {
+      resizing = true;
+      await viewer.setViewport(canvas.clientWidth, canvas.clientHeight);
+      Thermion_resizeCanvas(canvas.clientWidth, canvas.clientHeight);
+    } catch (err) {
+      print(err);
+    } finally {
+      resizing = false;
+    }
+  };
+  // ignore: unused_local_variable, prefer_function_declarations_over_variables
+  final jsWrapper = () {
+    var promise = resizer().toJS;
+    return promise;
+  };
+  window.addEventListener('resize', jsWrapper.toJS);
+  // // await FilamentApp.instance!.render();
+  // // await Future.delayed(Duration(seconds: 1));
+
+  // // await FilamentApp.instance!.setClearOptions(1.0, 1.0, 0.0, 1.0);
+  // // await FilamentApp.instance!.render();
+  // // await Future.delayed(Duration(seconds: 1));
+
+  await viewer.loadSkybox("assets/default_env_skybox.ktx");
+  await viewer.loadGltf("assets/cube.glb");
+  final camera = await viewer.getActiveCamera();
+
+  var zOffset = 10.0;
+
+  final inputHandler = DelegateInputHandler.flight(viewer);
+
+  final webInputHandler =
+      WebInputHandler(inputHandler: inputHandler, canvas: canvas);
+  await camera.lookAt(Vector3(0, 0, zOffset));
+  DateTime lastRender = DateTime.now();
+
+  while (true) {
+    var stackPtr = stackSave();
+    var now = DateTime.now();
+    await FilamentApp.instance!.requestFrame();
+    now = DateTime.now();
+    var timeSinceLast =
+        now.microsecondsSinceEpoch - lastRender.microsecondsSinceEpoch;
+    lastRender = now;
+    if (timeSinceLast < 1667) {
+      var waitFor = 1667 - timeSinceLast;
+      await Future.delayed(Duration(microseconds: waitFor));
+    }
+    stackRestore(stackPtr);
+    // inputHandler.keyDown(PhysicalKey.S);
+    // await camera.lookAt(Vector3(0,0,zOffset));
+    // zOffset +=0.1;
+  }
+}

examples/dart/js_wasm/web/index_js.html

@@ -0,0 +1,35 @@
+<!DOCTYPE html>
+<html>
+    <head>
+        <script type="text/javascript" src="./thermion_dart.js"></script>
+        <script type="module"> 
+            try {
+                window.thermion_dart = await thermion_dart();      
+            } catch(err) {
+                console.error(err);
+            }
+            const script = document.createElement('script')
+            script.src = 'example.dart.js'
+            document.head.append(script);
+        </script>
+        <style>
+            html, body { 
+                margin:0;
+                padding:0;
+            }
+            canvas {
+                position:absolute;
+                left:0;
+                right:0;
+                top:0;
+                bottom:0;
+                width:100%;
+                height:100%;
+            }
+        </style>
+    </head>
+
+  <body>
+    <canvas id="thermion_canvas"></canvas>
+</body>
+</html>

examples/dart/js_wasm/web/index_wasm.html

@@ -0,0 +1,35 @@
+<html>
+    <head>
+        <script src="thermion_dart.js"></script>
+        <style>
+            html, body { 
+                margin:0;
+                padding:0;
+            }
+            canvas {
+                position:absolute;
+                left:0;
+                right:0;
+                top:0;
+                bottom:0;
+                width:100%;
+                height:100%;
+            }
+        </style>
+    </head>
+<script type="module"> 
+    try {
+        window.thermion_dart = await thermion_dart();      
+    } catch(err) {
+        console.error(err);
+    }
+    const dartModulePromise = WebAssembly.compileStreaming(fetch('./example.wasm'));
+    const imports = {};
+    const dart2wasm_runtime = await import('./example.mjs');
+    const moduleInstance = await dart2wasm_runtime.instantiate(dartModulePromise, imports);
+    await dart2wasm_runtime.invoke(moduleInstance);
+  </script>
+  <body>
+    <canvas id="canvas"></canvas>
+</body>
+</html>

examples/dart/js_wasm/web/main.js

@@ -0,0 +1,22 @@
+import { readFile } from 'fs/promises';
+
+import { compile } from './example.mjs';
+import thermion_dart from './thermion_dart.js';
+
+
+async function runDartWasm() {
+    globalThis['thermion_dart'] = await thermion_dart(); 
+
+    const wasmBytes = await readFile('example.wasm');
+    const compiledApp = await compile(wasmBytes);
+    const instantiatedApp = await compiledApp.instantiate({});
+    try {
+        instantiatedApp.invokeMain();
+    } catch(err) {
+        console.error("Failed");
+        console.error(err);
+    }
+}
+
+runDartWasm().catch(console.error);
+

examples/dart/js_wasm/web/thermion_dart.js

@@ -0,0 +1 @@
+../../../../thermion_dart/native/web/build/build/out/thermion_dart.js

examples/dart/js_wasm/web/thermion_dart.wasm

@@ -0,0 +1 @@
+../../../../thermion_dart/native/web/build/build/out/thermion_dart.wasm

examples/dart/js_wasm/web/web_input_handler.dart

@@ -0,0 +1,299 @@
+import 'dart:js_interop';
+
+import 'package:web/web.dart' as web;
+import 'package:thermion_dart/thermion_dart.dart';
+
+class WebInputHandler {
+  final InputHandler inputHandler;
+  final web.HTMLCanvasElement canvas;
+  late double pixelRatio;
+
+  final Map<int, Vector2> _touchPositions = {};
+
+  WebInputHandler({
+    required this.inputHandler,
+    required this.canvas,
+  }) {
+    pixelRatio = web.window.devicePixelRatio;
+    _initializeEventListeners();
+  }
+
+  void _initializeEventListeners() {
+    canvas.addEventListener('mousedown', _onMouseDown.toJS);
+    canvas.addEventListener('mousemove', _onMouseMove.toJS);
+    canvas.addEventListener('mouseup', _onMouseUp.toJS);
+    canvas.addEventListener('wheel', _onMouseWheel.toJS);
+    web.window.addEventListener('keydown', _onKeyDown.toJS);
+    web.window.addEventListener('keyup', _onKeyUp.toJS);
+
+    canvas.addEventListener('touchstart', _onTouchStart.toJS);
+    canvas.addEventListener('touchmove', _onTouchMove.toJS);
+    canvas.addEventListener('touchend', _onTouchEnd.toJS);
+    canvas.addEventListener('touchcancel', _onTouchCancel.toJS);
+  }
+
+  void _onMouseDown(web.MouseEvent event) {
+    final localPos = _getLocalPositionFromEvent(event);
+    final button = _getMouseButtonFromEvent(event);
+    
+    inputHandler.handle(MouseEvent(
+      MouseEventType.buttonDown,
+      button,
+      localPos,
+      Vector2.zero(),
+    ));
+    
+    event.preventDefault();
+  }
+
+  void _onMouseMove(web.MouseEvent event) {
+    final localPos = _getLocalPositionFromEvent(event);
+    final delta = Vector2(event.movementX ?? 0, event.movementY ?? 0);
+    final button = _getMouseButtonFromEvent(event);
+    
+    inputHandler.handle(MouseEvent(
+      MouseEventType.move,
+      button,
+      localPos,
+      delta,
+    ));
+    
+    event.preventDefault();
+  }
+
+  void _onMouseUp(web.MouseEvent event) {
+    final localPos = _getLocalPositionFromEvent(event);
+    final button = _getMouseButtonFromEvent(event);
+    
+    inputHandler.handle(MouseEvent(
+      MouseEventType.buttonUp,
+      button,
+      localPos,
+      Vector2.zero(),
+    ));
+    
+    event.preventDefault();
+  }
+
+  void _onMouseWheel(web.WheelEvent event) {
+    final localPos = _getLocalPositionFromEvent(event);
+    final delta = event.deltaY;
+    
+    inputHandler.handle(ScrollEvent(
+      localPosition: localPos,
+      delta: delta,
+    ));
+    
+    event.preventDefault();
+  }
+
+  void _onKeyDown(web.KeyboardEvent event) {
+    PhysicalKey? physicalKey = _getPhysicalKeyFromEvent(event);
+    LogicalKey? logicalKey = _getLogicalKeyFromEvent(event);
+    if (physicalKey != null && logicalKey != null) {
+      inputHandler.handle(KeyEvent(KeyEventType.down, logicalKey, physicalKey));
+    }
+    event.preventDefault();
+  }
+
+  void _onKeyUp(web.KeyboardEvent event) {
+    LogicalKey? logicalKey = _getLogicalKeyFromEvent(event);
+    PhysicalKey? physicalKey = _getPhysicalKeyFromEvent(event);
+    if (physicalKey != null && logicalKey != null) {
+      inputHandler.handle(KeyEvent(KeyEventType.up, logicalKey, physicalKey));
+    }
+    event.preventDefault();
+  }
+
+  void _onTouchStart(web.TouchEvent event) {
+    for (var touch in event.changedTouches.toList()) {
+      final pos = _getLocalPositionFromTouch(touch);
+      _touchPositions[touch.identifier] = pos;
+    }
+
+    final touchCount = event.touches.toList().length;
+    if (touchCount == 1) {
+      final touch = event.touches.toList().first;
+      final pos = _getLocalPositionFromTouch(touch);
+      inputHandler.handle(TouchEvent(
+        TouchEventType.tap,
+        pos,
+        null,
+      ));
+    }
+
+    if (touchCount >= 2) {
+      final focalPoint = _calculateFocalPoint(event.touches.toList());
+      inputHandler.handle(ScaleStartEvent(
+        numPointers: touchCount,
+        localFocalPoint: (focalPoint.x, focalPoint.y),
+      ));
+    }
+    
+    event.preventDefault();
+  }
+
+  void _onTouchMove(web.TouchEvent event) {
+    for (var touch in event.changedTouches.toList()) {
+      final id = touch.identifier;
+      final currPos = _getLocalPositionFromTouch(touch);
+      final prevPos = _touchPositions[id];
+
+      if (prevPos != null) {
+        _touchPositions[id] = currPos;
+      }
+    }
+
+    final touchCount = event.touches.toList().length;
+    if (touchCount >= 2) {
+      final touches = event.touches.toList();
+      final focalPoint = _calculateFocalPoint(touches);
+      
+      // Calculate scale
+      final currPositions = touches.map((t) => _getLocalPositionFromTouch(t)).toList();
+      final prevPositions = touches.map((t) => _touchPositions[t.identifier] ?? _getLocalPositionFromTouch(t)).toList();
+      
+      final currDist = (currPositions[0] - currPositions[1]).length;
+      final prevDist = (prevPositions[0] - prevPositions[1]).length;
+      final scale = prevDist > 0 ? currDist / prevDist : 1.0;
+      
+      // Calculate focal point delta
+      final prevFocalPoint = _calculateFocalPoint(touches, prevPositions);
+      final focalPointDelta = focalPoint - prevFocalPoint;
+      
+      inputHandler.handle(ScaleUpdateEvent(
+        numPointers: touchCount,
+        localFocalPoint: (focalPoint.x, focalPoint.y),
+        localFocalPointDelta: (focalPointDelta.x, focalPointDelta.y),
+        rotation: 0.0, // We don't track rotation in the web implementation
+        scale: scale,
+        horizontalScale: scale,
+        verticalScale: scale,
+      ));
+    }
+    
+    event.preventDefault();
+  }
+
+  void _onTouchEnd(web.TouchEvent event) {
+    for (var touch in event.changedTouches.toList()) {
+      _touchPositions.remove(touch.identifier);
+    }
+
+    final touchCount = event.touches.toList().length;
+    inputHandler.handle(ScaleEndEvent(
+      numPointers: touchCount,
+    ));
+    
+    event.preventDefault();
+  }
+
+  void _onTouchCancel(web.TouchEvent event) {
+    for (var touch in event.changedTouches.toList()) {
+      _touchPositions.remove(touch.identifier);
+    }
+
+    final touchCount = event.touches.toList().length;
+    inputHandler.handle(ScaleEndEvent(
+      numPointers: touchCount,
+    ));
+    
+    event.preventDefault();
+  }
+
+  MouseButton? _getMouseButtonFromEvent(web.MouseEvent event) {
+    if (event.button == 1 || (event.buttons & 4 != 0)) {
+      return MouseButton.middle;
+    } else if (event.button == 0 || (event.buttons & 1 != 0)) {
+      return MouseButton.left;
+    } else if (event.button == 2 || (event.buttons & 2 != 0)) {
+      return MouseButton.right;
+    }
+    return null;
+  }
+
+    PhysicalKey? _getPhysicalKeyFromEvent(web.KeyboardEvent event) {
+    switch (event.code) {
+      case 'KeyW':
+        return PhysicalKey.w;
+      case 'KeyA':
+        return PhysicalKey.a;
+      case 'KeyS':
+        return PhysicalKey.s;
+      case 'KeyD':
+        return PhysicalKey.d;
+      default:
+        return null;
+    }
+  }
+
+  LogicalKey? _getLogicalKeyFromEvent(web.KeyboardEvent event) {
+    switch (event.key) {
+      case 'KeyW':
+        return LogicalKey.w;
+      case 'KeyA':
+        return LogicalKey.a;
+      case 'KeyS':
+        return LogicalKey.s;
+      case 'KeyD':
+        return LogicalKey.d;
+      default:
+        return null;
+    }
+  }
+
+  Vector2 _getLocalPositionFromEvent(web.Event event) {
+    final rect = canvas.getBoundingClientRect();
+    double clientX = 0, clientY = 0;
+
+    if (event is web.MouseEvent) {
+      clientX = event.clientX.toDouble();
+      clientY = event.clientY.toDouble();
+    } else if (event is web.TouchEvent) {
+      final touch = event.touches.toList().firstOrNull;
+      if (touch != null) {
+        clientX = touch.clientX;
+        clientY = touch.clientY;
+      }
+    }
+
+    return Vector2(
+      (clientX - rect.left) * pixelRatio,
+      (clientY - rect.top) * pixelRatio,
+    );
+  }
+
+  Vector2 _getLocalPositionFromTouch(web.Touch touch) {
+    final rect = canvas.getBoundingClientRect();
+    return Vector2(
+      (touch.clientX - rect.left) * pixelRatio,
+      (touch.clientY - rect.top) * pixelRatio,
+    );
+  }
+
+  Vector2 _calculateFocalPoint(List<web.Touch> touches, [List<Vector2>? positions]) {
+    if (touches.isEmpty) return Vector2.zero();
+    
+    final points = positions ?? touches.map((t) => _getLocalPositionFromTouch(t)).toList();
+    
+    Vector2 sum = Vector2.zero();
+    for (var point in points) {
+      sum += point;
+    }
+    
+    return sum.scaled(1.0 / points.length);
+  }
+
+  void dispose() {
+    canvas.removeEventListener('mousedown', _onMouseDown.toJS);
+    canvas.removeEventListener('mousemove', _onMouseMove.toJS);
+    canvas.removeEventListener('mouseup', _onMouseUp.toJS);
+    canvas.removeEventListener('wheel', _onMouseWheel.toJS);
+    web.window.removeEventListener('keydown', _onKeyDown.toJS);
+    web.window.removeEventListener('keyup', _onKeyUp.toJS);
+    canvas.removeEventListener('touchstart', _onTouchStart.toJS);
+    canvas.removeEventListener('touchmove', _onTouchMove.toJS);
+    canvas.removeEventListener('touchend', _onTouchEnd.toJS);
+    canvas.removeEventListener('touchcancel', _onTouchCancel.toJS);
+  }
+}

examples/flutter/animations/android/app/build.gradle

@@ -0,0 +1,46 @@
+plugins {
+    id "com.android.application"
+    id "kotlin-android"
+    // The Flutter Gradle Plugin must be applied after the Android and Kotlin Gradle plugins.
+    id "dev.flutter.flutter-gradle-plugin"
+}
+
+android {
+    namespace = "com.example.quickstart"
+    compileSdk = flutter.compileSdkVersion
+    ndkVersion = flutter.ndkVersion
+
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_1_8
+        targetCompatibility = JavaVersion.VERSION_1_8
+    }
+
+    kotlinOptions {
+        jvmTarget = JavaVersion.VERSION_1_8
+    }
+
+    defaultConfig {
+        // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
+        applicationId = "com.example.quickstart"
+        // You can update the following values to match your application needs.
+        // For more information, see: https://flutter.dev/to/review-gradle-config.
+        minSdk = 22
+        targetSdk = flutter.targetSdkVersion
+        versionCode = flutter.versionCode
+        versionName = flutter.versionName
+    }
+
+    buildTypes {
+        release {
+            // TODO: Add your own signing config for the release build.
+            // Signing with the debug keys for now, so `flutter run --release` works.
+            signingConfig = signingConfigs.debug
+            shrinkResources false
+            minifyEnabled false
+        }
+    }
+}
+
+flutter {
+    source = "../.."
+}

examples/flutter/animations/android/app/src/main/AndroidManifest.xml

@@ -0,0 +1,48 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <application
+        android:label="camera_manipulation"
+        android:name="${applicationName}"
+        android:icon="@mipmap/ic_launcher">
+        <activity
+            android:name=".MainActivity"
+            android:exported="true"
+            android:launchMode="singleTop"
+            android:taskAffinity=""
+            android:theme="@style/LaunchTheme"
+            android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
+            android:hardwareAccelerated="true"
+            android:windowSoftInputMode="adjustResize">
+            <!-- Specifies an Android theme to apply to this Activity as soon as
+                 the Android process has started. This theme is visible to the user
+                 while the Flutter UI initializes. After that, this theme continues
+                 to determine the Window background behind the Flutter UI. -->
+            <meta-data
+              android:name="io.flutter.embedding.android.NormalTheme"
+              android:resource="@style/NormalTheme"
+              />
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN"/>
+                <category android:name="android.intent.category.LAUNCHER"/>
+            </intent-filter>
+        </activity>
+        <!-- Don't delete the meta-data below.
+             This is used by the Flutter tool to generate GeneratedPluginRegistrant.java -->
+        <meta-data
+            android:name="flutterEmbedding"
+            android:value="2" />
+        <meta-data
+            android:name="io.flutter.embedding.android.EnableImpeller"
+            android:value="false" />
+    </application>
+    <!-- Required to query activities that can process text, see:
+         https://developer.android.com/training/package-visibility and
+         https://developer.android.com/reference/android/content/Intent#ACTION_PROCESS_TEXT.
+
+         In particular, this is used by the Flutter engine in io.flutter.plugin.text.ProcessTextPlugin. -->
+    <queries>
+        <intent>
+            <action android:name="android.intent.action.PROCESS_TEXT"/>
+            <data android:mimeType="text/plain"/>
+        </intent>
+    </queries>
+</manifest>