NewBeeVG 1.0.1.6

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


                    

                
NuGet\Install-Package NewBeeVG -Version 1.0.1.6
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="NewBeeVG" Version="1.0.1.6" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="NewBeeVG" Version="1.0.1.6" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="NewBeeVG" />
                    


                            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 NewBeeVG --version 1.0.1.6
                    


                    

                
#r "nuget: NewBeeVG, 1.0.1.6"
#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 NewBeeVG@1.0.1.6
#: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=NewBeeVG&version=1.0.1.6
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=NewBeeVG&version=1.0.1.6
                    


                            Install as a Cake Tool

<p align="center"> <img src="./assets/logo200.jpg" alt="logo" /> </p>

NewBeeVG(NewBee Visual Content Generator) 是基于 NewBeeUI 的程序化动画/视频内容生成工具，通过 AI 编程，可以快速的制作视频内容。

在设计上，受到 remotion(Make videos programmatically with React) 的启发，但要比 remotion 更间接易用。基于 nodejs 的东东，谁用谁知道 .....，吐槽 ......。我用 Trae + remotion/skills 跑了两小时，各种七七八八的 bug，痛不欲生 ...... 一怒之下，开发了这个。

NewBeeVG 集成了：

  • Avalonia 的 UI 布局系统, 完整复用 Avalonia 成熟布局计算逻辑，统一规范界面与画布元素排版能力
    • 基础布局容器：内置 Grid、StackPanel、Canvas、WrapPanel 等标准布局容器；
    • 元素间距控制：统一支持 Padding（内边距）、Margin（外边距）属性；
    • 对齐与拉伸：提供 HorizontalAlignment / VerticalAlignment 对齐、Stretch 尺寸拉伸策略；
    • 尺寸约束：支持 Width/Height、Min/Max 尺寸限制、比例自适应、内容自适应布局；
    • 跨平台兼容：布局逻辑完全跨平台统一，Windows/macOS/Linux 渲染排版无差异；
  • SkiaSharp 底层 2D 矢量图形渲染内核, 基于 Google Skia 2D 图形库作为底层画布绘制引擎，承担全框架 2D 绘制能力
    • 矢量绘图：路径、矩形、圆形、圆角、贝塞尔曲线、多边形、渐变填充、描边、蒙版裁剪；
    • 文本渲染：多行文本、字体缓存、字重 / 字号 / 字间距调整、文字渐变；
    • 图像处理：PNG/JPG/WebP 解码、纹理缓存、图像缩放、滤镜、透明度混合；
  • Typst 专业结构化排版引擎, 内置 Typst 编译内核，支持在画布内嵌入专业学术 / 文档排版内容，实现图文混排
    • 语法支持：数学公式、图表、化学方程式等；
    • 实时渲染：将 Typst 源码编译为矢量图形，直接嵌入布局容器，和 UI 元素自由混排；
    • 批量导出：支持无头模式批量编译文档、生成论文插图、公式矢量图；
    • 场景适配：学术性动画。
  • HelixToolkit.Nex 3D 引擎，提供完整 3D 实时 / 离线渲染、动画能力
    • 完整 3D 管线：Vulkan 硬件光栅渲染、PBR 材质、光照系统、阴影、后处理；
    • 模型支持：模型文件加载、材质资源、相机控制；

NewBeeVG 还可通过 PythonNet 集成 python 生态。

编译运行

需要下载 NewBeeVG 的源码和 NewBeeUI 的源码，放在相同的目录下，运行 ·NewBeeVG.slnx· 文件即可打开项目。

由于 NewBeeVG 引用了 HelixToolkit.Nex 项目，下载时需要加上 --recurse-submodules 参数，否则会导致编译失败。下载示例:

git clone --recurse-submodules https://github.com/nscript-site/NewBeeVG.git

简单示例

app/files 下是基于文件的应用示例，推荐使用基于文件的应用来使用 NewBeeVG。

NewBeeVG.Demo 是传统项目的使用示例。

下面是一个简单的单文件应用示例，源代码为 animate.cs

#!/usr/bin/env dotnet

font("阿里巴巴普惠体 2.0");

VStack([
    TextBlock("输入你的文字").Font(120, SKColors.Black).Align(0,0).Id("Text"),
    TextBlock("输入你的文字").Font(120, SKColors.Black)
        .OnFrame(e=> { e.Sender.Opacity(e.p);  e.SenderLayoutable?.Margin(0,e.p * 200,0,0); })
])
.Align(0, 0)
.AsClip(out var clip1, frames: 40, name: "animate");

VStack([
    TextBlock("Code").Font(80, SKColors.Orange).Align(0,0),
    TypstFile("./typst/code1.typ").MaxHeight(800).Align(0,0),
    TextBlock("生成视频的全部代码").Font(40, SKColors.Black).Align(0,-1),
]).Align(0,0).AsClip(out var clip2, frames: 120, name: "code");

TextBlock("NewBee VG").FontSize(40).Margin(20).Align(1, -1)
.AsClip(out var logo, frames: -1, start: 0, name: "logo");

run(stage(1920, 1080, bg: SKColors.White), [clip1, clip2, logo]);

上面代码创建了 3 个 clip。

  • animate: 40 帧的文字动画，OnFrame 事件驱动每帧画面变化
  • code: 120 帧的嵌入 tyspt 文件渲染画面，高亮显示源代码。成功渲染需要本地安装 typst，能正确编译/预览对应的 typ 文件
  • logo: logo 层。frames: -1, start: 0 表示从第 0 帧开始，一直持续到视频结束

下面代码表示，运行 [clip1, clip2, logo] 组成的 Track 项目，视频尺寸为 (1920,1080)，背景色为白色:

run(stage(1920, 1080, bg: SKColors.White), [clip1, clip2, logo]);

由于 clip1 和 clip2 没有设置 start，系统默认为 clip1 为视频的第一个片段，clip2 紧跟 clip1。系统会自动判断视频的长度为 clip1 的长度 + clip2 的长度。而 logo 设置了 start，frames 为 -1 (代表视频结束)，系统也会自动计算 logo 的长度为视频总长度。

进入 app/files 目录，执行 dotnet animate.cs 命令即可执行上述文件:

效果如下：

<img src="./assets/record-animate.gif" alt="animate" />

点击 track，可以看到整个 track 的动画。点击每个 clip，可以看到单独 clip 的动画。右上角的两个按钮可以将内容导出为 mp4 视频和 gif 动画。导出 mp4 视频时不会进行缩放。如果画面尺寸大于 1000，导出 gif 时会缩放到 1000。

下面代码可以直接导出视频文件：

save("youtpath.mp4", stage(1920, 1080, bg: SKColors.White), [clip1, clip2, logo]);

详细文档

工作管理

TODO

  • File Based App 示例
  • 导出视频
  • 集成 3D 模块
  • 完善文档
Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on NewBeeVG:

Package Downloads
NewBeeVG.ThreeD

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.1.6 63 2026/9/10
1.0.1.5 87 2026/9/9
1.0.1.4 69 2026/9/9
1.0.1.3 90 2026/9/4
1.0.1.2 129 2026/7/31
1.0.1.1 120 2026/7/23
1.0.1 117 2026/7/22
1.0.0.6 112 2026/7/21
1.0.0.5 102 2026/7/21
1.0.0.4 103 2026/7/20
1.0.0.3 111 2026/7/9
1.0.0.2 118 2026/7/8
1.0.0.1 115 2026/7/2