From 716da5485512540bc3134b77ec69b91e22835cd5 Mon Sep 17 00:00:00 2001 From: Nick Fisher Date: Sun, 16 Jun 2024 14:23:43 +0800 Subject: [PATCH] documentation --- .../ARCHITECTURE.md => docs/flutter.mdx | 0 docs/windows.mdx | 17 +++++++++++++++-- 2 files changed, 15 insertions(+), 2 deletions(-) rename thermion_dart/ARCHITECTURE.md => docs/flutter.mdx (100%) diff --git a/thermion_dart/ARCHITECTURE.md b/docs/flutter.mdx similarity index 100% rename from thermion_dart/ARCHITECTURE.md rename to docs/flutter.mdx diff --git a/docs/windows.mdx b/docs/windows.mdx index 2f7379b8..c2644256 100644 --- a/docs/windows.mdx +++ b/docs/windows.mdx @@ -1,8 +1,21 @@ ## Windows -To support embedding GPU textures in Flutter (rather than copying to a CPU pixel buffer on every frame), we need to build a slightly customized version of Filament that uses GLES on Windows (rather than the default, which uses OpenGL). +## pubspec.yaml -Separately, we also force the Filament gltfio library to load assets via in-memory buffers, rather than the filesystem. This is simply a convenience so we don't have to use different logic for gltf resource loading across platforms. +On Windows, you will need to add a custom version of `native_toolchain_c` to your `dependency_overrides`. This is currently needed to link static libraries when building a DLL. + +``` +native_toolchain_c: + git: + url: git@github.com:nmfisher/native.git + path: pkgs/native_toolchain_c + ref: 99020084c4687be4c58c7115a167088c0441d1de +``` + +This will eventually be fixed upstream in the `native_toolchain_c` package, so this should be a short-term/temporary issue only. + +## ANGLE build (not currently working) +To support embedding GPU textures in Flutter (rather than copying to a CPU pixel buffer on every frame), we need to build a slightly customized version of Filament that uses GLES on Windows (rather than the default, which uses OpenGL). ``` git checkout flutter-filament-windows