A Faceform Wrap is a topology transfer tool for creation of digital characters based on 3D scans of real actors or sculpts.

As Wrap has no Python API its integration is a bit limited. It can now open predefined template workfile based on profiles. These template workfiles could contain placeholders which will be textually replaced before starting and opening a workfile with Wrap.

Configure ayon+settings://wrap/workfile_builder/custom_templates to add profiles to select particular .wrap template for a task.

Read nodes which should be controlled by AYON needs to contain AYON. prefix in File name property.

Format of the placeholder: AYON.FOLDER_PATH.PRODUCT_NAME.VERSION.EXTENSION

Description:

• AYON - hardcoded prefix denoting this is Ayon placeholder
• FOLDER_PATH - points to folder
  • could be encased with {} to denote it is dynamic value {currentFolder} - folder from context
  • or any actual path of folder (/characters/characterA)
• PRODUCT_NAME - value of product from folder (modelMain)
• VERSION - value to select version
  • encased in {} ({latest}, {hero}) points to version of current context
  • any integer number points to specific version (4)
• EXTENSION - extension of loaded representation (png)

Regular artist opens Wrap ordinary via Launcher. Before Wrap is opened Scene Inventory tool will be shown to highlight which items were loaded when placeholders got resolved. Artist can see version, if loaded version is not the latest, it is highlighted by red color.

As there is no Python API to run code of Ayon directly in Wrap application, publish process is semi-manual. Artists must prepare workfile, save it and then publish it via Publisher: docs/artist_tools_publisher tool.

There might be multiple write nodes inside of the workfile, but not all of them must be published via Ayon. Publishable nodes must contain AYON_ prefix in their names. Whole name has then format AYON_PUBLISHED_PRODUCT_NAME (eg.AYON_wrapRenderMain - this will publish wrapRenderMain product of wrap family.

Artist should open Publisher, select published context in left column, drag&drop prepared workfile in the middle column and hit Create. There should appear new instance in the right column, next step would be to hit Publish to start publishing process.

Run create_package.py and install addon via Bundles page.

This addon doesn't require any external dependencies.