Skip to content

PlayerClosedCaptionsFile

property

Delphi
property PlayerClosedCaptionsFile: string read GetPlayerClosedCaptionsFile write SetPlayerClosedCaptionsFile; /// 261106st
C++Builder
__property System::UnicodeString PlayerClosedCaptionsFile = {read=GetPlayerClosedCaptionsFile, write=SetPlayerClosedCaptionsFile};
C#
public string PlayerClosedCaptionsFile { get; set; }
VB.NET
Public Property PlayerClosedCaptionsFile As String
C++/Qt
wchar_t *GetPlayerClosedCaptionsFile ();
void SetPlayerClosedCaptionsFile (wchar_t *Value);

Subtitle file of the closed captions of the clips (ClosedCaptionsEnabled): a file, a folder, "" (next to the clip) or "NONE".

Remarks

Used when ClosedCaptionsEnabled is true. The captions of the subtitle file replace the captions of the clip.

"" (default): subtitle file with the name of the clip, in the folder of the clip (local clips): .srt, then .srt (e.g. clip.mxf.srt), and so on for the other extensions.

A folder: these names are searched in this folder first, then in the folder of the clip. Convenient with a playlist: one folder for the subtitle files of all the clips.

A file: this file is used for the clips opened next, until PlayerClosedCaptionsFile is changed.

"NONE": no subtitle file, only the captions of the clip.

Extensions searched, in this order: srt, vtt, scc, mcc, ttml, dfxp, stl, xml. The format is detected from the content: SRT, WebVTT, SCC (Scenarist), MCC (MacCaption), TTML (DFXP, SMPTE-TT, EBU-TT, EBU-TT-D, IMSC1 text profile), EBU STL (Latin character table). Text files: UTF-8, UTF-16 or ANSI (Windows-1252).

The text formats are converted to CEA-608 (CC1, pop-on) and CTA-708 (service 1) captions: 32 columns and 4 rows at most, centred at the bottom of the picture, italics kept. SCC and MCC files are sent as is. The times of the file start at the beginning of the clip; a file based on the time code of the clip (e.g. 10:00:00:00) is shifted automatically.

CEA-608 bandwidth: a caption needs about 1 to 2 seconds of transmission before it is displayed; a caption that starts less than this delay after the previous one is displayed late in CEA-608 (on time in CTA-708).

Takes effect at the next OpenPlayer.