AWS Deadline Cloud for 3ds Max

Disclaimer

This GitHub repository is an example integration with AWS Deadline Cloud that is intended to only be used for testing and is subject to change. This code is an alpha release. It is not a commercial release and may contain bugs, errors, defects, or harmful components. Accordingly, the code in this repository is provided as-is. Use within a production environment is at your own risk!

Our focus is to explore a variety of software applications to ensure we have good coverage across common workflows. We prioritized making this example available earlier to users rather than being feature complete.

There are two open issues that prevent successful installation and rendering:

• Bug: Opening the 3ds Max Submitter fails with “runtime error : Failed to open file run_ui.py”
• Bug: Adaptor freezes on launching 3ds Max

This example has been used by at least one internal or external development team to create a series of jobs that successfully rendered. However, your mileage may vary. If you have questions or issues with this example, please start a discussion or cut an issue.

AWS Deadline Cloud for 3ds Max is a python package that allows users to create AWS Deadline Cloud jobs from within 3ds Max. Using the Open Job Description (OpenJD) Adaptor Runtime this package also provides a command line application that adapts 3ds Max's command line interface to support the OpenJD specification.

Compatibility

This library requires:

1. 3ds Max 2024,
2. Python 3.9 or higher; and
3. Windows operating system.

Submitter

This package provides a 3ds Max plugin that creates jobs for AWS Deadline Cloud using the AWS Deadline Cloud client library. Based on the loaded scene it determines the files required, allows the user to specify render options, and builds an OpenJD template that defines the workflow.

Adaptor

The 3ds Max Adaptor implements the OpenJD interface that allows render workloads to launch 3ds Max and feed it commands. This gives the following benefits:

• a standardized render application interface,
• sticky rendering, where the application stays open between tasks,

Jobs created by the submitter use this adaptor by default.

Getting Started

The adaptor can be installed by the standard python packaging mechanisms:

$ pip install deadline-cloud-for-3ds-max

After installation it can then be used as a command line tool:

$ 3dsmax-openjd --help

For more information on the commands the OpenJD adaptor runtime provides, see here.

Versioning

This package's version follows Semantic Versioning 2.0, but is still considered to be in its initial development, thus backwards incompatible versions are denoted by minor version bumps. To help illustrate how versions will increment during this initial development stage, they are described below:

1. The MAJOR version is currently 0, indicating initial development.
2. The MINOR version is currently incremented when backwards incompatible changes are introduced to the public API.
3. The PATCH version is currently incremented when bug fixes or backwards compatible changes are introduced to the public API.

Security

See CONTRIBUTING for more information.

Telemetry

See telemetry for more information.

License

This project is licensed under the Apache-2.0 License.