breakdown update bugfix

Fix a bug in the tk-multi-breakdown2 update function (undeclared variable in log)

Ability to set and retrieve meta data

Description

It is now possible to add meta data properties, retrieve or set set meta data values for project items (bins, clips).

• A new PremiereProject.add_meta_data_property was added allowing to define additional meta data properties for all items in a project.
• New get_meta_data and set_meta_data methods can be used to retrieve and set meta data properly values.

For example:

project = engine.current_project
project.add_meta_data_property("myproperty", "My Property", float)
mybin = project.get_bin_by_name("mybin")
val = mybin.set_meta_data("myproperty", 30.0)
val = mybin.get_meta_data("myproperty")

Note: Limitations in the Adobe Premiere API can cause unexpected behaviours. For example it is not possible to check at the moment if a property is already defined in the project meta data schema, so adding a property which already exists will have no effect.

What's Changed

• 11730 meta data by @gplsteph in #8

Full Changelog: v1.3.0...v1.3.1

Loader can import in bin defined by template

If a import_in_bin_template is defined, load clips into the bin defined by the template. Otherwise, load in the root.

Bins helpers and ability to update clips in a dedicated bin

Description

Some helpers were added to create and retrieve bins.
For example, importing media in a dedicated bin can be done with:

# Get the current Premiere project
project = engine.current_project
# Make sure needed bins exist
my_bin = project.ensure_bins_for_path("/path/to/my/import/bin")
# Create a new clip for some media in the bin
clip = my_bin.create_clip_from_media("/path/to/my/media/on/disk/media.mov")
# Adjust the clip name if needed
clip.name = "Demo media"

A new import_in_bin_template setting is now retrieved by the default scene operation hook: if set to a template name defined in core/templates.yml, clips are not updated in place, but new clips with updated media are created in a bin matching the resolved path.

For example:

• In core/templates.yml: premiere_import_bin: 'Published/{YYYY_MM_DD}
• In breakdown2 app settings: import_in_bin_template: premiere_import_bin

What's Changed

• 12123 import as new clips by @gplsteph in #6

Full Changelog: v1.2.2...v1.2.3

Fix `ensure_text` bug in `basic/scene_actions.py`

There was a bug preventing a published file to be opened properly. It is now fixed.

Timelines and tracks

Description

Some helpers were added for Timelines, Tracks and Track Clips.
The Breakdown2 scan scene hooks now only considers the current timeline if scan_current_timeline_only is set to true in the Breakdown2 app settings.

For example:

premiere.tk-multi-breakdown2:
  <<: *breakdown2
  help_url: "https://developer.shotgridsoftware.com/tk-multi-breakdown2/index.html"
  hook_scene_operations: "{engine}/tk-multi-breakdown2/basic/scene_operation.py"
  hook_get_published_files: "{config}/tk-multi-breakdown2/studio/get_published_files.py"
  scan_current_timeline_only: true

What's Changed

• 11528 breakdown app2 by @gplsteph in #4

Full Changelog: v1.2.0...v1.2.1

Premiere objects helpers

Description

Some helpers were added to deal with Premiere projects, sequences, bins and clips.
A hook for the tk-multi-breakdown2 app has been added.

What's Changed

• 11528 breakdown app by @gplsteph in #3

Full Changelog: v1.1.1...v1.2.0

Polish

Description

Polished code in couple of places.

What's Changed

• For #10802. polish by @gplsteph in #2

Full Changelog: v1.1.0...v1.1.1

Python 3, polish and fixes

Description

This engine can now be used with Python 3.
A couple of small things were fixed and the code is now PEP8 compliant.

What's Changed

• 10802 Fixes and polish by @gplsteph in #1

New Contributors

• @gplsteph made their first contribution in #1

Full Changelog: https://github.com/GPLgithub/tk-premiere/commits/v1.1.0