.. _writesequenceblock:

writesequenceblock
******************


**Syntax:** :code:`writesequenceblock(input image, filename, position, file dimensions, source position, source block size)`

Write an image to a specified position in an image sequence. Optionally can write only a block of the source image.

This command cannot be used in the distributed processing mode. If you need it, please contact the authors.

Arguments
---------

input image [input]
~~~~~~~~~~~~~~~~~~~

**Data type:** uint8 image, uint16 image, uint32 image, uint64 image, int8 image, int16 image, int32 image, int64 image, float32 image, complex32 image

Image to save.

filename [input]
~~~~~~~~~~~~~~~~

**Data type:** string

Name (and path) of the file to write.

position [input]
~~~~~~~~~~~~~~~~

**Data type:** 3-component integer vector

Position of the image in the target file.

file dimensions [input]
~~~~~~~~~~~~~~~~~~~~~~~

**Data type:** 3-component integer vector

**Default value:** "[0, 0, 0]"

Dimensions of the output file. Specify zero to parse dimensions from the file. In this case it must exist.

source position [input]
~~~~~~~~~~~~~~~~~~~~~~~

**Data type:** 3-component integer vector

**Default value:** "[0, 0, 0]"

Position of the block of the source image to write.

source block size [input]
~~~~~~~~~~~~~~~~~~~~~~~~~

**Data type:** 3-component integer vector

**Default value:** "[0, 0, 0]"

Size of the block to write. Specify zero to write the whole source image.