MorerialsAvalonia 1.1.1

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
dotnet add package MorerialsAvalonia --version 1.1.1
                    


                    

                
NuGet\Install-Package MorerialsAvalonia -Version 1.1.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="MorerialsAvalonia" Version="1.1.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="MorerialsAvalonia" Version="1.1.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="MorerialsAvalonia" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add MorerialsAvalonia --version 1.1.1
                    


                    

                
#r "nuget: MorerialsAvalonia, 1.1.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package MorerialsAvalonia@1.1.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=MorerialsAvalonia&version=1.1.1
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=MorerialsAvalonia&version=1.1.1
                    


                            Install as a Cake Tool

MorerialsAvalonia

适用于 Avalonia 的 Windows GPU 材质控件库。目前包含 MaterialHost、LiquidGlassContainer 和 LiquidGlassButton。

使用前准备

在创建 Avalonia 窗口前预热用户侧着色器缓存：

MaterialShaderCompiler.EnsureCompiledAsync().GetAwaiter().GetResult();

未调用也可以使用：首个 MaterialHost 会自动完成同一编译流程，但首次显示可能出现等待。缓存位于 %LOCALAPPDATA%\MorerialsAvalonia\Shaders。

AXAML

先在 App.axaml 引入：

<StyleInclude Source="avares://MorerialsAvalonia/Themes/Generic.axaml" />

再将液态玻璃控件置于一个 MaterialHost 内：

<materials:MaterialHost xmlns:materials="using:MorerialsAvalonia"
                        xmlns:liquid="using:MorerialsAvalonia.Materials.LiquidGlass">
  <liquid:LiquidGlassContainer CornerRadius="24"
                                materials:MaterialForeground.LightForeground="#FFF8FAFC"
                                materials:MaterialForeground.DarkForeground="#FF101827">
    <TextBlock Margin="24"
               Text="Liquid Glass"
               materials:MaterialForeground.Mode="Automatic" />
  </liquid:LiquidGlassContainer>
</materials:MaterialHost>

动态前景色

MaterialForeground 默认按每个控件自己的位置独立采样背景亮度。GPU 每 1000ms 对自动目标做固定 3x3 采样并归约；CPU 每轮最多读取 128 个亮度 float，不会读取捕获图像。

  • Automatic：默认值，独立选择浅色或深色前景。
  • Inherit：不重复采样，继承父级已解析的前景类型。
  • Light / Dark：强制使用配置的颜色。
  • Manual：保留应用自身的 Foreground。

可通过 LightForeground、DarkForeground 和 LuminanceThreshold 定制颜色与判定阈值。为平滑变化，可为控件的 Foreground（文本用 TextElement.Foreground）配置 Avalonia BrushTransition。

每个顶级窗口仅放置一个 MaterialHost。完整教程、限制和故障排查： MorerialsAvalonia 接入教程。

LGPL-3.0-only。

Product Compatible and additional computed target framework versions.
.NET net10.0-windows10.0.19041 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.1.1 118 9/13/2026
1.1.0 138 8/18/2026
1.0.3 104 8/18/2026
1.0.2 108 8/18/2026
1.0.1 110 8/17/2026
1.0.0 114 8/17/2026