Updates to Support PhysicallyBased V2 : Part I. (#37)

* Started work on updating the Physically Based API call to v2.0

* Add in colorspace tagging and handle specular color. The choise of colorspace and format (for specular) is to take the first entry which
preserves the previous values but now with proper colorspace tagging.

* Leave a Q. Is srgb-linear lin_rec709 or srgb_texture. Current set to srgb_texture.

* - Handle specular color propertly for glTF vs SS vs OPBR. Note that Diseny and USDPreview are not currently supported
but the default is Gulbrandsen. There is no BSDF for Lama nodes but the default should work there as well.
- Fix colorspace specification. It was being used for all inputs instead of just ones where specifeid.
- Fix transmission color colorspace setting.
- Rerun translation for each shading model.

* Fix to colorspace writing. Choose based on option. Default srgb-linear does not write lin_rec709 unless specified by option.

* Fix up mapping of colors, colorspace for custom definitions.

* Remove "default" colorspae behaviour. Colorspace is always explicitly set for clariity.

* - Remove colorspace option for now. Will always choice linear.
- Delete acescg translations

---------

Co-authored-by: Anton Palmqvist <13031779+AntonPalmqvist@users.noreply.github.com>

Author: kwokcb

src/materialxMaterials.egg-info/PKG-INFO

@@ -298,6 +298,8 @@ See the <a href="https://kwokcb.github.io/materialxMaterials/examples/index.html
         </tr>
       </table>
     </td>
+    </tr>
+    <tr>
     <td>
       <b>PhysicallyBased</b>
       <table>
@@ -338,20 +340,23 @@ See the <a href="https://kwokcb.github.io/materialxMaterials/examples/index.html
         </tr>
       </table>
     </td>
+    </tr>
+  <tr>
     <td>
       <b>PolyHaven</b>
       <table>
+      <!-- https://kwokcb.github.io/materialxMaterials/src/materialxMaterials/ -->
         <tr>
           <td>
-            <img src="https://kwokcb.github.io/materialxMaterials/src/materialxMaterials/data/PolyHavenMaterialX/polyhaven_aerial_asphalt_1.png" width=256px%><br>
-            Ashphalt
+            <img src="https://raw.githubusercontent.com/kwokcb/materialxMaterials/refs/heads/main/examples/PolyHaven/aerial_asphalt_01_1k_materialx/aerial_asphalt_01_1k.png" width="256px"><br>
+            Ashphalt 1
           </td>
           <td>
-            <img src="https://kwokcb.github.io/materialxMaterials/src/materialxMaterials/data/PolyHavenMaterialX/polyhaven_polystrylene.png" width=256px><br>
-            Polystyrene
+            <img src="https://github.com/kwokcb/materialxMaterials/blob/main/examples/PolyHaven/aerial_rocks_02_1k_materialx/aerial_rocks_02_1k.png?raw=true" width="256px"><br>
+            Rocks 2
           </td>
           <td>
-            <img src="https://kwokcb.github.io/materialxMaterials/src/materialxMaterials/data/PolyHavenMaterialX/polyhave_wood_trunk_wall.png" width=256px><br>
+            <img src="https://github.com/kwokcb/materialxMaterials/blob/main/examples/PolyHaven/wood_trunk_wall_1k_materialx/wood_trunk_wall_1k.png?raw=true" width="256px"><br>
             Wood Trunk Wall
           </td>
         </tr>
@@ -515,7 +520,7 @@ npm run [build/start]   # Build distribution or run the package
 
 <h3>Command Line Interfaces</h3>
 
-<h4>Python</h4>
+<h4>PhysicallyBased</h4>
 
 - Query all materials fom PhysicallyBased and convert them to all  support shading models. Save the material list and corresponding MaterialX files in the default output location. The build will include this information Python package under the <code>data</code> folder.
 
@@ -527,13 +532,16 @@ npm run [build/start]   # Build distribution or run the package
   ```sh
   materialxMaterials physbased
   ```
+<h4>GPUOpen</h4>
 
 - Query all materials fom GPUOpen. Extract out a few material packages (zip). Save the material lists, material names and unzipped packages (MaterialX and images) in the default output location. The build will include this information Python package under the <code>data</code> folder.
 
   ```sh
   materialxMaterials gpuopen --materialNames=1 --saveMaterials=1
   ```
 
+<h4>ambientCG</h4>
+
 - Download the materials list fom ambientCG: 
 
   ```sh
@@ -546,28 +554,50 @@ package where the images are 2K PNG files:
   ```sh
   materialxMaterials acg --downloadMaterial "WoodFloor038" --downloadResolution 2
   ```
-- Examine all texture assets on PolyHaven, and find all ones which have MaterialX resources. Does not download the asset.
+
+<h4>PolyHaven</h4>
+
+- Examine all texture assets on PolyHaven, and find all ones which have MaterialX resources. 
 
   ```sh
-  polyHavenLoaderCmd.py --fetch --download_id=""
+  polyHavenLoaderCmd.py -fe
   ```
 
-- Extract out a specific MateriaX asset with a given identifier.
+- The extraction can be filtered by identifier:
   ```sh
-  polyHavenLoaderCmd.py --fetch --download_id="aerial_asphalt_01"
+  polyHavenLoaderCmd.py -fe -id="aerial_asphalt_01"
   ```
-- Extract out the first 10 MaterialX assets.
+- or by count. In this case the first 10 assets with MaterialX resources will be extracted.
   ```sh
-  polyHavenLoaderCmd.py --fetch -c 10
+  polyHavenLoaderCmd.py -fe -c 10
   ```
 
-- Scan locally downloaded MaterialX asset information to download.
+Note that this does not download any of the content for each asset, but instead
+extract information into a file called `polyhaven_materialx_assets.json` for later usage.. The build process will include a file with this name under the <code>data</code> as part of the Python package. This avoids having to query the PolyHaven API repeatedly.
+
+- The user can either use a local version of this file by specifying the path the file as shown below, where an optional `--data_folder` argument can be used to specify the location of the file. 
 
   ```sh
-  python -m materialxMaterials polyhaven --load --download_id="aerial_asphalt_01"
+  python -m materialxMaterials polyhaven --load [--data-folder <myfolder location> -id="aerial_asphalt_01"
   ```
 
-<h5>NodeJS</h5>
+- If `--load` is not specified then the the packaged will be used by default. 
+
+  ```sh
+  python -m materialxMaterials polyhaven -id="aerial_asphalt_01"
+  ``` 
+
+Download options include:
+
+1. `-x` or `--extract` to extract the content of the package (MaterialX and images) into a folder. By default the package will be downloaded but not extracted.
+
+2. `-exr` or `--keep_exr` to keep the EXR files if they are included in the package. By default the equivalent PNG files are downloaded or EXR files are converted to PNG files. The latter requires the `OpenImageIO` package to be installed.
+    - Note that if EXR images are remapped then the MaterialX file references
+    are also remapped in the `.mtlx` file. 
+
+3. `-r` or `--download_resolution` to specify the resolution of the images to download. By default the lowest resolution images are downloaded. The user can specify "1k", "2k", "4k" or "8k".
+
+<h4>GPUOpen (NodeJS)</h4>
 
 The utility can be run from the `javascript\JsGPUOpenLoaderPackage` folder as follows:
 

src/materialxMaterials.egg-info/SOURCES.txt

@@ -51,8 +51,11 @@ src/materialxMaterials/data/PhysicallyBasedMaterialX/Cooking_Oil.png
 src/materialxMaterials/data/PhysicallyBasedMaterialX/Ketchup.png
 src/materialxMaterials/data/PhysicallyBasedMaterialX/PhysicallyBasedMaterial.json
 src/materialxMaterials/data/PhysicallyBasedMaterialX/PhysicallyBasedMaterialX_GLTF.mtlx
+src/materialxMaterials/data/PhysicallyBasedMaterialX/PhysicallyBasedMaterialX_GLTF_acescg.mtlx
 src/materialxMaterials/data/PhysicallyBasedMaterialX/PhysicallyBasedMaterialX_OPBR.mtlx
+src/materialxMaterials/data/PhysicallyBasedMaterialX/PhysicallyBasedMaterialX_OPBR_acescg.mtlx
 src/materialxMaterials/data/PhysicallyBasedMaterialX/PhysicallyBasedMaterialX_SS.mtlx
+src/materialxMaterials/data/PhysicallyBasedMaterialX/PhysicallyBasedMaterialX_SS_acescg.mtlx
 src/materialxMaterials/data/PhysicallyBasedMaterialX/PhysicallyBasedMaterialX_translated_GLTF.mtlx
 src/materialxMaterials/data/PhysicallyBasedMaterialX/PhysicallyBasedMaterialX_translated_OPBR.mtlx
 src/materialxMaterials/data/PhysicallyBasedMaterialX/PhysicallyBasedMaterialX_translated_SS.mtlx
@@ -61,17 +64,15 @@ src/materialxMaterials/data/PhysicallyBasedMaterialX/Skin.png
 src/materialxMaterials/data/PhysicallyBasedMaterialX/physbased_pbr.mtlx
 src/materialxMaterials/data/PhysicallyBasedMaterialX/physbased_pbr_materials.mtlx
 src/materialxMaterials/data/PhysicallyBasedMaterialX/physbased_pbr_translators.mtlx
-src/materialxMaterials/data/PolyHavenMaterialX/aerial_asphalt_01___1k_materialx.zip
 src/materialxMaterials/data/PolyHavenMaterialX/filtered_polyhaven_assets.json
 src/materialxMaterials/data/PolyHavenMaterialX/polyhave_wood_trunk_wall.png
 src/materialxMaterials/data/PolyHavenMaterialX/polyhaven_aerial_asphalt_1.png
 src/materialxMaterials/data/PolyHavenMaterialX/polyhaven_assets.json
 src/materialxMaterials/data/PolyHavenMaterialX/polyhaven_materialx_assets.json
 src/materialxMaterials/data/PolyHavenMaterialX/polyhaven_polystrylene.png
 src/materialxMaterials/data/PolyHavenMaterialX/polystyrene_1k_materialx.zip
-src/materialxMaterials/data/PolyHavenMaterialX/wood_trunk_wall___1k_materialx.zip
 src/materialxMaterials/data/PolyHavenMaterialX/polystyrene_1k_materialx/polystyrene_1k.mtlx
-src/materialxMaterials/data/PolyHavenMaterialX/polystyrene_1k_materialx/polystyrene_1k_thumbnail..png
+src/materialxMaterials/data/PolyHavenMaterialX/polystyrene_1k_materialx/polystyrene_1k_thumbnail.png
 src/materialxMaterials/data/PolyHavenMaterialX/polystyrene_1k_materialx/textures/polystyrene_diff_1k.jpg
 src/materialxMaterials/data/PolyHavenMaterialX/polystyrene_1k_materialx/textures/polystyrene_disp_1k.png
 src/materialxMaterials/data/PolyHavenMaterialX/polystyrene_1k_materialx/textures/polystyrene_nor_gl_1k.png