FancyBox2D 图标 FancyBox2D

2D GAME ENGINE & RUNTIME

用 FCC 脚本构建 2D 世界

FancyBox2D 是面向 2D 游戏与交互式应用的运行时框架：以 Go 实现核心，以 Ebiten 负责图形呈现，并提供类 C 语法的 FCC 脚本开发体验。

开始学习 FCC 了解引擎能力

CAPABILITIES

为脚本驱动的 2D 应用准备

从对象、脚本到绘制命令，FancyBox2D 将运行时的核心环节组合在一起。

FCC 脚本语言

支持类、继承、函数、宏、条件和循环，让游戏逻辑以熟悉的类 C 语法表达。

对象与方法系统

以 Root 对象树组织窗口、文本、图像、地图与人物，并通过参数和方法组合交互行为。

命令流渲染

对象系统生成设备无关的 DrawCmd 绘制命令，由 Ebiten 后端执行 GPU 呈现。

独立启动器

使用 launcher.exe 直接运行 FCC 脚本，适合快速预览、演示与 Windows 开发流程。

嵌入式运行时

objsys.dll 以 c-shared 产物提供宿主集成入口，与独立启动器共享同一引擎核心。

编辑器扩展

VS Code / Qoder 插件提供 FCC 语法高亮与补全、F5 一键运行、运行时追踪面板，以及 ALE 动画资源预览与编辑（偏移十字线、播放速度、帧内脚本、帧序调整）。

完整学习手册

浏览 FCC 语法、内置函数、对象属性、系统方法与事件参考。

进入手册

WORKFLOW

从脚本到画面

FCC 源文件经过扫描、宏处理和语法解析后由解释器执行；对象树生成绘制命令，Ebiten 在屏幕上完成渲染。

  1. 编写使用 FCC 定义对象、事件和游戏逻辑。
  2. 运行由 launcher.exe 加载脚本并启动运行时。
  3. 呈现对象系统生成命令流，Ebiten 绘制最终画面。

DOCUMENTATION

从 FCC 学习手册开始

现有手册收录 900 余条语法、对象、方法、函数与事件参考，覆盖脚本开发的常用入口。

打开学习手册

RELEASE NOTES

最新更新

按日期罗列各次更新的内容，新的在上、历史的在下。

2026-09-30 · 启动器与运行时修复批次

  1. CmdBtn 系统按钮修复补齐按钮依赖的 10 个绘制内建函数与 frame 三态贴图参数，脚本类成员变量改为每实例独立，new CmdBtn(...) 可正常绘制并响应点击。
  2. 按钮圆角四角透明修复 CmdBtn 圆角处被渐变方块填充的缺陷，圆弧外的区域恢复透明。
  3. 按钮文字垂直居中文本绘制基线对齐 Windows GDI 语义，修复按钮文字整体偏低、不居中的问题。
  4. launcher 窗口行为修复 caption=1 时窗口内容不显示；修复 fixed 属性双向缺陷：fixed=0 恢复可调尺寸，fixed=1 不再丢失边框。
  5. 背景绘制修复roundbar 支持真圆角与可选描边，underline 下划线位置归位，roundhalf 半圆配色修正。
  6. 颜色解析修复RGB() 返回类型与 11 处颜色参数站点重打包，btnup/btndown/dotcolor 颜色不再串色，bk:=color(RGB(..)) 正常绘制。
  7. 热键触发修复增加虚拟键码与键名翻译，脚本按名字注册的热键在 launcher 中可以正常触发。
  8. pdesktop.fps帧率属性统一为小写 fps，旧的大写写法 FPS 仍兼容。

2026-09-19 · 运行时 0.1.0

  1. round4_3 圆角矩形背景bk:=round4_3 按半径绘制圆角矩形：填充色 2/3 强度源覆盖、可选描边、内缩/外扩边距均正常；修复负内缩整体不显示与正内缩四角通透斜线（圆弧描边 alpha 溢出）两个缺陷，已经用户验收。
  2. imgtile 图像平铺bk:=imgtile 按帧尺寸在对象矩形内平铺，9 帧自动九宫格贴图；方法与对象透明度相乘，支持 BMP/PNG/GIF，加载失败用背景色兜底；图片背景已在 Windows 原生 CPU 启动器验证，GPU 图片背景尚未验收，himgtile/vimgtile/imgscale 仍为占位。
  3. _T 文本居中与动画恢复半透明加亮、向上飘出和淡出删除；以整段文本居中，中文缺字时回退到 TTF 字体。
  4. 窗口缩放与运行版本绘制前同步客户区尺寸与布局，缩放不再重建或叠加 _T，已有动画保持进度；launcher 与 objsys 统一使用 0.1.0 三段式版本号并输出启动日志。
  5. colorex 与 glowcolorex 正确使用对象透明度与 RGB 颜色；glow 修复颜色偏差并恢复持续闪烁，flashspeed 表示闪烁速度而非次数。
  6. ellipse 动态尾迹将“椭圆环绕”统一命名为 ellipse，恢复两段对称的渐隐尾迹；支持负边距向外扩展，并遵守父容器裁剪。
  7. rect 双颜色边框上边和左边使用第一色，下边和右边使用第二色；修复 RGB 转换、默认第二色及边距绘制。
  8. dlg 图片背景支持 res$dlgbk.gif 与 res$defbk.gif 内置资源、9/10 图块平铺和顶部居中装饰；方法与对象透明度相乘，透明区域、裁剪及缩放后显示正确，并释放不再使用的纹理。