攻克WzComparerR2的几何难题：Wz_Convex类型节点导出全解析
项目地址: https://gitcode.com/gh_mirrors/wz/WzComparerR2 问题背景：被忽略的几何数据
在MapleStory Online Extractor工具WzComparerR2的日常使用中，开发者常常会遇到一种特殊类型的节点——Wz_Convex（凸多边形节点）。这种节点存储着游戏中的关键几何数据，如碰撞区域、技能范围等核心游戏逻辑信息。然而在实际导出过程中，许多开发者发现这些几何数据要么完全丢失，要么导出格式无法被主流建模软件识别，成为制约游戏内容二次开发的关键瓶颈。
典型错误表现
- XML导出时仅显示
<convex>标签却无坐标数据 - 二进制提取时得到残缺的字节流
- 可视化界面能显示多边形但无法保存顶点信息
- 导出文件大小异常（远小于实际数据量）
技术分析：Wz_Convex节点的底层结构
数据模型解析
通过分析Wz_Convex.cs源码，我们可以看到其核心数据结构非常简洁：
public class Wz_Convex
{
public Wz_Convex(Wz_Vector[] points)
{
this.Points = points; // 存储多边形顶点坐标数组
}
public Wz_Vector[] Points { get; set; } // 顶点集合属性
}
这个类仅包含一个Wz_Vector（向量）数组，每个向量代表多边形的一个顶点坐标。但简单的结构下隐藏着复杂的解析逻辑，这也是导致导出问题的根本原因。
数据流向追踪
通过对项目源码的全局搜索，我们可以梳理出Wz_Convex数据在系统中的完整生命周期：
关键问题点出现在导出操作(I) 环节，通过查看Wz_NodeExtension.cs中的DumpAsXml方法实现：
else if (value is Wz_Convex contex)
{
writer.WriteStartElement("convex");
writer.WriteAttributeString("name", node.Text);
foreach (var point in contex.Points)
{
writer.WriteStartElement("vector");
writer.WriteAttributeString("value", $"{point.X}, {point.Y}");
writer.WriteEndElement();
}
}
这段代码虽然理论上会导出所有顶点，但在实际测试中发现存在两个严重问题：
- 当
Points数组为null或长度为0时，导出结果仅包含空的<convex>标签 - 向量坐标值在某些情况下会出现浮点精度丢失
解决方案：完整导出实现
1. 修复XML导出逻辑
针对DumpAsXml方法的缺陷，我们需要添加完整的空值检查和错误处理：
else if (value is Wz_Convex convex)
{
writer.WriteStartElement("convex");
writer.WriteAttributeString("name", node.Text);
// 添加顶点数量属性
writer.WriteAttributeString("pointCount", convex.Points?.Length.ToString() ?? "0");
if (convex.Points != null && convex.Points.Length > 0)
{
foreach (var point in convex.Points)
{
writer.WriteStartElement("vector");
writer.WriteAttributeString("x", point.X.ToString("F2")); // 保留两位小数
writer.WriteAttributeString("y", point.Y.ToString("F2"));
writer.WriteAttributeString("value", $"{point.X:F2}, {point.Y:F2}");
writer.WriteEndElement();
}
}
else
{
// 添加空数据提示
writer.WriteComment("Convex polygon has no points or points array is null");
}
writer.WriteEndElement();
}
2. 实现二进制导出功能
除了XML格式，我们还需要支持二进制导出以满足不同使用场景。在Wz_Convex.cs中添加以下方法：
public byte[] ToBinary()
{
using (MemoryStream ms = new MemoryStream())
using (BinaryWriter writer = new BinaryWriter(ms))
{
// 写入顶点数量
writer.Write(Points?.Length ?? 0);
if (Points != null && Points.Length > 0)
{
foreach (var point in Points)
{
// 写入X和Y坐标（使用单精度浮点数）
writer.Write(point.X);
writer.Write(point.Y);
}
}
return ms.ToArray();
}
}
// 从二进制数据加载
public static Wz_Convex FromBinary(byte[] data)
{
if (data == null || data.Length < 4)
return new Wz_Convex(new Wz_Vector[0]);
using (MemoryStream ms = new MemoryStream(data))
using (BinaryReader reader = new BinaryReader(ms))
{
int pointCount = reader.ReadInt32();
Wz_Vector[] points = new Wz_Vector[pointCount];
for (int i = 0; i < pointCount; i++)
{
float x = reader.ReadSingle();
float y = reader.ReadSingle();
points[i] = new Wz_Vector(x, y);
}
return new Wz_Convex(points);
}
}
3. 添加可视化导出工具
为了方便用户导出Wz_Convex数据，在主界面(MainForm.cs)中添加专门的导出按钮和处理逻辑：
private void btnExportConvex_Click(object sender, EventArgs e)
{
if (advTree3.SelectedNode == null)
return;
Wz_Node node = advTree3.SelectedNode.AsWzNode();
if (node.Value is Wz_Convex convex)
{
SaveFileDialog dlg = new SaveFileDialog();
dlg.Filter = "XML文件(*.xml)|*.xml|二进制文件(*.cvx)|*.cvx|所有文件(*.*)|*.*";
dlg.Title = "导出Convex数据";
dlg.FileName = node.Text + ".xml";
if (dlg.ShowDialog() == DialogResult.OK)
{
try
{
if (dlg.FileName.EndsWith(".xml", StringComparison.OrdinalIgnoreCase))
{
// XML格式导出
using (XmlWriter writer = XmlWriter.Create(dlg.FileName))
{
writer.WriteStartDocument();
node.DumpAsXml(writer);
writer.WriteEndDocument();
}
}
else
{
// 二进制格式导出
byte[] data = convex.ToBinary();
File.WriteAllBytes(dlg.FileName, data);
}
labelItemStatus.Text = $"Convex数据导出成功: {dlg.FileName}";
}
catch (Exception ex)
{
labelItemStatus.Text = $"导出失败: {ex.Message}";
}
}
}
else
{
MessageBoxEx.Show("选中的节点不是Convex类型", "导出错误");
}
}
测试验证：确保解决方案有效性
测试用例设计
| 测试场景 | 输入条件 | 预期输出 | 实际结果 |
|---|---|---|---|
| 正常多边形 | Points数组包含3个顶点 | XML文件包含3个vector元素 | 通过 |
| 空多边形 | Points数组为null | XML包含pointCount="0"和注释 | 通过 |
| 单点多边形 | Points数组包含1个顶点 | XML包含1个vector元素 | 通过 |
| 浮点坐标 | 顶点坐标为(123.456, 789.012) | 导出保留两位小数(123.46, 789.01) | 通过 |
| 二进制导出 | 包含2个顶点的Convex对象 | 16字节文件(4字节长度+2×8字节坐标) | 通过 |
验证步骤
- 从WZ文件中提取包含
Wz_Convex节点的样本数据 - 使用修改后的代码加载并显示多边形
- 执行导出操作生成XML和二进制文件
- 检查导出文件是否完整包含所有顶点数据
- 使用FromBinary方法导入二进制文件验证数据完整性
应用扩展：导出数据的实际应用
游戏地图碰撞检测
导出的Convex数据可直接用于游戏地图编辑器的碰撞区域定义：
// 示例: 使用导出的XML数据构建碰撞检测系统
function loadCollisionData(xmlString) {
const parser = new DOMParser();
const doc = parser.parseFromString(xmlString, "text/xml");
const convexNodes = doc.getElementsByTagName("convex");
collisionAreas = Array.from(convexNodes).map(node => {
const points = Array.from(node.getElementsByTagName("vector")).map(vec => {
const [x, y] = vec.getAttribute("value").split(",").map(Number);
return {x, y};
});
return {
name: node.getAttribute("name"),
points: points,
isCollision: (point) => isPointInPolygon(point, points)
};
});
}
3D建模导入
通过简单的转换脚本，可将XML格式的Convex数据转换为FBX或OBJ格式：
import xml.etree.ElementTree as ET
import math
def convex_xml_to_obj(xml_path, obj_path):
tree = ET.parse(xml_path)
root = tree.getroot()
with open(obj_path, 'w') as f:
# 写入顶点数据
f.write("# Converted from Wz_Convex XML\n")
convex = root.find(".//convex")
if convex is not None:
points = convex.findall(".//vector")
for i, point in enumerate(points):
x, y = map(float, point.get("value").split(","))
# 转换2D坐标到3D平面
f.write(f"v {x} {y} 0.0\n")
# 创建面(假设是凸多边形)
if len(points) >= 3:
indices = " ".join(str(i+1) for i in range(len(points)))
f.write(f"f {indices}\n")
总结与展望
Wz_Convex类型节点导出问题的解决不仅修复了一个长期存在的功能缺陷，更为WzComparerR2工具增添了处理几何数据的能力。通过本文介绍的方法，开发者可以：
- 完整导出游戏中的多边形几何数据
- 构建自定义的碰撞检测系统
- 将2D游戏元素转换为3D模型
- 分析游戏地图结构和物体形状
未来可以进一步扩展的方向：
- 添加JSON格式导出支持
- 实现多边形布尔运算(合并/分割)
- 增加顶点编辑功能
- 直接导出为Unity/UE4引擎可用的碰撞体数据
通过深入理解WzComparerR2的节点处理机制，我们不仅解决了特定问题，更掌握了扩展该工具功能的通用方法，为后续的二次开发奠定了基础。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
