首页
/ litegraph.js - 轻量级图形编辑库

litegraph.js - 轻量级图形编辑库

2026-01-15 17:39:05作者:田桥桑Industrious

在浏览器中构建类似Unreal Blueprints的图形界面从未如此简单。litegraph.js是一个JavaScript库,允许您轻松编程节点并提供一个用于构造和测试图的编辑器。无论是集成到现有Web应用还是单独运行图形,它都能胜任。

尝试在线演示

litegraph.js - 轻量级图形编辑库

功能概述

  • 在Canvas2D上渲染(支持缩放和平移,可绘制复杂接口,可用于WebGL纹理)
  • 用户友好的编辑器(搜索框、键盘快捷键、多选、右键菜单等)
  • 优化以支持每个图表数百个节点(在编辑器和执行时)
  • 可自定义的主题(颜色、形状、背景)
  • 回调以个性化每个节点的动作、绘图和事件
  • 子图表(包含自身图表的节点)
  • 实时模式系统(隐藏图表但调用节点进行渲染,适用于创建UI)
  • 图表可以在NodeJS中执行
  • 高度定制的节点(颜色、形状、垂直或水平槽口、小部件、自定义渲染)
  • 易于整合到任何JS应用(单文件,无依赖)
  • TypeScript支持

内置节点类型

尽管创建新节点类型很容易,但litegraph.js自带一些默认节点,可用于多种场景:

  • 接口(Widgets)
  • 数学(三角函数、数学运算)
  • 音频(AudioAPI和MIDI)
  • 3D图形(WebGL后处理)
  • 输入(读取游戏手柄)

安装与第一个项目

通过npm安装:

npm install litegraph.js

或者直接从仓库下载build/litegraph.jscss/litegraph.css

以下是一个简单的HTML示例,展示如何创建并运行一个litegraph.js图表:

<!DOCTYPE html>
<html lang="zh">
<head>
  <link rel="stylesheet" type="text/css" href="litegraph.css">
  <script type="text/javascript" src="litegraph.js"></script>
</head>
<body style='width:100%; height:100%'>
<canvas id='mycanvas' width='1024' height='720' style='border: 1px solid'></canvas>
<script>
  var graph = new LGraph();
  var canvas = new LGraphCanvas("#mycanvas", graph);
  // ...
  graph.start()
</script>
</body>
</html>

创建自己的节点类型

下面是如何创建一个可以相加两个输入值的新节点的例子:

function MyAddNode() {
  this.addInput("A","number");
  this.addInput("B","number");
  this.addOutput("A+B","number");
  this.properties = { precision: 1 };
}

MyAddNode.title = "Sum";

MyAddNode.prototype.onExecute = function() {
  var A = this.getInputData(0);
  var B = this.getInputData(1);
  this.setOutputData(0, A + B);
}

LiteGraph.registerNodeType("basic/sum", MyAddNode );

或包裹现有的函数:

function sum(a,b) {
   return a+b;
}

LiteGraph.wrapFunctionAsNode("math/sum", sum, ["Number","Number"], "Number");

服务器端使用

litegraph.js同样可以在NodeJS服务器端运行,不过某些与音频、图形、输入相关的节点在服务器端可能无法工作:

var LiteGraph = require("./litegraph.js").LiteGraph;

var graph = new LiteGraph.LGraph();

// ...

应用案例

工具和示例

包括用于生成文档、检查错误以及构建压缩版本的实用工具。要尝试示例,请按照以下步骤操作:

$ git clone https://github.com/jagenjo/litegraph.js.git
$ cd litegraph.js
$ npm install
$ node utils/server.js

然后在浏览器中访问http://localhost:8000/

反馈与贡献者

有任何反馈,欢迎发送邮件至javi.agenjo@gmail.com

感谢以下贡献者:

  • atlasan
  • kriffe
  • rappestad
  • InventivetalentDev
  • NateScarlet
  • coderofsalvation
  • ilyabesk
  • gausszhou

加入这个强大的社区,一起构建更优秀的可视化解决方案!

登录后查看全文
热门项目推荐
相关项目推荐