ftrack connect maya¶

Maya integration with ftrack.

Installing¶

Using ftrack Connect¶

The primary way of installing and launching the Maya integration is through the ftrack Connect package. Go to ftrack Connect package and download it for your platform.

Building from source¶

You can also build manually from the source for more control. First obtain a copy of the source by either downloading the zipball or cloning the public repository:

git clone git@bitbucket.org:ftrack/ftrack-connect-maya.git

Then you can build and install the package into your current Python site-packages folder:

python setup.py build_plugin

The result plugin will then be available under the build folder. Copy or symlink the result plugin folder in your FTRACK_CONNECT_PLUGIN_PATH.

Building documentation from source¶

To build the documentation from source:

python setup.py build_sphinx

Then view in your browser:

file:///path/to/ftrack-connect-maya/build/doc/html/index.html

Dependencies¶

Python >= 2.6, < 3
ftrack connect >= 0.1.2, < 2
Maya >= 2014, <= 2019

Additional For building¶

Sphinx >= 1.2.2, < 2
sphinx_rtd_theme >= 0.1.6, < 1

Using¶

Find out all information you need to use maya with ftrack.

Launching¶

The primary way of launching Maya with the ftrack integration is to download and use the ftrack Connect package

Once installed and running you can start Maya from the Actions tab after browsing to a task.

Publishing asset versions¶

Use the publish asset dialog to publish a new asset version from Maya.

Supported asset types are:

Camera
Geometry
Light rig
Rig
Scene

To publish a new asset or version up an existing, simply select it in your scene and bring up the publish asset dialog from the ftrack menu. Select the task you want to publish to and the type of asset you want to publish. You also need to give the asset a unique name or select the name of an existing asset to version up. A thumbnail can be added manually or as a screenshot of the current viewport.

Importing asset versions¶

To import an existing asset into Maya, open the ImportAsset dialog from the ftrack menu. Browse to an entity that has asset versions and select the version in the list. Components on that version will be shown and can be imported from a location if that location is available to you.

Managing asset versions in the scene¶

The asset manager can be used to track and manage the existing assets that have been imported into the scene. They can easily be versioned up or down using the asset manager. The asset manager can also be used to select assets in the scene to find them more easily.

Developing¶

Discover how to develop and extend the default ftrack integration with Maya.

API reference¶

`ftrack_connect_maya`¶

Glossary¶

Release and migration notes¶

Find out information about what has changed between versions and any important migration notes to be aware of when switching to a new version.

Release Notes¶

1.4.0¶

8 September 2021

change

HookUpdate hook for application-launcher.
change

SetupProvide dependency to ftrack-connector-legacy module.

Warning

From this version the support for ftrack-connect 1.X is dropped, and only ftrack-conenct 2.0 will be supported up to the integration EOL.

1.3.0¶

28 September 2020

change

Update pyside signal signature for pyside2 compatiblity.
add

ImportAdd support for FBX import.

1.2.3¶

21 January 2020

fix

Fix QStringListModel compatibility for PySide2 5.9+.
add

ImportAdded import single frame image sequence as image texture.

1.2.2¶

25 June 2019

fix

ImportAllow alembic to be imported as reference.
fix

ExportFbx export breaks under windows.
new

ImportAdded “Open” import mode, which replaces current scene.

1.2.1¶

2 April 2019

new

ExportProvide fbx export options.

1.2.0¶

19 December 2018

changed

InternalConvert code to standalone ftrack-connect plugin.

1.1.4¶

11 October 2018

fix

HookVersion check breaks due to changes in application version sorting with connect >= 1.5.0.

1.1.3¶

27 April 2018

changed

Import type of scenes are determined initially from file type.
changed

InternalEnforce QtExt minimum version in setup.
changed

Explicit radio buttons for import modes; “Import” and “Reference”. Change default import mode to “Reference”.
changed

Asset manager

Allow import support for different audio file formats.

1.1.2¶

2 February 2018

fixed

CompatibilityQtWebWidgets incompatibility for windows.

1.1.1¶

14 December 2017

fixed

CompatibilityIntegration does not load in Maya 2018 on windows.
new

LoggingImproved feedback gathering.

1.0.0¶

7 July 2017

fixed

LoggingLegacy api event hub spams Maya.
new

ImportAdd more options for import namespace.
fixed

TimelineError when setting timeline if task parent is not a Shot.
fixed

CompatibilityIf PySide is installed on the system Maya 2017 may crash.

0.2.5¶

1 December 2016

fixed

PerformanceScanning for new asset versions at scene startup is very slow.
fixed

PerformanceAll panels are created on Maya startup which has a negative impact on performance.
fixed

CompatibilityIntegration breaks on Maya 2015.
fixed

Can’t import abc which does not have “alembic” as component name.

0.2.4¶

16 September 2016

changed

Add support for Maya 2017.

0.2.3¶

7 June 2016

fixed

UiAsset without transform nodes doesn’t show in Maya Asset manager.
fixed

UiPublish asset doesn’t work correctly if changing context.
fixed

UiCannot switch version of alembic from the Asset manager.

Note

This fix applies to later versions of Maya 2016.
fixed

Timeline does not set correctly when importing a scene asset.
fixed

Assets not always deleted correctly from the Asset manager.

0.2.2¶

10 May 2016

fixed

When taking a screenshot for publish the entire window is captured rather than only the view port.

0.2.1¶

25 April 2016

fixed

HookMaya versions appear twice in connect.
fixed

UiRestore ftrack_connect.panelcom.PanelComInstance communication with contextSelector, so changes to the environments get reflected into the widgets.

0.2.0¶

8 January 2016

new

Initial release of ftrack connect maya plugin.