Tencent/libpag 4.4.29版本发布：解码优化与文本渲染修复

Tencent/libpag 4.4.29版本发布：解码优化与文本渲染修复

libpag The official rendering library for PAG (Portable Animated Graphics) files that renders After Effects animations natively across multiple platforms. 项目地址: https://gitcode.com/gh_mirrors/li/libpag

Tencent/libpag是腾讯开源的一个高效动画渲染库，它能够解析和渲染PAG（Portable Animated Graphics）格式的动画文件。PAG格式是腾讯开发的一种矢量动画格式，具有体积小、渲染效率高、跨平台等优势，广泛应用于移动端、Web端等各种场景的动画展示。

本次发布的4.4.29版本主要针对解码性能和文本渲染进行了优化和修复，提升了动画播放的稳定性和用户体验。下面我们详细解析这次更新的技术内容。

鸿蒙平台解码优化

在鸿蒙（HarmonyOS）平台上，本次更新调整了软件解码的最大送帧数量，将其修改为maxReorderSize + 1。这一改动解决了在某些情况下出现的解码异常问题。

在视频解码过程中，maxReorderSize参数决定了解码器可以重新排序的帧数上限。当解码器遇到B帧（双向预测帧）时，可能需要重新排序帧以确保正确的显示顺序。原先的设置可能导致在某些复杂场景下解码器无法正确处理帧顺序，从而引发解码异常。通过将最大送帧数量调整为maxReorderSize + 1，解码器现在能够更灵活地处理帧顺序，提高了解码的稳定性。

PAG文件解码安全性增强

本次更新在解码PAG文件时增加了对迭代过程中异常的检查，有效防止了可能的内存溢出问题。

PAG文件解析过程中涉及大量的数据迭代操作，特别是在处理复杂动画时。如果文件数据异常或损坏，可能导致迭代过程失控，进而引发内存溢出。新增的异常检查机制能够在迭代过程中及时检测到异常情况，避免程序崩溃，提高了库的健壮性。

苹果平台文本渲染修复

修复了在苹果平台上添加换行后部分文本无法显示的问题。这个问题主要影响包含多行文本的PAG动画，在某些情况下，换行后的文本内容可能无法正确渲染。

文本渲染是PAG动画中的重要组成部分，特别是在包含大量文字内容的场景中。本次修复确保了文本布局和渲染的正确性，使得多行文本能够完整显示，提升了用户体验。

视频禁用功能修复

修复了当videoEnable设置为false时运行BMP预合成素材导致的崩溃问题。videoEnable参数用于控制是否启用视频解码功能，当设置为false时，理论上应该只渲染非视频内容。

BMP预合成素材是一种特殊的动画元素，在某些情况下，即使禁用了视频解码，系统仍可能尝试处理与视频相关的操作。本次修复确保了在禁用视频解码的情况下，BMP预合成素材能够正确渲染而不会导致程序崩溃。

技术影响与建议

对于开发者而言，4.4.29版本的更新主要带来了以下改进：

1. 鸿蒙平台用户将获得更稳定的解码性能，特别是在处理复杂动画时
2. 所有平台用户都能受益于更安全的文件解析过程，减少因异常文件导致的崩溃
3. 苹果平台开发者可以更可靠地使用多行文本功能
4. 需要禁用视频解码功能的场景现在更加稳定

建议所有使用Tencent/libpag的开发者升级到最新版本，特别是那些在鸿蒙平台或苹果平台上运行的项目，以及需要处理复杂文本内容的应用程序。

这次更新体现了Tencent/libpag团队对产品质量和用户体验的持续关注，通过不断优化核心功能，为开发者提供了更强大、更稳定的动画渲染解决方案。

libpag The official rendering library for PAG (Portable Animated Graphics) files that renders After Effects animations natively across multiple platforms. 项目地址: https://gitcode.com/gh_mirrors/li/libpag