ayon-core/website/docs/artist_hosts_3dsmax.md
2023-01-26 08:54:29 +01:00

7 KiB

id title sidebar_label
artist_hosts_3dsmax 3dsmax 3dsmax

:::note Work in progress This part of documentation is still work in progress. :::

OpenPype Global Tools

First Steps With OpenPype Running

When OpenPype (reffered as OP ) properly installed and 3dsmax launched via OP Launcher/Ftrack (or similar) there should be OpenPype Menu visible in 3dsmax top header after start.

Menu OpenPype

Working With Scene Files

Most user actions happens in Work Files menu item. There user can perform Save/Load actions as he would normally do with File Save and/or File Open in the standard 3dsmax File Menu. OP Menu > Work Files... basically substitutes all file operations user can perform.

Here you have an overview of the Work Files window with descriptions what each area is used for.

Menu OpenPype

Setting scene data

3dsmax settings concerning framerate, resolution and frame range are handled by OpenPype. If set correctly in OP Project Manager/Ftrack, 3dsmax will automatically set the values for you.

Publishing models

Intro

Publishing models in 3dsmax is pretty straightforward. Create your model as you need. You might need to adhere to specifications of your studio that can be different between studios and projects but by default your geometry does not need any other convention.

Model example

Creating instance

Now create Model instance from it to let OpenPype know what in the scene you want to publish. Go OpenPype → Create... → Model.

Model create instance

Asset field is a name of asset you are working on - it should be already filled with correct name as you've started Blender or switched context to specific asset. You can edit that field to change it to different asset (but that one must already exists).

Subset field is a name you can decide on. It should describe what kind of data you have in the model. For example, you can name it Proxy to indicate that this is low resolution stuff. See Subset.

Read-only field just under it show final subset name, adding subset field to name of the group you have selected.

Use selection checkbox will use whatever you have selected in Outliner to be 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 a new collection in Outliner called after your asset and subset, in our case it is character1_modelDefault. The assets selected when creating the Model instance are linked in the new collection.

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

Now save your scene (if you didn't do it already). You will notice that path in Save dialog is already set to place where scenes related to modeling task on your asset should reside. As in our case we are working on asset called character1 and on task modeling, path relative to your project directory will be project_XY/assets/character1/work/modeling. The default name for the file will be project_XY_asset_task_version, so in our case simonetest_character1_modeling_v001.blend. Let's save it.

Model create instance

Publishing models

Now let's publish it. Go OpenPype → Publish.... You will be presented with following window:

Model publish

Note that content of this window can differs by your pipeline configuration. For more detail see Publisher.

Items in left column are instances you will be publishing. You can disable them by clicking on square next to them. White filled square indicate they are ready for publishing, red means something went wrong either during collection phase or publishing phase. Empty one with gray text is disabled.

See that in this case we are publishing from the scene file simonetest_character1_modeling_v001.blend the Blender model named character1_modelDefault.

Right column lists all tasks that are run during collection, validation, extraction and integration phase. White items are optional and you can disable them by clicking on them.

Lets do dry-run on publishing to see if we pass all validators. Click on flask icon at the bottom. Validators are run. Ideally you will end up with everything green in validator section.

Fixing problems

For the sake of demonstration, I intentionally kept the model in Edit Mode, to trigger the validator designed to check just this.

Failed Model Validator

You can see our model is now marked red in left column and in right we have red box next to Mesh is in Object Mode validator.

You can click on arrow next to it to see more details:

Failed Model Validator details

From there you can see in Records entry that there is problem with the object Suzanne. Some validators have option to fix problem for you or just select objects that cause trouble. This is the case with our failed validator.

In main overview you can notice little A 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 Blender.

Fix is easy. Without closing Publisher window we just turn back the Object Mode. 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 the Publisher to initial state. Run validators again (flask icon) to see if everything is ok.

It should OK be now. Write some comment if you want and click play icon button 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.

To check for yourself that model is published, open Asset Loader - OpenPype → Load.... There you should see your model, named modelDefault.

Loading models

You can load model with Loader. Go OpenPype → Load..., select your rig, right click on it and click Link model (blend).