先选项目,再进入软件
窗口初次显示在屏幕中央,可以拖动空白或画面区域移动;右上角可最小化或关闭。新建项目可以保存摄像机预设。最近项目最多 20 个,每张有实际画面预览;按住 Alt 滚轮调整缩略图大小,没有背景层时显示白底。

从 Pencil2D 到 HÁNABǏ Board:
看看改了什么,再跟着动图试一遍。
1.2.1 实际工作区 · 画面、相机、声音共用时间轴当前提供 Windows 64 位版本。手机可以阅读手册、分享网址;安装请在 Windows 电脑上完成。
1.4.0 安装包已完成本机安装、重装和卸载验证;性能优化与 TVPaint 效果对照继续迭代。
从 1.1.2 起,新安装包默认更新上次成功安装的位置;例如选择 D:\绘画软件,实际会安装到 D:\绘画软件\HÁNABǏ BOARD。已经选中软件文件夹时不再重复嵌套。已安装的 1.1.1 会直接沿用原目录。另选一个父目录可以保留两份程序,各自卸载互不影响。
你的习惯设置会保留。快捷键、轮盘、笔刷预设、外观和面板设置独立保存在本机的 Windows 用户配置中;更新、改换安装目录和卸载都不清理它们。同一 Windows 用户的多个版本共用这些设置,在一份程序里改动后,其他版本下次打开也会读取。
旧的解压版和个人工程不会自动删除。卸载可在 Windows「设置 → 应用」中操作;安装器只移除自己安装的文件。个人设置不会自动同步到另一台电脑。
安装包目前未做数字签名。若 Windows 显示“未知发布者”,可先核对本页的 SHA-256;不需要关闭系统安全防护。
文件:HANABI-Board-1.4.0-Setup.exe
SHA-256:fb4700682f84e2ffc623b323f0455876f257dcd476e2c07516a7fd679c245d0f
新建项目和最近项目都在启动窗口;选择后编辑器才显示。
点开版本时间线,看新增、优化、修复与使用入口。
02 / 与原版比逐项对照 Pencil2D,区分新增、改动、移除和保留。
03 / 跟着动图用暂停、重播或拖动进度,仔细看工具的响应。
.pclx,用 Ctrl + Shift + S 另存一个副本。点击一个版本,查看当时做了什么;“怎么用”链接会带你到当前版本的使用说明。
各版本发布日期以更新日志为准;用版本先后顺序区分迭代。0.1–0.6 对应早期六次测试,内部候选改进归入 1.0。旧包和源码标签保留原编号,便于回溯;本手册不附旧版程序。
先认清工具的边界,就不会把没实现的功能当成入口找。
共 27 项对照
| 类型 / 功能 | Pencil2D 0.7.2 | HÁNABǏ Board 1.4.0 |
|---|---|---|
| 新增画面文字 T ↗ | 没有本项目的多行文字工具 | 字体、字号、粗体、当前颜色实时预览;确认写入位图层,可撤销和导出 |
| 改动轨道高度与标记 ↗ | 原生图层时间轴显示 | 左侧 Alt 滚轮调单轨高度,固定字号编号,参考标签色与取色 |
| 改动全局播放与导出 ↗ | 单场景相机输出 | 按镜头排列合成图片、影片与声音 |
| 新增镜头调时长与跨镜头转移 ↗ | 没有本项目的镜头容器 | 尾缘调单段、角点等比调全段、联动、空隙与上下轨叠加 |
| 新增独立镜头与剪辑区 ↗ | 一个工程内的图层/帧时间轴 | 每个镜头独立画稿、声音和相机,和画布同窗编辑 |
| 新增Ctrl 整笔选择 / 变换 ↗ | 原生矩形像素选择 | 碰到即选中整笔;独立移动、八点变换和可移动轴心 |
| 改动复杂画面的笔触变换 ↗ | 本扩展的整笔变换不属于原版 | 1.1.1 复用未变化画面,局部重画并限制临时缓存 |
| 新增套索填充 ↗ | 无本项目的套索填色工具 | D 勾画时仅显示轮廓,松开填入当前位图层;Caps 可擦除,Esc 可取消 |
| 新增独立 PS 式笔刷 ↗ | 原生铅笔、钢笔、笔刷等 | 另加印章式引擎和 9 类参数 / 压感控制;原生笔刷保留 |
| 新增笔刷预设库 ↗ | 无本项目的跨引擎预设库 | 保存、调用、重命名、删除,笔尖缩略图,独立于工程保存 |
| 新增自定义工具轮盘 ↗ | 无本项目的 Tab 圆钮轮盘 | 2–12 项,工具 / 预设绑定;点击或长按 Tab 扇区确认 |
| 新增独立相机工具 C ↗ | 相机层配合移动工具操作 | 明确的摄像机入口,直接选择相机层;旧移动工具仍可用 |
| 改动相机控制与光标 ↗ | 原生相机与控制框 | 外侧圆角旋转区、悬停柔光、64 逻辑像素光标、随框转向,接入撤销 |
| 改动工具短按 / 长按 ↗ | 已有抓手等临时操作 | 扩展为工具键的短按保留 / 长按返回;C 还恢复原绘画层 |
| 改动关键帧直接拖动 ↗ | 原生关键帧时间轴 | 首次按下即可拖、延续区抓取、实时落点、边缘滚动、冲突取消 |
| 改动移动与绘画混合撤销 ↗ | 原生撤销重做 | 移动与绘画按顺序进入同一历史;不复制整幅图,历史仍为 20 步 |
| 改动时间轴视觉反馈 ↗ | 原生轨道与选择 | 分层配色、加深延续区、跟随鼠标的定位线;播放头独立 |
| 改动透写台入口 ↗ | 已有洋葱皮与参数面板 | 收为时间轴小灯泡,点击浮出完整设置,外部点击收起 |
| 新增透写台自选颜色 / 吸色 ↗ | 前后帧已有着色显示 | 前后颜色独立保存,可在软件画布、色板、浮动面板内取色 |
| 改动快捷键设置 ↗ | 已有可配置快捷键 | 松键录入、双击清空、标点 / 修饰键 / 组合键,冲突只询问一次 |
| 新增浅色 / 深色外观选择 ↗ | 沿用原有界面外观 | 中性深灰贯穿主窗口与子界面,立即切换;预设列表仍为白底 |
| 改动新面板与原生停靠 ↗ | 已有浮动、停靠和窗口菜单 | 新面板接入菜单;PS 参数可滚动,不挤住时间轴调整高度 |
| 改动交互刷新与缓存 ↗ | 原生绘画 / 时间轴渲染 | 轮盘文字、相机光标与时间轴底图复用;活动结束停用相应轮询 |
| 改动品牌、版本与设置 ↗ | Pencil2D 名称与独立配置 | HÁNABǏ 名称、圆角图标、数字版本、便携包;预设与布局延续 |
| 移除矢量绘画 ↗ | 位图、矢量、声音、相机 | 移除矢量层、路径 / 曲线编辑与专用读写;旧矢量工程明确拒绝 |
| 保留无限画布 / 分层绘画 ↗ | 原生已有 | 仍使用原生画布、位图叠放、声音层、相机层,不计作新增 |
| 保留动画与工程基础 ↗ | 原生已有 | 关键帧、相机动画、透写基础、播放、PNG / 视频导出及 .pclx |
比较对象固定为项目使用的 Pencil2D v0.7.2。这里只把本分支实际实现的差异列为新增或改动。
下列 GIF 由当前原生 Qt 程序的自动检查画面制作,展示实际控件状态与合成输入结果。它们不是实体数位板录像。
窗口初次显示在屏幕中央,可以拖动空白或画面区域移动;右上角可最小化或关闭。新建项目可以保存摄像机预设。最近项目最多 20 个,每张有实际画面预览;按住 Alt 滚轮调整缩略图大小,没有背景层时显示白底。

