diff --git a/README.md b/README.md index 61858043..200c9ad5 100644 --- a/README.md +++ b/README.md @@ -33,6 +33,8 @@ The `entry.usda` `stage` places you in a shot with a structure similar to how we For “production style rendering” we also provide an additional package `texture_pack` with multi UDIM, mipmapped 4K OpenEXR textures. +Refer below to the `Available Packages` section for more information on these. + We hope that this is the starting point for future contributions to showcase new ideas for discussion, promotion, and hopefully adoption. @@ -54,25 +56,52 @@ The same as we do internally. Their intended usage includes, but is not limited - Workflow Experiments and white paper proposals -# Working with Available Packages -## ALab -* "Lightweight" version with 1k textures and *without* fur & cloth. +# Available Packages + +As the complete data set is heavy and different use cases may consume distinct subsets of the data, ALab is split in different packages, each serving a different purpose depending on the consuming context. + +*If in doubt, start only with the `Asset Structure` and `Techvar Assets` packages.* + +## Asset Structure +* Main USD asset structure. No geometry, shaders or lights. + +This is purely the asset structure showcasing how all assets relate to each other through USD composition arcs. It does not include any geometry, shaders or lights, but it does include bounding box information and texture cards for every asset to be able to see extents and a preview of the ALab. +Open the `entry.usda` in your application to inspect the content: + +![asset_structure](docs/public/asset_structure_default.jpg) + +Since there are no geometry, shaders or lights in this pacakge, nothing will be visible by default in the viewport. However, if changing the draw mode on a prim like `/root/alab_set01` to `bounds` or `cards`, you'll be able to see a better preview of the contents: -Start with the default **ALab** package, load `entry.usda` in your application and see the content. +![change_draw_mode](docs/public/asset_structure_cards_mode.png) + +## Techvar Assets +* Geometry, shaders, rigs, lights & 1k textures. + +This will allow you to render the ALab *without* fur & cloth. + +Unzip and merge the `fragment` folder from this package onto the `ALab/fragment` folder of the `Asset Structure` package overriding all existing files. If your application does not set the start and end frame automatically (e.g. when using a `sublayer` node in **Houdini** or Create USD Stage from File in **Maya**), set the frame range from 1004 to 1057. You can also view through the shot camera on `prim` path: `/root/camera01/GEO/renderCam_hrc/renderCam_buffer/renderCam_srt/renderCam`. +![techvar_assets](docs/public/techvar_assets.png) + +For more information on "techvar" and other asset-related terminology, check-out the full [documentation](docs/src/pages/documentation.md). + ## Baked Procedurals * Baked procedurals (mainly in the form of `BasisCurves`) for the fur & cloth of the characters. +Internally we use custom schemas which allow procedural expansion of fur & cloth at render time. Since we can not ship these schemas as they are bound to our internal renderer, we provide their "expanded form as USD caches" separately. + Unzip the contents on top of the default ALab package to merge the `baked_procedurals` folder, overriding the previously empty `baked_procedurals/main.usda` file. After merging, your contents from the `baked_procedurals` folder should look like below: ![replace_texture_pack](docs/public/baked_procedurals.jpg) +Refer to the `Render Procedurals` section from [AL-specific content](docs/src/pages/alSpecific.md) for more details on this. + ## Texture Pack * 4k texture maps, half float mipmapped OpenEXR images in ACEScg colour space. diff --git a/docs/public/asset_structure_cards_mode.png b/docs/public/asset_structure_cards_mode.png new file mode 100644 index 00000000..8777a0f5 Binary files /dev/null and b/docs/public/asset_structure_cards_mode.png differ diff --git a/docs/public/asset_structure_default.jpg b/docs/public/asset_structure_default.jpg new file mode 100644 index 00000000..2b5ecc13 Binary files /dev/null and b/docs/public/asset_structure_default.jpg differ diff --git a/docs/public/techvar_assets.png b/docs/public/techvar_assets.png new file mode 100644 index 00000000..75534395 Binary files /dev/null and b/docs/public/techvar_assets.png differ diff --git a/docs/src/pages/changelog.md b/docs/src/pages/changelog.md index 84846e4f..91f73edb 100644 --- a/docs/src/pages/changelog.md +++ b/docs/src/pages/changelog.md @@ -10,6 +10,12 @@ layout: ../layouts/BaseLayout.astro > Changelog for [ALab](https://animallogic.com/alab/). +### 2.2.0 + +- Split main package in two: + - `asset_structure`: Available as well as a GitHub repository to facilitate external experimentation and collaboration on the asset structure. + - `techvar_assets`: Geometry, lights, shaders, rigs which are the heavy assets containing artistic contributions. + ### 2.1.0 - Updated geometry proxies to more closely match the **render** `purpose` geometry.