Skip to content

Releases: AcademySoftwareFoundation/OpenTimelineIO

Beta 16 - April 2024

04 Apr 17:10
2b9c3a4
Compare
Choose a tag to compare
Beta 16 - April 2024 Pre-release
Pre-release

Summary

This release moves from the third party any and optional to C++17 std::any and std::optional (by @darbyjohnston) as well as a collection of enhancements in how the python bindings handle type conversion with C++ (by @JeanChristopheMorinPerso) and the addition of comment to the Marker schema (by @nickblt).

This release also includes an experimental set of editing commands (by @ggarra13) in C++. These are a new set of APIs intended to implement some common editing commands (insert, overwrite, roll, etc.) backed by the OpenTimelineIO data model. These APIs are meant to provide an opportunity to try the concepts and form a base to iterate on, however there may be breaking changes as they evolve.

Important Note About Adapters

This will be the last release to include the full set of adapters. In the next release, most of the adapters will move out into their own PyPI packages as optional plugins.

tl;dr - if you rely on the adapters, please use the OpenTimelineIO-Plugins PyPI package to ensure you continue to receive them after this release.

The OpenTimelineIO native file format adapters will still be present in the opentimelineio python package. These adapters are:

  • otio_json
  • otiod
  • otioz

To get the full set of OTIO adapters, use the OpenTimelineIO-Plugins python package. In addition to the OpenTimelineIO native adapters, you'll also get:

  • AAF
  • ale
  • burnins
  • cmx_3600
  • fcp_xml
  • fcpx_xml
  • hls_playlist
  • maya_sequencer
  • svg
  • xges

The following are not included in the OTIO-maintained top-level packages:

  • kdenlive - Now hosted and supported under the KDE repository
  • rv_session - This adapter was made obsolete by first-party support of OpenTimelineIO in Shotgrid RV and OpenRV

To experiment with what this looks at, check out the 0.17.0 Pre-Release - packages are provided on PyPI to try out.

Big Changes

Breaking Changes

Other Changes

Read more

Beta 17 Pre-Release

24 Oct 19:44
843806e
Compare
Choose a tag to compare
Beta 17 Pre-Release Pre-release
Pre-release

Summary

This is a preview release for extracting the "batteries included" file format adapters and moving them to their own repositories and python packages. If you still require the adapters, you should use the opentimelineio-plugins python package which will have a version correlating to each OpenTimelineIO core release.

The release is a Developmental release to give users a chance to try out how the new opentimelineio and opentimelineio-plugins package setups work in their environments. Because this release is an early cut, there are still a collection of tasks to complete before the final release. There are also additional 0.16.0 changes that will be integrated with this release when it is finalized, so please treat it very much as a work-in-progress.

Please provide feedback about your experience in the GitHub issue for adapter break-out - #1386.

How To Install

By default pip won't pick up developmental releases. To try this release, use one of the following:

  • Setting opentimelineio==0.17.0.dev1 as a dependency
  • python -m pip install opentimelineio==0.17.0.dev1
  • python -m pip install --pre opentimelineio

To opt-in to the "batteries-included" package, use any of these variants with the opentimelineio-plugins package.

Important Note About Adapters

Since we've removed the adapters from OpenTimelineIO core, only the OpenTimelineIO native file format adapters are present in the opentimelineio python package. These adapters are:

  • otio_json
  • otiod
  • otioz

To get the full set of OTIO adapters, use the OpenTimelineIO-Plugins python package. In addition to the OpenTimelineIO native adapters, you'll also get:

  • AAF
  • ale
  • burnins
  • cmx_3600
  • fcp_xml
  • fcpx_xml
  • hls_playlist
  • maya_sequencer
  • svg
  • xges

The following are not included in the OTIO-maintained top-level packages:

  • kdenlive - Now hosted and supported under the KDE repository
  • rv_session - This adapter was made obsolete by first-party support of OpenTimelineIO in Shotgrid RV and OpenRV

What's Changed

Full Changelog: v0.15...v0.17.0.dev1

Beta 15 - September 2022

26 Sep 19:15
3703ac7
Compare
Choose a tag to compare
Pre-release

Summary

This release introduces Media-multi references (by @rogernelson), spatial coordinates parameters (also by @rogernelson), otiotool command line utility, a schema downgrading system (for writing OTIO files that are compatible with older versions of OTIO), as well as a number of other smaller bug fixes and enhancements across the core and adapters. This is the last version of OTIO that will support python 2.7.

Thank you to the many community members who contributed to this release!

Important Note About OTIO File Backwards Compatibility

