@ genart- dev/ core (中文(简体) )
渲染器适配器、技能注册和运行时接口 格纳特.德夫 ——有MCP服务器的基因艺术平台,桌面应用,以及IDE扩展.
再出口一切从 @genart-dev/format 所以消费者可以得到完整的 API 格式而不单独导入.
安装
npm install @genart-dev/core
使用量
import {
createDefaultRegistry,
createDefaultSkillRegistry,
parseGenart,
resolvePreset,
} from "@genart-dev/core";
// Set up renderer registry with all 5 adapters
const renderers = createDefaultRegistry();
// Parse a .genart file and resolve its renderer
const sketch = parseGenart(JSON.parse(fileContents));
const adapter = renderers.resolve(sketch.renderer.type); // → P5RendererAdapter
// Validate an algorithm for a specific renderer
const result = adapter.validate(sketch.algorithm);
if (!result.valid) {
console.error(result.errors);
}
// Generate standalone HTML (embeds algorithm + CDN runtime)
const html = adapter.generateStandaloneHTML(sketch);
// Browse design knowledge skills
const skills = createDefaultSkillRegistry();
skills.list("composition"); // → 6 composition skills
skills.list("color"); // → 6 color skills
渲染器适配器
5个可插接的渲染引擎,每个装置 RendererAdapter 接口 :
| 适配器 | 类型 | 语言 | 运行时间 | 算法签名 |
P5RendererAdapter | p5 | Java 脚本 | 页:1 | function sketch(p, state) |
Canvas2DRendererAdapter | canvas2d | Java 脚本 | 土著 | function sketch(ctx, state) |
ThreeRendererAdapter | three | Java 脚本 | 3个J | function sketch(THREE, state, container) |
GLSLRendererAdapter | glsl | GLSL 语言 | 网络GL2 | 碎片阴影源 |
SVGRendererAdapter | svg | Java 脚本 | 土著 | function sketch(state) |
import { P5RendererAdapter } from "@genart-dev/core";
const p5 = new P5RendererAdapter();
// Validate algorithm source
p5.validate(algorithm);
// Compile for execution
const compiled = await p5.compile(algorithm);
// Create a live instance (browser context)
const instance = p5.createInstance(compiled, sketch.state, sketch.canvas);
instance.mount(document.getElementById("canvas"));
instance.updateState(newState);
instance.captureFrame({ format: "png" }); // → data URL
// Generate standalone HTML with embedded CDN runtime
const html = p5.generateStandaloneHTML(sketch);
// Get starter template for new sketches
const template = p5.getAlgorithmTemplate();
渲染器注册
import { createDefaultRegistry, RendererRegistry } from "@genart-dev/core";
// Pre-loaded with all 5 adapters
const registry = createDefaultRegistry();
registry.resolve("p5"); // → P5RendererAdapter
registry.resolve("glsl"); // → GLSLRendererAdapter
registry.list(); // → ["p5", "canvas2d", "three", "glsl", "svg"]
registry.getDefault(); // → P5RendererAdapter
registry.has("three"); // → true
技能登记处
以古典设计理论为基础的11个内置设计知识技能——组成原理(Arnheim, Wong)和色彩理论(Albers, Itten). 每个技能包括理论文本,关键原理,学术参考,以及可选的渲染器特定算法实例.
技能(6)
| 身份证 | 复杂性 | 来源 |
golden-ratio | 中级 | 1:1.618 比例,螺旋布局 |
rule-of-thirds | 初学者 | 3x3 电网、电站、动态平衡 |
visual-weight | 中级 | 大小、价值、饱和度、位置平衡 |
gestalt-grouping | 中级 | 近相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 |
figure-ground | 初学者 | 阳性形式对阴性空间 |
rhythm-movement | 高级 | 重复、变化、进步、流动 |
色彩技能(6)
| 身份证 | 复杂性 | 来源 |
color-harmony | 初学者 | 补充性、类似性、三角性、分部分补充 |
simultaneous-contrast | 高级 | 阿尔伯斯相邻的颜色感知变化 |
color-temperature | 初学者 | 温暖(提前)与凉爽(接收) |
itten-contrasts | 高级 | 这是7个对比型 |
value-structure | 中级 | 灯光、中子和暗子;通式键 |
palette-generation | 中级 | 算法 OKLCH 色彩空间生成 |
import { createDefaultSkillRegistry } from "@genart-dev/core";
const skills = createDefaultSkillRegistry();
const skill = skills.resolve("golden-ratio");
skill.theory; // Markdown theory text
skill.principles; // Key design principles
skill.references; // Academic citations
skill.suggestedParameters; // Example ParamDefs for this technique
skill.examples?.p5; // p5.js algorithm example
API 参考
接口
| 接口 | 说明 |
RendererAdapter | 制造引擎的合同——验证、编译、上载、捕获、出口 |
SketchInstance | 活生生的草图——挂载/卸载,更新状态,暂停/重现,捕获Frame |
SkillDefinition | 设计知识技能——理论,原理,参考,实例 |
SkillReference | 学术引文(标题、作者,年份) |
ValidationResult | 算法验证结果( E)valid + 键 errors[](中文(简体) ) |
RuntimeDependency | 独立 HTML 导出( 名称、 版本、 cdnUrl) 依赖 CDN |
CaptureOptions | 截图选项(格式、质量、比例) |
CompiledAlgorithm | 不透明编译算法手柄 |
类
| 类 | 说明 |
RendererRegistry | 按类型分列的登记和解析渲染器适配器 |
SkillRegistry | 注册和解决设计知识技能 |
工厂功能
| 函数 | 说明 |
createDefaultRegistry() | 登记册预装了所有5个变形器适配器 |
createDefaultSkillRegistry() | 登记册预装了所有11个技能 |
公用事业
| 函数 | 说明 |
hexToVec3(hex) | 转换 "#rrggbb" 改为 [r, g, b] 以 [0, 1] 形式浮动——用于 GLSL 制服 |
所有类型和职能来自 @genart-dev/format 被再出口: parseGenart, (中文(简体) ), serializeGenart, (中文(简体) ), parseWorkspace, (中文(简体) ), serializeWorkspace, (中文(简体) ), convertLegacySketch, (中文(简体) ), CANVAS_PRESETS, (中文(简体) ), resolvePreset, (中文(简体) ), SketchDefinition, (中文(简体) ), WorkspaceDefinition, (中文(简体) ), ParamDef, (中文(简体) ), ColorDef还有更多 见 格式 README 完整名单.
支助
问题、错误或反馈—— 支持@ genart.dev 或者说 打开一个问题。 。 。 .
许可证
麻省理工学院