Merge remote-tracking branch 'origin/feature/multiverse' into feature…

…/multiverse

openpype/hosts/maya/plugins/publish/extract_multiverse_look.py

@@ -7,7 +7,31 @@
 
 
 class ExtractMultiverseLook(openpype.api.Extractor):
- """Extractor for Multiverse USD look data into a Maya Scene."""
+ """Extractor for Multiverse USD look data.
+
+ This will extract:
+
+ - the shading networks that are assigned in MEOW as Maya material overrides
+ to a Multiverse Compound
+ - settings for a Multiverse Write Override operation.
+
+ Relevant settings are visible in the Maya set node created by a Multiverse
+ USD Look instance creator.
+
+ The input data contained in the set is:
+
+ - a single Multiverse Compound node with any number of Maya material
+ overrides (typically set in MEOW)
+
+ Upon publish two files will be written:
+
+ - a .usda override file containing material assignment information
+ - a .ma file containing shading networks
+
+ Note: when layering the material assignment override on a loaded Compound,
+ remember to set a matching attribute override with the namespace of
+ the loaded compound in order for the material assignment to resolve.
+ """
 
  label = "Extract Multiverse USD Look"
  hosts = ["maya"]

openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py

@@ -8,7 +8,21 @@
 
 
 class ExtractMultiverseUsd(openpype.api.Extractor):
- """Extractor for Multiverse USD asset data."""
+ """Extractor for Multiverse USD Asset data.
+
+ This will extract settings for a Multiverse Write Asset operation:
+ they are visible in the Maya set node created by a Multiverse USD
+ Asset instance creator.
+
+ The input data contained in the set is:
+
+ - a single hierarchy of Maya nodes. Multiverse supports a variety of Maya
+ nodes such as transforms, mesh, curves, particles, instances, particle
+ instancers, pfx, MASH, lights, cameras, joints, connected materials,
+ shading networks etc. including many of their attributes.
+
+ Upon publish a .usd (or .usdz) asset file will be typically written.
+ """
 
  label = "Extract Multiverse USD Asset"
  hosts = ["maya"]

openpype/hosts/maya/plugins/publish/extract_multiverse_usd_comp.py

@@ -7,7 +7,21 @@
 
 
 class ExtractMultiverseUsdComposition(openpype.api.Extractor):
- """Extractor of Multiverse USD Composition."""
+ """Extractor of Multiverse USD Composition data.
+
+ This will extract settings for a Multiverse Write Composition operation:
+ they are visible in the Maya set node created by a Multiverse USD
+ Composition instance creator.
+
+ The input data contained in the set is either:
+
+ - a single hierarchy consisting of several Multiverse Compound nodes, with
+ any number of layers, and Maya transform nodes
+ - a single Compound node with more than one layer (in this case the "Write
+ as Compound Layers" option should be set).
+
+ Upon publish a .usda composition file will be written.
+ """
 
  label = "Extract Multiverse USD Composition"
  hosts = ["maya"]

openpype/hosts/maya/plugins/publish/extract_multiverse_usd_over.py

@@ -7,7 +7,19 @@
 
 
 class ExtractMultiverseUsdOverride(openpype.api.Extractor):
- """Extractor for Multiverse USD Override."""
+ """Extractor for Multiverse USD Override data.
+
+ This will extract settings for a Multiverse Write Override operation:
+ they are visible in the Maya set node created by a Multiverse USD
+ Override instance creator.
+
+ The input data contained in the set is:
+
+ - a single Multiverse Compound node with any number of overrides (typically
+ set in MEOW)
+
+ Upon publish a .usda override file will be written.
+ """
 
  label = "Extract Multiverse USD Override"
  hosts = ["maya"]