一款批量修改AE模板的工具

一、需求分析

对于视频后期剪辑及相关从业人员来说，AE(After Effects)模板效果是一个不错的开始点。在模板效果的基础上，可以很快的做出各种炫酷的后期效果。但是在网上下载的模板工程中，往往包含了非常多的模板文字、图片、图形实体、AI资源等。这些资源文件往往并不是我们需要的，在使用模板时需要手动替换或者删除。但是网上下载的模板工程往往非常大，包含的资源非常多。这样手动改动起来的话，工作量会成倍增加。那么，是否可以考虑做一个小工具来高效完成这项枯燥的工作呢？要替换模板中的文字和图片，第一步就是要定位到这些图片和文字；其次才能考虑使用程序替换。那么，如何定位模板工程中的图片和文字呢？定位到之后又如何修改呢？如果要修改的话，又要修改哪些地方呢？接下来就来分析下整个解决过程。

二、实现方案

Adobe After Effects工程使用aep格式来存储。aep格式是一种紧凑的二进制格式，工程中的所有资源及组织结构都以二进制格式保存。如果要从这种二进制的格式中来定位图片和文字，倒也不是不可能：

但是有一个致命的缺点。先不说定位的时候无法做到精确匹配，就算成功找到了文本或图片路径，替换的时候很可能还要进行位置移动。因为替换的文本可能比原文本长，如果不移动腾出空位的话，替换的内容就会覆盖掉后面的二进制数据。修改后的aep文件极有可能因此损坏。因此，直接修改aep文件是不可取的。经过一番搜索，得知AE工程还有另外一种存储格式：AEPX。

*.aepx是以XML格式进行存储的。相对于二进制格式aep而言，aepx的文件尺寸比较大，加载速度也会慢些。但是XML格式非常容易操作，而且在成熟的XML库的帮助下，修改标签和遍历标签只需要几行代码即可搞定。那么，接下来的工作就是确定XML的组织结构以及需要修改哪些字段了。首先看一个比较复杂的AEP工程：

这是一个典型的AEP工程，使用文件夹的方式来组织各种资源。那么XML中是怎么组织的呢？上面这个工程中存在8个顶级文件夹，可以在XML中看到对应8个<Item>标签：

再来分析其中的合成(Composite)：

这张图是关键的：我们可以看到，文件夹中的子元素是以<Sfdr>标签来包裹的。而不管是Composite还是文件夹，都是以<Item>标签来表示的，只不过以子标签<idta>的值来区分。0001开头的表示是文件夹，0004开头的表示合成，而0007开头的则表示是其他普通资源文件，如图片、AI文件等。经过分析，文本都是以<Layr>标签包裹的，我们要替换文本的话，直接替换子标签<string>中的文本即可。那么图片是怎样一种结构呢？

图片资源的引用是封装在<Pin>标签里面的<fileReference>里面，直接以路径的形式引用。确定了这些东西，就可以开始编码来定位文本和图片了。这里采用了一个C++ XML解析库TinyXML，不依赖其他外部库，接口简单。

void XMLParser::parseTemplateItem(XMLNode* rootElement, int& index)
{
	if (rootElement == nullptr)
	{
		return;
	}

	XMLElement* str = rootElement->FirstChildElement("string");
	const char* txt = str->GetText();
	XMLElement* idtaNode = rootElement->FirstChildElement("idta");
	if (idtaNode != nullptr)
	{
		const char* idatBdata = idtaNode->Attribute("bdata");
		ItemType itemType = whichType(idatBdata);
		if (itemType == NORMAL_ITEM)
		{
			XMLElement* pinNode = idtaNode->NextSiblingElement("Pin");
			if (pinNode != nullptr)
			{
				XMLElement* sspcNode = pinNode->FirstChildElement("sspc");
				if (sspcNode == nullptr)
				{
					return;
				}
				const char* sspcBdata = sspcNode->Attribute("bdata");
				bool isNormalFormat = isImageFormat(sspcBdata);
				if (isNormalFormat)
				{
					XMLElement* Als2Node = sspcNode->NextSiblingElement("Als2");
					if (Als2Node == nullptr)
					{
						return;
					}
					XMLElement* fileReferenceNode = Als2Node->FirstChildElement("fileReference");
					if (fileReferenceNode == nullptr)
					{
						return;
					}
					const char* fullPath = fileReferenceNode->Attribute("fullpath");
					m_imageMap.insertMulti(fullPath, index);
					index++;
				}
			}
		}
		else if (itemType == COMPOSITE_ITEM)
		{
			XMLElement* LayrNode = idtaNode->NextSiblingElement("Layr");
			while (LayrNode != nullptr)
			{
				XMLElement* stringNode = LayrNode->FirstChildElement("string");
				if (stringNode)
				{
					// 文本为空的层直接跳过不要
					const char* layerStr = stringNode->GetText();
					if (layerStr != nullptr && strcmp(layerStr, ""))
					{
						XMLElement* tdgpOuter = stringNode->NextSiblingElement("tdgp");
						if (tdgpOuter)
						{
							XMLElement* tdmnOuter = tdgpOuter->FirstChildElement("tdmn");
							if (tdmnOuter)
							{
								const char* tdmnOuterBdata = tdmnOuter->Attribute("bdata");
								// 'ADBE Text Properties'
								if (tdmnOuterBdata != nullptr && !strcmp("4144424520546578742050726f706572746965730000000000000000000000000000000000000000", tdmnOuterBdata))
								{
									XMLElement* tdgpInner = tdmnOuter->NextSiblingElement("tdgp");
									if (tdgpInner != nullptr)
									{
										XMLElement* tdmnInner = tdgpInner->FirstChildElement("tdmn");
										if (tdmnInner != nullptr)
										{
											const char* tdmnInnerBdata = tdmnInner->Attribute("bdata");
											// 'ADBE Text Document'
											if (tdmnInnerBdata != nullptr || !strcmp("41444245205465787420446f63756d656e7400000000000000000000000000000000000000000000", tdmnInnerBdata))
											{
												m_textMap.insertMulti(layerStr, index);
												index++;
											}
										}
									}
								}
							}
						}
					}
				}
				LayrNode = LayrNode->NextSiblingElement("Layr");
			}
		}
		else if (itemType == FOLDER_ITEM)
		{
			XMLElement* SfdrNode = idtaNode->NextSiblingElement("Sfdr");
			if (SfdrNode == nullptr)
			{
				return;
			}
			XMLElement* tempItem = SfdrNode->FirstChildElement("Item");
			while (tempItem != nullptr)
			{
				parseTemplateItem(tempItem, index);
				tempItem = tempItem->NextSiblingElement("Item");
			}
		}
		else
		{
			return;
		}
	}
}

