rinri
/
cuetools-jp
1
0
Fork 0
Code Issues 0 Pull Requests 0 Releases 0 Wiki Activity
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.
269 Commits
1 Branch
296 KiB
 
 
 
 
 
 
Branch: master
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'master'
${ noResults }
cuetools-jp/doc/formats.txt

588 lines
10 KiB
Raw Permalink Blame History 

  1. ===========================================================

  2. Description of the Cue Sheet/Table of Contents File Formats

  3. ===========================================================

  4. 

  5. :Author: Svend Sorensen

  6. :Contact: svend@ciffer.net

  7. :Date: $LastChangedDate$

  8. 

  9. .. contents::

  10. 

  11. The Cue Sheet (cue) and Table of Contents (toc) file formats both describe the

  12. layout of a CD.

  13. 

  14. Notes

  15. =====

  16. 

  17. A cue or toc file has an (optional) global section, followed by any number of

  18. track sections.

  19. 

  20. Lines (with a few exceptions for the toc format) begin with a keyword, which

  21. may be followed by whitespace separated fields.  Some keywords are only allowed

  22. in the global section or a track section.

  23. 

  24. Format Notation

  25. ---------------

  26. 

  27. A string may be enclosed in single or double quotation marks.  If the string

  28. contains whitespace, it must be enclosed in quotation marks.

  29. 

  30. ``<field>``

  31. 	a required field

  32. ``[field]``

  33. 	an optional field

  34. ``...``

  35. 	preceding field may be repeated any number of times

  36. 

  37. Cue Sheet Format

  38. ================

  39. 

  40. The standard file suffix for a cue file is ``.cue``.

  41. 

  42. Keywords

  43. --------

  44. 

  45. CATALOG

  46. ~~~~~~~

  47. 

  48. :Description: Sets the media catalog number of the CD.

  49. :Section(s): global

  50. :Format:

  51. 	``CATALOG <catalog_number>``

  52. 

  53. 	``catalog_number``

  54. 		an integer consisting of exactly 13 digits.

  55. 

  56. CDTEXTFILE

  57. ~~~~~~~~~~

  58. 

  59. :Description: Sets an external file for CD-TEXT data.

  60. :Section(s): global

  61. :Format:

  62. 	``CDTEXTFILE <filename>``

  63. 

  64. 	``filename``

  65. 		a string.

  66. 

  67. The CD-TEXT file contains encoded CD-TEXT data.  The standard extension for

  68. CD-TEXT files is ``.cdt``.  *TODO: describe CD-TEXT file format*

  69. 

  70. FILE

  71. ~~~~

  72. 

  73. :Description: Sets a new input file.

  74. :Section(s): track

  75. :Format:

  76. 	``FILE <filename> [file_format]``

  77. 

  78. 	``filename``

  79. 		a string.

  80. 	``file_format``

  81. 		one of: ``BINARY``, ``MOTOROLA``, ``AIFF``, ``WAVE``, or

  82. 		``MP3`` [#]_.

  83. 

  84. ``FILE`` line precedes the beginning of the track section.

  85. 

  86. .. [#] ``file_fomat`` differs between software packages.  The cdrtools_

  87.        ``cue.c`` file also has ``file_format`` entries for ``AU`` and ``OGG``.

  88. 

  89. FLAGS

  90. ~~~~~

  91. 

  92. :Description: Sets track flags.

  93. :Section(s): track

  94. :Format:

  95. 	``FLAGS [flag]...``

  96. 

  97. 	``flag``

  98. 		one of: ``PRE``, ``DCP``, ``4CH``, or ``SCMS``.

  99. 

  100. INDEX

  101. ~~~~~

  102. 

  103. :Description: Sets a track index.

  104. :Section(s): track

  105. :Format:

  106. 	``INDEX <index_number> <index>``

  107. 

  108. 	``index_number``

  109. 		an integer in the range 0-99.

  110. 	``index``

  111. 		time in MSF format.

  112. 

  113. Having an ``INDEX 00`` and an ``INDEX 01`` defines a pregap using data from the

  114. ``FILE``.

  115. 

  116. ISRC

  117. ~~~~

  118. 

  119. :Description: Sets track ISRC number.

  120. :Section(s): track

  121. :Format:

  122. 	``ISRC <ISRC_number>``

  123. 

  124. 	``ISRC_number``

  125. 		a string with the format CCOOOOYYSSSSS.

  126. 

  127. POSTGAP

  128. ~~~~~~~

  129. 

  130. :Description: Sets track postgap.

  131. :Section(s): track

  132. :Format:

  133. 	``POSTGAP <postgap>``

  134. 

  135. 	``postgap``

  136. 		time in MSF format.

  137. 

  138. Postgap is filled with generated silence.

  139. 

  140. PREGAP

  141. ~~~~~~

  142. 

  143. :Description: Sets track pregap.

  144. :Section(s): track

  145. :Format:

  146. 	``PREGAP <pregap>``

  147. 

  148. 	``pregap``

  149. 		time in MSF format.

  150. 

  151. The pregap is filled with generated silence.

  152. 

  153. REM

  154. ~~~

  155. 

  156. :Description: Begins a comment line.

  157. :Section(s): any

  158. :Format:

  159. 	``REM [comments]``

  160. 

  161. TRACK

  162. ~~~~~

  163. 

  164. :Description: Starts a new track.

  165. :Section(s): track

  166. :Format:

  167. 	``TRACK <track_number> <track_mode>``

  168. 

  169. 	``track_number``

  170. 		a positive integer in the range 1-99.

  171. 	``track_mode``

  172. 		one of: ``AUDIO``, ``CDG``, ``MODE1/2048``, ``MODE1/2352``,

  173. 		``MODE2/2336``, ``MODE2/2352``, ``CDI/2336``, or ``CDI/2352``.

  174. 

  175. (CD-TEXT keywords)

  176. ~~~~~~~~~~~~~~~~~~

  177. 

  178. :Description: Sets CD-TEXT data.

  179. :Section(s): any

  180. :Format:

  181. 	``<CDTEXT_keyword> <CDTEXT_field>``

  182. 

  183. 	``CDTEXT_keyword``

  184. 		one of: (see `CD-TEXT`_ section for a list of keywords).

  185. 	``CDTEXT_field``

  186. 		a string.

  187. 

  188. The cue format does not have native support for binary CD-TEXT.

  189. 

  190. Table of Contents File Format

  191. =============================

  192. 

  193. The standard file suffix for a toc file is ``.toc``.

  194. 

  195. Certain keywords begin a block, which must be enclosed between ``{`` and ``}``

  196. brackets.

  197. 

  198. Comments

  199. --------

  200. 

  201. Comments begin with ``//`` and may be placed anywhere except inside quoted

  202. strings.  A comment beginning with ``//`` is stripped from each line.

  203. 

  204. Keywords

  205. --------

  206. 

  207. AUDIOFILE

  208. ~~~~~~~~~

  209. 

  210. :Description: Add file to current track.

  211. :Section(s): track

  212. :Format:

  213. 	``AUDIOFILE "<filename>" <start> [length]``

  214. 

  215. 	``filename``

  216. 		a string.

  217. 	``start``

  218. 		time in MSF format.

  219. 	``length``

  220. 		time in MSF format.

  221. 

  222. CATALOG

  223. ~~~~~~~

  224. 

  225. :Description: Sets the media catalog number of the CD.

  226. :Section(s): global

  227. :Format:

  228. 	``CATALOG "<catalog_number>"``

  229. 

  230. 	``catalog_number``

  231. 		an integer consisting of exactly 13 digits.

  232. 

  233. CD_DA

  234. ~~~~~

  235. 

  236. :Description: Sets the CD format to audio.

  237. :Section(s): global

  238. :Format: ``CD_DA``

  239. 

  240. CD_ROM

  241. ~~~~~~

  242. 

  243. :Description: Sets the CD format to data.

  244. :Section(s): global

  245. :Format: ``CD_ROM``

  246. 

  247. CD_ROM_XA

  248. ~~~~~~~~~

  249. 

  250. :Description: Sets the CD format to mixed.

  251. :Section(s): global

  252. :Format: ``CD_ROM_XA``

  253. 

  254. CD_TEXT

  255. ~~~~~~~

  256. 

  257. :Section(s): any

  258. :Format: ``CD_TEXT {}``

  259. 

  260. Begins a CD-TEXT block.

  261. 

  262. COPY

  263. ~~~~

  264. 

  265. :Description: Sets the copy permitted flag.

  266. :Section(s): track

  267. :Format: ``COPY``

  268. 

  269. DATAFILE

  270. ~~~~~~~~

  271. 

  272. :Description: Add data from file to current track.

  273. :Section(s): track

  274. :Format:

  275. 	``DATAFILE "<filename>" [length]``

  276. 

  277. 	``filename``

  278. 		a string.

  279. 	``length``

  280. 		time in MSF format.

  281. 

  282. ISRC

  283. ~~~~

  284. 

  285. :Description: Sets track ISRC number.

  286. :Section(s): track

  287. :Format:

  288. 	``ISRC "<ISRC_number>"``

  289. 

  290. 	``ISRC_number``

  291. 		a string with the format CCOOOOYYSSSSS.

  292. 

  293. FIFO

  294. ~~~~

  295. 

  296. :Description: Add data from FIFO to current track.

  297. :Section(s): track

  298. :Format:

  299. 	``FIFO "<fifoname>" <length>"``

  300. 

  301. 	``length``

  302. 		time in MSF format.

  303. 

  304. FILE

  305. ~~~~

  306. 

  307. :Description: Add data from file to current track.

  308. :Section(s): track

  309. :Format:

  310. 	``FILE "<filename>" <start> [length]``

  311. 

  312. 	``filename``

  313. 		a string.

  314. 	``start``

  315. 		time in MSF format.

  316. 	``length``

  317. 		time in MSF format.

  318. 

  319. FOUR_CHANNEL_AUDIO

  320. ~~~~~~~~~~~~~~~~~~

  321. 

  322. :Description: Sets the four channel audio flag.

  323. :Section(s): track

  324. :Format: ``FOUR_CHANNEL_AUDIO``

  325. 

  326. INDEX

  327. ~~~~~

  328. 

  329. :Description: Sets a track index.

  330. :Section(s): track

  331. :Format: ``INDEX <index_number> <index_time>``

  332. 

  333. 	``index_number``

  334. 		a non-negative integer.

  335. 	``index_time``

  336. 		time in MSF format.

  337. 

  338. LANGUAGE

  339. ~~~~~~~~

  340. 

  341. :Description: Begins a language block.

  342. :Section(s): track

  343. :Subsection(s): CD-TEXT block

  344. :Format:

  345. 	``LANGUAGE language_number { cd_text }``

  346. 

  347. 	``language_number``

  348. 		an integer in the range 0-255.

  349. 	``cd_text``

  350. 		a series of CD-TEXT keyword lines.

  351. 

  352. LANGUAGE_MAP

  353. ~~~~~~~~~~~~

  354. 

  355. :Description: Begins a language map block.

  356. :Section(s): global

  357. :Subsection(s): CD-TEXT block

  358. :Format:

  359. 	``LANGUAGE_MAP { language_map... }``

  360. 

  361. 	``language_map``

  362. 		is a mapping of an integer in the range 0-255 to a country

  363. 		code. *TODO: add description of mapping format*

  364. 

  365. NO

  366. ~~

  367. :Description: Negates (clears) track flags.

  368. :Section(s): track

  369. :Format:

  370. 	``NO <flag>``

  371. 

  372. 	``flag``

  373. 		  one of: ``COPY`` or ``PRE_EMPHASIS``.

  374. 

  375. PREGAP

  376. ~~~~~~

  377. 

  378. :Description: Sets track pregap.

  379. :Section(s): track

  380. :Format:

  381. 	``PREGAP <pregap>``

  382. 

  383. 	``pregap``

  384. 		time in MSF format.

  385. 

  386. SILENCE

  387. ~~~~~~~

  388. 

  389. :Description: Add zero (silent) audio data to current track.

  390. :Section(s): track

  391. :Format:

  392. 	``SILENCE <length>``

  393. 

  394. 	``length``

  395. 		time in MSF format.

  396. 

  397. START

  398. ~~~~~

  399. 

  400. :Description: Sets the length of the pregap.

  401. :Section(s): track

  402. :Format:

  403. 	``START <start>``

  404. 

  405. 	``start``

  406. 		time in MSF format.

  407. 

  408. TRACK

  409. ~~~~~

  410. 

  411. :Description: Starts a new track.

  412. :Section(s): track

  413. :Format:

  414. 	``TRACK <track_mode> [sub_channel_mode]``

  415. 

  416. 	``track_mode``

  417. 		one of: ``AUDIO``, ``MODE1``, ``MODE1_RAW``, ``MODE2``,

  418. 		``MODE2_FORM1``, ``MODE2_FORM2``, ``MODE2_FORM_MIX``,

  419. 		``MODE2_RAW``

  420. 	``sub_channel_mode``

  421. 		one of: ``RW``, ``RW_RAW``

  422. 

  423. TWO_CHANNEL_AUDIO

  424. ~~~~~~~~~~~~~~~~~

  425. 

  426. :Description: Sets the two channel audio flag.

  427. :Section(s): track

  428. :Format: ``TWO_CHANNEL_AUDIO``

  429. 

  430. ZERO

  431. ~~~~

  432. 

  433. :Description: Add zero data to current track.

  434. :Section(s): track

  435. :Format:

  436. 	``ZERO <length>``

  437. 

  438. 	``length``

  439. 		time in MSF format.

  440. 

  441. (CD-TEXT keywords)

  442. ~~~~~~~~~~~~~~~~~~

  443. 

  444. :Description: Sets CD-TEXT data.

  445. :Section(s): any

  446. :Subsection(s): language block

  447. :Format1:

  448. 	``<CDTEXT_keyword> "<CDTEXT_field>"``

  449. 

  450. 	``CDTEXT_keyword``

  451. 		one of: (see `CD-TEXT`_ section for a list of keywords).

  452. 	``CDTEXT_field``

  453. 		a string.

  454. 

  455. :Format2:

  456. 	``<CDTEXT_keyword> { CDTEXT_binary_data }``

  457. 

  458. 	``CDTEXT_binary_data``

  459. 		comma separated list of integers in the range 0-255.

  460. 

  461. Format1 is for character data and Format2 is for binary data.  See `CD-TEXT`_

  462. section for a list of CD-TEXT keywords.

  463. 

  464. CD-TEXT

  465. =======

  466. 

  467. MMC-3_ specifies 16 CD-TEXT types.  Three are reserved and have no

  468. corresponding keywords.  One is shared; the keyword depends on whether it is

  469. for the disc (``UPC_EAN``) or a track (``ISRC``).  CD-TEXT entries are either

  470. character or binary data.  All descriptions taken from MMC-3_.

  471. 

  472. Keywords

  473. --------

  474. 

  475. ARRANGER

  476. ~~~~~~~~

  477. 

  478. :Description: Name(s) of the arranger(s)

  479. :Section: any

  480. :Format: character

  481. 

  482. COMPOSER

  483. ~~~~~~~~

  484. 

  485. :Description: Name(s) of the composer(s)

  486. :Section: any

  487. :Format: character

  488. 

  489. DISC_ID

  490. ~~~~~~~

  491. 

  492. :Description: Disc Identification information

  493. :Section: any

  494. :Format: binary

  495. 

  496. GENRE

  497. ~~~~~

  498. 

  499. :Description: Genre Identification and Genre information

  500. :Section: any

  501. :Format: binary

  502. 

  503. Genre codes are in the Enhanced CD Specification or cdrtools_ ``cdtext.h`` file.

  504. 

  505. ISRC

  506. ~~~~~

  507. 

  508. :Description: ISRC Code of each track

  509. :Section: track

  510. :Format: character

  511. 

  512. MESSAGE

  513. ~~~~~~~

  514. 

  515. :Description: Message from the content provider and/or artist

  516. :Section: any

  517. :Format: character

  518. 

  519. PERFORMER

  520. ~~~~~~~~~

  521. 

  522. :Description: Name(s) of the performer(s)

  523. :Section: any

  524. :Format: character

  525. 

  526. SONGWRITER

  527. ~~~~~~~~~~

  528. 

  529. :Description: Name(s) of the songwriter(s)

  530. :Section: any

  531. :Format: character

  532. 

  533. TITLE

  534. ~~~~~

  535. 

  536. :Description: Title of album name or Track Titles

  537. :Section: any

  538. :Format: character

  539. 

  540. TOC_INFO

  541. ~~~~~~~~~

  542. 

  543. :Description: Table of Content information

  544. :Section: any

  545. :Format: binary

  546. 

  547. TOC_INFO2

  548. ~~~~~~~~~

  549. 

  550. :Description: Second Table of Content information

  551. :Section: any

  552. :Format: binary

  553. 

  554. UPC_EAN

  555. ~~~~~~~

  556. 

  557. :Description: UPC/EAN code of the album

  558. :Section: disc

  559. :Format: character

  560. 

  561. SIZE_INFO

  562. ~~~~~~~~~

  563. 

  564. :Description: Size information of the Block

  565. :Section: any

  566. :Format: binary

  567. 

  568. Definitions

  569. ===========

  570. 

  571. frame

  572. 	1/75 of a second.

  573. 

  574. International Standard Recording Code (ISRC)

  575. 	A 12 character identification code for sound recordings.  See

  576. 	`ISRC intro`_ for details.

  577. 

  578. Media Catalog Number (MCN)

  579. 	A 13 digit UPC/EAN code for the disc.

  580. 

  581. MSF format

  582. 	a representation of time in the form ``m:s:f``.  ``m`` is minutes,

  583. 	``s`` is seconds, and ``f`` is frames.  Fields may be zero padded.

  584. 

  585. .. _MMC-3: ftp://ftp.t10.org/t10/drafts/mmc3/

  586. .. _cdrtools: http://www.fokus.gmd.de/research/cc/glone/employees/joerg.schilling/private/cdrecord.html

  587. .. _ISRC intro: http://www.ifpi.org/site-content/online/isrc_intro.html