AcademySoftwareFoundation / AcademySoftwareFoundation/OpenTimelineIO

Add Sequence/Project Settings to Timeline

Open
#1,683 2 comments 1 reaction 0 assignees View on GitHub
Dominant language
C++
Stars
2k
Forks
351
Avg merge
1d 12h
Merged PRs (30d)
1

Description

## Feature Request

It would be helpful to have a set of Sequence/Project settings on a timeline that includes useful information when rendering a sequence.
This could include:

- Video Resolution
- Pixel Aspect Ratio
- Pixel Format
- Video Frame Rate
- Audio Sample Rate
- Audio Sample Format
- Audio output channels (Perhaps this is added when #145 is addressed)
- Color Space (Perhaps this is added with #1805)

We should avoid things that don't materially impact how the timeline is evaluated (e.g. output codecs) - those would generally be determined by the context of the application doing the render. Making the proper judgement call on these will be an ongoing challenge.

Technical characteristics should be grouped into sub-schema by media type - there may be some reason to re-use these.

## Context

Suggested by @darbyjohnston in #1679

In that issue, @darbyjohnston [comments](https://github.com/AcademySoftwareFoundation/OpenTimelineIO/pull/1679#issuecomment-1845816344) on the challenge for application developers when we don't include this information:

> Currently in tlRender I make a guess at the settings by using the video and audio from the first clip in the timeline. This works mostly OK but fails in some situations and also requires opening the media.

## References

- [Final Cut Pro 10 Project Settings](https://support.apple.com/guide/final-cut-pro/final-cut-pro-project-settings-ver1b946a4ff/10.7/mac/13.5)
- [DaVinci Resolve Timeline Settings](https://documents.blackmagicdesign.com/UserManuals/DaVinci_Resolve_18_Reference_Manual.pdf#page=644)
- [Adobe Premiere Sequence Settings](https://helpx.adobe.com/premiere-pro/using/change-sequence-settings.html)

Contributor guide

Open the contributing guide

Research direction

Review the discussion in #1679 and the listed Final Cut Pro, DaVinci Resolve, and Adobe Premiere references to define which sequence settings belong in the schema. Done means agreeing on the settings, media-type sub-schema structure, and treatment of optional items before implementation begins.

Written by the indexing model from the issue text.

Assessment

Domain
data
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.