Skip to content

STLXML2EBU-TT

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History
 
 

STLXML2EBU-TT

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
documentation
documentation
 
 
tests
tests
 
 
README.md
README.md
 
 
STLXML2EBU-TT.xslt
STLXML2EBU-TT.xslt
 
 

README.md

STLXML2EBU-TT

The requirements of the STLXML2EBU-TT module are implemented in the SCF by the XSLT 1.0 stylesheet STLXML2EBU-TT.xslt. The XSLT takes as input an STLXML file (an XML representation of a binary EBU STL file). The output is an EBU-TT file that conforms to the EBU-TT Part 1 specification (EBU Tech 3350). The conversion is based on the guideline provided in EBU Tech 3360 (see Resources).

Prerequisites

  • an XSLT 1.0 processor with EXSLT support (e.g. Saxon 6.5.5 or higher, or xsltproc), or
  • an XSLT 2.0 processor

Note that there are XSLT processors that do not support XSLT 2.0. In this case the stylesheet uses equivalent EXSLT functions as fallback. If this fails as well, the transformation terminates with a respective error message.

USAGE

STLXML2EBU-TT.xslt has the following parameters:

- offsetInSeconds
    An integer that defines in seconds the time-offset that's used for the TCP, TCI and TCO elements (default is 0). Thus this offset will be subtracted from the mentioned element's values.

- offsetInFrames
    A SMPTE timecode that defines the time-offset that's used for the TCP, TCI and TCO elements (default is 00:00:00:00). Thus this offset will be subtracted from the mentioned element's values.

- offsetTCP
    If set to 1, the TCP value is used as the time-offset that's used for the TCP, TCI and TCO elements (default is 0). Thus this offset will be subtracted from the mentioned element's values.

- ignoreManualOffsetForTCP
    If set to 1, any manual offset (seconds or frames) will *not* be subtracted from the TCP value.

- timeBase
    Either the value 'smpte' or 'media'. It sets explicitly the ttp:timeBase attribute (default is 'smpte')

DESCRIPTION

The goal of the conversion is to create an EBU-TT-Part 1 file that can be used in archive and exchange based on an STLXML file. The results can therefore be seen as an EBU-TT representation of an EBU STL file.

Amongst others STLXML files with the following characteristics are not supported:

  • the DFC (Disc Format Code) is set to another value then "STL25.01" (25 fps)
  • the TCS of a TTI element is set to 0 (timecode that is not intended for use)
  • the STLXML does not validate against the STLXML XSD

EXAMPLES

If you use the Saxon parser (version 9.5) you could perform a transformation as follows:

java -cp saxon9he.jar net.sf.saxon.Transform -s:testStl.xml -xsl:STLXML2EBU-TT.xslt -o:ebutt-out.xml

or even simpler:

java -jar [dir]/saxon9he.jar -s:testStl.xml -xsl:STLXML2EBU-TT.xslt -o:ebutt-out.xml

where [dir] is the directory of the Saxon jar-file.

RESOURCES