AEJoy—— 使用 JS 脚本创建预合成（四）

怼烎@ 2022-09-11 15:28 104阅读 0赞

这是由 Brian Maffitt 设计出的一个很实用的脚本。当你想将一个或多个图层创建预合成时，产生的新合成会占用当前合成的长度，而嵌入的剪辑的持续时间则会相应被隐藏。这个脚本搭配 “Move all attributes…” 选项，将一个或多个选定的层进行预合成，产生的新的 comp 的 In Point 将是选定层最早的 In Point ，同样该 comp 的 Out Point 将是选定层最晚的 Out Point。如果你只选择一个层，新的 comp 的持续时间和开始时间是与层相匹配的。

## 分步代码解析 ##

### 范围限定 ###

首先要注意的是，我们将脚本封装在标准作用域限制的大括号和撤销组中:

{
        
    
      // create undo group
      app.beginUndoGroup("Pre-Compose to Layer Duration");
      
      [the rest of the script goes in here]
      
      app.endUndoGroup();
    }

如果你不确定我们为什么要这样做，请参考这篇文章《[AEJoy—— JS 脚本的代码管理好习惯（三）][AEJoy_ JS]》。

### 测试分支条件 ###

脚本的实际主体以两个条件测试开始，如果没有满足这些测试，脚本将以两个错误消息中的一个退出。这是通过两个嵌套的 if/else 结构来完成的，它们像这样包围了脚本的其余部分:

// select the active item in the project window
      // and make sure it's a comp
    
      var myComp = app.project.activeItem;
      if(myComp instanceof CompItem) {
        
    
        // make sure one or more layers are selected
    
        var myLayers = myComp.selectedLayers;
        if(myLayers.length > 0){
        
    	
    	[the rest of the script goes in here]
    	
        }else{
        
           alert("select at least one layer to precompose.");
        }
      }else{
        
        alert("please select a composition.");
      }

这段代码的第一行(忽略注释)创建了一个名为 “myComp” 的新对象，该对象被设置为项目窗口中的活动项（activeItem）的值。我们假设它是一个 comp，但我们需要确保（不会发生以下情形） —— 因为如果它不是，而我们仍然继续执行的话，脚本将中止（这种执行形式总是比较糟糕的）。因此，下一行代码将使用 JavaScript 操作符 “instanceof” 来测试 “myComp” 是否是一个类型为 “CompItem” 的对象。如果是，脚本继续执行下一个语句，如果不是，执行跳转到代码末尾的警告(第一个 if /else 的 “else” 子句)，并为用户生成一个错误消息对话框，如下所示:

![在这里插入图片描述][7f61c50f41df4eb1b73475e14edadf5e.png_pic_center]  
在第二个测试中，我们创建了一个名为 “myLayers” 的新对象，它构成了 “myComp” 中选中的图层集合。然后我们测试 “myLayers” 的长度，如果有任何层被选中，那么该值将大于零。如果是这样的话，则继续执行脚本的其余部分。如果不满足条件，则弹出警告，显示如下对话框:

![在这里插入图片描述][f441051e5abc4543a67a865c4e2ac974.png_pic_center]  
因此，如果没有满足运行脚本的任何要求，就会显示适当的有帮助的对话框，脚本会优雅地退出，而不做任何事情。

### 脚本执行前后对比 ###

在进入代码的真正核心之前，让我们看看成功运行脚本应该是什么样子的。这是我们运行脚本前的两个图层的小合成:

脚本执行前：  
![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAcGFuZGExMjM0bGVl_size_20_color_FFFFFF_t_70_g_se_x_16]

脚本执行后：  
![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAcGFuZGExMjM0bGVl_size_20_color_FFFFFF_t_70_g_se_x_16 1]

注意，三个被选中的图层已经被一个名为 “comp R Arm” 的预合成替换了。新 comp 的名字是通过将第一个选中的图层的名字连接到 comp 来构建的。注意，新的合成被修剪，以精确地适合所选图层们的合并持续时间。

### 回到代码 ###

好的，让我们来看看建立和创建新的预合成的代码块。这是第一部分:

// set new comp's default In and Out points to those of first layer
    
          var newInPoint = myLayers[0].inPoint;
          var newOutPoint = myLayers[0].outPoint;

在这里，我们只是设置了两个新变量，它们最终将成为新 comp 的 InPoint 和 OutPoint 。记住“myLayers” 是一个对象，它包含了所选图层的集合。结果是，这些是按它们被选中的顺序排列的——所以 myLayers\[0\] 是第一个被选中的图层。  
稍后在代码中，我们会看到每个选中的层，并决定我们是否应该使用它的 InPoint 或 OutPoint ，这里我们只是初始化这些变量，稍后我们会比较一些东西。

### 命名该预合成 ###

下一段代码为新 comp 创建了名称，代码如下:

// create new comp name of "comp " plus name of first layer
    
          var newCompName = "comp ";
          var layerName = myLayers[0].name;
          if(layerName.length > 26) {
        
            layerName = layerName.substring(0, 26);
          }
          newCompName += layerName;

首先，我们创建一个名为 “newCompName” 的字符串变量，并将其初始化为字符串 “comp” 。然后我们创建另一个名为 “layerName” 的字符串变量，并将其设置为选中图层集合 “myLayers” 中第一个选中的图层的名称。然后我们检查层名是否超过 26 个字符。**我们这样做是因为 AE 最大层名长度为 31 个字符**，我们将使用 “comp” 中的 5 个字符。如果层名超过 26 个字符，我们只使用前 26 个字符。然后我们添加图层名称(或前 26 个字符)到 “comp” 来创建新的图层名称。

