New cdrskin options extract_audio_to= , extract_tracks= , extract_basename= , --extract_dap

This commit is contained in:
Thomas Schmitt 2013-05-23 15:48:04 +00:00
parent 167d73e268
commit 19cbdde95f
2 changed files with 259 additions and 10 deletions

View File

@ -2,7 +2,7 @@
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH CDRSKIN 1 "Version 1.3.1, May 20, 2013"
.TH CDRSKIN 1 "Version 1.3.1, May 23, 2013"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
@ -37,7 +37,7 @@ Blanking of CD-RW and DVD-RW.
.br
Formatting of DVD-RW, DVD+RW, DVD-RAM, BD.
.br
Burning of data or audio tracks to CD,
Burning of data tracks or audio tracks with CD-TEXT to CD,
.br
either in versatile Track at Once mode (TAO)
.br
@ -55,6 +55,8 @@ on overwriteable DVD+RW, DVD-RW, DVD-RAM, BD-RE
.br
or on data file or block device.
.br
Extraction of audio tracks and CD-TEXT to hard disk files.
.br
Bus scan, burnfree, speed options, retrieving media info, padding, fifo.
.br
See section EXAMPLES at the end of this text.
@ -1000,6 +1002,7 @@ the file with the given path. If CD-TEXT can be retrieved, then this file
will be suitable for option textfile=.
.br
Not all drives can read CD-TEXT and not all audio CDs bear CD-TEXT.
It is not considered an error if no CD-TEXT is available.
.TP
.BI cdtext_to_v07t= path
Extract the CD-TEXT packs from the lead-in of an audio CD and write them
@ -1010,6 +1013,7 @@ will be suitable for option input_sheet_v07t=.
If the given path is "-", then the result is printed to standard output.
.br
Not all drives can read CD-TEXT and not all audio CDs bear CD-TEXT.
It is not considered an error if no CD-TEXT is available.
.TP
.BI \--demand_a_drive
Exit with a nonzero value if no drive can be found during a bus scan.
@ -1074,6 +1078,32 @@ A number of 64 KB may improve throughput with systems
which show latency problems. The default depends on media type, option
stream_recording=, and on compile time options.
.TP
.BI extract_audio_to= directory_path
Extract tracks from an audio CD as separate WAVE audio files into the
given directory.
This directory has to already exist, but none of the track files may exist.
This option will rather fail than overwrite an existing file.
.br
By default all tracks of the CD are extracted to files with names
trackNN.wav, where NN is the track number from 01 to at most 99.
.TP
.BI extract_basename= name
Set a filename which shall be used by extract_audio_to= instead of the default
name "track".
.TP
.BI --extract_dap
Enable Digital Audio Play flaw obscuring mechanisms
like audio data mute and interpolate.
.TP
.BI extract_tracks= number[,number[,...]]
Set a list of track numbers to define which tracks shall be extracted
by extract_audio_to=.
If no extract_tracks= is given, then all audio tracks get extracted.
It is permissible to have more than one extract_tracks= option in order
to split a long list into shorter pieces.
.br
The lowest permissible track number is 1, the highest is 99.
.TP
.BI fallback_program= command
Set a command name to be executed if cdrskin encounters a known cdrecord
option which it does not yet support. If a non-empty command is given with
@ -1613,7 +1643,7 @@ cdrskin -v dev=/dev/sr0 blank=deformat_sequential
.br
cdrskin -v dev=/dev/hdc speed=12 fs=8m \\
.br
blank=as_needed -eject padsize=300k my_image.iso
blank=as_needed -eject padsize=300k my_image.iso
.SS
.B Write compressed afio archive on-the-fly (not possible with minimally blanked DVD-RW or DVD-R DL):
.br
@ -1621,7 +1651,7 @@ find . | afio -oZ - | \\
.br
cdrskin -v dev=0,1,0 fs=32m speed=8 \\
.br
blank=as_needed padsize=300k -
blank=as_needed padsize=300k -
.SS
.B Write multi-session to the same CD, DVD-R[W], DVD+R[/DL], or BD-R:
.br
@ -1643,16 +1673,23 @@ mkisofs ... -C "$c_values" ...
.br
x=$(cdrskin dev=/dev/sr0 -multi \\
.br
--tell_media_space 2>/dev/null)
--tell_media_space 2>/dev/null)
.br
echo "Available: $x blocks of 2048 data bytes"
.SS
.B Write audio tracks to CD:
.B Write audio tracks and CD-TEXT to CD:
.br
cdrskin -v dev=ATA:1,0,0 speed=48 -sao \\
.br
track1.wav track2.au -audio -swab track3.raw
input_sheet_v07t=cdtext.v07t \\
.br
track1.wav track2.au -audio -swab track3.raw
.SS
.B Extract audio tracks and CD-TEXT from CD into directory /home/me/my_cd:
.br
cdrskin -v dev=/dev/sr0 extract_audio_to=/home/me/my_cd \\
.br
cdtext_to_v07t=/home/me/my_cd/cdtext.v07t
.SH FILES
.SS
Startup files:

