首页 > 代码库 > 一款批量修改AE模板的工具
一款批量修改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 = http://www.mamicode.com/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 = http://www.mamicode.com/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 = http://www.mamicode.com/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 = http://www.mamicode.com/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>中包含的才是文本。这种过滤条件，能够过滤掉其他的干扰数据，让我专注于处理模板中的文本内容。
四、最终效果
一款批量修改AE模板的工具