Adobe Illustrator jsx 脚本批量建立裁切蒙板

蘭雅

先来看这个把选择的物件建立裁切蒙板代码，使用顶层的简单物件用来建立蒙板

if (app.documents.length > 0) {
    var doc = app.activeDocument;
    var sel = doc.selection;

    if (sel.length >= 2) {
        // 1. 创建剪切组，并直接放在当前选中的最上层物件的位置
        var clipGroup = doc.groupItems.add();
        clipGroup.move(sel[0], ElementPlacement.PLACEBEFORE);
        
        // 2. 正确维护层级顺序：从倒数第二个（底层）开始移入组内
        for (var i = sel.length - 1; i > 0; i--) {
            sel[i].move(clipGroup, ElementPlacement.PLACEATBEGINNING);
        }
        
        // 3. 把最上层的物件（做蒙版的物件）移到组内的最顶部
        sel[0].move(clipGroup, ElementPlacement.PLACEATBEGINNING);
        
        // 4. 开启剪切蒙版
        clipGroup.clipped = true;
        clipGroup.selected = true;
    } else {
        alert("请至少选择两个物件！");
    }
}

再结合 autogroup.jsx 批量群组的代码，可以让AI帮我们组合，完成我们想要的批量建立蒙板功能

autogroup.jsx 批量群组代码下载

通过 Gemini 写的 AutoClipMask.jsx 和使用的效果

AutoClipMask.jsx 代码下载

蘭雅

由于建立蒙版必须要求每一个组内都有一个“最上层物件”作为裁切路径，算法的逻辑调整为：

找出所有相交的物件并分好组。
在每个组内部，找出原本 Z 轴层级最靠前（最上层）的物件。
将该组的其他物件移入新群组，最后把最上层物件移到组内顶部，开启 clipped = true。

批量建立蒙版脚本片段

// 3. 遍历分组，分别建立蒙版
    for (var i = 0; i < groups.length; i++) {
        var indices = groups[i];
        var len = indices.length;
        
        // 建立蒙版至少需要2个物件
        if (len >= 2) {
            // 核心思路：doc.selection 的索引越小，层级越靠上。
            // 经过碰撞算法出来的 indices 数组是有序的，所以 indices[0] 就是该组内最上层的物件。
            var topIdx = indices[0];
            var topItem = sr[topIdx];

            // 创建剪切组，并定位到最上层物件的位置
            var clipGroup = doc.groupItems.add();
            clipGroup.move(topItem, ElementPlacement.PLACEBEFORE);

            // 从后往前移入底层的物件
            for (var j = len - 1; j > 0; j--) {
                var item = sr[indices[j]];
                item.move(clipGroup, ElementPlacement.PLACEATBEGINNING);
            }

            // 最后移入最上层的蒙版物件，确保它在组内最顶部
            topItem.move(clipGroup, ElementPlacement.PLACEATBEGINNING);

            // 激活剪切蒙版
            clipGroup.clipped = true;
            maskCount++;
        }
    }

为什么这样结合是正确的？

天然的层级顺序：Illustrator 的 doc.selection 默认从 [0] 到 [n] 已经是从上到下的顺序。
完美匹配：并查集分组后，拿到的 indices 数组中，indices[0] 依然是该组里原本图层最靠上的物件。代码直接抓取它作为蒙版路径，避免了错乱。

zry2

谢谢分享