选择套索填充 D 后,按住鼠标或笔勾画,拖动中只显示轮廓,松开后一次提交填充。按住 Caps 再勾画会擦除;羽化、不透明度和抗锯齿/平滑在「选项」中设置。数值条可直接拖动,悬停会变亮。

按住 Ctrl 圈选整笔,松开鼠标后继续按着 Ctrl,就能追加选择、移动、缩放或旋转。加按 Shift 可沿直线移动、等比缩放、以 15° 为步进旋转。松开 Ctrl 立即取消选择。

智能模糊作为图层效果项保留参数;Ctrl 选中原始笔触后拖动时,预览跟随更新,切换工具或取消选择仍能回到原稿。图层组支持整理画稿,效果项与图层面板一起显示。

按住 Alt 拖动鼠标,可从画布以外的可见界面吸取颜色。取色结果回到当前颜色;不必先切换到吸管工具。

悬停导航、缩放和拖动保持目标对象跟手;Ctrl 圈选、大画布绘画和数位笔拖动继续按固定场景做延迟测量。测得数值受工程体量与机器影响,1ms 仍是目标。

图层面板可创建、整理和拖放图层组。智能模糊与普通画稿分开显示;当前选中项决定编辑对象。使用前先核对是否处在画稿层。

Ctrl 必须持续按住;松开 Ctrl 就取消选择。

