Substance Painter: Support for exporting maps/layer stacks with specific channels

[moonyuet]

Changelog Description

This PR is to add support for exporting outputs with specific channels defined in the settings and the users can choose to export layer with use_selection being enabled.


User can add/define their channel map in the ayon project setting, once they add their maps, it would show up in the multiselection options of export channel.
You need to specify your channel type and the name of your channel type(of which name extension you set in your export presets)

Additional info

• Update SubstancePainter Addon 0.1.2 to test this PR
• Export Layer Stack by selection is only compatible with substance painter 10.0.0
• Layer Stack Export only works when both export channel and use selections being enabled.
  The template below showed the setting does not support for exporting specific channels
• Export specific channels are not supported for the templates from the export-preset-generator due to the limitation of Substance API (currently asking Substance Painter support in substance discord now to see if they would support in the next version)

"2D View",
"Document channels + Normal + AO (No Alpha)",  
"Document channels + Normal + AO (With Alpha)", 
"Sketchfab",  
"Substance 3D Stager",
 "USD PBR Metal Roughness", 
"glTF PBR Metal Roughness",  
"glTF PBR Metal Roughness + Displacement texture (experimental)" 

Testing notes:

Without layer stack

1. Create Texture Set with your preferred template
2. Choose your export channel
3. Publish
4. Only your chosen export channel is being published

With selected layer stack

1. Create Texture Set with your preferred template with your selected layer stack with the use_selection being enabled.
2. Choose your export channel
3. Publish
4. Only your selected layer stack with your chosen export channel being published

General

1. Create Texture Set
2. Export Channel without any input
3. Publish
4. All channels should be published correctly

[ynbot]

Task linked: AY-5104 Substance: selective export of layers

[LiborBatek]

I have made bunch of misc tests with different conditions for publish of the texture set.

All three occasions works well as I was able to produce standard full publish of texture set, also just picked channel like base color or roughness and finally also test with Use Selected option.

There is also no malfunction when mutliple publish instances present...again all good!

[LiborBatek]

All seems working well in any circumstances, wether its just selection, cherrypicked channel types or non existing channels, user gets proper Validation for each occasion informing user whats going on aka wrong...

And finally all products succesfully produced!

[moonyuet]

@iLLiCiTiT can you check on the code?

[antirotor]

went quickly through the code, looks fine but I couldn't test it

[BigRoy]

Aside of the open comments the code looks good. I did not do a test run as I do not have Substance Painter available to me currently but the code looks good aside of aforementioned notes.

[LiborBatek]

I did make last round of stress tests also including UDIM tiles and removing/adding custom channel type and all working nicely!

It also works well with new or adjusted Texture Export Preset user creates... so all good!