Saskia-Dwarshuis / UDIM-Tile-Combiner-Script

UDIM Tile Combiner Script for Substance Painter and Photoshop is a Photoshop script built for combining UDIM tile texture maps split across multiple images into one map (on a per-UDIM-number by per-material-channel basis.)

UDIM Tile Combiner Script for Substance Painter and Photoshop

UDIM Tile Combiner Script for Substance Painter and Photoshop is a Photoshop script built for combining UDIM tile texture maps split across multiple images into one map (on a per-UDIM-number by per-material-channel basis.)

Disclaimer

This script was written and tested only on Windows OS. I have done my best to make the script work for MacOS, but there may be issues. Likewise only installation instructions for Windows OS are listed, but MacOS shouldn’t be much different.

The script was tested on Photoshop CC versions 2019 and 2020. Backwards and forwards compatibility is likely, but not guaranteed.

Installation Instructions

Windows

If you have administrator permissions:

1. Download the most recent release.
2. Unzip the release file and place the file UDIM Tile Combiner.jsxbin and the folder UDIM Tile Combiner Script for Photoshop Library Scripts Only in the Photoshop scripts folder. README.md can be deleted.
3. Edit the permissions of the folder UDIM Tile Combiner Script for Photoshop Library Scripts Only— for Users, give the permission to write. This is to enable active settings data (ActiveSettings.js) and the previous session (PreviousSessionSettings.js) to be written to the appropriate files.
4. Open Photoshop and browse to File > Scripts. UDIM Tile Combiner should show up as a script available to run.

If you don’t have administrator permissions:

1. Download the most recent release
2. Locate a place on your computer where you can easily access/navigate to and where administrator permissions are not required. Unzip the release file and place the file UDIM Tile Combiner.jsxbin and the folder UDIM Tile Combiner Script for Photoshop Library Scripts Only at this location. README.md can be deleted.
3. Open Photoshop and browse to File > Scripts > Browse. Navigate to the place where you put UDIM Tile Combiner.jsxbin and load the script. You will have to repeat this step each time you want to run the script.

How To Use

Substance Painter Export Settings

• Add an alpha channel to each material channel exported, with Opacity or 2D View used as the alpha value.
• Dilation + Transparency, with a low dilation value.

Combiner Script Walkthrough

1. Select a source folder, which should contain the texture maps exported from Substance Painter.
2. Select a destination folder, into which the combined images will be saved.
3. Choose which tile setting the script should work with when combining texture maps and change the UDIM tile number values if necessary.
4. Add or remove material channel sort terms the script should work with when combining texture maps. Separate each sort term by a comma and a space.
5. Change or remove the combined texture maps’ save name prefix (the default is “Prefix_”).
6. Select which file type to save the combined texture maps as (the default is .png).
7. Run the script!

Other Features

Tile Combiner Settings to Load

Default radio button— When selected, loads in the script settings saved in the file UDIM Tile Combiner Script for Photoshop Library Scripts Only/DefaultSettings.js. Note: DefaultSettings.js is never written to by the script, but can be edited by the user to change default settings.

Previous Session radio button— When selected, loads in the script settings saved in the file UDIM Tile Combiner Script for Photoshop Library Scripts Only/PreviousSessionSettings.js. PreviousSessionSettings.js is written to at the end of each complete script run, saving the script settings used.

User Defined Preferences radio button— When selected, loads in the script settings from whichever file the load button is pointing to (the default is the file UDIM Tile Combiner Script for Photoshop Library Scripts Only/UserSetSettings.js).

Set button— Takes a snapshot of the current script settings and creates a new settings file with that information. The user selects which folder to save that file in and what name the file should have (the file type will always be .js). The script will automatically set this new file as the user-set settings file to reference if the User Defined Preferences radio button is clicked.

Load button— Opens a file selection dialog to allow the user to select a user-set settings file. The settings saved within that file will then update the current script settings. I will also update the script with those settings each time the User Defined Preferences radio button is clicked. The selected settings file will remain the file that gets referenced for the User Defined Preferences radio button until another file is selected. (The file path of the selected settings file gets written to ActiveSettings.js at the end of every script run and then gets referenced at the beginning of each instance of the script thereafter.)

Reset Current Folder Paths button— Any source folder selected and any destination folder selected will be cleared.

Other Script Settings

Folder selection shortcut mode checkbox— If checked, the second folder selection dialog (typically the destination folder) will open with the file path of the first folder selection (typically the source folder). If unchecked, the folder selection dialog will always open at the desktop.

“Script completed!” alert checkbox— If checked, an alert will pop up at the end of the combining process.

Ignore image overwriting warnings checkbox— If checked, the combining script will ignore any image overwrite warnings. If unchecked, an alert will sound for each image overwritten, requiring the user to allow or skip the overwrite.