移动、缩放和旋转笔触时,复用没变的画面,只重画受影响的地方。
拖动和提交都改用局部重画,排除绘制范围外的笔触;临时预览补片最多 16 MiB,结束即释放,不带进撤销快照。保存和读取按行批量处理像素,工程格式与 1.1 保持一致。
在 20,000 笔交叠曲线的受控样例中,单次变换预览中位耗时由约 20.8 ms 降至约 0.59 ms。这是预览绘制环节的测量,不是整机帧率或实物数位笔延迟。
大面积高分辨率笔触仍会占用内存,保存仍同步执行。工程规模不同,实际表现也会不同;请继续用真实创作反馈手感。
拖动只显示轮廓,避免每个输入点都重算羽化与像素。

原生笔刷继续使用;PS 式笔刷是独立加入的印章式绘画工具。

点工具箱的 PS 按钮,或「窗口 → PS 式笔刷 → 使用此笔刷」。默认没有占用快捷键,可以自行绑定。

预设独立于工程保存,重启后仍可调用。缩略图帮助辨认笔尖,不保证与实际整条笔迹完全相同。

快速点开,也可以按住 Tab 后用方向选。

快速按一下 Tab 再松开,轮盘留在画面上。单击一个圆钮,工具切换,轮盘收起。
适合慢慢看清工具后再选。
按住 Tab,先让光标碰到想选的圆钮,看到它凸起。继续留在它后方的同一扇区,松开 Tab 即选中。
不必回到圆钮上点一下;想点也可以。

不会把你的外圈工具挤走。也可以右键一个外圈圆钮,绑定“相机层 / 绘画层”,沿用按住 Tab 后松键确认的方式。
从没碰到圆钮就直接滑到远处、回到中心、跨出已激活的扇区、进入菜单 / 标题栏或窗口外,都会取消当前候选。按 Esc 或再按一次 Tab 可以收起。
相机决定最终画面。相机层和基础相机动画原本就有,本版改的是入口、控制与反馈。

按 C 或点小摄像机,进入相机层。拖动框内移动取景框。
角上的小方块用于缩放。放大后的光标帮助你辨认命中的操作。
外侧深灰括角悬停时发亮、变大。旋转箭头按角的方向与相机一起转。
相机操作支持撤销、重做和保存。做相机运动时,在相机层选好相应关键帧再调整取景;基础相机动画继续沿用 Pencil2D。
相机内安全框左上角的 C02-k1 表示镜头与画面顺序。文字保持 16 个逻辑像素,不随缩放变大,但位置和方向跟相机框一起移动、旋转;深灰字配浅描边。
自定义缩放、旋转和调时长光标增大到 64 个逻辑像素,圆角黑色主体配白边与轻柔光,浅色和深色背景都能看清。旋转箭头随框角方向变化;文字编辑和 Windows 系统光标保留原生形式。

画面轨在上,相机在中间,声音在下。每个镜头仍然有自己的多层画稿,切到镜头就能继续画。

点画面关键帧区,回到该镜头上次使用的位图层与绘画工具;直接选择笔刷,也会离开相机层。每个镜头分别记住正在画的层,保存重开仍保留。
松笔后优先更新当前画面预览。缩略图放在关键帧画面区中心,随可用空间变大或缩小。
拖动画面/相机、相机/声音之间的分隔线,立即改变分区高度。右侧三条拖条互相独立:拖中间上下查看,拖两端圆点改变轨道高度。
相机轨显示全序列;重叠时以上方可见画面轨的相机为准,点击即可编辑对应镜头。
镜头外开始:从空白处拖框,碰到的整段镜头实时高亮。可以跨轨框选,拖动已选镜头一起移动。
镜头内开始:从画面区块下方的空白带拖框,只选中这个镜头里碰到的关键帧。即使框拉到其他镜头,也不会换对象。
Shift 拉框可以加选、减选;Esc 取消。直接抓关键帧仍然用于移动,拖边缘用于改时长。
单击两段镜头之间的空隙,它会整段变成浅灰色。按 Backspace 或 Delete 合拢,Ctrl+Z 可撤销。
开启「后续跟随」会推动后面的未锁定画面轨。如果其他轨道占用这段时间,则保留原内容并提示;关闭「后续跟随」可只合拢当前轨。最后一段之后的无限空白不能删除。


