Beta 15 - September 22

[ssteinbach]

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 Compatability

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:
  • Technical Steering Committee Charter, GOVERNANCE, etc. by @jminor in Technical Steering Committee Charter, GOVERNANCE, etc. #1057
  • Prep for ASWF transfer by @jminor in Prep for ASWF transfer #932
  • More ASWF transition prep by @jminor in More ASWF transition prep #1167
  • Replaced @Pixar email addresses with @aswf email addresses. by @jminor in Replaced @pixar email addresses with @aswf email addresses. #1170
  • OpenTimelineIO License & CLA Change by @jminor in OpenTimelineIO License & CLA Change #1285
  • Updated verify_license.py to support more languages by @jminor in Updated verify_license.py to support more languages #1288
  • Update links in readme to point to new ASWF url by @ssteinbach in Update links in readme to point to new ASWF url #1302
  • Updated URLs to new AcademySofwareFoundation GitHub org. by @jminor in Updated URLs to new AcademySofwareFoundation GitHub org. #1303
• AAF Adapter:
  • AAF Adapter: support for reading markers by @timlehr in AAF Adapter: support for reading markers #1019
  • AAF adapter: added support for keyframed properties by @timlehr in AAF adapter: added support for keyframed properties #1151
• Merge spatial_coordinates to main by @rogernelson in Merge spatial_coordinates to main #1219
• Media Multi-Reference Feature by @rogernelson in Media Multi-Reference Feature #1241
• Schema Downgrading System by @ssteinbach in Schema Downgrading System #1387
• otiotool command line utility by @jminor in otiotool command line utility #1375

Breaking Changes

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

Other Changes

