Ferrite Graphics

铁素体图形

ferrite-graphics 是铁氧体空间计算和可视化子系统。 它将铁氧体计算、状态和数学程序转化为 GPU渲染的空间伪影、导出包和3D UI曲面。

这是一个独立的安装，但不是一个单独的平台。它位于：

• feRcuda 用于内存引擎、CUDA底层和OS/运行时机器
• ferrite-mcp 用于工具/控制平面集成和场景转换

此软件包拥有面向图形的层：

• 空间执行与可视化
• 复值数学
• 自定义数学脚本
• 空间几何与场变换
• GPU加速渲染管道
• 3D场景探索和着色器驱动的可视化
• 用于演示、调试和检查的视觉伪影生成
• 未来下游发动机集成的结构化交换规划
• 3D操作系统用户体验和运行时绑定接口的语义场景节点
• MCP驱动的场景变异和运行时包导出

源代码位于其自己的存储库中， 并独立安装。 ferrite-mcp 在运行时通过 安装二进制文件或环境变量，而不是假设硬编码 结账路径。

为了保持顶层紧凑，面向包装的材料分为以下几类 system/.

初始设计

• include/ferrite_graphics/core

核心共享类型和项目配置。

• include/ferrite_graphics/geometry

场景图、程序几何、带符号距离场、网格实用程序。

• include/ferrite_graphics/render

渲染图、相机状态、帧编排、后端接口。

• include/ferrite_graphics/scripting

未来用于数学实验的自定义脚本界面。

• include/ferrite_graphics/cuda

用于GPU场和几何计算的CUDA主机/内核接口。

• include/ferrite_graphics/runtime

显式桥接层 feRcuda 运行时和内存服务。

• include/ferrite_graphics/platform

铁氧体叠层集成的本地环境和检测发现。

• src/

用于主机端逻辑的C++实现单元。

• cuda/kernels

CUDA内核用于现场评估、采样和几何变换。

• system/docs/integration

描述此项目如何位于 feRcuda 和 ferrite-mcp.

• system/shaders/glsl

着色器实验和渲染后端原型。

• system/assets/scenes

场景描述和示例数据集。

• system/docs

设计说明、架构决策和路线图。

• system/config

包和集成配置示例。

• system/scripts

用于配置/构建/运行的开发助手脚本。

• system/examples

示例场景输入和面向包的示例。

构建

cmake -S . -B build
cmake --build build -j
ctest --test-dir build

安装

单线安装程序：

curl -fsSL https://raw.githubusercontent.com/DaronPopov/ferrite-graphics/main/install.sh | bash

安装特定标记或自定义前缀：

curl -fsSL https://raw.githubusercontent.com/DaronPopov/ferrite-graphics/main/install.sh | \
  bash -s -- --ref v0.1.0 --prefix ~/.local

手动构建/安装：

cmake -S . -B build
cmake --build build -j
cmake --install build --prefix ~/.local

安装布局：

• 二元的： ~/.local/bin/ferrite_graphics_lab
• 场景控制器： ~/.local/bin/ferrite_graphics_scene_ctl
• 标题： ~/.local/include/ferrite_graphics
• 库： ~/.local/lib
• 资产/文档： ~/.local/share/ferrite-graphics

一体化合同

ferrite-graphics 旨在独立于其他设备进行安装 铁氧体叠层。

• feRcuda 可以单独存在或进化。
• ferrite-mcp 只能在以下情况下显示图形工具 ferrite-graphics 存在。
• ferrite-graphics 可以直接通过以下方式使用 ferrite_graphics_lab 甚至

在MCP服务器之外。

当前的发现顺序为：

1. FERRITE_GRAPHICS_BIN 或 FERRITE_GRAPHICS_SCENE_CTL
2. FERRITE_GRAPHICS_ROOT
3. 已安装二进制文件 PATH

有用的环境变量：

• FERRITE_GRAPHICS_ROOT
• FERRITE_GRAPHICS_BIN
• FERRITE_GRAPHICS_SCENE_CTL
• FERRITE_GRAPHICS_INSTALL_PREFIX
• FERRITE_GRAPHICS_FERCUDA_ROOT
• FERRITE_GRAPHICS_MCP_ROOT
• FERRITE_GRAPHICS_DEFAULT_SCENE
• FERRITE_GRAPHICS_OUTPUT_DIR

安装程序先决条件：

• cmake
• 此存储库支持的可用C++/CUDA工具链
• ffmpeg
• curl
• tar

MCP表面

装运的控制平面路径目前支持：

• 运行时目标列表
• 运行时导出计划
• 运行时包写入
• 语义场景节点列表
• 语义场景节点变异
• 相机焦点重定向

这是用于支持可编程3D的层 feRcuda 操作系统UX。

近期方向

1. 定义 feRcuda 运行时适配器边界，而不是在任何地方都假设直接的原始CUDA所有权。
2. 为复杂的字段和转换定义一种紧凑的数学脚本格式。
3. 为3D程序实验添加场景/相机图元。
4. 构建第一个真正的图形管道：脚本IR->几何/现场作业->CUDA执行->渲染输出。

指导用例

1. 数学场景渲染。
2. 铁氧体运行时状态可视化。
3. 空间形式的内存、图形和调度器检查。
4. 用于演示和调试的工件生成。
5. 场景、材质、动画和预览工件的下游引擎交换。