拖画面区块边缘调整停留时间;拖镜头右下角的小方块按比例调整整段。光标上方显示帧数,相机与声音随之预览,松开才提交一次修改。按 Esc 放弃,靠近左右边缘会持续滚动。
改动若会让相机关键帧重叠,则取消本次修改。声音保持原速,不做音频变速。
相机区可按退格增加控制点,拖动菱形改帧位,选中后 Delete 删除。声音块可拖动,拖两端裁剪,切分工具可切开声音。
「+声音轨」先加空轨,然后把音频文件拖进镜头覆盖的区域;也可点「导入声音」。当前声音仍归属于镜头,不能作为跨多个镜头的全局音乐轨;暂时没有波形、混音或变速。
不用先点选:悬停轨道左侧,Alt+滚轮只调该轨高度;悬停内容区,Alt+滚轮围绕鼠标时间缩放。底部拖条可用 Ctrl+滚轮(也保留 Alt);拖中间平移,拖两端圆点缩放。普通滚轮在内容区移动时间,在左侧上下看轨道。
相邻镜头深浅交替,关键帧底色与镜头结构分开;选中整段用清晰外框标识。右键可改整个镜头主色。点左侧「显示/隐藏」才切换可见性;「锁定」防止剪辑移动、删改和被覆盖,它不是画稿笔触锁。
扩展名仍是 .pclx,独立镜头工程需要 1.2.0 或以上版本。旧 pclx 第一次原位保存会保留 .pre-1.2.pclx 升级前副本。没有宣称 PR 全功能复刻:滑移、滑动、滚动剪辑、全局声音混音与独立字幕轨尚未加入。
字幕、对白或画面说明都可以放进当前位图层。

确认后文字成为当前层的位图像素,能撤销、保存与导出;可用 Ctrl 整笔选择移动、缩放、旋转。目前不能重新编辑已确认的字句,也没有独立字幕轨。需要改字时撤销后重新输入。
1.2.2 的现行操作以「镜头剪辑」章节为准。下方旧图演示的是早期原生逐帧时间轴;它已并入统一剪辑区。
当前操作:从镜头外的空白处拉框选镜头;从镜头内画面区块下方的空白带拉框选本镜头关键帧。Shift 加选/减选,边缘调整停留时间,拖区块移动。
选中内容时,退格或 Delete 删除选中对象;没有选中内容时,退格在鼠标指到的帧位新建关键帧。先按 Esc 可清空选择。更多操作见 统一剪辑区。
已有关键帧时保持原样,不覆盖,也不挤动后面的帧。按 Ctrl + Z 可以撤销。鼠标放在上方时间尺时,在当前选中图层建帧;隐藏轨道、声音轨道不创建。
正在输入文字或数值、播放、弹窗操作、按笔绘画时不会抢占退格键。


Ctrl 多选、Shift 连选、Alt 选择后续帧,以及空白处框选继续保留。选中后可一起拖。
移动一个关键帧不会自动把所有后续帧一起推走;要整组挪动,先选好那一组。
Ctrl + Z 撤销,Ctrl + Shift + Z 重做。绘画和移动按同一操作顺序回退,历史仍限 20 步。
两关键帧之间的延续区颜色更深;选中高亮与播放头可能覆盖基础配色。鼠标定位竖线按帧边界跳动,单纯移动鼠标不会改变当前播放帧;按退格新建关键帧后才切到目标帧。
洋葱皮原本就有。本版把它收进时间轴旁的弹出面板,并加入自定义颜色与全局吸色。
正在画的时候,少一次切回工具,就少一次打断。
正在用笔刷 → 按住 Space → 拖动画布 → 松开 Space → 回到笔刷。
超过约 0.2 秒的按住,或已经执行拖动,松开会恢复;短按则保留刚切换的工具。
若键先松开、笔还没抬起,会等本次拖动结束再恢复,避免多出笔迹。
输入文字或数值时不抢键。这里的短按 / 长按是工具逻辑,保存等普通命令不按此方式处理。

