Skip to content

Commit

Permalink
Merge pull request #45 from ynput/documentation/OP-5047_Documentation…
Browse files Browse the repository at this point in the history
…-Maya-Model-publishing
  • Loading branch information
mkolar committed Jun 30, 2023
2 parents d2e52db + 723b70c commit 2aa5e4b
Show file tree
Hide file tree
Showing 7 changed files with 40 additions and 6 deletions.
42 changes: 38 additions & 4 deletions website/docs/artist_hosts_maya.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,18 @@ name of the group you have selected.
wrapped in Model instance. This is usually what you want. Click on **Create** button.

You'll notice then after you've created new Model instance, there is new set
in Outliner called after your subset, in our case it is `modelMain`.
in Outliner called after your subset, in our case it is `modelMain`. The `modelMain`
set provides settings for you to includes some data when publishing. The settings can be found
in the channel box when you select the set.

![ModelMain Settings in Channel Box](assets/maya_model_main_custom_attributes.png)

These settings allow you to include either **Write Color Sets**, **Write Face Sets**,
or **Include Parent Hierarchy** as your exported preference before publishing.

:::note
The exported setting is solely valid for `Extract PointCache(Alembic)`.
:::

And that's it, you have your first model ready to publish.

Expand Down Expand Up @@ -125,28 +136,51 @@ In main overview you can notice little up arrow in a circle next to validator
name. Right click on it and you can see menu item `select invalid`. This
will select offending object in Maya.

![Model Validator Selected Invalid](assets/maya-model-validator-select-invalid.png)

Fix is easy. Without closing Publisher window we just freeze transformations.
Then we need to reset it to make it notice changes we've made. Click on arrow
circle button at the bottom and it will reset Publisher to initial state. Run
validators again (flask icon) to see if everything is ok.

It should be now. Write some comment if you want and click play icon button
when ready.
There are also `repair` actions for some validators. e.g. Mesh ColorSets
If you can't pass the validator, you can right-click and hit `repair`. It will
fix the stuff which triggers the validator in the scene.

![Model Validator Repair](assets/maya_model_publishing_repair_action.png)

When everything pass all the validations, you can write some comment if you want
and click play icon button to publish the instance when ready.

Publish process will now take its course. Depending on data you are publishing
it can take a while. You should end up with everything green and message
**Finished successfully ...** You can now close publisher window.

Ayon is able to publish model data in Alembic, Maya Scene, OBJ format; where
OBJ publisher needs to be enabled in the Settings.

![OBJ Extractor in Setting](assets/maya_obj_extractor_settings.png)

To check for yourself that model is published, open
[Asset Loader](artist_tools_loader) - **AYON → Load...**.
There you should see your model, named `modelMain`.

You can load your model by either referencing or importing.
Ayon can now support referencing the model in both Alembic
and Maya ASCII(ma) format, while it can load the model in four
different ways. You can choose to load your model in Alembic
format in Vray Proxy, Arnold Standin or GPU Cache. You can also
load the mesh in USD format if you have the multiverse USD plugin
installed in your machine.

![OBJ Extractor in Setting](assets/maya_loaders_options.png)

## Look development

Look development in AYON is easy. It helps you with versioning different
kinds of shaders and easy switching between them.

Let se how it works.
Let see how it works.

### Loading model

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added website/docs/assets/maya_loaders_options.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions website/yarn.lock
Original file line number Diff line number Diff line change
Expand Up @@ -1222,7 +1222,7 @@
"@docsearch/css" "3.3.3"
algoliasearch "^4.0.0"

"@docusaurus/core@2.4.0", "@docusaurus/core@^2.4.0":
"@docusaurus/core@2.4.0":
version "2.4.0"
resolved "https://registry.yarnpkg.com/@docusaurus/core/-/core-2.4.0.tgz#a12c175cb2e5a7e4582e65876a50813f6168913d"
integrity sha512-J55/WEoIpRcLf3afO5POHPguVZosKmJEQWKBL+K7TAnfuE7i+Y0NPLlkKtnWCehagGsgTqClfQEexH/UT4kELA==
Expand Down Expand Up @@ -1497,7 +1497,7 @@
sitemap "^7.1.1"
tslib "^2.4.0"

"@docusaurus/preset-classic@^2.4.0":
"@docusaurus/preset-classic@2.4.0":
version "2.4.0"
resolved "https://registry.yarnpkg.com/@docusaurus/preset-classic/-/preset-classic-2.4.0.tgz#92fdcfab35d8d0ffb8c38bcbf439e4e1cb0566a3"
integrity sha512-/5z5o/9bc6+P5ool2y01PbJhoGddEGsC0ej1MF6mCoazk8A+kW4feoUd68l7Bnv01rCnG3xy7kHUQP97Y0grUA==
Expand Down

0 comments on commit 2aa5e4b

Please sign in to comment.