You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
175 lines
6.8 KiB
175 lines
6.8 KiB
<!--
|
|
This document describes the layout of the toc.xml file in a K3b image archive.
|
|
A K3b image archive is a TAR archive with a simple layout as follows.
|
|
|
|
Every K3b image archive contains the toc.xml file as described in this document
|
|
which describes the layout of the CD or DVD saved in the K3b image archive.
|
|
Additionally the K3b image archive contains an arbitrary number of files which
|
|
contain the CD/DVD sector data. These files are referenced in the elements of
|
|
type "file".
|
|
|
|
The most simple K3b image archive may look as follows:
|
|
Archive
|
|
|- toc.xml
|
|
|- image.iso
|
|
and the toc.xml may look as follows:
|
|
<image>
|
|
<numsessions>1</numsessions>
|
|
<numtracks>1</numtracks>
|
|
<session number="1">
|
|
<numtracks>1</numtracks>
|
|
<track number="1" type="Data Mode1">
|
|
<data sectorsize="2048">
|
|
<file>image.iso</file>
|
|
</data>
|
|
</track>
|
|
</session>
|
|
</image>
|
|
|
|
|
|
We used tar as a backend because K3b image archives tend to get really big when it
|
|
comes to DVD images and ZIP does not support archives bigger than 2 GB.
|
|
Although tar supports files bigger than 2 GB (inside the archive) K3b splits every
|
|
track bigger than 1 GB into chunks of 1 GB to avoid any problems with big filesizes.
|
|
-->
|
|
|
|
|
|
<!-- FIXME: introduce a version field! -->
|
|
|
|
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
|
|
targetNamespace="http://www.k3b.org"
|
|
xmlns="http://www.k3b.org"
|
|
elementFormDefault="qualified">
|
|
|
|
<!-- THE TYPES -->
|
|
<xs:simpleType name="tracktype">
|
|
<xs:restriction base="xs:string">
|
|
<xs:enumeration value="Audio" />
|
|
<xs:enumeration value="Data Mode1" />
|
|
<xs:enumeration value="Data Mode2" />
|
|
<xs:enumeration value="Data XA Form1" />
|
|
<xs:enumeration value="Data XA Form2" />
|
|
</xs:restriction>
|
|
</xs:simpleType>
|
|
|
|
<xs:simpleType name="sector_size">
|
|
<xs:restriction base="xs:integer">
|
|
<xs:enumeration value="2048" /> <!-- Mode1/Mode2 Form1/DVD: plain user data -->
|
|
<xs:enumeration value="2056" /> <!-- Mode2 Form1: 2048 bytes user data + 8 bytes sub header FIXME: or does this include 4 bytes crc? -->
|
|
<xs:enumeration value="2324" /> <!-- Mode2 Form2: plain user data -->
|
|
<xs:enumeration value="2332" /> <!-- Mode2 Form2: 2324 bytes user data + 8 bytes sub header FIXME: or does this include 4 bytes crc? -->
|
|
<xs:enumeration value="2352" /> <!-- Audio: 16bit, stereo, 44100Hz, big endian -->
|
|
<xs:enumeration value="2448" /> <!-- Raw data -->
|
|
</xs:restriction>
|
|
</xs:simpleType>
|
|
|
|
<xs:complexType name="filecontents">
|
|
<xs:simpleContent>
|
|
<!-- Filename in the image archive. -->
|
|
<xs:extension base="xs:string">
|
|
<!-- The start_sector allows for multiple tracks including the CD-TEXT to be defined in one file. Default: 0 -->
|
|
<xs:attribute name="start_offset" type="xs:nonNegativeInteger" use="optional" />
|
|
|
|
<!-- The number of bytes to be used. Default: up to end of the file -->
|
|
<xs:attribute name="length" type="xs:positiveInteger" use="optional" />
|
|
</xs:extension>
|
|
</xs:simpleContent>
|
|
</xs:complexType>
|
|
|
|
<xs:simpleType name="catalogname">
|
|
<xs:restriction base="xs:string">
|
|
<xs:pattern value="[0-9]{13}" />
|
|
</xs:restriction>
|
|
</xs:simpleType>
|
|
|
|
<xs:simpleType name="isrcname">
|
|
<xs:restriction base="xs:string">
|
|
<xs:pattern value="[A-Z0-9]{5}[0-9]{7}" />
|
|
</xs:restriction>
|
|
</xs:simpleType>
|
|
|
|
|
|
|
|
<!-- THE IMAGE DEFINITION -->
|
|
|
|
<xs:element name="image">
|
|
<xs:complexType>
|
|
<xs:sequence>
|
|
<!-- Number of session for convinience -->
|
|
<xs:element name="numsessions" type="xs:positiveInteger" />
|
|
|
|
<!-- Number of tracks for convinience -->
|
|
<xs:element name="numtracks" type="xs:positiveInteger" />
|
|
|
|
<!-- CD-TEXT is always stored in binary form -->
|
|
<xs:element name="cdtext" type="filecontents" minOccurs="0" />
|
|
|
|
<!-- The optional catalog name. -->
|
|
<xs:element name="catalog" type="catalogname" minOccurs="0" />
|
|
|
|
<!-- The tracks are splitted into sessions. In most cases there will only be one session. -->
|
|
<xs:element name="session" maxOccurs="99"> <!-- FIXME: what is the real max here? -->
|
|
<xs:complexType>
|
|
<xs:sequence>
|
|
<!-- Number of tracks in this session for convinience -->
|
|
<xs:element name="numtracks" type="xs:positiveInteger" />
|
|
|
|
<!-- And here come the tracks. -->
|
|
<xs:element name="track" maxOccurs="99">
|
|
<xs:complexType>
|
|
<xs:sequence>
|
|
<!-- The data tag contains file elements specifying where to find the data for the track.
|
|
The data may span over multiple files but all need to have the same sector size. -->
|
|
<xs:element name="data" minOccurs="1" maxOccurs="1">
|
|
<xs:complexType>
|
|
<xs:sequence>
|
|
<xs:element name="file" type="filecontents" />
|
|
</xs:sequence>
|
|
<xs:attribute name="sectorsize" type="sector_size" />
|
|
</xs:complexType>
|
|
</xs:element>
|
|
|
|
<!-- The index tag contains the start sector of the index relative to the start of the track. -->
|
|
<xs:element name="index" minOccurs="0" maxOccurs="100">
|
|
<xs:complexType>
|
|
<xs:simpleContent>
|
|
<xs:extension base="xs:nonNegativeInteger">
|
|
<xs:attribute name="number" type="xs:nonNegativeInteger" />
|
|
</xs:extension>
|
|
</xs:simpleContent>
|
|
</xs:complexType>
|
|
</xs:element>
|
|
|
|
<!-- Pre emphasis. -->
|
|
<xs:element name="preemp" type="xs:boolean" minOccurs="0" default="false" />
|
|
|
|
<!-- Copy permitted. -->
|
|
<xs:element name="copy" type="xs:boolean" minOccurs="0" default="true" />
|
|
|
|
<!-- SCMS enabled (alternating copy control bit). Only useful in combination with
|
|
copy=true. -->
|
|
<xs:element name="scms" type="xs:boolean" minOccurs="0" default="false" />
|
|
|
|
<xs:element name="isrc" type="isrcname" minOccurs="0" />
|
|
</xs:sequence>
|
|
|
|
<!-- The track number for convinience. -->
|
|
<xs:attribute name="number" type="xs:positiveInteger" />
|
|
|
|
<!-- Type of the track as defined above. -->
|
|
<xs:attribute name="type" type="tracktype" />
|
|
</xs:complexType>
|
|
</xs:element>
|
|
</xs:sequence>
|
|
|
|
<!-- The session number for convinience. There is one special case in which the first session's number may be
|
|
bigger than 1. It is used internally by K3b to indicate that the image contains a session to be appended
|
|
to a multisession CD or DVD. It cannot be used in another situation since the data does only fit for the
|
|
multisession CD or DVD it was created for. -->
|
|
<xs:attribute name="number" type="xs:positiveInteger" />
|
|
</xs:complexType>
|
|
</xs:element>
|
|
</xs:sequence>
|
|
</xs:complexType>
|
|
</xs:element>
|
|
</xs:schema> |