Create a ticket

Q100341: Tile rendering in Katana


This article describes how to render an image in multiple tiles using Katana in Batch Mode, and how to subsequently stitch the separate tiles together to form one complete image.



When an image is rendered in tiles, it is divided horizontally and vertically into smaller images referred to as tiles. These tiles are written out as separate files and then assembled into the final image.

In Katana, an image can be tile rendered by rendering each tile in Batch Mode from the command line, using the --tile-render option.

Once all tiles have been rendered, the --tile-stitch command is used to assemble them, followed by the --tile-clean command to delete the rendered separate tiles and leave only the final image.

The following is an example of terminal commands used to render 2x2 tiles for an image, then stitch them together and clean up the process:

katana --batch --katana-file=/tmp/clean.katana --render-node=Render -t 1 --tile-render=0,0,2,2
katana --batch --katana-file=/tmp/clean.katana --render-node=Render -t 1 --tile-render=0,1,2,2
katana --batch --katana-file=/tmp/clean.katana --render-node=Render -t 1 --tile-render=1,0,2,2
katana --batch --katana-file=/tmp/clean.katana --render-node=Render -t 1 --tile-render=1,1,2,2

katana --batch --katana-file=/tmp/clean.katana --render-node=Render -t 1 --tile-render=0,0,2,2 --tile-stitch --tile-clean

NOTE: It is possible to run the --tile-stitch command without using --tile-clean, however ---tile-clean will currently only work if it is preceded by --tile-stitch.

For more information on the syntax of these batch render options, please see the Katana Online Help on Batch Mode.

Was this article helpful?

We're sorry to hear that

Please tell us why
2 out of 2 found this helpful