View File

@ -2850,8 +2850,21 @@ set_dev:;
printf(" dvd_obs=\"default\"|number\n");
printf(
" set number of bytes per DVD/BD write: 32k or 64k\n");
printf(" extract_audio_to=<dir>\n");
printf(
" fallback_program=<cmd> use external program for exotic CD jobs\n");
" Copy all tracks of an audio CD as separate\n");
printf(
" .WAV files <dir>/track<NN>.wav to hard disk\n");
printf(" extract_basename=<name>\n");
printf(
" Compose track files as <dir>/<name><NN>.wav\n");
printf(
" --extract_dap Enable flaw obscuring mechanisms for audio reading\n");
printf(" extract_tracks=<number[,number[,...]]>\n");
printf(
" Restrict extract_audio_to= to list of tracks.\n");
printf(
" fallback_program=<cmd> use external program for exotic CD jobs.\n");
printf(" --fifo_disable disable fifo despite any fs=...\n");
printf(" --fifo_per_track use a separate fifo for each track\n");
printf(
@ -3117,7 +3130,7 @@ set_severities:;
if(o->verbosity>=Cdrskin_verbose_debuG)
Cdrpreskin_set_severities(o,"NEVER","DEBUG",0);
else if(o->verbosity >= Cdrskin_verbose_progresS)
Cdrpreskin_set_severities(o, "NEVER", "NOTE", 0);
Cdrpreskin_set_severities(o, "NEVER", "UPDATE", 0);
} else if(strcmp(argv[i],"-vv")==0 || strcmp(argv[i],"-vvv")==0 ||
strcmp(argv[i],"-vvvv")==0) {
@ -3367,6 +3380,13 @@ struct CdrskiN {
char cdtext_to_textfile_path[Cdrskin_strleN];
int do_cdtext_to_vt07;
char cdtext_to_vt07_path[Cdrskin_strleN];
int do_extract_audio;
char extract_audio_dir[Cdrskin_strleN];
char extract_basename[249];
char extract_audio_tracks[100]; /* if [i] > 0 : extract track i */
int extract_flags; /* bit3 = for flag bit3 of
burn_drive_extract_audio()
*/
#ifdef Libburn_develop_quality_scaN
int do_qcheck; /* 0= no , 1=nec_optiarc_rep_err_rate */
@ -3622,6 +3642,12 @@ int Cdrskin_new(struct CdrskiN **skin, struct CdrpreskiN *preskin, int flag)
o->cdtext_to_textfile_path[0]= 0;
o->do_cdtext_to_vt07= 0;
o->cdtext_to_vt07_path[0]= 0;
o->do_extract_audio= 0;
o->extract_audio_dir[0]= 0;
o->extract_basename[0]= 0;
for(i= 0; i < 100; i++)
o->extract_audio_tracks[i]= 0;
o->extract_flags= 0;
#ifdef Libburn_develop_quality_scaN
o->do_qcheck= 0;
@ -4971,12 +4997,16 @@ int Cdrskin_cdtext_to_file(struct CdrskiN *skin, char *path, int flag)
FILE *fp= NULL;
struct stat stbuf;
ret= Cdrskin_grab_drive(skin, 0);
if(ret<=0)
goto ex;
fmt= flag & 15;
drive= skin->drives[skin->driveno].drive;
ret= burn_disc_get_leadin_text(drive, &text_packs, &num_packs, 0);
if(ret <= 0 || num_packs <= 0) {
fprintf(stderr, "cdrskin: No CD-Text or CD-Text unaware drive.\n");
return(2);
ret= 2; goto ex;
}
if(fmt == 1) {
ret = burn_make_input_sheet_v07t(text_packs, num_packs, 0, 0, &result,
@ -5035,6 +5065,7 @@ ex:;
return(1);
}
/** Perform -toc under control of Cdrskin_atip().
@param flag Bitfield for control purposes:
bit0= do not list sessions separately (do it cdrecord style)
@ -5860,6 +5891,117 @@ ex:;
}
/*
@param flag Bitfield for control purposes:
bit3= Enable DAP : "flaw obscuring mechanisms like
audio data mute and interpolate"
*/
int Cdrskin_extract_audio_to_dir(struct CdrskiN *skin,
char *dir, char *basename,
char print_tracks[100], int flag)
{
int num_sessions= 0, num_tracks= 0, profile_number, session_no, track_no;
int track_count= 0, existing= 0, ret, pass, not_audio= 0, pick_tracks= 0, i;
int tracks_extracted= 0, min_tno= 100, max_tno= 0;
struct burn_drive *drive;
struct burn_disc *disc= NULL;
struct burn_session **sessions;
struct burn_track **tracks;
enum burn_disc_status s;
struct burn_toc_entry toc_entry;
struct stat stbuf;
char profile_name[80], path[4096 + 256];
ret= Cdrskin_grab_drive(skin, 0);
if(ret<=0)
goto ex;
drive= skin->drives[skin->driveno].drive;
s= burn_disc_get_status(drive);
disc= burn_drive_get_disc(drive);
if(s == BURN_DISC_EMPTY || s == BURN_DISC_BLANK || disc == NULL) {
not_readable:;
fprintf(stderr, "cdrskin: SORRY : No audio CD in drive.\n");
ret= 0; goto ex;
}
ret= burn_disc_get_profile(drive, &profile_number, profile_name);
if(ret <= 0 || profile_number < 0x08 || profile_number > 0x0a) {
not_audio_cd:;
fprintf(stderr, "cdrskin: SORRY : Medium in drive is not an audio CD.\n");
ret= 0; goto ex;
}
for(i= 0; i < 99; i++)
if(print_tracks[i])
pick_tracks= 1;
sessions= burn_disc_get_sessions(disc, &num_sessions);
if(num_sessions <= 0)
goto not_readable;
for(pass= 0; pass < 2; pass++) {
if(pass > 0) {
if(existing > 0)
{ret= 0; goto ex;}
if(not_audio == track_count)
goto not_audio_cd;
}
track_count= 0;
for(session_no= 0; session_no < num_sessions; session_no++) {
tracks= burn_session_get_tracks(sessions[session_no],&num_tracks);
if(tracks==NULL)
continue;
for(track_no= 0; track_no < num_tracks; track_no++) {
track_count++;
burn_track_get_entry(tracks[track_no], &toc_entry);
if(toc_entry.point < min_tno)
min_tno= toc_entry.point;
if(toc_entry.point > max_tno)
max_tno= toc_entry.point;
if(pick_tracks) {
if(toc_entry.point <= 0 || toc_entry.point > 99)
continue; /* should not happen */
if(print_tracks[toc_entry.point] == 0)
continue;
}
if((toc_entry.control & 7) >= 4) {
if(pass == 0)
fprintf(stderr,
"cdrskin: WARNING : Track %2.2d is not an audio track.\n",
toc_entry.point);
not_audio++;
continue;
}
sprintf(path, "%s/%s%2.2u.wav", dir, basename, toc_entry.point);
if(pass == 0) {
if(stat(path, &stbuf) != -1) {
fprintf(stderr,
"cdrskin: SORRY : May not overwrite existing file: '%s'\n",
path);
existing++;
}
continue;
}
if(skin->verbosity >= Cdrskin_verbose_progresS)
fprintf(stderr, "cdrskin: Writing audio track file: %s\n", path);
ret= burn_drive_extract_audio_track(drive, tracks[track_no], path,
(flag & 8) | (skin->verbosity >= Cdrskin_verbose_progresS));
if(ret <= 0)
goto ex;
tracks_extracted++;
}
}
}
if(tracks_extracted == 0 && pick_tracks) {
fprintf(stderr,
"cdrskin: SORRY : Not a single track matched the list of extract_tracks=\n");
if(min_tno < 100 && max_tno > 0)
fprintf(stderr, "cdrskin: HINT : Track range is %2.2d to %2.2d\n",
min_tno, max_tno);
ret= 0; goto ex;
}
ret= 1;
ex:;
return(ret);
}
#ifndef Cdrskin_extra_leaN
/* A70324: proposal by Eduard Bloch */
@ -8303,6 +8445,68 @@ dvd_obs:;
ClN(printf("cdrskin: ignoring obsolete eject_device=%s\n",
skin->eject_device));
} else if(strncmp(argv[i],"-extract_audio_to=", 18)==0) {
value_pt= argpt + 18;
goto extract_audio_to;
} else if(strncmp(argpt, "extract_audio_to=", 17) == 0) {
value_pt= argpt + 17;
extract_audio_to:;
if(strlen(value_pt) >= sizeof(skin->extract_audio_dir)) {
fprintf(stderr,
"cdrskin: FAILURE : extract_audio_to=... is much too long.\n");
return(0);
}
skin->do_extract_audio= 1;
strcpy(skin->extract_audio_dir, value_pt);
} else if(strncmp(argv[i],"-extract_tracks=", 16)==0) {
value_pt= argpt + 16;
goto extract_tracks;
} else if(strncmp(argpt, "extract_tracks=", 15) == 0) {
value_pt= argpt + 15;
extract_tracks:;
value= 0.0;
for(cpt= value_pt; ; cpt++) {
if(*cpt >= '0' && *cpt <= '9') {
value= value * 10 + *cpt - '0';
} else {
if(value >= 1.0 && value <= 99.0) {
skin->extract_audio_tracks[(int) value]= 1;
if(skin->verbosity >= Cdrskin_verbose_cmD)
fprintf(stderr, "cdrskin: Will extract track number %.f\n",
value);
} else {
fprintf(stderr,
"cdrskin: WARNING : extract_tracks= with unsuitable number: %.f\n",
value);
}
if(*cpt == 0)
break;
value= 0;
}
}
} else if(strncmp(argv[i],"-extract_basename=", 18)==0) {
value_pt= argpt + 18;
goto extract_basename;
} else if(strncmp(argpt, "extract_basename=", 17) == 0) {
value_pt= argpt + 17;
extract_basename:;
if(strchr(value_pt, '/') != NULL) {
fprintf(stderr,
"cdrskin: FAILURE : extract_basename=... may not contain '/'\n");
return(0);
}
if(strlen(value_pt) > 248) {
fprintf(stderr,
"cdrskin: FAILURE : Oversized extract_basename=... (Max. 248)\n");
return(0);
}
strcpy(skin->extract_basename, value_pt);
} else if(strcmp(argv[i],"--extract_dap") == 0) {
skin->extract_flags|= 8;
#ifndef Cdrskin_extra_leaN
} else if(strcmp(argv[i],"--fifo_disable")==0) {
@ -9284,6 +9488,14 @@ int Cdrskin_run(struct CdrskiN *skin, int *exit_value, int flag)
if(ret<=0)
{*exit_value= 19; goto ex;}
}
if(skin->do_extract_audio) {
ret= Cdrskin_extract_audio_to_dir(skin, skin->extract_audio_dir,
skin->extract_basename,
skin->extract_audio_tracks,
skin->extract_flags & 8);
if(ret<=0)
{*exit_value= 19; goto ex;}
}
if(skin->do_list_speeds) {
if(skin->n_drives<=0)
{*exit_value= 17; goto no_drive;}