Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

These values should be used when obtaining time code information from a shape:

Shape Element

Format

Meaning

shape.containerComponent.startTimecode

integer number

The start time code of the shape as an integer. The unit is denoted by shape.containerComponent.timeCodeTimeBase

shape.containerComponent.timeCodeTimeBase

length of a unit in seconds, denoted as fraction (numerator=1 and denominator=25 means: each unit is 1/25s long, i.e. 25 fps)

The unit for the number in shape.containerComponent.startTimecode

shape.containerComponent.roundeTimeBase

integer number

The unit from shape.containerComponent.startTimecode as a rounded integer.

shape.containerComponent.duration

sample count (integer) + time base (length of one unit fraction)

The duration of the video

Do not use the values from the <metadata> key-value information. These are specific to the container format - whereas to values in the table above are uniform across different container formats.

...

Some metadata of the original shape are transferred to system-defined metadata fields on item level:

Metadata Field

Format

Meaning

startTimeCode

VidiCore time code

The start time code of the video - corresponds to the start time code of the original shape.

startSeconds

integer number

The start time code of the video expressed as seconds (rounded).

durationTimeCode

VidiCore time code

The duration of the video as time code - corresponds to the duration element of the original shape.

durationSeconds

integer number

The duration of the video expressed as seconds (rounded).

These metadata fields on item level are automatically populated by VidiCore when the original shape is created and cannot be modified via VidiCore’s API.

...

Therefore, it’s better to not rely on the start time code stored in the proxy file - and thus ignore the start time code on the proxy shape.

...

Expand
titleDraw.io diagram view with the standard Confluence view.
Drawio
zoom1
simple0
inComment0
pageId1850761721
custContentId1854373925
lbox1
diagramDisplayNameProxy Start Timecode
contentVer2
revision2
baseUrlhttps://vidispine.atlassian.net/wiki
diagramNameProxy Start Timecode
pCenter0
width1015.0660722881737
links
tbstyle
height633.5

Time Codes For Camera Material

Camera material originating from professional cameras like Sony XDCAM or Panasonic P2 need special consideration as each clip on the camera usually has it distinct start time code. Please refer to Original Timecodes [INT ENT XY21.Z 3 ARC] for more details.