Dialogic项目中的角色肖像百分比尺寸适配问题解析

问题概述

在Dialogic 2.0 Alpha 16-WIP版本中，当使用百分比尺寸设置角色肖像时，发现肖像缩放没有正确处理窗口拉伸模式(Window Stretch Mode)的设置。这个问题会导致在不同显示模式下(如窗口模式和全屏模式之间切换时)，角色肖像的尺寸表现不一致。

技术背景

在Godot引擎中，窗口拉伸模式(Window Stretch Mode)是一个重要的显示设置，它决定了游戏内容如何适应不同分辨率的显示设备。常见的拉伸模式包括：

1. canvas_items模式：基于CanvasItem节点的缩放
2. viewport模式：基于视口的缩放

当项目设置中指定了不同的视口大小和窗口覆盖大小时，引擎应该根据拉伸模式自动调整内容的显示比例。然而在Dialogic的角色肖像系统中，这一机制没有被正确实现。

问题表现

具体表现为：

1. 当项目设置中同时指定了视口大小(如1920x1080)和窗口覆盖大小(如1152x648)时
2. 使用百分比尺寸(如y1表示100%高度)设置角色肖像位置
3. 在不同显示模式间切换时，角色肖像的尺寸不会根据内容缩放比例调整

影响范围

这个问题会影响以下使用场景的开发：

• 需要同时支持窗口模式和全屏模式的项目
• 使用不同分辨率进行开发和发布的项目
• 需要精确控制UI元素在不同显示模式下保持相对比例的项目

解决方案分析

问题的根源在于角色肖像尺寸计算时直接使用了窗口尺寸，而没有考虑content_scale_size这一关键参数。正确的实现应该：

1. 检测当前项目的拉伸模式设置
2. 根据不同的拉伸模式选择适当的参考尺寸
3. 对于百分比尺寸计算，使用经过内容缩放调整后的尺寸

技术实现建议

在代码层面，建议修改subsystem_containers.gd文件中的尺寸计算逻辑，加入对内容缩放比例的考虑。具体可能需要：

1. 获取当前窗口的内容缩放比例
2. 根据项目设置选择正确的参考尺寸
3. 实现不同拉伸模式下的尺寸计算逻辑

兼容性考虑

由于这一修改可能影响现有项目的显示效果，建议：

1. 在下一个主要版本中引入这一改进
2. 提供详细的升级指南
3. 考虑添加兼容性选项以保持旧项目的表现

总结

Dialogic作为Godot引擎的重要对话系统插件，其UI元素的尺寸适配能力对于多分辨率支持至关重要。正确处理窗口拉伸模式下的百分比尺寸计算，将大大提升插件在不同显示环境下的表现一致性，为开发者提供更可靠的UI布局控制能力。