extract_frames_with_overlap

// extract_frames_with_overlap.jsx
// 功能：从一张大图中提取12帧，每帧宽600px，水平步进100px，高400px
// 要求：当前文档宽度 >= 1600px，高度 >= 400px

#target photoshop

var doc = app.activeDocument;
var frameWidth = 600;
var frameHeight = 400;
var step = 100;          // 每帧偏移量（"不同"的部分）
var numFrames = 12;

// 检查文档尺寸是否足够
if (doc.width.as("px") < frameWidth + step * (numFrames - 1) || doc.height.as("px") < frameHeight) {
    alert("错误：文档尺寸太小！\n需要宽度至少 " + (frameWidth + step * (numFrames - 1)) + "px，高度至少 " + frameHeight + "px");
    exit();
}

// 设置保存路径（桌面/frames/）
var saveFolder = new Folder("~/Desktop/frames/");
if (!saveFolder.exists) saveFolder.create();

// 辅助函数：数字补零
function padZero(num, size) {
    var s = num + "";
    while (s.length < size) s = "0" + s;
    return s;
}

// 确保工作在像素单位
app.preferences.rulerUnits = Units.PIXELS;

for (var i = 0; i < numFrames; i++) {
    var x = i * step;
    var y = 0;
    
    // 创建选区边界数组 [left, top, right, bottom]
    var bounds = [
        [x, y],
        [x + frameWidth, y],
        [x + frameWidth, y + frameHeight],
        [x, y + frameHeight]
    ];

    // 创建选区
    doc.selection.select(bounds);
    
    // 复制选区
    doc.selection.copy();
    doc.selection.deselect();
    
    // 新建文档（使用像素单位）
    var newDoc = app.documents.add(
        frameWidth, 
        frameHeight, 
        doc.resolution, 
        "frame_" + (i + 1), 
        NewDocumentMode.RGB, 
        DocumentFill.TRANSPARENT
    );
    
    // 如果原图是灰度模式，转换新文档
    if (doc.mode == DocumentMode.GRAYSCALE) {
        newDoc.changeMode(ChangeMode.GRAYSCALE);
    }
    
    // 粘贴并栅格化
    newDoc.paste();
    
    // 栅格化图层以确保正确尺寸
    newDoc.activeLayer.rasterize(RasterizeType.ENTIRELAYER);
    
    // 裁剪到画布大小（确保没有超出边界的部分）
    newDoc.crop([0, 0, frameWidth, frameHeight]);
    
    // 拼合图像（替代合并可见图层）
    newDoc.flatten();
    
    // 保存为 PNG
    var filePath = new File(saveFolder + "/frame_" + padZero(i + 1, 3) + ".png");
    var pngSaveOptions = new PNGSaveOptions();
    pngSaveOptions.compression = 9;
    pngSaveOptions.interlaced = false;
    newDoc.saveAs(filePath, pngSaveOptions, true);
    newDoc.close(SaveOptions.DONOTSAVECHANGES);
}

alert("✅ 成功导出 " + numFrames + " 帧到桌面 /frames 文件夹！");