inplace = truefalse

Specifies whether the operation is performed in-place. This can be used to avoid allocating memory. The default is false.

output = Image

Specifies a data structure into which the output is written. This can be used to avoid allocating memory. The size and number of layers must match that of the input. The dimensions of the output image are adjusted so that the row and column indices match the input. The default is NULL.

The SetSubImage command inserts a subimage into a main image.

The img and sub parameters are the main and subimages, respectively.  They must have the same number of layers and the same order.

The optional row and col parameters specify the coordinates in img where the upper left corner of sub is inserted. Their default values are the upper left coordinates of sub (not img).  This simplifies cutting a subimage from one image and inserting it into the same position in another.

$\mathrm{with}\left(\mathrm{ImageTools}\right)\:$

$\mathrm{img}≔\mathrm{Checkerboard}\left(16\right)\:$

$\mathrm{sub}≔\mathrm{GetSubImage}\left(\mathrm{img}\,8\,8\,33\,33\right)\:$

$\mathrm{SetSubImage}\left(\mathrm{img}\,\mathrm{Complement}\left(\mathrm{sub}\right)\,\mathrm{inplace}\right)\:$

$\mathrm{Embed}\left(\mathrm{img}\right)$