• R0.15.set dev version by @ssteinbach in R0.15.set dev version #1128
• CI: switch platform versions back to -latest by @ssteinbach in CI: switch platform versions back to -latest #1129
• Fix RV plugin test timing by @rogernelson in Fix RV plugin test timing #1147
• Fix RV plugin test for Mac by @rogernelson in Fix RV plugin test for Mac #1149
• Update sdist to include submodules by @JeanChristopheMorinPerso in Update sdist to include submodules #1152
• Improve the developer quickstart documentation by @JeanChristopheMorinPerso in Improve the developer quickstart documentation #1144
• Use platform specific command to find path by @ThomasWilshaw in Use platform specific command to find path #1143
• Fix code coverage report uploads by @JeanChristopheMorinPerso in Fix code coverage report uploads #1189
• Add nearest_valid_timecode_rate function by @splidje in Add nearest_valid_timecode_rate function #1181
• Replace deprecated Pybind11 get_type() usages by py::type::of() by @JeanChristopheMorinPerso in Replace deprecated Pybind11 get_type() usages by py::type::of() #1194
• SVG adapter fixes by @KarthikRIyer in SVG adapter fixes #1195
• Remove extra useless parameter from RationalTime.copy method by @JeanChristopheMorinPerso in Remove extra useless parameter from RationalTime.__copy__ method #1198
• Update AAF Documentation Link by @camkerr in Update AAF Documentation Link #1202
• Add enabled flag to Item by @ThomasWilshaw in Add enabled flag to Item #1175
• Add missing memo keyword argument to TimeTransform.deepcopy method by @JeanChristopheMorinPerso in Add missing memo keyword argument to TimeTransform.__deepcopy__ method #1203
• Kdenlive adapter: process recent project format by @vpinon in Kdenlive adapter: process recent project format #1191
• On macOS build universal arm64 and x86_64 by @jminor in On macOS build universal arm64 and x86_64 #1214
• Port to PySide6 by @darbyjohnston in Port to PySide6 #1221
• C++ tests by @darbyjohnston in C++ tests #1161
• Don't skip asserts in unit test release builds by @rogernelson in Don't skip asserts in unit test release builds #1236
• Keep markers at the track if child_at_time() found something that does not hold markers by @jchen9 in Keep markers at the track if child_at_time() found something that does not hold markers #1239
• otioview track and window fit improvements by @michdolan in otioview track and window fit improvements #1237
• Install full OTIO Python env with CMake by @michdolan in Install full OTIO Python env with CMake #1238
• clang notices that constexpr can't be used on a mutating function by @meshula in clang notices that constexpr can't be used on a mutating function #1242
• AAF Adapter: Mob transcription heuristics by @jchen9 in AAF Adapter: Mob transcription heuristics #1249
• Add ALE adapter argument ale_name_column_key by @jchen9 in Add ALE adapter argument ale_name_column_key #1248
• Support OTIO_PLUGIN_MANIFEST_PATH being set to an empty string by @avrata in Support OTIO_PLUGIN_MANIFEST_PATH being set to an empty string #1253
• Fix missing init metadata by @JeanChristopheMorinPerso in Fix missing init metadata #1251
• Add Python 3.10 to CI by @JeanChristopheMorinPerso in Add Python 3.10 to CI #1256
• Fix each_clip no longer exists on Clip #1257 missing each_clip on Clip by @meshula in Fix #1257 missing each_clip on Clip #1258
• Detect & use Imath from vfxplatform CY2019-2022 by @meshula in Detect & use Imath from vfxplatform CY2019-2022 #1255
• Adapt changes between PySide2 and PySide6 by @jchen9 in Adapt changes between PySide2 and PySide6 #1262
• Copy core sample data used by contrib tests into the contrib area to better isolate contrib tests by @avrata in Copy core sample data used by contrib tests into the contrib area to better isolate contrib tests #1266
• Add a test case and fix for transcribing markers over a single audio AAF file by @jchen9 in Add a test case and fix for transcribing markers over a single audio AAF file #1259
• Support python 3 in the "rv_session" adapter. by @avrata in Support python 3 in the "rv_session" adapter. #1267
• Change angle include Imath to quote include, remove multiMediaReference prototype by @meshula in Change angle include Imath to quote include, remove multiMediaReference prototype #1276
• Update test_v2d to support multiple exception types by @avrata in Update test_v2d to support multiple exception types #1279
• Fix for external Imath, must set USE_DEPS_IMATH OFF by @meshula in Fix for external Imath, must set USE_DEPS_IMATH OFF #1273
• AAF Clip Enabled/Muting Update by @andrewmoore-nz in AAF Clip Enabled/Muting Update #1277
• fix FCP XML outputs not recognised by Resolve 17 #839 - FCP XML outputs not recognized by Resolve by @pedrolabonia in fix #839 - FCP XML outputs not recognized by Resolve #1287
• Removed a vestigial "Foo" schema by @reinecke in Removed a vestigial "Foo" schema #1306
• CII Best Practices badge by @jminor in CII Best Practices badge #1304
• Update Pybind11 to 2.9.2 by @JeanChristopheMorinPerso in Update Pybind11 to 2.9.2 #1312
• Use py::module_local() for Imath bindings by @JeanChristopheMorinPerso in Use py::module_local() for Imath bindings #1323
• Update feature matrix to mention that the AAF adapter now supports markers by @JeanChristopheMorinPerso in Update feature matrix to mention that the AAF adapter now supports markers #1309
• Python bindings: raise proper exceptions for IO operations by @JeanChristopheMorinPerso in Python bindings: raise proper exceptions for IO operations #1313
• Improve Python reference documentation by @JeanChristopheMorinPerso in Improve Python reference documentation #1209
• Use marker colors in otioview by @markreidvfx in Use marker colors in otioview #1340
• Prevent divide by zero and print warning if width is zero by @markreidvfx in Prevent divide by zero and print warning if width is zero #1346
• Cancel in-progress CI jobs for the same branch by @JeanChristopheMorinPerso in Cancel in-progress CI jobs for the same branch #1329
• Fix setuptools deprecation warnings by @JeanChristopheMorinPerso in Fix setuptools deprecation warnings #1317
• Revisited how transitions are handled by the cmx 3600 adapter. by @gplsteph in Revisited how transitions are handled by the cmx 3600 adapter. #1341
• Add unit tests in preparation for moving the aaf adapter by @markreidvfx in Add unit tests in preparation for moving the aaf adapter #1353
• Added SVG and PDF vector logos. by @jminor in Added SVG and PDF vector logos. #1360
• Fix lint issues by @JeanChristopheMorinPerso in Fix lint issues #1370
• Close Temporary file handles in tests by @markreidvfx in Close Temporary file handles in tests #1363
• Python3 fixes for the shot_detect example by @ssteinbach in Python3 fixes for the shot_detect example #1374
• Added documentation explaining contrib and outlining process around it by @reinecke in Added documentation explaining contrib and outlining process around it #1378
• Fixes and improvements for Kdenlive adapter by @jlskuz in Fixes and improvements for Kdenlive adapter #1390
• Load entrypoint plugins before builtin and contrib. by @markreidvfx in Load entrypoint plugins before builtin and contrib. #1389
• Update pyaaf2 requirement from ~=1.4.0 to >=1.4,<1.7 by @dependabot in Update pyaaf2 requirement from ~=1.4.0 to >=1.4,<1.7 #1355
• Fix parsing of time_strings lacking leading zeroes by @meshula in Fix parsing of time_strings lacking leading zeroes #1297
• Add basic mingw_x86_64 build support by @markreidvfx in Add basic mingw_x86_64 build support #1354
• Import _opentime before actually creating the bindings for _otio by @JeanChristopheMorinPerso in Import _opentime before actually creating the bindings for _otio #1396
• Fix for SerializableCollection::children_if by @darbyjohnston in Fix for SerializableCollection::children_if #1404
• Added OTIO_CORE 0.14.0 version_manifest. by @jminor in Added OTIO_CORE 0.14.0 version_manifest. #1415
• Fix compiler warnings on Windows by @darbyjohnston in Fix compiler warnings on Windows #1414
• Fix a few typos and cosmetics inconsistencies by @markreidvfx in Fix a few typos and cosmetics inconsistencies #1416
• Release v0.15.0 changes by @ssteinbach in Release v0.15.0 changes #1403

