Example › Film protocol
The following image shows the original film protocol for the shortfilm "Father and Daughter" in the PDF-format. The contents are not machine-readable and have to be converted to FEI. Additionally, heart rate measurements for the film are added to the FEI body.
View the source code here
The basic structure of the document contains the fei-tag as well as its two children fhead and fbody.
<fei>
<fhead>...</fhead>
<fbody>...</fbody>
</fei>The fhead element contains all metadata for the film such as the used version, production info and a crew list.
<fhead>
<titlestmt>...</titlestmt>
<editionstmt>...</editionstmt>
<prodstmt>...</prodstmt>
<genrestmt>...</genrestmt>
<crewlist>...</crewlist>
</fhead>The titlestmt element provides info about the movie title. It is the parent of one or more title elements that can provide the title and subtitles in multiple languages.
<titlestmt>
<title>Father and Daughter</title>
</titlestmt>The editionstmt element is the container element for version information about the film. It contains one or more edition elements that each provide data like release date or duration as well as the possibility to link a source file.
<editionstmt>
<edition id="current">
<date>April 2001</date>
<duration>00:09:22</duration>
<source>Father and Daughter HD.mp4</source>
</edition>
<edition id="04jpth">
<date>2004</date>
<desc>theatrical</desc>
</edition>
</editionstmt>The prodstmt element provides info about the production of the film. This ranges from companies to individuals. The two child-elements production and distributor can be extended with the more generic proditem element that also provides a role description.
<prodstmt>
<production>
<corpname>CinéTé Filmproductie BV</corpname>
<corpname>Cloudrunner Ltd.</corpname>
<persname>Claire Jennings</persname>
<persname>Willem Thijssen</persname>
</production>
<distributor>
<corpname>Crest International</corpname>
<editionreference target="04jpth"></editionreference>
</distributor>
<proditem>
<proddesc>technical direction</proddesc>
<corpname>Spider Eye Ltd.</corpname>
</proditem>
<proditem>
<proddesc>sound mixing</proddesc>
<corpname>Studio SPR</corpname>
</proditem>
</prodstmt>The genrestmt (Genre statement) is the container for one or more genreitem elements that each provide a genre from the list of available genres.
<genrestmt>
<genreitem>Animation</genreitem>
<genreitem>Short</genreitem>
<genreitem>Drama</genreitem>
</genrestmt>The crewlist (Crew list) links different crew members and their roles to the film. There are one or more crewitem child elements that describe the role and individual.
<crewlist>
<crewitem>
<role>director</role>
<role>writer</role>
<role>animation and backgrounds</role>
<persname>Michael Dudok de Wit</persname>
</crewitem>
<crewitem>
<role>additional animation</role>
<persname>Arjan Wilschut</persname>
</crewitem>
...
<crewitem>
<role>mixing</role>
<corpname>Studio SPR</corpname>
</crewitem>
</crewlist>The data of an FEI-file is stored in the document body, the fbody element. There are several ways data can be stored. At the moment, the fbody covers quantitative data and film protocols with the division in sequence, scene and shot.
The fbody content for this filmprotocol covers both quantitative data (heart rate measurements) and a film protocol:
<fbody>
<quantstmt type="measure" id="measure_up">...</quantstmt>
<quantstmt type="measure" id="measure_down">...</quantstmt>
<shotstmt>...</shotstmt>
</fbody>The quantstmt (Quantitative statement) is the most flexible of data containers in FEI. It contains one or more quantitem elements that represent the single elements of the dataset. The type of data is not specified and can be included in the form of attributes. A description of the dataset via a quantdesc element is also possible.
<quantstmt type="measure" id="measure_up">
<quantdesc>heartrate significant rise</quantdesc>
<quantitem>
<timecode>00:00:00</timecode>
<value>12</value>
</quantitem>
<quantitem>
<timecode>00:00:01</timecode>
<value>9</value>
</quantitem>
...
<quantitem>
<timecode>00:07:55</timecode>
<value>25</value>
</quantitem>
</quantstmt>The film can be hierarchically structured into smaller sections. In FEI, we propose three depth layers: sequences, scenes and shots. For each of these layers a container is provided that can both provide information on its segments and nest smaller layers in its children. Since the film protocol template only uses shots, the shotstmt is the only one used here. For more information about the film structure layers, please visit the documentation.
The smallest section of a film is a shot. It can be defined with in- and out-points. The shot element can contain a description element as well as data about the shot with the use of quantstmt.
<shot id="2">
<summary>Wolke im Himmel</summary>
<timecodestart>00:00:09</timecodestart>
<quantstmt>
<quantitem type="referenceframe">
<timecode>00:00:09</timecode>
<source>img_log/003.jpg</source>
</quantitem>
<quantitem type="camera">HN</quantitem>
<quantitem type="camera">front</quantitem>
<quantitem type="camera">Normalperspektive</quantitem>
<quantitem type="transition">Aufblende</quantitem>
<quantitem type="imagery">Braun</quantitem>
<quantitem type="imagery">Weiß</quantitem>
<quantitem type="audio">Leitmotiv Akkordeon: Intro</quantitem>
</quantstmt>
</shot>This element contains a group of shot elements
<shotstmt>
<shot id="0">
<summary>START</summary>
<timecodestart>00:00:00</timecodestart>
<quantstmt>
<quantitem type="referenceframe">
<timecode>00:00:00</timecode>
<source>img_log/001.jpg</source>
</quantitem>
</quantstmt>
</shot>
<shot id="1">
<summary>Vorspann,Titel</summary>
<timecodestart>00:00:02</timecodestart>
<quantstmt>
<quantitem type="referenceframe">
<timecode>00:00:02</timecode>
<source>img_log/002.jpg</source>
</quantitem>
</quantstmt>
</shot>
...
</shotstmt>