spliceImage() 會增加影像的尺寸,而不會拉伸原始影像,方法是建立一個與影像背景顏色相同的方塊。
您可以在執行 spliceImage() 之前使用 setImageBackgroundColor() 設定顏色。
$width 和 $height 參數定義水平和垂直方向增加多少,這決定了方塊的大小。(請注意,這些值並不總是與方塊的大小相同。)新影像的最終尺寸為
$newWidth = $oldWidth + $width
$newHeight = $oldHeight + $height
因此,若要在兩個方向擴展影像,$width 和 $height 應為正值。若要僅在一個方向(水平或垂直)擴展,請將其中一個值設定為 0(分別為 $height 或 $width)。
$x 和 $y 參數相對於原始影像,並定義方塊的放置位置。如果 $x 和 $y 是原始影像的其中一個角落,則方塊會放置在相應的角落,並從該角落向外擴展影像。否則,方塊會將原始影像分割到兩側或角落,並將方塊放置在新影像的中央。因此,您可以使用 $x 和 $y 來指示原始影像的分割位置和方式。任何剩餘空間都會以背景顏色填滿。