This version of OTIO introduces a new version of the Clip schema, Clip.2 (with multiple media reference support). If you need to write out OTIO files that are compatible with older versions of the OTIO library, then you can use the new downgrade feature to save out OTIO files with Clip.1 schema.

Example using otioconvert on the commandline:

❯ otioconvert -i tests/sample_data/nested_example.otio -o /var/tmp/v14_compat.otio -A target_schema_versions="{'Clip':1}" && grep "OTIO_SCHEMA.*Clip" /var/tmp/v14_compat.otio
26:                        "OTIO_SCHEMA": "Clip.1",
75:                                "OTIO_SCHEMA": "Clip.1",
105:                        "OTIO_SCHEMA": "Clip.1",
162:                                "OTIO_SCHEMA": "Clip.1",
192:                        "OTIO_SCHEMA": "Clip.1",
249:                                "OTIO_SCHEMA": "Clip.1",
280:                        "OTIO_SCHEMA": "Clip.1",

C++:

#include <iostream>

#include "opentimelineio/timeline.h"

namespace otio = opentimelineio::OPENTIMELINEIO_VERSION;

void
main()
{
    otio::ErrorStatus err;
    otio::SerializableObject::Retainer<otio::Timeline> timeline(
            dynamic_cast<otio::Timeline*>(
                otio::Timeline::from_json_file(
                    "tests/sample_data/nested_example.otio",
                    &err
                )
            )
    );

    otio::schema_version_map downgrade_manifest = {
        {"Clip", 1},
    };
    timeline->to_json_file("/var/tmp/v14_compat.otio", &err, &downgrade_manifest);
}

python:

import opentimelineio as otio

tl = otio.adapters.read_from_file("tests/sample_data/nested_example.otio")
otio.adapters.write_to_file(
    tl,
    "/var/tmp/v14_compat.otio",
    target_schema_versions={"Clip": 1}
)

Big Changes

  • The OpenTimelineIO project was moved over to the ASWF organization, and a number of changes were made as part of the ASWF graduation process in:
  • AAF Adapter:
    • AAF Adapter: support for reading markers by @timlehr in #1019
    • AAF adapter: added support for keyframed properties by @timlehr in #1151
  • Merge spatial_coordinates to main by @rogernelson in #1219
  • Media Multi-Reference Feature by @rogernelson in #1241
  • Schema Downgrading System by @ssteinbach in #1387
  • otiotool command line utility by @jminor in #1375

Breaking Changes

  • Fixes #1188 BREAKING CHANGE: change "effect" argument to Gap constructor to "effects" by @visajshah in #1292
  • Clip.2 schema as noted above

Other Changes

Read more

Beta 14.1 Patch - November 2021

10 Dec 22:44
8cdda64
Compare
Choose a tag to compare
Pre-release

Summary

This release fixes an issue where installation from the sdist (source) package on PyPI would fail. This mostly impacted users with a platform for which we don't provide a prebuilt wheel.

Changes

Beta 14 - October 2021

27 Oct 18:43
4d2f668
Compare
Choose a tag to compare
Pre-release

Summary

This release has a number of features, including many backend features that upgrade the CI, build, and release process. Big thanks especially to @KarthikRIyer, @darbyjohnston and @JeanChristopheMorinPerso for their contributions in this and other areas.

Big Things

Other Changes

Read more

Beta 13 - August 2020

24 Aug 18:04
b104129
Compare
Choose a tag to compare
Beta 13 - August 2020 Pre-release
Pre-release

This release introduces the ImageSequenceReference schema to OTIO. It adds support for media references that point at sets of files on disk, for example, the rendered EXR frames for a shot. This work was contributed by @apetrynet and @reinecke. It includes RV adapter support.

