mcpField
T
transform-build-mosaic-collage-with-transloadit

transform-build-mosaic-collage-with-transloadit

github.com/transloadit创意与媒体565 次安装1 周前更新
代码仓库

关于 transform-build-mosaic-collage-with-transloadit

这是一个使用 Transloadit CLI 将多张图片排成马赛克拼贴的技能，适合制作图像拼贴的用户。可调整画布、边距、背景和布局随机种子，并支持重复生成相同布局。

主要功能

  1. 01将多张图片合成为马赛克
  2. 02设置画布尺寸和背景
  3. 03调整边框与图片间距
  4. 04使用种子复现布局
  5. 05随机调整输入图片顺序

适用场景

  1. 01将多张照片排成拼贴图
  2. 02制作带自定义边距和背景的图片布局
  3. 03按固定种子重复生成同一拼贴
  4. 04混合纵向与横向图片制作网格

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/transloadit/skills --skill transform-build-mosaic-collage-with-transloadit

安装后在 Claude Code 中输入/transform-build-mosaic-collage-with-transloadit确认已加载。

详细介绍

输入

  • 两个或更多本地输入图像的绝对路径
  • 可选输出路径；默认为当前工作目录中的明确文件 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 \
  --input ./photo-c.jpg \
  --input ./photo-d.jpg \
  --input ./photo-e.jpg \
  --input ./photo-f.jpg \
  --effect mosaic \
  --width 1920 \
  --height 1200 \
  --border 12 \
  --shuffle \
  --format jpg \
  --output ./collage.jpg

命令完成后，确认图像存在于预期的输出路径。

调整

  • --border 12 同时设置画布外边距和图块之间的间距。数值越大，留白越宽裕。
  • --background '#eee5d3' 为间隙和画布边距填充颜色（默认值）。可以使用十六进制颜色代码或命名颜色。
  • --background none（搭配 --format png 或 --format webp）会生成透明画布和透明间隙。
  • --shuffle 允许 Robot 在计算布局前重新排列输入；搭配 --seed 可固定打乱顺序。
  • --seed 42 可让马赛克求解器保持确定性——使用相同输入重新运行即可复现相同输出。

故障排查

npx -y @transloadit/node assemblies get <assemblyIdOrUrl> -j

注意：

  • 重复的 --input 值会打包到单个 /image/merge assembly 中。
  • 马赛克效果会读取每个输入的宽高比，并计算出紧凑排列的图块布局——纵向与横向图像混合使用，通常比尺寸统一的图像效果更有趣。
  • 图块会居中裁剪以适应分配的矩形区域。照片的部分内容可能会被裁掉。预先使用 /image/resize 和 resize_strategy: fit 调整输入图像大小，并不能保证马赛克布局会保留每个像素。
  • 优先使用明确的输出文件名（例如 ./collage.jpg 或 ./collage.png），而不是输出到目录，以确保扩展名固定。

评论

支持 Markdown