可以录入字母、数字、标点、单独 Alt / Ctrl / Shift,以及组合键。已经用来组成其他快捷键或参与滚轮操作的修饰键,不会在松开时再误触发一次。Windows 保留组合仍由系统优先处理。
| 用途 | 当前默认按键 | 用途 | 当前默认按键 |
|---|---|---|---|
| 套索填充 | D | 相机 | C |
| 抓手 | Space | 工具轮盘 | Tab |
| 原生笔刷 / 橡皮 | B / E | 铅笔 / 吸管 | N / I |
| 无选择:所指帧新建;有选择:删除 | Backspace | 相机 / 绘画层切换 | 轮盘中央按钮 |
| 新建 / 复制关键帧 | F7 / F6 | 前 / 后一帧 | , / . |
| 保存 | Ctrl + S | 播放 / 停止 | Ctrl + Return |
| 撤销 | Ctrl + Z | 重做 | Ctrl + Shift + Z |
| 画面文字 | T | 取消剪辑选择/拖动 | Esc |
| 剪辑选择/切分/抓手 | Q / W / H | 新增镜头、轨道、切换吸附等 | 在快捷键页自行绑定 |
浅色是默认;深色用中性灰。所有面板仍跟随原生 Qt 工作区。
「编辑 → 首选项 → 通用 → 外观」选择浅色或深色。主窗口、时间轴、菜单、首选项与浮动面板立即切换,并保存到下次启动。
画面颜色不会随主题改变。笔刷预设列表在两种主题下都使用白纸底。
拖动画布与时间轴的分隔边界调整高度;拖动面板标题栏可以浮动或重新停靠。点 × 关闭的面板,从「窗口」菜单重新打开。
PS 参数区不够高时可滚动,避免参数高度挤住时间轴。浮动、停靠和原生窗口菜单本来就有;新增面板接入同样规则。

新增工具与说明优先使用中文,相机选项与状态栏补充了翻译;原生部分界面仍可能保留英文。当前不把“全覆盖汉化”列为已完成。
原生 Qt 无限画布、独立镜头与时间轴、位图层和图层组、相机、声音、文字 T、智能模糊、三种整层模糊、轻量 3D/2.5D、项目入口与最近项目缩略图。具体格式与边界以对应功能章节为准。
TVPaint 自由手绘填充的所有参数尚未逐像素验收;大工程全程 1ms 响应也尚未达成。完整 Photoshop ABR 笔刷兼容、完整非破坏二维补间、全局混音和完整三维建模仍未实现。
本轮性能复测以离屏 Qt 和合成输入为主:固定大范围软边圈选的移动帧 P95 为 0.42ms,复杂软边笔触变换 P95 约 4.96ms。实际数字随硬件、画布及笔触复杂度变化,不能等同物理数位板手感。
以保留的版本记录和当前实现为准,不把历史需求当作已完成功能。
1.4.0 源码归档与安装包一同提供;性能和效果限制以现行说明为准。
HÁNABǏ Board 基于 Pencil2D,保留原作者版权与 GPL-2.0 授权。本手册保留 1.0 操作动图,整笔选择图片来自 1.1.1 控件渲染,切层按钮和逐帧定位图片来自 1.1.3 控件渲染;历史版本页中的“怎么用”跳转到现行用法。
手册整理:2026-09-24 · 使用说明适用版本:1.4.0。
1.2.0 新增剪辑截图和动图来自实际 Qt 控件渲染与合成输入。镜头结构、保存重开、撤销、逐帧导出和声音裁切有独立检查;性能数据为固定场景测量,未把模拟笔事件当成实物数位板验证。
1.2.1 新截图来自实际 Qt 控件渲染。界面检查包含镜头内外框选、空隙删除、鼠标与合成笔、文字、保存重开;测试不能代替实体数位板手感,也不代表任意体量工程都零延迟。
1.2.2 工作区截图来自真实 Qt 控件。新增检查覆盖焦点仍在画布时的悬停滚轮、相机往返后的实际像素落笔、缩略图更新、分区拖动与相机重叠选择;实体数位板手感仍需体验验证。