Next: , Previous: , Up: Top   [Contents][Index]

4 Tutorial

The most ordinary use case is when you have a CCD set of files and just want to generate a CUE sheet file in order to burn or otherwise access the data inside the image file. Supposing your CCD sheet file is called free-as-in-freedom.ccd, all you need is the command:

ccd2cue -o free-as-in-freedom.cue free-as-in-freedom.ccd

Remember that if your CCD sheet file name has spaces or unusual characters, like ‘$’, you are better quoting the whole name with ‘'’. Naturally the CUE sheet file don’t need to have the same base name as the CCD sheet file. You can give an adequate CUE sheet output file name, at your discretion, to the -o (--output) option. If you omit the -o option entirely as in

ccd2cue free-as-in-freedom.ccd

the result is that the yielding CUE sheet is written to the standard output, giving you the chance to pipe it out to another command or to use the shell to redirect it to a file, as you would do without it using the -o option. The same thing is accomplished by passing - as an argument to option -o.

Can you guess what happens if we omit the CCD sheet input file specification as well? If you answered that GNU ccd2cue will read the CCD sheet input from standard input and write the correspondent CUE sheet output to standard output, unfortunately you are wrong. It would be nice if it behaved that way, but there is an inherent design drawback: the CUE sheet needs to reference an image file and possibly a CD-Text file; in that way, how could it have any clue about those file names? For that reason it is always necessary to supply at least one file name in an option or non-option argument, so GNU ccd2cue can deduce the remaining file names needed. The deduction algorithm is very simple: get the file name supplied, in the following preference order:

  1. CCD sheet input file name (non-option argument);
  2. CUE sheet output file name (-o, --output);
  3. Image file name (-i, --image);
  4. CD-Text file name (-c, --cd-text);

conserve only its base name and concatenate the canonical suffix. Therefore, if you want to read the CCD sheet input from standard input and write the CCD sheet output to standard output, it is enough to just make explicit the name of a image name, possibly with a nonstandard suffix, regardless of the actual existence of the image file, as in

ccd2cue -i free-as-in-free-speech.img

where free-as-in-free-speech.img is the image file name. On the other hand, you can use the -i (--image) in conjunction with the CCD sheet file name and/or CUE sheet file name just to override the image file name deduction. As expected, the argument - in place of the CCD sheet file name, will also make GNU ccd2cue read its CCD sheet input from standard input.

If, for some weird reason, you want to move the CUE sheet file around while keeping the image file in its original place and yet be able to normally use this pair as if they were in the same directory, you can use the option -a (--absolute-file-name). That option will make the file name deduction algorithm explained above retain the absolute directory name for each file; however, as a consequence of this approach, it will only work for file names not directly supplied, but deduced by the program.

When GNU ccd2cue detects CD-Text data information inside the CCD sheet, it outputs a CD-Text file, whose name is determined by the same file name deduction rules just described, unless overridden by the option -c (--cd-text). It is not possible to output the binary CD-Text data to standard output, however.

Next: , Previous: , Up: Top   [Contents][Index]