[AI]英雄无敌3的素材格式和引擎限制

Sun, 06 Sep 2026 12:00:00 +0800

本文记录发布时的实现与测量。文中的版本号、费用和检查数量属于该阶段；后续兵种安装记录见吸血鬼交付，现行工具入口见独立仓库。

我想把英雄无敌 3 的兵种美术换掉，在 VCMI 上做。

动手生成任何东西之前，我先去读了引擎代码，想知道它到底要什么。结果发现一堆规矩，基本没文档，而且踩了不报错——你只会得到一个看着别扭的兵种，还不知道哪儿不对。

画布尺寸只认第一帧

CreatureAnimation 从当前动画组的头一帧取尺寸：

auto first = forward->getImage(0, size_t(type), true);
fullWidth = first->width();

但 pos.w/pos.h 在单位创建时就定死了，后面每一帧都得从这个矩形里过：

canvas.draw(image, pos.topLeft(), Rect(0, 0, pos.w, pos.h));

比待机帧大的，超出部分直接裁掉；比它小的，就悬在半空。所以每个动画组的每一帧都得用同一张画布，靠透明像素填满。

getStackPositionAtHex 算绘制位置只看六边形——一个写死的 basePos(-189, -139) 加偏移，兵种自己的尺寸压根不参与。

从 PNG 读进来的帧 margins 是 (0,0)，不像 .def 帧自带边距。换句话说，兵种画在画布哪个位置，就是唯一的锚点。放偏了，单位要么浮空要么陷地，后面没有任何环节能补救。