Dependency Version Bumps

• Bump src/deps/pybind11 from 7c58058 to e7e2c79 by @dependabot in Bump src/deps/pybind11 from 7c58058 to e7e2c79 #1125
• Bump src/deps/optional-lite from 52f2b61 to 36c5b87 by @dependabot in Bump src/deps/optional-lite from 52f2b61 to 36c5b87 #1097
• Bump src/deps/optional-lite from 36c5b87 to a006f22 by @dependabot in Bump src/deps/optional-lite from 36c5b87 to a006f22 #1137
• Bump src/deps/optional-lite from a006f22 to ea502a6 by @dependabot in Bump src/deps/optional-lite from a006f22 to ea502a6 #1319
• Bump src/deps/optional-lite from ea502a6 to 5e4b776 by @dependabot in Bump src/deps/optional-lite from ea502a6 to 5e4b776 #1383
• Bump src/deps/rapidjson from 00dbcf2 to 4d6cb08 by @dependabot in Bump src/deps/rapidjson from 00dbcf2 to 4d6cb08 #1105
• Bump src/deps/rapidjson from 4d6cb08 to e4bde97 by @dependabot in Bump src/deps/rapidjson from 4d6cb08 to e4bde97 #1217
• Bump src/deps/rapidjson from e4bde97 to 8261c1d by @dependabot in Bump src/deps/rapidjson from e4bde97 to 8261c1d #1240
• Bump src/deps/rapidjson from 8261c1d to 27c3a8d by @dependabot in Bump src/deps/rapidjson from 8261c1d to 27c3a8d #1358
• Bump src/deps/rapidjson from 27c3a8d to 06d58b9 by @dependabot in Bump src/deps/rapidjson from 27c3a8d to 06d58b9 #1388
• Bump actions/checkout from 2.3.4 to 2.3.5 by @dependabot in Bump actions/checkout from 2.3.4 to 2.3.5 #1107
• Bump actions/checkout from 2.3.5 to 3 by @dependabot in Bump actions/checkout from 2.3.5 to 3 #1227
• Bump src/deps/Imath from 8b3363a to bd6f74c by @dependabot in Bump src/deps/Imath from 8b3363a to bd6f74c #1222
• Bump src/deps/Imath from bd6f74c to bd254da by @dependabot in Bump src/deps/Imath from bd6f74c to bd254da #1245
• Bump src/deps/Imath from bd254da to 3ffb078 by @dependabot in Bump src/deps/Imath from bd254da to 3ffb078 #1291
• Bump src/deps/Imath from 3ffb078 to 3ad5d4d by @dependabot in Bump src/deps/Imath from 3ffb078 to 3ad5d4d #1324
• Bump actions/setup-python from 2.2.2 to 3 by @dependabot in Bump actions/setup-python from 2.2.2 to 3 #1226
• Bump src/deps/any from f67bd5f to bfc77f2 by @dependabot in Bump src/deps/any from f67bd5f to bfc77f2 #1357
• Bump readthedocs-sphinx-ext from 2.1.5 to 2.1.9 by @dependabot in Bump readthedocs-sphinx-ext from 2.1.5 to 2.1.9 #1397

New Contributors

• @ThomasWilshaw made their first contribution in Use platform specific command to find path #1143
• @camkerr made their first contribution in Update AAF Documentation Link #1202
• @michdolan made their first contribution in otioview track and window fit improvements #1237
• @andrewmoore-nz made their first contribution in AAF Clip Enabled/Muting Update #1277
• @pedrolabonia made their first contribution in fix #839 - FCP XML outputs not recognized by Resolve #1287
• @visajshah made their first contribution in Fixes #1188 BREAKING CHANGE: change "effect" argument to Gap constructor to "effects" #1292
• @markreidvfx made their first contribution in Use marker colors in otioview #1340
• @gplsteph made their first contribution in Revisited how transitions are handled by the cmx 3600 adapter. #1341
• @jlskuz made their first contribution in Fixes and improvements for Kdenlive adapter #1390

Full Changelog: v0.14...v0.15

---

This discussion was created from the release Beta 15 - September 22.