transform-build-mosaic-collage-with-transloadit

入力

• ローカル入力画像の絶対パスを2つ以上
• 出力パス（省略可能）。デフォルトは、現在の作業ディレクトリに明示的に指定された collage.jpg です
• キャンバスサイズ（--width、--height。省略可能）。デフォルトは 1920×1200 です
• 決定論的なレイアウトにするための --seed（省略可能）

手順の準備

次の順序で認証情報を解決します。

• シェル環境変数
• 現在の作業ディレクトリにある .env のみ
• ~/.transloadit/credentials

.env が親ディレクトリにある場合は、先に変数をシェルにエクスポートしてください。

実行

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' は、間隔とキャンバスの余白を塗りつぶします（デフォルト）。16進カラーコードと名前付きカラーのどちらも使用できます。
• --background none（--format png または --format webp と併用）を指定すると、キャンバスと間隔が透明になります。
• --shuffle を指定すると、レイアウトの計算前にRobotが入力の順序を変更します。--seed と組み合わせると、シャッフル順を固定できます。
• --seed 42 を指定すると、モザイクの計算が決定論的になります。同じ入力で再実行すると、同じ出力を再現できます。

失敗した場合のデバッグ

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

注意：

• --input の値を複数指定すると、単一の /image/merge アセンブリにまとめられます。
• モザイク効果は各入力のアスペクト比を読み取り、整列したタイルレイアウトを計算します。一般に、縦向きと横向きの画像を混在させると、サイズが均一な画像よりも興味深いレイアウトになります。
• タイルは、割り当てられた長方形に収まるよう中央でトリミングされます。写真の一部が切り取られる場合があります。事前に /image/resize と resize_strategy: fit で入力をリサイズしても、モザイクレイアウトですべてのピクセルが保持されるとは限りません。
• 拡張子を確実に指定するため、ディレクトリ出力より明示的な出力ファイル名（例：./collage.jpg または ./collage.png）を指定してください。