### 创建一个层索引的数组 ###

构造 “预合成” 的方法, 我们需要更进一步的代码，其中一个输 —— 一个数组, 其包含将被移动到新的 comp 的层索引。这里我们将通过遍历选择层的集合来构建数组, 选择它们的层索引值并将它们添加到数组中。这也是我们对所选层进行循环遍历的地方，以确定最早的层 InPoint 和最晚的 OutPoint 。这是代码:

// "precompose" expects an array of layer indices
    
          var layerIndices = new Array();
          for (var i = 0; i < myLayers.length; i++) {
        
            layerIndices[layerIndices.length] = myLayers[i].index;
    
            // make sure new comp In point is In point of earliest layer
            // and new comp Out point is Out point of latest layer
    
            if (myLayers[i].inPoint < newInPoint) newInPoint = myLayers[i].inPoint;
            if (myLayers[i].outPoint > newOutPoint) newOutPoint = myLayers[i].outPoint;
          }

### 创建合成 ###

现在我们有了创建新合成所需的一切，这里我们使用图层集合对象的 “预合成” 方法来预合成选中的图层。“precomp” 需要三个参数。

*  第一个是要被预合成的层的层索引数组；
 *  第二个是新合成的名称；
 *  如果你想要预合成选项 “Move all attributes into the new composition”，你可以设置第三个参数为 “true”，就像我们在本例中做的那样。

下面是创建新 comp 的代码:

// create the new comp
    
          var newComp = myComp.layers.precompose(layerIndices, newCompName, true );

### 设置新合成的 InPoint 和 OutPoint ###

至此，我们选择层已经被我们的新合成替代了。我们需要做的最后一件事是在新 comp 中设置 InPoint 和 OutPoint。事实证明, 这种新的 comp 将是在旧 comp 中选中的层。所以我们创建一个新的对象 “preCompLayer” 并设置它等于在旧 comp 当前选中的层(**此时已是新的 comp** )。变量 “newInPoint” 有我们需要的新 comp 的 InPoint 的值，变量 “newOutPoint” 有我们需要的新 comp 的 OutPoint 的值。下面是我们需要为新 comp 设置 inPoint 和 outPoint 属性的代码:

// set in and out points of new comp
    
          var preCompLayer = myComp.selectedLayers[0];
          preCompLayer.inPoint = newInPoint;
          preCompLayer.outPoint = newOutPoint;

## 完整的脚本 ##

//
    // preCompToLayerDur.jsx (revised 7/26/04)
    //
    // This script will pre-compose selected layers with "Move all attributes..."
    // The in point of the new comp will be the earliest in point of the selected
    // layers and the out point will be the latest out point of the selected layers.
    //
    // The new comp will thus be trimmed so that its duration reflects the composite 
    // duration of the included layers.
    //
    
    // Based on an idea by Brian Maffitt
    // Original code design by Keiko Yamada
    // Final tweaks and enhancements by Dan Ebberts
    //
    
    {
        
    
      // create undo group
    
      app.beginUndoGroup("Pre-Compose to Layer Duration");
    
      // select the active item in the project window
      // and make sure it's a comp
    
      var myComp = app.project.activeItem;
      if(myComp instanceof CompItem) {
        
    
        // make sure one or more layers are selected
    
        var myLayers = myComp.selectedLayers;
        if(myLayers.length > 0){
        
    
          // set new comp's default in and out points to those of first layer
    
          var newInPoint = myLayers[0].inPoint;
          var newOutPoint = myLayers[0].outPoint;
    
          // create new comp name of "comp " plus name of first layer
    
          var newCompName = "comp ";
          var layerName = myLayers[0].name;
          if(layerName.length > 26) {
        
            layerName = layerName.substring(0, 26);
          }
          newCompName += layerName;
    
          // "precompose" expects an array of layer indices
    
          var layerIndices = new Array();
          for (var i = 0; i < myLayers.length; i++) {
        
            layerIndices[layerIndices.length] = myLayers[i].index;
    
            // make sure new comp in point is in point of earliest layer
            // and new comp out point is out point of latest layer
    
            if (myLayers[i].inPoint < newInPoint) newInPoint = myLayers[i].inPoint;
            if (myLayers[i].outPoint > newOutPoint) newOutPoint = myLayers[i].outPoint;
          }
    
          // create the new comp
    
          var newComp = myComp.layers.precompose(layerIndices, newCompName, true );
    
          // set in and out points of new comp
    
          var preCompLayer = myComp.selectedLayers[0];
          preCompLayer.inPoint = newInPoint;
          preCompLayer.outPoint = newOutPoint;
    
        }else{
        
           alert("select at least one layer to precompose.");
        }
      }else{
        
        alert("please select a composition.");
      }
      app.endUndoGroup();
    }

（完）

[AEJoy_ JS]: https://blog.csdn.net/panda1234lee/article/details/120344914
[7f61c50f41df4eb1b73475e14edadf5e.png_pic_center]: /images/20220828/fbe99b3077fb42c78709a15c3d1fd025.png
[f441051e5abc4543a67a865c4e2ac974.png_pic_center]: /images/20220828/057d100be0c048899ba6661946536272.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAcGFuZGExMjM0bGVl_size_20_color_FFFFFF_t_70_g_se_x_16]: /images/20220828/99d5c15fbfc94552b017e5127cb0e423.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAcGFuZGExMjM0bGVl_size_20_color_FFFFFF_t_70_g_se_x_16 1]: /images/20220828/2394e4be921d4447ba1ebc5b19d78ffd.png