用途:把两张以上的本地图片一次性合成一张马赛克拼贴图,通过官方 @transloadit/node 命令行工具调用 /image/merge Robot 的 mosaic 效果。
输入:两个或更多本地图片的绝对路径;可选输出路径(默认当前目录下的 collage.jpg);可选画布尺寸(--width、--height,默认 1920×1200);可选 --seed 用于确定性布局。
凭据解析顺序:Shell 环境变量、仅当前工作目录的 .env、~/.transloadit/credentials。若 .env 位于父目录,需先导出变量到 Shell。
示例命令: npx -y @transloadit/node image merge --input ./photo-a.jpg --input ./photo-b.jpg --effect mosaic --width 1920 --height 1200 --border 12 --shuffle --format jpg --output ./collage.jpg
命令结束后确认图片已生成在预期输出路径。
调参:--border 同时设置外层画布留白和瓦片间距;--background '#eee5d3' 填充间隙与留白(默认),也可用命名颜色;--background none 配合 --format png 或 webp 得到透明画布和透明间隙;--shuffle 允许 Robot 在求解布局前重排输入,与 --seed 组合可固定重排;--seed 42 使 mosaic 求解确定性,相同输入可复现相同输出。
调试失败可用:npx -y @transloadit/node assemblies get <assemblyIdOrUrl> -j
限制与说明:重复的 --input 会合并进同一个 /image/merge assembly;mosaic 效果读取每张输入的宽高比并求解 justified 瓦片布局,竖图与横图混合通常比尺寸统一更有趣;瓦片会居中裁剪以适配分配到的矩形,照片部分内容可能被裁掉;事先用 /image/resize 与 resize_strategy: fit 调整输入,也不能保证 mosaic 布局保留每个像素;建议使用明确的输出文件名(如 ./collage.jpg 或 ./collage.png),而非目录输出,以保证扩展名确定。