@chestnutlabs/gcode-colors

中文文档
0.21.1发布于 2026/11/04MITTypeScriptES Module构建来源已验证近 30 天下载 3083

栗子实验室G码工具路由堆栈(DD-014 D3)的渲染器-可知分层颜色模型:彩色模式结合和TolopathIR通道上诚实,能力分层取色,由3D和2D渲染器共享.

中文使用文档
文档目录3 节
  1. 颜色模式
  2. 使用量
  3. 许可证

@ chestnutlabs/ gcode- 颜色

不可知论者 每块颜色模型 联 合 国 栗子实验室 G 代码预览 工具路径堆栈(DD-014 D3).

这个包是工具路的单家 颜色子系统页:1 ColorMode 工会和工会 诚实、能力强的绘图 ToolpathIR 段到一个 RGB 3个 两个三.j 渲染器(@chestnutlabs/gcode-renderer-three)和低资源 2D 渲染器 (单位:千美元)@chestnutlabs/gcode-renderer-2d)依赖于它,所以色彩和动人的语义 永远不会漂移 他们之间.

这只取决于 @chestnutlabs/toolpath-core —— 说 没有 three,没有画布,没有框架。 。 。 .

颜色模式

模式频道诚实的后退
single—— 说无效( 一个颜色)
toolsegments.toolfallback 无调色板时
featuresegments.feature (0=不详)fallback 未知/ 没有调色板
colorChangecolorChanges[] 交换槽( M600, # 147)fallback 当没有更改/ 没有调色板时
feedratesegments.feedrate (mm/min; NaN = 未知, # 177) (中文(简体) )fallback 纳恩
objectsegments.object (基于 1; 0 = 无, # 178)fallback 无/无only

每一种模式都退化成 fallback 对于未知的频道值, 它从不编织 角色/速度/对象颜色。 读取可选通道的模式( E)feature, (中文(简体) ), object, (中文(简体) ), feedrate必须 为: 由呼叫者指定的能力 在使用前使用.

使用量

import { createSegmentColorer } from '@chestnutlabs/gcode-colors';

// Build a colorer once (feedrate auto-range is resolved here), then O(1) per segment.
const colorOf = createSegmentColorer(ir, { mode: 'feedrate', ramp: [[0, 0, 1], [1, 0, 0]], fallback: [0.7, 0.7, 0.7] });
for (let i = 0; i < ir.segments.count; i++) {
  const [r, g, b] = colorOf(i);
  // …map onto your surface (WebGL vertex buffer, Canvas 2D strokeStyle, …)
}

许可证

麻省理工学院栗子实验室. 见 仓库 来源和全力支持政策.

版本与发布记录

@chestnutlabs/gcode-colors 共发布 23 个版本,首次发布于 2026/07/28;过去 12 个月发布了 23 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.21.1latest2026/11/045 天前
0.21.02026/10/2911 天前
0.20.12026/09/032 个月前
0.20.02026/08/312 个月前
0.19.02026/08/282 个月前
0.18.02026/08/282 个月前

关于 @chestnutlabs/gcode-colors 的常见问题

@chestnutlabs/gcode-colors 是什么?

栗子实验室G码工具路由堆栈(DD-014 D3)的渲染器-可知分层颜色模型:彩色模式结合和TolopathIR通道上诚实,能力分层取色,由3D和2D渲染器共享.

如何安装 @chestnutlabs/gcode-colors?

在项目目录运行 npm install @chestnutlabs/gcode-colors,或使用 pnpm add / yarn add / bun add。

@chestnutlabs/gcode-colors 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@chestnutlabs/gcode-colors 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@chestnutlabs/gcode-colors 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@chestnutlabs/gcode-colors 可以商用吗?

@chestnutlabs/gcode-colors 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@chestnutlabs/gcode-colors 的下载量有多少?

根据 npm 官方下载统计,@chestnutlabs/gcode-colors 在 2026/10/10 – 2026/11/08 这 30 天内被下载 3,083 次,日均约 103 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@chestnutlabs/gcode-colors 还在维护吗?

最新版本 0.21.1 发布于 2026/11/04(5 天前);至今共发布 23 个版本,其中过去 12 个月发布了 23 个;首次发布于 2026/07/28。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。