diff options
Diffstat (limited to 'libk3b/k3bimage.xsd')
| -rw-r--r-- | libk3b/k3bimage.xsd | 175 |
1 files changed, 175 insertions, 0 deletions
diff --git a/libk3b/k3bimage.xsd b/libk3b/k3bimage.xsd new file mode 100644 index 0000000..ab7f36c --- /dev/null +++ b/libk3b/k3bimage.xsd @@ -0,0 +1,175 @@ +<!-- + 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>
\ No newline at end of file |