三、修改字段

完成了图片和文字的解析工作之后，剩下的就是替换了。不妨先来观察下使用AE修改资源时，XML文件会发生哪些变化。这样，我们用程序修改时，把相关的字段也修改掉就可以了。对于图片修改可以看下图：

总共需要修改三个地方。其中，"4a504547"是JPEG这八个字符的十六进制表示，有两个地方需要同时修改。如果是替换成其他格式的图片，也要修改成对应格式的十六进制表示。如：

'706e6721'  -> PNG format
'4a504547'  -> JPEG or JPG format
'5449465f'   -> TIF or TIFF format
'424d5020'  -> BMP format

　 另外一个要修改的就是<fileReference>的属性fullpath值了。也就是图片资源的路径。文本的修改就要稍显复杂一点了。如下图：

这里采用了一个小技巧，使用了文本层的一个属性：text.sourceText=name。给了这个属性之后，文本层的内容和名称保持一致。也即是说，我们只要修改文本层的名称，就能达到修改文本层内容的目的。这个技巧需要修改两个地方。一个是<tdb4>标签值的倒数第七位置1；另一个就是增加一个<tdb4>的兄弟标签<expr>，其值为“746578742e736f75726365546578743d6e616d6500”，也就是"text.sourceText=name"的十六进制表示。这样就实现了文本层和文本内容的同步设置了。

此外，Layr层不光只有text在里面，还有色块（Solid）、过渡效果、动画等内容。因此还需要根据<tdmn>标签的值来过滤。条件就是<tdmn>的值：

4144424520546578742050726f706572746965730000000000000000000000000000000000000000 // 'ADBE Text Properties'
41444245205472616e73666f726d2047726f75700000000000000000000000000000000000000000 // 'ADBE Transform Group'
41444245204c61796572205374796c65730000000000000000000000000000000000000000000000 // 'ADBE Layer Styles'
414442452045787472736e204f7074696f6e732047726f7570000000000000000000000000000000 // 'ADBE Extrsn Options Group'
41444245204d6174657269616c204f7074696f6e732047726f757000000000000000000000000000 // 'ADBE Material Options Group'
4144424520417564696f2047726f7570000000000000000000000000000000000000000000000000 // 'ADBE Audio Group'
414442452047726f757020456e640000000000000000000000000000000000000000000000000000 // 'ADBE Group End'
41444245205465787420446f63756d656e7400000000000000000000000000000000000000000000 // 'ADBE Text Document'
4144424520546578742050617468204f7074696f6e73000000000000000000000000000000000000 // 'ADBE Path Options'
414442452054696d652052656d617070696e67000000000000000000000000000000000000000000 // 'ADBE Time Remapping'
4144424520506c616e65204f7074696f6e732047726f757000000000000000000000000000000000 // 'ADBE Plane Options Group'
41444245204566666563742050617261646500000000000000000000000000000000000000000000 // 'ADBE Effect Parade'

　　只有内层<tdmn>和外层<tdmn>的值分别是'ADBE Text Properties'和'ADBE Text Document'的时候，<Layr>中包含的才是文本。这种过滤条件，能够过滤掉其他的干扰数据，让我专注于处理模板中的文本内容。

四、最终效果