mirror of
https://github.com/aaru-dps/libaaruformat.git
synced 2025-12-16 19:24:40 +00:00
82 lines
2.7 KiB
Plaintext
82 lines
2.7 KiB
Plaintext
=== Tracks Block (`TRKS`)
|
||
|
||
The tracks block holds a structured list of track entries, typically aligned with the layout specified in the table of contents or a similar indexing schema.
|
||
This format is common in optical media such as CDs, DVDs, and related disc-based formats.
|
||
|
||
==== Structure Definition
|
||
|
||
[source,c]
|
||
#define TRACKS_MAGIC 0x534B5254
|
||
/**Contains list of optical disc tracks */
|
||
typedef struct TracksHeader
|
||
{
|
||
/**Identifier, <see cref="BlockType.TracksBlock" /> */
|
||
uint32_t identifier;
|
||
/**How many entries follow this header */
|
||
uint16_t entries;
|
||
/**CRC64-ECMA of the block */
|
||
uint64_t crc64;
|
||
} TracksHeader;
|
||
|
||
==== Field Descriptions
|
||
|
||
[cols="2,2,2,6",options="header"]
|
||
|===
|
||
|Type|Size|Name|Description
|
||
|uint32_t|4 bytes|identifier|The tracks block identifier, always `TRKS`
|
||
|uint16_t|2 bytes|entries|The number of entries following this header
|
||
|uint64_t|8 bytes|crc64|CRC64-ECMA checksum of the entries following this header
|
||
|===
|
||
|
||
==== Track entries
|
||
|
||
[source,c]
|
||
/**Optical disc track */
|
||
typedef struct TrackEntry
|
||
{
|
||
/**Track sequence */
|
||
uint8_t sequence;
|
||
/**Track type */
|
||
uint8_t type;
|
||
/**Track starting LBA */
|
||
int64_t start;
|
||
/**Track last LBA */
|
||
int64_t end;
|
||
/**Track pregap in sectors */
|
||
int64_t pregap;
|
||
/**Track session */
|
||
uint8_t session;
|
||
/**Track's ISRC in ASCII */
|
||
uint8_t isrc[13];
|
||
/**Track flags */
|
||
uint8_t flags;
|
||
} TrackEntry;
|
||
|
||
==== Field Descriptions
|
||
|
||
[cols="2,2,2,6",options="header"]
|
||
|===
|
||
|Type|Size|Name|Description
|
||
|uint8|1 byte|sequence|Track number.
|
||
|uint8|1 byte|type|Track type (see table below).
|
||
|int64|8 bytes|start|Track starting LBA (including pregap).
|
||
|int64|8 bytes|end|Track ending LBA.
|
||
|int64|8 bytes|pregap|Size of track’s pregap in sectors.
|
||
|uint8|1 byte|session|Session the track belongs to.
|
||
|StringA|13 bytes|isrc|Track’s ISRC in ASCIIZ.
|
||
|uint8|1 byte|flags|Track flags as indicated in TOC if applicable.
|
||
|===
|
||
|
||
==== Track Types
|
||
|
||
[cols="2,1,8",options="header"]
|
||
|===
|
||
|Type|Value|Description
|
||
|Audio|0|All sectors in the track contain audio as defined by the Red Book.
|
||
|Data|1|All sectors in the track contain user data that is not defined by any of the following types.
|
||
|CdMode1|2|All sectors in the track contain user data according to MODE 1 as defined by the Yellow Book.
|
||
|CdMode2Formless|3|All sectors in the track contain user data according to MODE 2 as defined by the Yellow and Green Books. Not all sectors belong to the same Form.
|
||
|CdMode2Form1|4|All sectors in the track contain user data according to MODE 2 Form 1 as defined by the Yellow and Green Books. All sectors belong to the same Form.
|
||
|CdMode2Form2|5|All sectors in the track contain user data according to MODE 2 Form 2 as defined by the Yellow and Green Books. All sectors belong to the same Form.
|
||
|===
|