o3de/Gems/AtomLyIntegration/TechnicalArt/DccScriptingInterface

"""
Copyright (c) Contributors to the Open 3D Engine Project.
For complete copyright and license terms please see the LICENSE at the root of this distribution.

SPDX-License-Identifier: Apache-2.0 OR MIT
"""

# -------------------------------------------------------------------------

This folder contains the DccScriptingInterface (DCCsi) for O3DE

Notice: The old \\SDK folder is being replaced with \\Tools
The scripts in \\SDK may be out of data (and not run)
When scripts are finished being updated and refactored into \\Tools the \\SDK will be removed

What is the DCCsi?

- A shared development environment for technical art oriented to working with Python across a number of DCC tools.
- Leverage the existing python ecosystem for technical art.
- Integrate a DCC app like Substance (or Substance SAT api) from the Python driven VFX and Games ecosystem.
- Extend O3DE and unlock its potential for content creators, and the Technical Artists that service them.

Tenets:
(1) Interoperability: Design DCC-agnostic modules and DCC-bespoke modules
to work together efficiently and intuitively.

(2) Encapsulation: Define a module in terms of its essential features and interface to other components,
to facilitate logical layered design and easy maintenance.

(3) Extensibility: Design the tool set to be easily extensible with new functionality and new tools.
Individual pieces should have a generic communication mechanism to allow newly written tools to slot cleanly and transparently into the tool chain.

What is provided (High Level):

- DCC-Agnostic Python Framework (as a modular Gem) related to multiple integrations for:
O3DE Editor (python scripting, utils and PySide2 tools)
DCC applications and their Python APIs/SDKs
Custom standalone tools and utils (python based)

external from cmd line
external standalone
integrated to run within O3DE Editor

What is provided (by folder):

\3rdParty: Allows third party libs/packages to be integrated outside of O3DE
Example: O3DE is py3, Maya 2020 (and earlier) is py27
O3DE provides a patterns for Gems to provide a requirements.txt
See:
DccScriptingInterface\reqiurements.txt
^ These packages will be fetched and installed into O3DE python at build time

This means for some applications like Maya we need another way to add the same packages
See:
DccScriptingInterface\SDK\Maya\readme.txt
DccScriptingInterface\SDK\Maya\requirements.txt
DccScriptingInterface\3rdParty\Python\Lib\2.x\2.7.x\site-packages\*

Packages that reside in 3rdParty are never commited to the repo (only fetched+installed)

\Assets: All O3DE Gems can maintain an asset folder
If a Gem contains an \Asset folder, these assets are folded into the projects asset data
These assets are processed by the Asset Processor for use in the Editor and Runtime
In the DCCsi the \Assets folder primarily contains TestData

\azpy Core (shared) API, A pure python Package and Modules

\Code Contains the bare bones C++ scaffold to build and integrate the Gem with O3DE
Notes: portions of the DCCsi can be utilized outside of O3DE
thus this Gem doens't have to be enabled and built for some use cases

\Editor This folder provides an entry point pattern for extending O3DE Editor with python
When a Gem is enabled ...
If the following if found, it will be executed when the Editor boots:
"Editor\Scripts\bootstrap.py"

This can be used to initialize code access, extend the editor (PySide2), etc.

\Tools This is where the following is maintained:

\Tools\DCC Integration for DCC tools:
configuration of tool (managed env, etc.)
bootstrapping, such as providing the tool access to azpy api code
extensibility, such as adding new functionality or tool to the app

\Tools\DCC\Maya An example of adding a integration for Autodesk Maya

\Tools\Env\Windows This provides a .bat file managed env to configure and bootsrap windows apps
\Tools\Launchers\windows Provides .bat files based tool launchers for windows (accesses env)