The Batch Output node can be used in conjunction with Batch Input to quickly process multiple Bitmaps or Materials through the same set of node operations, and output the results from ArtEngine to your hard drive. Executing a Batch Output node requires a Batch Input node to be at the beginning of the execution chain.
To Batch Output a set of Bitmaps or Materials imported with a Batch Input node, follow these steps:
When Batch Output exports Bitmaps, all Bitmaps are placed in the root folder specified in the Output Path property.
The file names follow the naming convention defined in the File Structure field.
When Batch Output exports Materials, each Material creates a sub-folder with the title identical to the one it was imported with by the Batch Input node.
The texture maps of each material are placed within that material’s sub-folder, and titled according to the naming convention defined in the File Structure field.
Node category | Output |
---|---|
Node execution style | Manual |
Input Type | Description |
---|---|
Bitmap / Material | The set of Bitmaps or Materials which Batch Output exports to your hard drive. |
Property/Setting | Description |
---|---|
Input Type | Choose whether this node accepts Bitmaps or Materials as input. This property will adjust automatically depending on the type of the Batch Input node at the start of the execution chain. |
File Structure | Define the structure of the output file names of this node. You can propagate the following information into the output:
|
File Type | Choose the file extension and bit depth of the outputs of this node. The file extensions available are JPG, PNG, EXR, TIF, and TGA. For the bit depth, choose between 8bit, 16bit, or matching the input bit depth instead. |
Preview | This field displays a preview of the output file name, depending on the File Structure you have chosen. |
Overwrite Existing | Enable this option to automatically overwrite any existing files with matching file names in the specified output path. |
Output Path | Specify the output folder path where files will be saved. You can enter the path manually, or use the Browse button on the right to navigate to the desired output folder. |
The Bitmap Naming Preferences button brings up a new window which allows you to individually adjust file names for each Bitmap type in the input.
In this window, the Bitmap types are listed on the left, and the corresponding output file names - on the right. Click any of the fields on the right-hand side to change the name for all output textures of that type.
You can also use the Reset button to the right of each file name to revert it to the default.
When you are done changing the Bitmap Naming Preferences, click the OK button at the bottom of the window, or the Cancel button if you want to discard the changes.