Additionally, we're starting a restructure of some of the core math libraries built around a more consistent mathematical framework. The first of these changes is shifting to predicates based on Allen's Interval Algebra [https://en.wikipedia.org/wiki/Allen%27s_interval_algebra] .

Big things:
- ImageSequenceReference (@apetrynet and @reinecke) main: #602 #722 w/ #783 #751
- Allen Interval Algebra predicates (@KarthikRIyer) #697
- AAF Reader metadata support #739
- Post adapter write hook added (@apetrynet) #730
- RV native plugin (so that you can read OTIO files from inside RV rather than convert via an adapter to .rvsession files) @avrata and @apetrynet #637

Small things:
- Reverse and dissolve fixes, Wipe transition support was added to the CMX EDL adapter #763 #757 #687
- Fixing up some bugs and algorithms in rationalTime.cpp #755 #721 #692 (@reinecke and @KarthikRIyer)
- Tox changed and our setup.cfg was altered to conform with the new standard
- otioview enhancement: double click to see full track name (@KarthikRIyer) #690
- conform.py example now prints support file suffixes (@TheBigSasha) #676
- FCP7 adapter bug fixes #674
- xges adapter markers and effects support (@hwilkes-igalia) #609
- Fix bugs in the kdenlive adapter (@vpinon) #714
- bumped pin of PyAAF2 version to 1.4.0 #738
- bug fixes in Markers #740 and #592 (@elabrosseRodeofx)

Project related things:
- added issue templates to the github repo #768
- cleaned up developer quickstart documentation #717
- documentation was broken on read the docs, this was fixed #715

Point release to fix windows builds (Beta 12.1)

27 Mar 20:43
Compare
Choose a tag to compare

Includes PR #669, which fixes issues in the cmake build system reported on windows machines. As always, please let us know if you see any further issues and alert us! Thanks!

Beta 12 - March 2020

17 Mar 22:04
693ebeb
Compare
Choose a tag to compare
Beta 12 - March 2020 Pre-release
Pre-release

This is the first release with the C++ core. Please test the new build system and make sure it works for your needs. If you run into issues, pin to 0.11.0 (the last pure python release) and let us know so that we can address them.

The adapters remain in python, but the core library and algorithms are implemented in C++. For more information you can see this pr:
#540

Big Changes:

  • C++ Core: the core of opentimelineio is now pybind11-wrapped C++. (see above)
  • otiopluginfo command was added for printing information about plugins visible to otio: #586
  • Kdenlive adapter included in contrib (thanks @vpinon) #618
  • Also includes preliminary swift bindings

Small Changes:

  • Tweaks to the repo in anticipation of the move to being hosted by the Academy Software Foundation
  • hook function arguments are passable to all commandline scripts (@mikekoetter) #651
  • Documention for the C++ core, debugging and building
  • local manifests are loaded so that they override the internal manifests for plugins (@JoshBurnell) #591
  • Lots of upgrades for the AAF adapter (@JoshBurnell)
  • SchemaDefs now have a repr method #566
  • CMX EDL Adapter supports multiple locaters per clip now (@elabrosseRodeofx) #664

Lots of other small fixes and changes. Thank you to all of the community contributors!

Beta 11 - July 2019

22 Jul 20:36
cc78a7c
Compare
Choose a tag to compare
Beta 11 - July 2019 Pre-release
Pre-release

This release is a final checkpoint before we land the C++ branch (cxx) into the master branch. We found there were a number of other small changes that needed to be made before the CXX and Master branches were ready to be merged, so we needed to do one more release before we did that.

Big Changes:

  • The CXX branch is now up to date with master and will be landed shortly after we make this release. (#528)
  • In keeping with the VFX platform, we've dropped support for python 3.5 and added support for python 3.7 in our unit test and CI system. (#526)

Small Changes:

Big thanks go to @andrewmoore-nz and @thecargocultnz for all the very detailed bug reports and repro cases, they are very helpful for improving OTIO robustness!

Beta 10 - April 2019

23 Apr 16:46
2709923
Compare
Choose a tag to compare
Beta 10 - April 2019 Pre-release
Pre-release

OpenTimelineIO Release v0.10

We have a port to C++ that you can preview on the cxx branch which we will soon land into master. There are also some schema changes we'd like to make, which we'll be working on and presenting to the community after we land the C++ port. If you'd like to read about how that will work:
https://opentimelineio.readthedocs.io/en/latest/tutorials/wrapping-otio.html

Breaking Change:

  • In anticipation of the C++ port (see the cxx branch: https://github.com/PixarAnimationStudios/OpenTimelineIO/tree/cxx) a number of changes were made to make the python API behave like the C++ one
    • #372 types in Opentime are now immutable
  • This led to other enhancements that shouldn't be as noticeable to developers:
    • #477 Timeline.global_start_time had a default value of 0, 24 and was not being serialized. Now it defaults to None and is correctly serializead/deserialized
    • #377 JSON serializer adapter arguments tweaked
    • #364 Using weakref to point at parents
    • #400 the __copy__ method has been removed

Big Changes:

New adapters:

Small Changes:

  • arguments for the commandline tools are now more consistent and richer
    • media linker arguments are now passed in
  • #434, #392 upgrades for the EDL adapter (@apetrynet, @mikekoetter)
  • #437 there was a slice membership bug that got fixed
  • #426, #363 For audio-only tracks, the rv adapter will insert a blank movieproc so only sound is loaded from a source (@avrata, @apetrynet)
  • better unicode string support
  • #462 ALE adapter ugprades (@mikekoetter)
  • #403 Fix a bug in the hook/manifest system (@timlehr)

And more! Thanks to everyone for this big release!