ref: f8667d2d023388c96d0f2d4ac93ef8d15dca1d17
dir: /src/sox.c/
/* SoX - The Swiss Army Knife of Audio Manipulation. * * This is the main function for the SoX command line programs: * sox, play, rec, soxi. * * Copyright 1998-2009 Chris Bagwell and SoX contributors * Copyright 1991 Lance Norskog And Sundry Contributors * * This program is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License as published by the * Free Software Foundation; either version 2 of the License, or (at your * option) any later version. * * This program is distributed in the hope that it will be useful, but * WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General * Public License for more details. * * You should have received a copy of the GNU General Public License along * with this program; if not, write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. */ #include "soxomp.h" /* Make this 1st in list (for soxconfig) */ #include "sox.h" #include "util.h" #include "sgetopt.h" #include <ctype.h> #include <errno.h> #include <fcntl.h> #include <math.h> #include <signal.h> #include <stdio.h> #include <stdlib.h> #include <string.h> #include <sys/stat.h> #include <sys/types.h> #include <time.h> #if defined(HAVE_WIN32_GLOB_H) #include "win32-glob.h" #define HAVE_GLOB_H 1 #elif defined(HAVE_GLOB_H) #include <glob.h> #endif #ifdef HAVE_IO_H #include <io.h> #endif #ifdef HAVE_SUN_AUDIOIO_H #include <sun/audioio.h> #define HAVE_AUDIOIO_H 1 #else #ifdef HAVE_SYS_AUDIOIO_H #include <sys/audioio.h> #define HAVE_AUDIOIO_H 1 #endif #endif #ifdef HAVE_SYS_SOUNDCARD_H #include <sys/soundcard.h> #define HAVE_SOUNDCARD_H 1 #else #ifdef HAVE_MACHINE_SOUNDCARD_H #include <machine/soundcard.h> #define HAVE_SOUNDCARD_H 1 #endif #endif #ifdef HAVE_SYS_TIME_H #include <sys/time.h> #endif #ifdef HAVE_SYS_TIMEB_H #include <sys/timeb.h> #endif #ifdef HAVE_SYS_UTSNAME_H #include <sys/utsname.h> #endif #ifdef HAVE_UNISTD_H #include <unistd.h> #endif #ifdef HAVE_GETTIMEOFDAY #define TIME_FRAC 1e6 #else #define timeval timeb #define gettimeofday(a,b) ftime(a) #define tv_sec time #define tv_usec millitm #define TIME_FRAC 1e3 #endif #if !defined(HAVE_CONIO_H) && !defined(HAVE_TERMIOS_H) && (defined(_MSC_VER) || defined(__MINGW32__)) #define HAVE_CONIO_H 1 #endif #ifdef HAVE_CONIO_H /* _kbhit and _getch */ #include <conio.h> #undef HAVE_TERMIOS_H #endif /*#define MORE_INTERACTIVE 1*/ /* argv[0] options */ static char const * myname = NULL; static enum {sox_sox, sox_play, sox_rec, sox_soxi} sox_mode; /* gopts */ static enum { sox_sequence, sox_concatenate, sox_mix, sox_mix_power, sox_merge, sox_multiply, sox_default } combine_method = sox_default; static enum { sox_single, sox_multiple } output_method = sox_single; #define is_serial(m) ((m) <= sox_concatenate) #define is_parallel(m) (!is_serial(m)) static sox_bool no_clobber = sox_false, interactive = sox_false; static sox_bool uservolume = sox_false; typedef enum {RG_off, RG_track, RG_album, RG_default} rg_mode; static lsx_enum_item const rg_modes[] = { LSX_ENUM_ITEM(RG_,off) LSX_ENUM_ITEM(RG_,track) LSX_ENUM_ITEM(RG_,album) {0, 0}}; static rg_mode replay_gain_mode = RG_default; static sox_option_t show_progress = SOX_OPTION_DEFAULT; #define SOX_OPTS "SOX_OPTS" /* Input & output files */ typedef struct { char * filename; /* fopts */ char const * filetype; sox_signalinfo_t signal; sox_encodinginfo_t encoding; double volume; double replay_gain; sox_oob_t oob; sox_bool no_glob; sox_format_t * ft; /* libSoX file descriptor */ size_t volume_clips; rg_mode replay_gain_mode; } file_t; static file_t * * files; /* Array tracking input and output files */ #define ofile files[file_count - 1] static size_t file_count = 0; static size_t input_count = 0; static size_t output_count = 0; /* Effects */ /* We parse effects into a temporary effects table and then place into * the real effects chain. This allows scanning all effects to give * hints to what input effect options should be as well as determining * when mixer or resample effects need to be auto-inserted as well. * * User effects table must be 4 entries smaller then the real * effects table. This is because at most we will need to add * the input effect, an optional resample effect, an optional mixer * effect, and the output effect. */ #define MAX_USER_EFF (SOX_MAX_EFFECTS - 4) static sox_effect_t *user_efftab[MAX_USER_EFF]; static sox_effects_chain_t *effects_chain = NULL; static sox_effect_t *save_output_eff = NULL; static struct { char *name; int argc; char *argv[FILENAME_MAX]; } (*user_effargs)[MAX_USER_EFF] = NULL; static unsigned *nuser_effects = NULL; static int current_eff_chain = 0; static int eff_chain_count = 0; static char *effects_filename = NULL; static char * play_rate_arg = NULL; /* Flowing */ static sox_signalinfo_t combiner_signal, ofile_signal_options; static sox_encodinginfo_t combiner_encoding, ofile_encoding_options; static size_t mixing_clips = 0; static size_t current_input = 0; static unsigned long input_wide_samples = 0; static unsigned long read_wide_samples = 0; static unsigned long output_samples = 0; static sox_bool input_eof = sox_false; static sox_bool output_eof = sox_false; static sox_bool user_abort = sox_false; static sox_bool user_skip = sox_false; static sox_bool user_restart_eff = sox_false; static int success = 0; static sox_sample_t omax[2], omin[2]; /* Multi-processing */ static sox_bool single_threaded = sox_true; #ifdef HAVE_TERMIOS_H #include <termios.h> static struct termios original_termios; #endif static sox_bool stdin_is_a_tty, is_player, is_guarded, do_guarded_norm, no_dither, reported_sox_opts; /* Cleanup atexit() function, hence always called. */ static void cleanup(void) { size_t i; if (!success && !reported_sox_opts) { char const * env_opts = getenv(SOX_OPTS); if (env_opts && *env_opts) lsx_report("used "SOX_OPTS"=%s", env_opts); } /* Close the input and output files before exiting. */ for (i = 0; i < input_count; i++) { if (files[i]->ft) { sox_close(files[i]->ft); } free(files[i]); } if (file_count) { if (ofile->ft) { if (!success && ofile->ft->fp) { /* If we failed part way through */ struct stat st; /* writing a normal file, remove it. */ fstat(fileno(ofile->ft->fp), &st); if ((st.st_mode & S_IFMT) == S_IFREG) unlink(ofile->ft->filename); } sox_close(ofile->ft); /* Assume we can unlink a file before closing it. */ } free(ofile); } #ifdef HAVE_TERMIOS_H if (interactive) tcsetattr(fileno(stdin), TCSANOW, &original_termios); #endif sox_quit(); } static char const * str_time(double seconds) { static char string[16][50]; static int i; int hours, mins = seconds / 60; seconds -= mins * 60; hours = mins / 60; mins -= hours * 60; i = (i+1) & 15; sprintf(string[i], "%02i:%02i:%05.2f", hours, mins, seconds); return string[i]; } static char const * size_and_bitrate(sox_format_t * ft, char const * * text) { struct stat st; /* ft->fp may validly be NULL, so stat not fstat */ if (stat(ft->filename, &st) || (st.st_mode & S_IFMT) != S_IFREG) return NULL; if (ft->signal.length && ft->signal.channels && ft->signal.rate && text) { double secs = ft->signal.length / ft->signal.channels / ft->signal.rate; *text = lsx_sigfigs3(8. * st.st_size / secs); } return lsx_sigfigs3((double)st.st_size); } static void play_file_info(sox_format_t * ft, file_t * f, sox_bool full) { FILE * const output = sox_mode == sox_soxi? stdout : stderr; char const * text, * text2 = NULL; char buffer[30]; size_t ws = ft->signal.length / ft->signal.channels; (void)full; fprintf(output, "\n"); if (ft->filename[0]) { fprintf(output, "%s:", ft->filename); if (strcmp(ft->filename, "-") == 0 || (ft->handler.flags & SOX_FILE_DEVICE)) fprintf(output, " (%s)", ft->handler.names[0]); fprintf(output, "\n\n"); } if ((text = size_and_bitrate(ft, &text2))) { fprintf(output, " File Size: %-10s", text); if (text2) fprintf(output, "Bit Rate: %s", text2); fprintf(output, "\n"); } fprintf(output, " Encoding: %-14s", sox_encodings_info[ft->encoding.encoding].name); text = sox_find_comment(f->ft->oob.comments, "Comment"); if (!text) text = sox_find_comment(f->ft->oob.comments, "Description"); if (!text) text = sox_find_comment(f->ft->oob.comments, "Year"); if (text) fprintf(output, "Info: %s", text); fprintf(output, "\n"); sprintf(buffer, " Channels: %u @ %u-bit", ft->signal.channels, ft->signal.precision); fprintf(output, "%-25s", buffer); text = sox_find_comment(f->ft->oob.comments, "Tracknumber"); if (text) { fprintf(output, "Track: %s", text); text = sox_find_comment(f->ft->oob.comments, "Tracktotal"); if (text) fprintf(output, " of %s", text); } fprintf(output, "\n"); sprintf(buffer, "Samplerate: %gHz", ft->signal.rate); fprintf(output, "%-25s", buffer); text = sox_find_comment(f->ft->oob.comments, "Album"); if (text) fprintf(output, "Album: %s", text); fprintf(output, "\n"); if (f && f->replay_gain != HUGE_VAL){ sprintf(buffer, "%s gain: %+.1fdB", lsx_find_enum_value(f->replay_gain_mode, rg_modes)->text, f->replay_gain); buffer[0] += 'A' - 'a'; fprintf(output, "%-24s", buffer); } else fprintf(output, "%-24s", "Replaygain: off"); text = sox_find_comment(f->ft->oob.comments, "Artist"); if (text) fprintf(output, "Artist: %s", text); fprintf(output, "\n"); fprintf(output, " Duration: %-13s", ft->signal.length? str_time((double)ws / ft->signal.rate) : "unknown"); text = sox_find_comment(f->ft->oob.comments, "Title"); if (text) fprintf(output, "Title: %s", text); fprintf(output, "\n\n"); } static void display_file_info(sox_format_t * ft, file_t * f, sox_bool full) { static char const * const no_yes[] = {"no", "yes"}; FILE * const output = sox_mode == sox_soxi? stdout : stderr; char const * filetype = lsx_find_file_extension(ft->filename); sox_bool show_type = sox_true; size_t i; if (is_player && sox_globals.verbosity < 3) { play_file_info(ft, f, full); return; } fprintf(output, "\n%s: '%s'", ft->mode == 'r'? "Input File " : "Output File ", ft->filename); if (filetype) for (i = 0; ft->handler.names[i] && show_type; ++i) if (!strcasecmp(filetype, ft->handler.names[i])) show_type = sox_false; if (show_type) fprintf(output, " (%s)", ft->handler.names[0]); fprintf(output, "\n"); fprintf(output, "Channels : %u\n" "Sample Rate : %g\n" "Precision : %u-bit\n", ft->signal.channels, ft->signal.rate, ft->signal.precision); if (ft->signal.length && ft->signal.channels && ft->signal.rate) { size_t ws = ft->signal.length / ft->signal.channels; char const * text, * text2 = NULL; fprintf(output, "Duration : %s = %lu samples %c %g CDDA sectors\n", str_time((double)ws / ft->signal.rate), (unsigned long)ws, "~="[ft->signal.rate == 44100], (double)ws / ft->signal.rate * 44100 / 588); if (ft->mode == 'r' && (text = size_and_bitrate(ft, &text2))) { fprintf(output, "File Size : %s\n", text); if (text2) fprintf(output, "Bit Rate : %s\n", text2); } } if (ft->encoding.encoding) { char buffer[20] = {'\0'}; if (ft->encoding.bits_per_sample) sprintf(buffer, "%u-bit ", ft->encoding.bits_per_sample); fprintf(output, "Sample Encoding: %s%s\n", buffer, sox_encodings_info[ft->encoding.encoding].desc); } if (full) { if (ft->encoding.bits_per_sample > 8 || (ft->handler.flags & SOX_FILE_ENDIAN)) fprintf(output, "Endian Type : %s\n", ft->encoding.reverse_bytes != MACHINE_IS_BIGENDIAN ? "big" : "little"); if (ft->encoding.bits_per_sample) fprintf(output, "Reverse Nibbles: %s\n" "Reverse Bits : %s\n", no_yes[ft->encoding.reverse_nibbles], no_yes[ft->encoding.reverse_bits]); } if (f && f->replay_gain != HUGE_VAL) fprintf(output, "Replay gain : %+g dB (%s)\n" , f->replay_gain, lsx_find_enum_value(f->replay_gain_mode, rg_modes)->text); if (f && f->volume != HUGE_VAL) fprintf(output, "Level adjust : %g (linear gain)\n" , f->volume); if (!(ft->handler.flags & SOX_FILE_DEVICE) && ft->oob.comments) { if (sox_num_comments(ft->oob.comments) > 1) { sox_comments_t p = ft->oob.comments; fprintf(output, "Comments : \n"); do fprintf(output, "%s\n", *p); while (*++p); } else fprintf(output, "Comment : '%s'\n", ft->oob.comments[0]); } fprintf(output, "\n"); } static void report_file_info(file_t * f) { if (sox_globals.verbosity > 2) display_file_info(f->ft, f, sox_true); } static void progress_to_next_input_file(file_t * f, sox_effect_t * effp) { if (user_skip) { user_skip = sox_false; fprintf(stderr, "\nSkipped (Ctrl-C twice to quit).\n"); } read_wide_samples = 0; input_wide_samples = f->ft->signal.length / f->ft->signal.channels; if (show_progress && (sox_globals.verbosity < 3 || (is_serial(combine_method) && input_count > 1))) display_file_info(f->ft, f, sox_false); if (f->volume == HUGE_VAL) f->volume = 1; if (f->replay_gain != HUGE_VAL) f->volume *= pow(10.0, f->replay_gain / 20); if (effp && f->volume != floor(f->volume)) effp->out_signal.precision = SOX_SAMPLE_PRECISION; f->ft->sox_errno = errno = 0; } /* Read up to max `wide' samples. A wide sample contains one sample per channel * from the input audio. */ static size_t sox_read_wide(sox_format_t * ft, sox_sample_t * buf, size_t max) { size_t len = max / combiner_signal.channels; len = sox_read(ft, buf, len * ft->signal.channels) / ft->signal.channels; if (!len && ft->sox_errno) lsx_fail("`%s' %s: %s", ft->filename, ft->sox_errstr, sox_strerror(ft->sox_errno)); return len; } static void balance_input(sox_sample_t * buf, size_t ws, file_t * f) { size_t s = ws * f->ft->signal.channels; if (f->volume != 1) while (s--) { double d = f->volume * *buf; *buf++ = SOX_ROUND_CLIP_COUNT(d, f->volume_clips); } } /* The input combiner: contains one sample buffer per input file, but only * needed if is_parallel(combine_method) */ typedef struct { sox_sample_t * * ibuf; size_t * ilen; } input_combiner_t; static int combiner_start(sox_effect_t *effp) { input_combiner_t * z = (input_combiner_t *) effp->priv; size_t ws, i; if (is_serial(combine_method)) progress_to_next_input_file(files[current_input], effp); else { ws = 0; z->ibuf = lsx_malloc(input_count * sizeof(*z->ibuf)); for (i = 0; i < input_count; i++) { z->ibuf[i] = lsx_malloc(sox_globals.bufsiz * sizeof(sox_sample_t)); progress_to_next_input_file(files[i], effp); ws = max(ws, input_wide_samples); } input_wide_samples = ws; /* Output length is that of longest input file. */ } z->ilen = lsx_malloc(input_count * sizeof(*z->ilen)); return SOX_SUCCESS; } static sox_bool can_segue(size_t i) { return files[i]->ft->signal.channels == files[i - 1]->ft->signal.channels && files[i]->ft->signal.rate == files[i - 1]->ft->signal.rate; } static int combiner_drain(sox_effect_t *effp, sox_sample_t * obuf, size_t * osamp) { input_combiner_t * z = (input_combiner_t *) effp->priv; size_t ws, s, i; size_t olen = 0; if (is_serial(combine_method)) { while (sox_true) { if (!user_skip) olen = sox_read_wide(files[current_input]->ft, obuf, *osamp); if (olen == 0) { /* If EOF, go to the next input file. */ if (++current_input < input_count) { if (combine_method == sox_sequence && !can_segue(current_input)) break; progress_to_next_input_file(files[current_input], NULL); continue; } } balance_input(obuf, olen, files[current_input]); break; } /* while */ } /* is_serial */ else { /* else is_parallel() */ sox_sample_t * p = obuf; for (i = 0; i < input_count; ++i) { z->ilen[i] = sox_read_wide(files[i]->ft, z->ibuf[i], *osamp); balance_input(z->ibuf[i], z->ilen[i], files[i]); olen = max(olen, z->ilen[i]); } for (ws = 0; ws < olen; ++ws) { /* wide samples */ if (combine_method == sox_mix || combine_method == sox_mix_power) { for (s = 0; s < effp->in_signal.channels; ++s, ++p) { /* sum samples */ *p = 0; for (i = 0; i < input_count; ++i) if (ws < z->ilen[i] && s < files[i]->ft->signal.channels) { /* Cast to double prevents integer overflow */ double sample = *p + (double)z->ibuf[i][ws * files[i]->ft->signal.channels + s]; *p = SOX_ROUND_CLIP_COUNT(sample, mixing_clips); } } } /* sox_mix */ else if (combine_method == sox_multiply) { for (s = 0; s < effp->in_signal.channels; ++s, ++p) { /* multiple samples */ i = 0; *p = ws < z->ilen[i] && s < files[i]->ft->signal.channels? z->ibuf[i][ws * files[i]->ft->signal.channels + s] : 0; for (++i; i < input_count; ++i) { double sample = *p * (-1. / SOX_SAMPLE_MIN) * (ws < z->ilen[i] && s < files[i]->ft->signal.channels? z->ibuf[i][ws * files[i]->ft->signal.channels + s] : 0); *p = SOX_ROUND_CLIP_COUNT(sample, mixing_clips); } } } /* sox_multiply */ else { /* sox_merge: like a multi-track recorder */ for (i = 0; i < input_count; ++i) for (s = 0; s < files[i]->ft->signal.channels; ++s) *p++ = (ws < z->ilen[i]) * z->ibuf[i][ws * files[i]->ft->signal.channels + s]; } /* sox_merge */ } /* wide samples */ current_input += input_count; } /* is_parallel */ read_wide_samples += olen; olen *= effp->in_signal.channels; *osamp = olen; input_eof = olen ? sox_false : sox_true; return olen? SOX_SUCCESS : SOX_EOF; } static int combiner_stop(sox_effect_t *effp) { input_combiner_t * z = (input_combiner_t *) effp->priv; size_t i; if (is_parallel(combine_method)) /* Free input buffers now that they are not used */ for (i = 0; i < input_count; i++) free(z->ibuf[i]); return SOX_SUCCESS; } static sox_effect_handler_t const * input_combiner_effect_fn(void) { static sox_effect_handler_t handler = { "input", 0, SOX_EFF_MCHAN | SOX_EFF_MODIFY, 0, combiner_start, 0, combiner_drain, combiner_stop, 0, sizeof(input_combiner_t) }; return &handler; } static int ostart(sox_effect_t *effp) { unsigned prec = effp->out_signal.precision; if (effp->in_signal.mult && effp->in_signal.precision > prec) *effp->in_signal.mult *= 1 - (1 << (31 - prec)) * (1. / SOX_SAMPLE_MAX); return SOX_SUCCESS; } static int output_flow(sox_effect_t *effp, sox_sample_t const * ibuf, sox_sample_t * obuf, size_t * isamp, size_t * osamp) { size_t len; (void)effp, (void)obuf; if (show_progress) for (len = 0; len < *isamp; len += effp->in_signal.channels) { omax[0] = max(omax[0], ibuf[len]); omin[0] = min(omin[0], ibuf[len]); if (effp->in_signal.channels > 1) { omax[1] = max(omax[1], ibuf[len + 1]); omin[1] = min(omin[1], ibuf[len + 1]); } else { omax[1] = omax[0]; omin[1] = omin[0]; } } *osamp = 0; len = *isamp? sox_write(ofile->ft, ibuf, *isamp) : 0; output_samples += len / ofile->ft->signal.channels; output_eof = (len != *isamp) ? sox_true: sox_false; if (len != *isamp) { if (ofile->ft->sox_errno) lsx_fail("`%s' %s: %s", ofile->ft->filename, ofile->ft->sox_errstr, sox_strerror(ofile->ft->sox_errno)); return SOX_EOF; } return SOX_SUCCESS; } static sox_effect_handler_t const * output_effect_fn(void) { static sox_effect_handler_t handler = {"output", 0, SOX_EFF_MCHAN | SOX_EFF_MODIFY | SOX_EFF_PREC, NULL, ostart, output_flow, NULL, NULL, NULL, 0 }; return &handler; } static void auto_effect(sox_effects_chain_t *, char const *, int, char **, sox_signalinfo_t *, int *); static int add_effect(sox_effects_chain_t * chain, sox_effect_t * effp, sox_signalinfo_t * in, sox_signalinfo_t const * out, int * guard) { int no_guard = -1; switch (*guard) { case 0: if (!(effp->handler.flags & SOX_EFF_GAIN)) { char * arg = "-h"; auto_effect(chain, "gain", 1, &arg, in, &no_guard); ++*guard; } break; case 1: if (effp->handler.flags & SOX_EFF_GAIN) { char * arg = "-r"; auto_effect(chain, "gain", 1, &arg, in, &no_guard); --*guard; } break; case 2: if (!(effp->handler.flags & SOX_EFF_MODIFY)) { lsx_fail("effects that modify audio must not follow dither"); exit(1); } } return sox_add_effect(chain, effp, in, out); } static void auto_effect(sox_effects_chain_t *chain, char const *name, int argc, char *argv[], sox_signalinfo_t *signal, int * guard) { sox_effect_t * effp; effp = sox_create_effect(sox_find_effect(name)); /* Should always succeed. */ if (sox_effect_options(effp, argc, argv) == SOX_EOF) exit(1); /* The failing effect should have displayed an error message */ if (add_effect(chain, effp, signal, &ofile->ft->signal, guard) != SOX_SUCCESS) exit(2); /* The effects chain should have displayed an error message */ } static void init_eff_chains(void) { user_effargs = lsx_malloc(sizeof(user_effargs[0][0]) * MAX_USER_EFF); nuser_effects = lsx_malloc(sizeof(*nuser_effects)); nuser_effects[0] = 0; } /* init_eff_chains */ /* add_eff_chain() - NOTE: this only adds memory for one * additional effects chain beyond value of eff_chain_count. It * does not unconditionally increase size of effects chain. */ static void add_eff_chain(void) { user_effargs = lsx_realloc(user_effargs, (eff_chain_count+1) * sizeof(user_effargs[0][0]) * MAX_USER_EFF); nuser_effects = lsx_realloc(nuser_effects, (eff_chain_count+1) * sizeof(*nuser_effects)); nuser_effects[eff_chain_count] = 0; } /* add_eff_chain */ static void delete_eff_chains(void) { unsigned j; int i, k; for (i = 0; i < eff_chain_count; i++) { for (j = 0; j < nuser_effects[i]; j++) { if (user_effargs[i][j].name) free(user_effargs[i][j].name); user_effargs[i][j].name = NULL; for (k = 0; k < user_effargs[i][j].argc; k++) { if (user_effargs[i][j].argv[k]) free(user_effargs[i][j].argv[k]); user_effargs[i][j].argv[k] = NULL; } user_effargs[i][j].argc = 0; } nuser_effects[i] = 0; } free(user_effargs); free(nuser_effects); user_effargs = NULL; nuser_effects = NULL; eff_chain_count = 0; } /* delete_eff_chains */ static sox_bool is_pseudo_effect(char *s) { if (s) if (strcmp("newfile", s) == 0 || strcmp("restart", s) == 0 || strcmp(":", s) == 0) return sox_true; return sox_false; } /* is_pseudo_effect */ static void parse_effects(int argc, char **argv) { while (lsx_optind < argc) { unsigned eff_offset; int j; int newline_mode = 0; eff_offset = nuser_effects[eff_chain_count]; if (eff_offset >= MAX_USER_EFF) { lsx_fail("too many effects specified (at most %i allowed)", MAX_USER_EFF); exit(1); } /* psuedo-effect ":" is used to create a new effects chain */ if (strcmp(argv[lsx_optind], ":") == 0) { /* Only create a new chain if current one has effects. * Error checking will be done when loop is restarted. */ if (nuser_effects[eff_chain_count] != 0) { eff_chain_count++; add_eff_chain(); } lsx_optind++; continue; } if (strcmp(argv[lsx_optind], "newfile") == 0) { /* Start a new effect chain for newfile if user doesn't * manually do it. Restart loop without advancing * optind to do error checking. */ if (nuser_effects[eff_chain_count] != 0) { eff_chain_count++; add_eff_chain(); continue; } newline_mode = 1; } else if (strcmp(argv[lsx_optind], "restart") == 0) { /* Start a new effect chain for restart if user doesn't * manually do it. Restart loop without advancing * optind to do error checking. */ if (nuser_effects[eff_chain_count] != 0) { eff_chain_count++; add_eff_chain(); continue; } newline_mode = 1; } /* Name should always be correct! */ user_effargs[eff_chain_count][eff_offset].name = strdup(argv[lsx_optind++]); for (j = 0; j < argc - lsx_optind && !sox_find_effect(argv[lsx_optind + j]) && !is_pseudo_effect(argv[lsx_optind + j]); ++j) user_effargs[eff_chain_count][eff_offset].argv[j] = strdup(argv[lsx_optind + j]); user_effargs[eff_chain_count][eff_offset].argc = j; lsx_optind += j; /* Skip past the effect arguments */ nuser_effects[eff_chain_count]++; if (newline_mode) { output_method = sox_multiple; eff_chain_count++; add_eff_chain(); } } } /* parse_effects */ static char * * strtoargv(char * s, int * argc) { sox_bool squote = sox_false; /* Single quote mode (') is in effect. */ sox_bool dquote = sox_false; /* Double quote mode (") is in effect. */ sox_bool esc = sox_false; /* Escape mode (\) is in effect. */ char * t, * * argv = NULL; for (*argc = 0; *s;) { for (; isspace(*s); ++s); /* Skip past any (more) white space. */ if (*s) { /* Found an arg. */ lsx_revalloc(argv, *argc + 1); argv[(*argc)++] = s; /* Store pointer to start of arg. */ /* Find the end of the arg: */ for (t = s; *s && (esc || squote || dquote || !isspace(*s)); ++s) if (!esc && !squote && *s == '"') dquote = !dquote; /* Toggle double quote mode. */ else if (!esc && !dquote && *s == '\'') squote = !squote; /* Toggle single quote mode. */ else if (!(esc = !esc && *s == '\\' && s[1] && (!squote && (s[1] == '"' || !dquote)))) *t++ = *s; /* Only copy if not an active ', ", or \ */ s = *s ? s + 1 : s; /* Skip the 1st white space char. */ *t = '\0'; /* Terminate the arg. */ } } return argv; } /* strtoargv */ static void read_user_effects(char *filename) { FILE *file = fopen(filename, "rt"); char s[FILENAME_MAX]; int argc; char * * argv; int len; /* Free any command line options and then re-initialize to * starter user_effargs. */ delete_eff_chains(); current_eff_chain = 0; init_eff_chains(); if (file == NULL) { lsx_fail("Cannot open effects file `%s'", filename); exit(1); } lsx_report("Reading effects from file `%s'", filename); while (fgets(s, FILENAME_MAX, file)) { len = strlen(s); if (s[len-1] == '\n') s[len-1] = 0; argv = strtoargv(s, &argc); if (argv) { /* Make sure first option is an effect name. */ if (!sox_find_effect(argv[0]) && !is_pseudo_effect(argv[0])) { printf("Cannot find an effect called `%s'.\n", argv[0]); exit(1); } /* parse_effects normally parses options from command line. * Reset opt index so it thinks its back at beginning of * main()'s argv[]. */ lsx_optind = 0; parse_effects(argc, argv); /* Advance to next effect but only if current chain has been * filled in. This recovers from side affects of psuedo-effects. */ if (nuser_effects[eff_chain_count] > 0) { eff_chain_count++; add_eff_chain(); } free(argv); } } fclose(file); } /* read_user_effects */ /* Creates users effects and passes in user specified options. * This is done without putting anything into the effects chain * because an effect may set the effp->in_format and we may want * to copy that back into the input/combiner before opening and * inserting it. * Similarly, we may want to use effp->out_format to override the * default values of output file before we open it. * To keep things simple, we create all user effects. Later, when * we add them, some may already be in the chain and we will need to free * them. */ static void create_user_effects(void) { unsigned i; sox_effect_t *effp; for (i = 0; i < nuser_effects[current_eff_chain]; i++) { effp = sox_create_effect(sox_find_effect(user_effargs[current_eff_chain][i].name)); if (effp->handler.flags & SOX_EFF_DEPRECATED) lsx_warn("effect `%s' is deprecated; see sox(1) for an alternative", effp->handler.name); else if (effp->handler.flags & SOX_EFF_ALPHA) lsx_warn("effect `%s' is experimental/incomplete", effp->handler.name); else if (effp->handler.flags & SOX_EFF_INTERNAL) { lsx_fail("`%s' is a libSoX-only effect", effp->handler.name); exit(1); } /* The failing effect should have displayed an error message */ if (sox_effect_options(effp, user_effargs[current_eff_chain][i].argc, user_effargs[current_eff_chain][i].argv) == SOX_EOF) exit(1); user_efftab[i] = effp; } } /* Add all user effects to the chain. If the output effect's rate or * channel count do not match the end of the effects chain then * insert effects to correct this. * * This can be called with the input effect already in the effects * chain from a previous run. Also, it use a pre-existing * output effect if its been saved into save_output_eff. */ static void add_effects(sox_effects_chain_t *chain) { sox_signalinfo_t signal = combiner_signal; int guard = is_guarded - 1; unsigned i; sox_effect_t * effp; char * rate_arg = is_player ? play_rate_arg ? play_rate_arg : (rate_arg = getenv("PLAY_RATE_ARG")) ? rate_arg : "-l" : NULL; /* 1st `effect' in the chain is the input combiner_signal. * add it only if its not there from a previous run. */ if (chain->length == 0) { effp = sox_create_effect(input_combiner_effect_fn()); sox_add_effect(chain, effp, &signal, &ofile->ft->signal); } /* Add user specified effects; stop before `dither' */ for (i = 0; i < nuser_effects[current_eff_chain] && strcmp(user_efftab[i]->handler.name, "dither"); i++) if (add_effect(chain, user_efftab[i], &signal, &ofile->ft->signal, &guard) != SOX_SUCCESS) exit(2); /* Effects chain should have displayed an error message */ /* Add auto effects if still needed at this point */ if (signal.channels < ofile->ft->signal.channels && signal.rate != ofile->ft->signal.rate) auto_effect(chain, "rate", rate_arg != NULL, &rate_arg, &signal, &guard); if (signal.channels != ofile->ft->signal.channels) auto_effect(chain, "channels", 0, NULL, &signal, &guard); if (signal.rate != ofile->ft->signal.rate) auto_effect(chain, "rate", rate_arg != NULL, &rate_arg, &signal, &guard); if (is_guarded && (do_guarded_norm || !(signal.mult && *signal.mult == 1))) { char * arg = do_guarded_norm? "-nh" : guard? "-rh" : "-h"; int no_guard = -1; auto_effect(chain, "gain", 1, &arg, &signal, &no_guard); guard = 1; } if (i == nuser_effects[current_eff_chain] && !no_dither && signal.precision > ofile->ft->signal.precision && ofile->ft->signal.precision < 24) auto_effect(chain, "dither", 0, NULL, &signal, &guard); /* Add user specified effects from `dither' onwards */ for (; i < nuser_effects[current_eff_chain]; i++, guard = 2) if (add_effect(chain, user_efftab[i], &signal, &ofile->ft->signal, &guard) != SOX_SUCCESS) exit(2); /* Effects chain should have displayed an error message */ if (!save_output_eff) { /* Last `effect' in the chain is the output file */ effp = sox_create_effect(output_effect_fn()); if (sox_add_effect(chain, effp, &signal, &ofile->ft->signal) != SOX_SUCCESS) exit(2); } else { sox_push_effect_last(chain, save_output_eff); save_output_eff = NULL; } for (i = 0; i < chain->length; ++i) { char const * format = sox_globals.verbosity > 3? "effects chain: %-10s %gHz %u channels %u bits %s" : "effects chain: %-10s %gHz %u channels"; sox_effect_t const * effp = &chain->effects[i][0]; lsx_report(format, effp->handler.name, effp->out_signal.rate, effp->out_signal.channels, effp->out_signal.precision, (effp->handler.flags & SOX_EFF_MCHAN)? "(multi)" : ""); } } static int advance_eff_chain(void) { sox_bool reuse_output = sox_true; /* If input file reached EOF then delete all effects in current * chain and restart the current chain. * * This is only used with sox_sequence combine mode even though * we do not specifically check for that method. */ if (input_eof) sox_delete_effects(effects_chain); else { /* If user requested to restart this effect chain then * do not advance to next. Usually, this is because * an option to current effect was changed. */ if (user_restart_eff) user_restart_eff = sox_false; /* Effect chain stopped so advance to next effect chain but * quite if no more chains exist. */ else if (++current_eff_chain >= eff_chain_count) return SOX_EOF; while (nuser_effects[current_eff_chain] == 1 && is_pseudo_effect(user_effargs[current_eff_chain][0].name)) { if (strcmp("newfile", user_effargs[current_eff_chain][0].name) == 0) { if (++current_eff_chain >= eff_chain_count) return SOX_EOF; reuse_output = sox_false; } else if (strcmp("restart", user_effargs[current_eff_chain][0].name) == 0) current_eff_chain = 0; } if (reuse_output) save_output_eff = sox_pop_effect_last(effects_chain); /* TODO: Warn user when an effect is deleted that still * had unprocessed samples. */ while (effects_chain->length > 1) { sox_delete_effect_last(effects_chain); } } return SOX_SUCCESS; } /* advance_eff_chain */ static size_t total_clips(void) { unsigned i; size_t clips = 0; for (i = 0; i < file_count; ++i) clips += files[i]->ft->clips + files[i]->volume_clips; return clips + mixing_clips + sox_effects_clips(effects_chain); } static sox_bool since(struct timeval * then, double secs, sox_bool always_reset) { sox_bool ret; struct timeval now; time_t d; gettimeofday(&now, NULL); d = now.tv_sec - then->tv_sec; ret = d > ceil(secs) || now.tv_usec - then->tv_usec + d * TIME_FRAC >= secs * TIME_FRAC; if (ret || always_reset) *then = now; return ret; } #define MIN_HEADROOM 6. static double min_headroom = MIN_HEADROOM; static char const * vu(unsigned channel) { static struct timeval then; static char const * const text[][2] = { /* White: 2dB steps */ {"", ""}, {"-", "-"}, {"=", "="}, {"-=", "=-"}, {"==", "=="}, {"-==", "==-"}, {"===", "==="}, {"-===", "===-"}, {"====", "===="}, {"-====", "====-"}, {"=====", "====="}, {"-=====", "=====-"}, {"======", "======"}, /* Red: 1dB steps */ {"!=====", "=====!"}, }; int const red = 1, white = array_length(text) - red; double const MAX = SOX_SAMPLE_MAX, MIN = SOX_SAMPLE_MIN; double linear = max(omax[channel] / MAX, omin[channel] / MIN); double dB = linear_to_dB(linear); int vu_dB = linear? floor(2 * white + red + dB) : 0; int index = vu_dB < 2 * white? max(vu_dB / 2, 0) : min(vu_dB - white, red + white - 1); omax[channel] = omin[channel] = 0; if (-dB < min_headroom) { gettimeofday(&then, NULL); min_headroom = -dB; } else if (since(&then, 3., sox_false)) min_headroom = -dB; return text[index][channel]; } static char * headroom(void) { static char buff[10]; unsigned h = (unsigned)(min_headroom * 10); if (min_headroom >= MIN_HEADROOM) return " "; sprintf(buff, "Hd:%u.%u", h /10, h % 10); return buff; } static void display_status(sox_bool all_done) { static struct timeval then; if (!show_progress) return; if (all_done || since(&then, .1, sox_false)) { double read_time = (double)read_wide_samples / combiner_signal.rate; double left_time = 0, in_time = 0, percentage = 0; if (input_wide_samples) { in_time = (double)input_wide_samples / combiner_signal.rate; left_time = max(in_time - read_time, 0); percentage = max(100. * read_wide_samples / input_wide_samples, 0); } fprintf(stderr, "\rIn:%-5s %s [%s] Out:%-5s [%6s|%-6s] %s Clip:%-5s", lsx_sigfigs3p(percentage), str_time(read_time), str_time(left_time), lsx_sigfigs3((double)output_samples), vu(0), vu(1), headroom(), lsx_sigfigs3((double)total_clips())); } if (all_done) fputc('\n', stderr); } #ifdef HAVE_TERMIOS_H static int kbhit(void) { struct timeval time_val = {0, 0}; fd_set fdset; FD_ZERO(&fdset); FD_SET(fileno(stdin), &fdset); select(fileno(stdin) + 1, &fdset, NULL, NULL, &time_val); return FD_ISSET(fileno(stdin), &fdset); } #elif !defined(HAVE_CONIO_H) #define kbhit() 0 #endif #ifdef HAVE_SOUNDCARD_H #include <sys/ioctl.h> static void adjust_volume(int delta) { char * from_env = getenv("MIXERDEV"); int vol1 = 0, vol2 = 0, fd = open(from_env? from_env : "/dev/mixer", O_RDWR); if (fd >= 0) { if (ioctl(fd, MIXER_READ(SOUND_MIXER_PCM), &vol1) != -1) { int side1 = vol1 & 0xff, side2 = (vol1 >> 8) & 0xff; delta = delta < 0? max(delta, -min(side1, side2)) : min(delta, 100 - max(side1, side2)); vol2 = ((side2 + delta) << 8) + side1 + delta; lsx_debug("%04x %04x", vol1, vol2); if (vol1 != vol2 && ioctl(fd, MIXER_WRITE(SOUND_MIXER_PCM), &vol2) < 0) vol2 = vol1; } close(fd); } if (vol1 == vol2) putc('\a', stderr); } #elif defined(HAVE_AUDIOIO_H) static void adjust_volume(int delta) { int vol1 = 0, vol2 = 0, fd = fileno(ofile->ft->fp); if (fd >= 0) { audio_info_t audio_info; if (ioctl(fd, AUDIO_GETINFO, &audio_info) >= 0) { vol1 = (audio_info.play.gain * 100 + (AUDIO_MAX_GAIN >> 1)) / AUDIO_MAX_GAIN; vol2 = range_limit(vol1 + delta, 0, 100); AUDIO_INITINFO(&audio_info); audio_info.play.gain = (vol2 * AUDIO_MAX_GAIN + 50) / 100; audio_info.output_muted = 0; lsx_debug("%04x %04x", vol1, vol2); if (vol1 != vol2 && ioctl(fd, AUDIO_SETINFO, &audio_info) < 0) vol2 = vol1; } } if (vol1 == vol2) putc('\a', stderr); } #else static void adjust_volume(int delta) { (void)delta; putc('\a', stderr); } #endif static int update_status(sox_bool all_done, void * client_data) { (void)client_data; if (interactive) while (kbhit()) { #ifdef HAVE_CONIO_H int ch = _getch(); #else int ch = getchar(); #endif #ifdef MORE_INTERACTIVE if (files[current_input]->ft->handler.seek && files[current_input]->ft->seekable) { if (ch == '>') { read_wide_samples += files[current_input]->ft->signal.rate*30; sox_seek(files[current_input]->ft, read_wide_samples, SOX_SEEK_SET); } if (ch == '<') { read_wide_samples -= files[current_input]->ft->signal.rate*30; sox_seek(files[current_input]->ft, read_wide_samples, SOX_SEEK_SET); } if (ch == 'R') { /* Not very useful, eh! Sample though of the place you * could change the value to effects options * like vol or speed or mixer. * Modify values in user_effargs[current_eff_chain][xxx] * and then chain will be drain()ed and restarted whence * this function is existed. */ user_restart_eff = sox_true; } } #endif switch (ch) { case 'V': adjust_volume(+7); break; case 'v': adjust_volume(-7); break; } } display_status(all_done || user_abort); return (user_abort || user_restart_eff) ? SOX_EOF : SOX_SUCCESS; } static void optimize_trim(void) { /* Speed hack. If the "trim" effect is the first effect then peek inside its * "effect descriptor" and see what the start location is. This has to be * done after its start() is called to have the correct location. Also, only * do this when only working with one input file. This is because the logic * to do it for multiple files is complex and problably never used. This * hack is a huge time savings when trimming gigs of audio data into * managable chunks. */ if (input_count == 1 && effects_chain->length > 1 && strcmp(effects_chain->effects[1][0].handler.name, "trim") == 0) { if (files[0]->ft->handler.seek && files[0]->ft->seekable){ uint64_t offset = sox_trim_get_start(&effects_chain->effects[1][0]); if (offset && sox_seek(files[0]->ft, offset, SOX_SEEK_SET) == SOX_SUCCESS) { read_wide_samples = offset / files[0]->ft->signal.channels; /* Assuming a failed seek stayed where it was. If the seek worked then * reset the start location of trim so that it thinks user didn't * request a skip. */ sox_trim_clear_start(&effects_chain->effects[1][0]); lsx_debug("optimize_trim successful"); } } } else if (input_count == 1 && effects_chain->length > 1 && strcmp(effects_chain->effects[1][0].handler.name, "crop") == 0) { if (files[0]->ft->handler.seek && files[0]->ft->seekable){ uint64_t offset = sox_crop_get_start(&effects_chain->effects[1][0]); if (offset && sox_seek(files[0]->ft, offset, SOX_SEEK_SET) == SOX_SUCCESS) { read_wide_samples = offset / files[0]->ft->signal.channels; /* Assuming a failed seek stayed where it was. If the seek worked then * reset the start location of crop so that it thinks user didn't * request a skip. */ sox_crop_clear_start(&effects_chain->effects[1][0]); lsx_debug("optimize_crop successful"); } } } } static sox_bool overwrite_permitted(char const * filename) { char c; if (!no_clobber) { lsx_report("Overwriting `%s'", filename); return sox_true; } lsx_warn("Output file `%s' already exists", filename); if (!stdin_is_a_tty) return sox_false; do fprintf(stderr, "%s sox: overwrite `%s' (y/n)? ", myname, filename); while (scanf(" %c%*[^\n]", &c) != 1 || !strchr("yYnN", c)); return c == 'y' || c == 'Y'; } static char *fndup_with_count(const char *filename, size_t count) { char *expand_fn, *efn; const char *fn, *ext, *end; sox_bool found_marker = sox_false; fn = filename; efn = expand_fn = lsx_malloc((size_t)FILENAME_MAX); /* Find extension in case user didn't specify a substitution * marker. */ end = ext = filename + strlen(filename); while (ext > filename && *ext != '.') ext--; /* In case extension not found, point back to end of string to do less * copying later. */ if (*ext != '.') ext = end; while (fn < end) { /* Look for %n. If found, replace with count. Can specify an * option width of 1-9. */ if (*fn == '%') { char width = 0; fn++; if (*fn >= '1' && *fn <= '9') { width = *fn++; } if (*fn == 'n') { char format[5]; found_marker = sox_true; if (width) { sprintf(format, "%%0%cd", width); } else { strcpy(format, "%02d"); } efn += sprintf(efn, format, count); fn++; } else *efn++ = *fn++; } else *efn++ = *fn++; } *efn = 0; /* If user didn't tell us what to do then default to putting * the count right before file extension. */ if (!found_marker) { efn -= strlen (ext); sprintf(efn, "%03lu", (unsigned long)count); efn = efn + 3; strcat(efn, ext); } return expand_fn; } static void open_output_file(void) { double factor; int i; sox_comments_t p = ofile->oob.comments; sox_oob_t oob = files[0]->ft->oob; char *expand_fn; /* Skip opening file if we are not recreating output effect */ if (save_output_eff) return; oob.comments = sox_copy_comments(files[0]->ft->oob.comments); if (!oob.comments && !p) sox_append_comment(&oob.comments, "Processed by SoX"); else if (p) { if (!(*p)[0]) { sox_delete_comments(&oob.comments); ++p; } while (*p) sox_append_comment(&oob.comments, *p++); } /* Copy loop info, resizing appropriately it's in samples, so # channels * don't matter FIXME: This doesn't work for multi-file processing or effects * that change file length. */ factor = (double) ofile->signal.rate / combiner_signal.rate; for (i = 0; i < SOX_MAX_NLOOPS; i++) { oob.loops[i].start = oob.loops[i].start * factor; oob.loops[i].length = oob.loops[i].length * factor; } if (output_method == sox_multiple) expand_fn = fndup_with_count(ofile->filename, ++output_count); else expand_fn = strdup(ofile->filename); ofile->ft = sox_open_write(expand_fn, &ofile->signal, &ofile->encoding, ofile->filetype, &oob, overwrite_permitted); sox_delete_comments(&oob.comments); free(expand_fn); if (!ofile->ft) /* sox_open_write() will call lsx_warn for most errors. * Rely on that printing something. */ exit(2); /* If whether to enable the progress display (similar to that of ogg123) has * not been specified by the user, auto turn on when outputting to an audio * device: */ if (show_progress == SOX_OPTION_DEFAULT) show_progress = (ofile->ft->handler.flags & SOX_FILE_DEVICE) != 0 && (ofile->ft->handler.flags & SOX_FILE_PHONY) == 0; report_file_info(ofile); } static void sigint(int s) { static struct timeval then; if (input_count > 1 && show_progress && s == SIGINT && is_serial(combine_method) && since(&then, 1.0, sox_true)) { signal(SIGINT, sigint); user_skip = sox_true; } else user_abort = sox_true; } static void calculate_combiner_signal_parameters(void) { size_t i; /* If user didn't specify # of channels then see if an effect * is specifying them. This is of most use currently with the * synth effect were user can use null input handler and specify * channel counts directly in effect. Forcing to use -c with * -n isn't as convenient. */ for (i = 0; i < input_count; i++) { unsigned j; for (j =0; j < nuser_effects[current_eff_chain] && !files[i]->ft->signal.channels; ++j) files[i]->ft->signal.channels = user_efftab[j]->in_signal.channels; /* For historical reasons, default to one channel if not specified. */ if (!files[i]->ft->signal.channels) files[i]->ft->signal.channels = 1; } /* Set the combiner output signal attributes to those of the 1st/next input * file. If we are in sox_sequence mode then we don't need to check the * attributes of the other inputs, otherwise, it is mandatory that all input * files have the same sample rate, and for sox_concatenate, it is mandatory * that they have the same number of channels, otherwise, the number of * channels at the output of the combiner is calculated according to the * combiner mode. */ combiner_signal = files[current_input]->ft->signal; if (combine_method == sox_sequence) { /* Report all input files; do this only the 1st time process() is called: */ if (!current_input) for (i = 0; i < input_count; i++) report_file_info(files[i]); } else { size_t total_channels = 0; size_t min_channels = SOX_SIZE_MAX; size_t max_channels = 0; size_t min_rate = SOX_SIZE_MAX; size_t max_rate = 0; /* Report all input files and gather info on differing rates & numbers of * channels, and on the resulting output audio length: */ for (i = 0; i < input_count; i++) { report_file_info(files[i]); total_channels += files[i]->ft->signal.channels; min_channels = min(min_channels, files[i]->ft->signal.channels); max_channels = max(max_channels, files[i]->ft->signal.channels); min_rate = min(min_rate , files[i]->ft->signal.rate); max_rate = max(max_rate , files[i]->ft->signal.rate); } /* Check for invalid/unusual rate or channel combinations: */ if (min_rate != max_rate) lsx_fail("Input files must have the same sample-rate"); /* Don't exit quite yet; give the user any other message 1st */ if (min_channels != max_channels) { if (combine_method == sox_concatenate) { lsx_fail("Input files must have the same # channels"); exit(1); } else if (combine_method != sox_merge) lsx_warn("Input files don't have the same # channels"); } if (min_rate != max_rate) exit(1); /* Store the calculated # of combined channels: */ combiner_signal.channels = combine_method == sox_merge? total_channels : max_channels; } } /* calculate_combiner_signal_parameters */ static void calculate_output_signal_parameters(void) { sox_bool known_length = combine_method != sox_sequence; size_t i, olen = 0; /* Report all input files and gather info on differing rates & numbers of * channels, and on the resulting output audio length: */ for (i = 0; i < input_count; i++) { known_length = known_length && files[i]->ft->signal.length != 0; if (combine_method == sox_concatenate) olen += files[i]->ft->signal.length / files[i]->ft->signal.channels; else olen = max(olen, files[i]->ft->signal.length / files[i]->ft->signal.channels); } /* Determine the output file signal attributes; set from user options * if given: */ ofile->signal = ofile_signal_options; /* If no user option for output rate or # of channels, set from the last * effect that sets these, or from the input combiner if there is none such */ for (i = 0; i < nuser_effects[current_eff_chain] && !ofile->signal.rate; ++i) ofile->signal.rate = user_efftab[nuser_effects[current_eff_chain] - 1 - i]->out_signal.rate; for (i = 0; i < nuser_effects[current_eff_chain] && !ofile->signal.channels; ++i) ofile->signal.channels = user_efftab[nuser_effects[current_eff_chain] - 1 - i]->out_signal.channels; if (!ofile->signal.rate) ofile->signal.rate = combiner_signal.rate; if (!ofile->signal.channels) ofile->signal.channels = combiner_signal.channels; /* FIXME: comment this: */ ofile->signal.precision = combiner_signal.precision; /* If any given user effect modifies the audio length, then we assume that * we don't know what the output length will be. FIXME: in most cases, * an effect that modifies length will be able to determine by how much from * its getopts parameters, so olen should be calculable. */ for (i = 0; i < nuser_effects[current_eff_chain]; i++) known_length = known_length && !(user_efftab[i]->handler.flags & SOX_EFF_LENGTH); if (!known_length) olen = 0; ofile->signal.length = (size_t)(olen * ofile->signal.channels * ofile->signal.rate / combiner_signal.rate + .5); } static void set_combiner_and_output_encoding_parameters(void) { /* The input encoding parameters passed to the effects chain are those of * the first input file (for each segued block if sox_sequence):*/ combiner_encoding = files[current_input]->ft->encoding; /* Determine the output file encoding attributes; set from user options * if given: */ ofile->encoding = ofile_encoding_options; /* Get unspecified output file encoding attributes from the input file and * set the output file to the resultant encoding if this is supported by the * output file type; if not, the output file handler should select an * encoding suitable for the output signal and its precision. */ { sox_encodinginfo_t t = ofile->encoding; if (!t.encoding) t.encoding = combiner_encoding.encoding; if (!t.bits_per_sample) t.bits_per_sample = combiner_encoding.bits_per_sample; if (sox_format_supports_encoding(ofile->filename, ofile->filetype, &t)) ofile->encoding = t; } } static int process(void) { /* Input(s) -> Balancing -> Combiner -> Effects -> Output */ int flow_status; create_user_effects(); calculate_combiner_signal_parameters(); set_combiner_and_output_encoding_parameters(); calculate_output_signal_parameters(); open_output_file(); if (!effects_chain) effects_chain = sox_create_effects_chain(&combiner_encoding, &ofile->ft->encoding); add_effects(effects_chain); optimize_trim(); #if defined(HAVE_TERMIOS_H) || defined(HAVE_CONIO_H) /* so we can be fully interactive. */ if (show_progress && !interactive && is_player && stdin_is_a_tty) { #ifdef HAVE_TERMIOS_H struct termios modified_termios; tcgetattr(fileno(stdin), &original_termios); modified_termios = original_termios; modified_termios.c_lflag &= ~(ICANON | ECHO); modified_termios.c_cc[VMIN] = modified_termios.c_cc[VTIME] = 0; tcsetattr(fileno(stdin), TCSANOW, &modified_termios); #endif interactive = sox_true; } #endif signal(SIGTERM, sigint); /* Stop gracefully, as soon as we possibly can. */ signal(SIGINT , sigint); /* Either skip current input or behave as SIGTERM. */ flow_status = sox_flow_effects(effects_chain, update_status, NULL); /* Don't return SOX_EOF if * 1) input reach EOF and there are more input files to process or * 2) output didn't return EOF (disk full?) there are more * effect chains. * For case #2, something else must decide when to stop processing. */ if ((input_eof && current_input < input_count) || (!output_eof && current_eff_chain < eff_chain_count)) flow_status = SOX_SUCCESS; return flow_status; } static void display_SoX_version(FILE * file) { #if HAVE_SYS_UTSNAME_H struct utsname uts; #endif fprintf(file, "%s: SoX v%s\n", myname, PACKAGE_VERSION); if (sox_globals.verbosity > 3) { fprintf(file, "time: %s %s\n", __DATE__, __TIME__); #if HAVE_DISTRO fprintf(file, "issue: %s\n", DISTRO); #endif #if HAVE_SYS_UTSNAME_H if (!uname(&uts)) fprintf(file, "uname: %s %s %s %s %s\n", uts.sysname, uts.nodename, uts.release, uts.version, uts.machine); #endif #if defined __GNUC__ fprintf(file, "gcc: %s\n", __VERSION__); #elif defined _MSC_VER fprintf(file, "msc: %u\n", _MSC_VER); #elif defined __SUNPRO_C fprintf(file, "sun c: %x\n", __SUNPRO_C); #endif fprintf(file, "arch: %lu%lu%lu%lu %lu%lu %lu%lu %c %s\n", (unsigned long)sizeof(char), (unsigned long)sizeof(short), (unsigned long)sizeof(long), (unsigned long)sizeof(off_t), (unsigned long)sizeof(float), (unsigned long)sizeof(double), (unsigned long)sizeof(int *), (unsigned long)sizeof(int (*)(void)), "LB"[MACHINE_IS_BIGENDIAN], #ifdef HAVE_OPENMP "OMP" #else "" #endif ); } } static int strcmp_p(const void *p1, const void *p2) { return strcmp(*(const char **)p1, *(const char **)p2); } static void display_supported_formats(void) { size_t i, formats; char const * * format_list; char const * const * names; sox_format_init(); for (i = formats = 0; sox_format_fns[i].fn; ++i) { char const * const *names = sox_format_fns[i].fn()->names; while (*names++) formats++; } format_list = lsx_malloc(formats * sizeof(*format_list)); printf("AUDIO FILE FORMATS:"); for (i = formats = 0; sox_format_fns[i].fn; ++i) { sox_format_handler_t const * handler = sox_format_fns[i].fn(); if (!(handler->flags & SOX_FILE_DEVICE)) for (names = handler->names; *names; ++names) if (!strchr(*names, '/')) format_list[formats++] = *names; } qsort((void*)format_list, formats, sizeof(*format_list), strcmp_p); for (i = 0; i < formats; i++) printf(" %s", format_list[i]); putchar('\n'); printf("PLAYLIST FORMATS: m3u pls\nAUDIO DEVICE DRIVERS:"); for (i = formats = 0; sox_format_fns[i].fn; ++i) { sox_format_handler_t const * handler = sox_format_fns[i].fn(); if ((handler->flags & SOX_FILE_DEVICE) && !(handler->flags & SOX_FILE_PHONY)) for (names = handler->names; *names; ++names) format_list[formats++] = *names; } qsort((void*)format_list, formats, sizeof(*format_list), strcmp_p); for (i = 0; i < formats; i++) printf(" %s", format_list[i]); puts("\n"); free((void*)format_list); } static void display_supported_effects(void) { size_t i; const sox_effect_handler_t *e; printf("EFFECTS:"); for (i = 0; sox_effect_fns[i]; i++) { e = sox_effect_fns[i](); if (e && e->name) printf(" %s%s", e->name, (e->flags & SOX_EFF_DEPRECATED)? "*" : (e->flags & SOX_EFF_ALPHA)? "+" : (e->flags & SOX_EFF_INTERNAL)? "#" : ""); } puts("\n * Deprecated effect + Experimental effect # LibSoX-only effect"); } static void usage(char const * message) { size_t i; static char const * const lines[] = { "SPECIAL FILENAMES (infile, outfile):", "- Pipe/redirect input/output (stdin/stdout); may need -t", "-d, --default-device Use the default audio device (where available)", "-n, --null Use the `null' file handler; e.g. with synth effect", "-p, --sox-pipe Alias for `-t sox -'", #ifdef HAVE_POPEN "\nSPECIAL FILENAMES (infile only):", "\"|program [options] ...\" Pipe input from external program (where supported)", "http://server/file Use the given URL as input file (where supported)", #endif "", "GLOBAL OPTIONS (gopts) (can be specified at any point before the first effect):", "--buffer BYTES Set the size of all processing buffers (default 8192)", "--clobber Don't prompt to overwrite output file (default)", "--combine concatenate Concatenate all input files (default for sox, rec)", "--combine sequence Sequence all input files (default for play)", "-D, --no-dither Don't dither automatically", "--effects-file FILENAME File containing effects and options", "-G, --guard Use temporary files to guard against clipping", "-h, --help Display version number and usage information", "--help-effect NAME Show usage of effect NAME, or NAME=all for all", "--help-format NAME Show info on format NAME, or NAME=all for all", "--i, --info Behave as soxi(1)", "--input-buffer BYTES Override the input buffer size (default: as --buffer)", "--no-clobber Prompt to overwrite output file", "-m, --combine mix Mix multiple input files (instead of concatenating)", "-M, --combine merge Merge multiple input files (instead of concatenating)", "--magic Use `magic' file-type detection", "--multi-threaded Enable parallel effects channels processing (where", " available)", "--norm Guard (see --guard) & normalise", "--play-rate-arg ARG Default `rate' argument for auto-resample with `play'", "--plot gnuplot|octave Generate script to plot response of filter effect", "-q, --no-show-progress Run in quiet mode; opposite of -S", "--replay-gain track|album|off Default: off (sox, rec), track (play)", "-R Use default random numbers (same on each run of SoX)", "-S, --show-progress Display progress while processing audio data", "--single-threaded Disable parallel effects channels processing", "--temp DIRECTORY Specify the directory to use for temporary files", "--version Display version number of SoX and exit", "-V[LEVEL] Increment or set verbosity level (default 2); levels:", " 1: failure messages", " 2: warnings", " 3: details of processing", " 4-6: increasing levels of debug messages", "FORMAT OPTIONS (fopts):", "Input file format options need only be supplied for files that are headerless.", "Output files will have the same format as the input file where possible and not", "overriden by any of various means including providing output format options.", "", "-v|--volume FACTOR Input file volume adjustment factor (real number)", "--ignore-length Ignore input file length given in header; read to EOF", "-t|--type FILETYPE File type of audio", "-s/-u/-f/-U/-A/-i/-a/-g Encoding type=signed-integer/unsigned-integer/floating", " point/mu-law/a-law/ima-adpcm/ms-adpcm/gsm-full-rate", "-e|--encoding ENCODING Set encoding (ENCODING in above list)", "-b|--bits BITS Encoded sample size in bits", "-1/-2/-3/-4/-8 Encoded sample size in bytes", "-N|--reverse-nibbles Encoded nibble-order", "-X|--reverse-bits Encoded bit-order", "--endian little|big|swap Encoded byte-order; swap means opposite to default", "-L/-B/-x Short options for the above", "-c|--channels CHANNELS Number of channels of audio data; e.g. 2 = stereo", "-r|--rate RATE Sample rate of audio", "-C|--compression FACTOR Compression factor for output format", "--add-comment TEXT Append output file comment", "--comment TEXT Specify comment text for the output file", "--comment-file FILENAME File containing comment text for the output file", "--no-glob Don't `glob' wildcard match the following filename", ""}; if (!(sox_globals.verbosity > 2)) { display_SoX_version(stdout); putchar('\n'); } if (message) lsx_fail("%s\n", message); /* N.B. stderr */ printf("Usage summary: [gopts] [[fopts] infile]... [fopts]%s [effect [effopt]]...\n\n", sox_mode == sox_play? "" : " outfile"); for (i = 0; i < array_length(lines); ++i) puts(lines[i]); display_supported_formats(); display_supported_effects(); printf("EFFECT OPTIONS (effopts): effect dependent; see --help-effect\n"); exit(message != NULL); } static void usage_effect(char const * name) { int i; display_SoX_version(stdout); putchar('\n'); if (strcmp("all", name) && !sox_find_effect(name)) { printf("Cannot find an effect called `%s'.\n", name); display_supported_effects(); } else { printf("Effect usage:\n\n"); for (i = 0; sox_effect_fns[i]; i++) { const sox_effect_handler_t *e = sox_effect_fns[i](); if (e && e->name && (!strcmp("all", name) || !strcmp(e->name, name))) { printf("%s %s\n", e->name, e->usage? e->usage : ""); if (e->flags & (SOX_EFF_DEPRECATED | SOX_EFF_ALPHA | SOX_EFF_INTERNAL)) putchar('\n'); if (e->flags & SOX_EFF_DEPRECATED) printf("`%s' is deprecated\n", e->name); if (e->flags & SOX_EFF_ALPHA) printf("`%s' is experimental/incomplete\n", e->name); if (e->flags & SOX_EFF_INTERNAL) printf("`%s' is libSoX-only\n", e->name); printf("\n\n"); } } } exit(1); } static void usage_format1(sox_format_handler_t const * f) { char const * const * names; printf("\nFormat: %s\n", f->names[0]); printf("Description: %s\n", f->description); if (f->names[1]) { printf("Also handles:"); for (names = f->names + 1; *names; ++names) printf(" %s", *names); putchar('\n'); } if (f->flags & SOX_FILE_CHANS) { printf("Channels restricted to:"); if (f->flags & SOX_FILE_MONO) printf(" mono"); if (f->flags & SOX_FILE_STEREO) printf(" stereo"); if (f->flags & SOX_FILE_QUAD) printf(" quad"); putchar('\n'); } if (f->write_rates) { sox_rate_t const * p = f->write_rates; printf("Sample-rate restricted to:"); while (*p) printf(" %g", *p++); putchar('\n'); } printf("Reads: %s\n", f->startread || f->read? "yes" : "no"); if (f->startwrite || f->write) { if (f->write_formats) { sox_encoding_t e; unsigned i, s; #define enc_arg(T) (T)f->write_formats[i++] i = 0; puts("Writes:"); while ((e = enc_arg(sox_encoding_t))) do { s = enc_arg(unsigned); if (sox_precision(e, s)) { printf(" "); if (s) printf("%2u-bit ", s); printf("%s (%u-bit precision)\n", sox_encodings_info[e].desc, sox_precision(e, s)); } } while (s); } else puts("Writes: yes"); } else puts("Writes: no"); } static void usage_format(char const * name) { sox_format_handler_t const * f; unsigned i; display_SoX_version(stdout); if (strcmp("all", name)) { if (!(f = sox_find_format(name, sox_false))) { printf("Cannot find a format called `%s'.\n", name); display_supported_formats(); } else usage_format1(f); } else { for (i = 0; sox_format_fns[i].fn; ++i) { sox_format_handler_t const * f = sox_format_fns[i].fn(); if (!(f->flags & SOX_FILE_PHONY)) usage_format1(f); } } exit(1); } static void read_comment_file(sox_comments_t * comments, char const * const filename) { int c; size_t text_length = 100; char * text = lsx_malloc(text_length + 1); FILE * file = fopen(filename, "rt"); if (file == NULL) { lsx_fail("Cannot open comment file `%s'", filename); exit(1); } do { size_t i = 0; while ((c = getc(file)) != EOF && !strchr("\r\n", c)) { if (i == text_length) text = lsx_realloc(text, (text_length <<= 1) + 1); text[i++] = c; } if (ferror(file)) { lsx_fail("Error reading comment file `%s'", filename); exit(1); } if (i) { text[i] = '\0'; sox_append_comment(comments, text); } } while (c != EOF); fclose(file); free(text); } static char const * const getoptstr = "+ab:c:de:fghimnopqr:st:uv:xABC:DGLMNRSTUV::X12348"; static struct option const long_options[] = { {"add-comment" , required_argument, NULL, 0}, {"buffer" , required_argument, NULL, 0}, {"combine" , required_argument, NULL, 0}, {"comment-file" , required_argument, NULL, 0}, {"comment" , required_argument, NULL, 0}, {"endian" , required_argument, NULL, 0}, {"input-buffer" , required_argument, NULL, 0}, {"interactive" , no_argument, NULL, 0}, {"help-effect" , required_argument, NULL, 0}, {"help-format" , required_argument, NULL, 0}, {"no-glob" , no_argument, NULL, 0}, {"plot" , required_argument, NULL, 0}, {"replay-gain" , required_argument, NULL, 0}, {"version" , no_argument, NULL, 0}, {"output" , required_argument, NULL, 0}, {"effects-file" , required_argument, NULL, 0}, {"temp" , required_argument, NULL, 0}, {"single-threaded" , no_argument, NULL, 0}, {"ignore-length" , no_argument, NULL, 0}, {"norm" , no_argument, NULL, 0}, {"magic" , no_argument, NULL, 0}, {"play-rate-arg" , required_argument, NULL, 0}, {"clobber" , no_argument, NULL, 0}, {"no-clobber" , no_argument, NULL, 0}, {"multi-threaded" , no_argument, NULL, 0}, {"bits" , required_argument, NULL, 'b'}, {"channels" , required_argument, NULL, 'c'}, {"compression" , required_argument, NULL, 'C'}, {"default-device" , no_argument, NULL, 'd'}, {"no-dither" , no_argument, NULL, 'D'}, {"encoding" , required_argument, NULL, 'e'}, {"help" , no_argument, NULL, 'h'}, {"null" , no_argument, NULL, 'n'}, {"no-show-progress", no_argument, NULL, 'q'}, {"pipe" , no_argument, NULL, 'p'}, {"rate" , required_argument, NULL, 'r'}, {"reverse-bits" , no_argument, NULL, 'X'}, {"reverse-nibbles" , no_argument, NULL, 'N'}, {"show-progress" , no_argument, NULL, 'S'}, {"type" , required_argument, NULL, 't'}, {"volume" , required_argument, NULL, 'v'}, {"guard" , no_argument, NULL, 'G'}, {NULL, 0, NULL, 0} }; static int opt_index(int val) { int i; for (i = 0; long_options[i].name; ++i) if (long_options[i].val == val) return i; return -1; } static lsx_enum_item const combine_methods[] = { LSX_ENUM_ITEM(sox_,sequence) LSX_ENUM_ITEM(sox_,concatenate) LSX_ENUM_ITEM(sox_,mix) {"mix-power", sox_mix_power}, LSX_ENUM_ITEM(sox_,merge) LSX_ENUM_ITEM(sox_,multiply) {0, 0}}; enum {ENDIAN_little, ENDIAN_big, ENDIAN_swap}; static lsx_enum_item const endian_options[] = { LSX_ENUM_ITEM(ENDIAN_,little) LSX_ENUM_ITEM(ENDIAN_,big) LSX_ENUM_ITEM(ENDIAN_,swap) {0, 0}}; static lsx_enum_item const plot_methods[] = { LSX_ENUM_ITEM(sox_plot_,off) LSX_ENUM_ITEM(sox_plot_,octave) LSX_ENUM_ITEM(sox_plot_,gnuplot) LSX_ENUM_ITEM(sox_plot_,data) {0, 0}}; enum { encoding_signed_integer, encoding_unsigned_integer, encoding_floating_point, encoding_ms_adpcm, encoding_ima_adpcm, encoding_oki_adpcm, encoding_gsm_full_rate, encoding_u_law, encoding_a_law}; static lsx_enum_item const encodings[] = { {"signed-integer", encoding_signed_integer}, {"unsigned-integer", encoding_unsigned_integer}, {"floating-point", encoding_floating_point}, {"ms-adpcm", encoding_ms_adpcm}, {"ima-adpcm", encoding_ima_adpcm}, {"oki-adpcm", encoding_oki_adpcm}, {"gsm-full-rate", encoding_gsm_full_rate}, {"u-law", encoding_u_law}, {"mu-law", encoding_u_law}, {"a-law", encoding_a_law}, {0, 0}}; static int enum_option(int option_index, lsx_enum_item const * items) { lsx_enum_item const * p = lsx_find_enum_text(lsx_optarg, items, 0); if (p == NULL) { size_t len = 1; char * set = lsx_malloc(len); *set = 0; for (p = items; p->text; ++p) { set = lsx_realloc(set, len += 2 + strlen(p->text)); strcat(set, ", "); strcat(set, p->text); } lsx_fail("--%s: `%s' is not one of: %s.", long_options[option_index].name, lsx_optarg, set + 2); free(set); exit(1); } return p->value; } static char parse_gopts_and_fopts(file_t * f, int argc, char **argv) { while (sox_true) { int c, option_index; int i; /* sscanf silently accepts negative numbers for %u :( */ char dummy; /* To check for extraneous chars in optarg. */ switch (c=lsx_getopt_long(argc, argv, getoptstr, long_options, &option_index)) { case -1: /* @ one of: file-name, effect name, end of arg-list. */ return '\0'; /* i.e. not device. */ case 0: /* Long options with no short equivalent. */ switch (option_index) { case 0: if (lsx_optarg) sox_append_comment(&f->oob.comments, lsx_optarg); break; case 1: #define SOX_BUFMIN 16 if (sscanf(lsx_optarg, "%i %c", &i, &dummy) != 1 || i <= SOX_BUFMIN) { lsx_fail("Buffer size `%s' must be > %d", lsx_optarg, SOX_BUFMIN); exit(1); } sox_globals.bufsiz = i; break; case 2: combine_method = enum_option(option_index, combine_methods); break; case 3: sox_append_comment(&f->oob.comments, ""); read_comment_file(&f->oob.comments, lsx_optarg); break; case 4: sox_append_comment(&f->oob.comments, ""); if (*lsx_optarg) sox_append_comment(&f->oob.comments, lsx_optarg); break; case 5: if (f->encoding.reverse_bytes != SOX_OPTION_DEFAULT || f->encoding.opposite_endian) usage("only one endian option per file is allowed"); switch (enum_option(option_index, endian_options)) { case ENDIAN_little: f->encoding.reverse_bytes = MACHINE_IS_BIGENDIAN; break; case ENDIAN_big: f->encoding.reverse_bytes = MACHINE_IS_LITTLEENDIAN; break; case ENDIAN_swap: f->encoding.opposite_endian = sox_true; break; } break; case 6: if (sscanf(lsx_optarg, "%i %c", &i, &dummy) != 1 || i <= SOX_BUFMIN) { lsx_fail("Buffer size `%s' must be > %d", lsx_optarg, SOX_BUFMIN); exit(1); } sox_globals.input_bufsiz = i; break; case 7: no_clobber = sox_true; break; case 8: usage_effect(lsx_optarg); break; case 9: usage_format(lsx_optarg); break; case 10: f->no_glob = sox_true; break; case 11: sox_effects_globals.plot = enum_option(option_index, plot_methods); break; case 12: replay_gain_mode = enum_option(option_index, rg_modes); break; case 13: display_SoX_version(stdout); exit(0); break; case 14: break; case 15: effects_filename = strdup(lsx_optarg); break; case 16: sox_globals.tmp_path = strdup(lsx_optarg); break; case 17: single_threaded = sox_true; break; case 18: f->signal.length = SOX_IGNORE_LENGTH; break; case 19: do_guarded_norm = is_guarded = sox_true; break; #if HAVE_MAGIC case 20: sox_globals.use_magic = sox_true; break; #else case 20: lsx_warn("this build of SoX does not include `magic'"); break; #endif case 21: play_rate_arg = strdup(lsx_optarg); break; case 22: no_clobber = sox_false; break; case 23: no_clobber = sox_true; break; case 24: single_threaded = sox_false; break; } break; case 'G': is_guarded = sox_true; break; case 'm': combine_method = sox_mix; break; case 'M': combine_method = sox_merge; break; case 'T': combine_method = sox_multiply; break; case 'R': /* Useful for regression testing. */ sox_globals.repeatable = sox_true; break; case 'd': case 'n': case 'p': return c; break; case 'h': usage(NULL); break; case '?': usage("invalid option"); /* No return */ break; case 't': f->filetype = lsx_optarg; if (f->filetype[0] == '.') f->filetype++; break; case 'r': { char k = 0; size_t n = sscanf(lsx_optarg, "%lf %c %c", &f->signal.rate, &k, &dummy); if (n < 1 || f->signal.rate <= 0 || (n > 1 && k != 'k') || n > 2) { lsx_fail("Rate value `%s' is not a positive number", lsx_optarg); exit(1); } f->signal.rate *= k == 'k'? 1000. : 1.; break; } case 'v': if (sscanf(lsx_optarg, "%lf %c", &f->volume, &dummy) != 1) { lsx_fail("Volume value `%s' is not a number", lsx_optarg); exit(1); } uservolume = sox_true; if (f->volume < 0.0) lsx_report("Volume adjustment is negative; " "this will result in a phase change"); break; case 'c': if (sscanf(lsx_optarg, "%d %c", &i, &dummy) != 1 || i <= 0) { lsx_fail("Channels value `%s' is not a positive integer", lsx_optarg); exit(1); } f->signal.channels = i; break; case 'C': if (sscanf(lsx_optarg, "%lf %c", &f->encoding.compression, &dummy) != 1) { lsx_fail("Compression value `%s' is not a number", lsx_optarg); exit(1); } break; case 'b': if (sscanf(lsx_optarg, "%d %c", &i, &dummy) != 1 || i <= 0) { lsx_fail("Bits value `%s' is not a positive integer", lsx_optarg); exit(1); } f->encoding.bits_per_sample = i; break; case 'e': switch (enum_option(opt_index('e'), encodings)) { case encoding_signed_integer: f->encoding.encoding = SOX_ENCODING_SIGN2; break; case encoding_unsigned_integer: f->encoding.encoding = SOX_ENCODING_UNSIGNED; break; case encoding_floating_point: f->encoding.encoding = SOX_ENCODING_FLOAT; break; case encoding_ms_adpcm: f->encoding.encoding = SOX_ENCODING_MS_ADPCM; break; case encoding_ima_adpcm: f->encoding.encoding = SOX_ENCODING_IMA_ADPCM; break; case encoding_oki_adpcm: f->encoding.encoding = SOX_ENCODING_OKI_ADPCM; break; case encoding_gsm_full_rate: f->encoding.encoding = SOX_ENCODING_GSM; break; case encoding_u_law: f->encoding.encoding = SOX_ENCODING_ULAW; if (f->encoding.bits_per_sample == 0) f->encoding.bits_per_sample = 8; break; case encoding_a_law: f->encoding.encoding = SOX_ENCODING_ALAW; if (f->encoding.bits_per_sample == 0) f->encoding.bits_per_sample = 8; break; } break; case '1': f->encoding.bits_per_sample = 8; break; case '2': f->encoding.bits_per_sample = 16; break; case '3': f->encoding.bits_per_sample = 24; break; case '4': f->encoding.bits_per_sample = 32; break; case '8': f->encoding.bits_per_sample = 64; break; case 's': f->encoding.encoding = SOX_ENCODING_SIGN2; break; case 'u': f->encoding.encoding = SOX_ENCODING_UNSIGNED; break; case 'f': f->encoding.encoding = SOX_ENCODING_FLOAT; break; case 'a': f->encoding.encoding = SOX_ENCODING_MS_ADPCM; break; case 'i': f->encoding.encoding = SOX_ENCODING_IMA_ADPCM; break; case 'o': f->encoding.encoding = SOX_ENCODING_OKI_ADPCM; break; case 'g': f->encoding.encoding = SOX_ENCODING_GSM; break; case 'U': f->encoding.encoding = SOX_ENCODING_ULAW; if (f->encoding.bits_per_sample == 0) f->encoding.bits_per_sample = 8; break; case 'A': f->encoding.encoding = SOX_ENCODING_ALAW; if (f->encoding.bits_per_sample == 0) f->encoding.bits_per_sample = 8; break; case 'L': case 'B': case 'x': if (f->encoding.reverse_bytes != SOX_OPTION_DEFAULT || f->encoding.opposite_endian) usage("only one endian option per file is allowed"); switch (c) { case 'L': f->encoding.reverse_bytes = MACHINE_IS_BIGENDIAN; break; case 'B': f->encoding.reverse_bytes = MACHINE_IS_LITTLEENDIAN; break; case 'x': f->encoding.opposite_endian = sox_true; break; } break; case 'X': f->encoding.reverse_bits = SOX_OPTION_YES; break; case 'N': f->encoding.reverse_nibbles = SOX_OPTION_YES; break; case 'S': show_progress = SOX_OPTION_YES; break; case 'q': show_progress = SOX_OPTION_NO; break; case 'D': no_dither = sox_true; break; case 'V': if (lsx_optarg == NULL) ++sox_globals.verbosity; else { if (sscanf(lsx_optarg, "%d %c", &i, &dummy) != 1 || i < 0) { sox_globals.verbosity = 2; lsx_fail("Verbosity value `%s' is not a non-negative integer", lsx_optarg); exit(1); } sox_globals.verbosity = (unsigned)i; } break; } } } static char const * device_name(char const * const type) { char * name = NULL, * from_env = getenv("AUDIODEV"); if (!type) return NULL; if (!strcmp(type, "sunau")) name = "/dev/audio"; else if (!strcmp(type, "oss" ) || !strcmp(type, "ossdsp")) name = "/dev/dsp"; else if (!strcmp(type, "alsa") || !strcmp(type, "ao") || !strcmp(type,"sndio") || !strcmp(type, "coreaudio") || !strcmp(type, "pulseaudio") || !strcmp(type, "waveaudio")) name = "default"; return name? from_env? from_env : name : NULL; } static char const * set_default_device(file_t * f) { /* Default audio driver type in order of preference: */ if (!f->filetype) f->filetype = getenv("AUDIODRIVER"); if (!f->filetype && sox_find_format("coreaudio", sox_false)) f->filetype = "coreaudio"; if (!f->filetype && sox_find_format("alsa", sox_false)) f->filetype = "alsa"; if (!f->filetype && sox_find_format("waveaudio" , sox_false)) f->filetype = "waveaudio"; if (!f->filetype && sox_find_format("sndio", sox_false)) f->filetype = "sndio"; if (!f->filetype && sox_find_format("oss" , sox_false)) f->filetype = "oss"; if (!f->filetype && sox_find_format("pulseaudio" , sox_false)) f->filetype = "pulseaudio"; if (!f->filetype && sox_find_format("sunau",sox_false)) f->filetype = "sunau"; if (!f->filetype && sox_find_format("ao" , sox_false) && file_count) /*!rec*/ f->filetype = "ao"; if (!f->filetype) { lsx_fail("Sorry, there is no default audio device configured"); exit(1); } return device_name(f->filetype); } static int add_file(file_t const * const opts, char const * const filename) { file_t * f = lsx_malloc(sizeof(*f)); *f = *opts; if (!filename) usage("missing filename"); /* No return */ f->filename = lsx_strdup(filename); files = lsx_realloc(files, (file_count + 1) * sizeof(*files)); files[file_count++] = f; return 0; } #if HAVE_GLOB_H #ifndef GLOB_BRACE #define GLOB_BRACE 0 #endif #ifndef GLOB_TILDE #define GLOB_TILDE 0 #endif static int add_glob_file(file_t const * const opts, char const * const filename) { glob_t globbuf; size_t i; if (opts->no_glob) return add_file(opts, filename); if (glob(filename, GLOB_BRACE | GLOB_TILDE | GLOB_NOCHECK, NULL, &globbuf)) { lsx_fail("glob: %s", strerror(errno)); exit(1); } for (i = 0; i < globbuf.gl_pathc; ++i) add_file(opts, globbuf.gl_pathv[i]); globfree(&globbuf); return 0; } #else #define add_glob_file add_file #endif static void init_file(file_t * f) { memset(f, 0, sizeof(*f)); sox_init_encodinginfo(&f->encoding); f->volume = HUGE_VAL; f->replay_gain = HUGE_VAL; } static void parse_options_and_filenames(int argc, char **argv) { char const * env_opts = getenv(SOX_OPTS); file_t opts, opts_none; init_file(&opts), init_file(&opts_none); if (sox_mode == sox_rec) add_file(&opts, set_default_device(&opts)), init_file(&opts); if (env_opts && *env_opts) { char * * argv2, * str = lsx_malloc(strlen(argv[0]) + strlen(env_opts) + 2); int argc2; strcpy(str, argv[0]); strcat(str, " "); strcat(str, env_opts); argv2 = strtoargv(str, &argc2); if (parse_gopts_and_fopts(&opts, argc2, argv2)) { lsx_fail("invalid option for "SOX_OPTS); exit(1); } lsx_optind = 1, opterr = 0; free(str); free(argv2); } for (; lsx_optind < argc && !sox_find_effect(argv[lsx_optind]); init_file(&opts)) { char c = parse_gopts_and_fopts(&opts, argc, argv); if (c == 'n') { /* is null file? */ if (opts.filetype != NULL && strcmp(opts.filetype, "null") != 0) lsx_warn("ignoring `-t %s'.", opts.filetype); opts.filetype = "null"; add_file(&opts, ""); } else if (c == 'd') /* is default device? */ add_file(&opts, set_default_device(&opts)); else if (c == 'p') { /* is sox pipe? */ if (opts.filetype != NULL && strcmp(opts.filetype, "sox") != 0) lsx_warn("ignoring `-t %s'.", opts.filetype); opts.filetype = "sox"; add_file(&opts, "-"); } else if (lsx_optind >= argc || sox_find_effect(argv[lsx_optind])) break; else if (!sox_is_playlist(argv[lsx_optind])) add_glob_file(&opts, argv[lsx_optind++]); else if (sox_parse_playlist((sox_playlist_callback_t)add_file, &opts, argv[lsx_optind++]) != SOX_SUCCESS) exit(1); } if (env_opts && *env_opts) { lsx_report("using "SOX_OPTS"=%s", env_opts); reported_sox_opts = sox_true; } if (sox_mode == sox_play) add_file(&opts, set_default_device(&opts)); else if (memcmp(&opts, &opts_none, sizeof(opts))) /* fopts but no file */ add_file(&opts, device_name(opts.filetype)); } static double soxi_total; static size_t soxi_file_count; typedef enum {Full, Type, Rate, Channels, Samples, Duration, Duration_secs, Bits, Bitrate, Encoding, Annotation} soxi_t; static int soxi1(soxi_t const * type, char * filename) { sox_format_t * ft = sox_open_read(filename, NULL, NULL, NULL); double secs; size_t ws; char const * text = NULL; if (!ft) return 1; ws = ft->signal.length / max(ft->signal.channels, 1); secs = (double)ws / max(ft->signal.rate, 1); ++soxi_file_count; if (soxi_total >= 0 && !ws) soxi_total = -2; if (soxi_total >= 0) soxi_total += *type == Samples? ws : secs; switch (*type) { case Type: printf("%s\n", ft->filetype); break; case Rate: printf("%g\n", ft->signal.rate); break; case Channels: printf("%u\n", ft->signal.channels); break; case Samples: if (soxi_total ==-1) printf("%lu\n",(unsigned long)ws); break; case Duration: if (soxi_total ==-1) printf("%s\n", str_time(secs)); break; case Duration_secs: if (soxi_total ==-1) printf("%f\n", secs); break; case Bits: printf("%u\n", ft->encoding.bits_per_sample); break; case Bitrate: size_and_bitrate(ft, &text); puts(text? text : "0"); break; case Encoding: printf("%s\n", sox_encodings_info[ft->encoding.encoding].desc); break; case Annotation: if (ft->oob.comments) { sox_comments_t p = ft->oob.comments; do printf("%s\n", *p); while (*++p); } break; case Full: display_file_info(ft, NULL, sox_false); break; } return !!sox_close(ft); } static void soxi_usage(int return_code) { display_SoX_version(stdout); printf( "\n" "Usage: soxi [-V[level]] [-T] [-t|-r|-c|-s|-d|-D|-b|-B|-e|-a] infile1 ...\n" "\n" "-V[n]\tIncrement or set verbosity level (default is 2)\n" "-T\tWith -s, -d or -D, display the total across all given files\n" "\n" "-t\tShow detected file-type\n" "-r\tShow sample-rate\n" "-c\tShow number of channels\n" ); printf( "-s\tShow number of samples (0 if unavailable)\n" "-d\tShow duration in hours, minutes and seconds (0 if unavailable)\n" "-D\tShow duration in seconds (0 if unavailable)\n" "-b\tShow number of bits per sample\n" "-B\tShow the bitrate averaged over the whole file (0 if unavailable)\n" "-e\tShow the name of the audio encoding\n" "-a\tShow file comments (annotations) if available\n" "\n" "With no options, as much information as is available is shown for\n" "each given file.\n" ); exit(return_code); } static int soxi(int argc, char * const * argv) { static char const opts[] = "trcsdDbBea?TV::"; soxi_t type = Full; int opt, num_errors = 0; sox_bool do_total = sox_false; if (argc < 2) soxi_usage(0); while ((opt = lsx_getopt(argc, argv, opts)) > 0) /* act only on last option */ if (opt == 'V') { int i; /* sscanf silently accepts negative numbers for %u :( */ char dummy; /* To check for extraneous chars in optarg. */ if (lsx_optarg == NULL) ++sox_globals.verbosity; else { if (sscanf(lsx_optarg, "%d %c", &i, &dummy) != 1 || i < 0) { sox_globals.verbosity = 2; lsx_fail("Verbosity value `%s' is not a non-negative integer", lsx_optarg); exit(1); } sox_globals.verbosity = (unsigned)i; } } else if (opt == 'T') do_total = sox_true; else if ((type = 1 + (strchr(opts, opt) - opts)) > Annotation) soxi_usage(1); if (type == Full) do_total = sox_true; else if (do_total && (type < Samples || type > Duration_secs)) { fprintf(stderr, "soxi: ignoring -T; n/a with other given option"); do_total = sox_false; } soxi_total = -!do_total; for (; lsx_optind < argc; ++lsx_optind) { if (sox_is_playlist(argv[lsx_optind])) num_errors += (sox_parse_playlist((sox_playlist_callback_t)soxi1, &type, argv[lsx_optind]) != SOX_SUCCESS); else num_errors += soxi1(&type, argv[lsx_optind]); } if (type == Full) { if (soxi_file_count > 1 && soxi_total > 0) printf("Total Duration of %u files: %s\n", (unsigned)soxi_file_count, str_time(soxi_total)); } else if (do_total) { if (soxi_total < 0) puts("0"); else if (type == Duration) printf("%s\n", str_time(soxi_total)); else printf("%f\n", soxi_total); } return num_errors; } static void set_replay_gain(sox_comments_t comments, file_t * f) { rg_mode rg = replay_gain_mode; int try = 2; /* Will try to find the other GAIN if preferred one not found */ size_t i, n = sox_num_comments(comments); if (rg != RG_off) while (try--) { char const * target = rg == RG_track? "REPLAYGAIN_TRACK_GAIN=" : "REPLAYGAIN_ALBUM_GAIN="; for (i = 0; i < n; ++i) { if (strncasecmp(comments[i], target, strlen(target)) == 0) { f->replay_gain = atof(comments[i] + strlen(target)); f->replay_gain_mode = rg; return; } } rg ^= RG_track ^ RG_album; } } static void output_message(unsigned level, const char *filename, const char *fmt, va_list ap) { char const * const str[] = {"FAIL", "WARN", "INFO", "DBUG"}; if (sox_globals.verbosity >= level) { fprintf(stderr, "%s %s ", myname, str[min(level - 1, 3)]); sox_output_message(stderr, filename, fmt, ap); fprintf(stderr, "\n"); } } static sox_bool cmp_comment_text(char const * c1, char const * c2) { return c1 && c2 && !strcasecmp(c1, c2); } #if defined(__CYGWIN__) || defined(__MINGW32__) static char * check_dir(char * name) { struct stat st; return !name || stat(name, &st) || (st.st_mode & S_IFMT) != S_IFDIR? NULL : name; } #endif int main(int argc, char **argv) { size_t i; myname = argv[0]; sox_globals.output_message_handler = output_message; if (lsx_strends(myname, "play")) sox_mode = sox_play; else if (lsx_strends(myname, "rec")) sox_mode = sox_rec; else if (lsx_strends(myname, "soxi")) sox_mode = sox_soxi; if (!sox_mode && argc > 1 && (!strcmp(argv[1], "--i") || !strcmp(argv[1], "--info"))) --argc, ++argv, sox_mode = sox_soxi; if (sox_init() != SOX_SUCCESS) exit(1); stdin_is_a_tty = isatty(fileno(stdin)); errno = 0; /* Both isatty & fileno may set errno. */ atexit(cleanup); if (sox_mode == sox_soxi) exit(soxi(argc, argv)); parse_options_and_filenames(argc, argv); #if defined(__CYGWIN__) || defined(__MINGW32__) /* Workarounds for a couple of cygwin/mingw problems: */ /* Allow command-line --temp "" to specify default behaviour: */ if (sox_globals.tmp_path && !*sox_globals.tmp_path) { free(sox_globals.tmp_path); sox_globals.tmp_path = NULL; } else if (!sox_globals.tmp_path) { /* cygwin tmpfile does not use std. windows env. vars, so we do here: */ if (!(sox_globals.tmp_path = check_dir(getenv("TEMP")))) if (!(sox_globals.tmp_path = check_dir(getenv("TMP")))) /* Std. values for T(E)MP don't work in cygwin shell so try these: */ if (!(sox_globals.tmp_path = check_dir("/tmp"))) sox_globals.tmp_path = "."; sox_globals.tmp_path = lsx_strdup(sox_globals.tmp_path); } #endif #ifdef HAVE_OPENMP if (single_threaded) omp_set_num_threads(1); #endif if (sox_globals.verbosity > 2) display_SoX_version(stderr); input_count = file_count ? file_count - 1 : 0; if (file_count) { sox_format_handler_t const * handler = sox_write_handler(ofile->filename, ofile->filetype, NULL); is_player = handler && (handler->flags & SOX_FILE_DEVICE) && !(handler->flags & SOX_FILE_PHONY); } if (combine_method == sox_default) combine_method = is_player? sox_sequence : sox_concatenate; /* Allow e.g. known length processing in this case */ if (combine_method == sox_sequence && input_count == 1) combine_method = sox_concatenate; /* Make sure we got at least the required # of input filenames */ if (input_count < (size_t)(is_serial(combine_method) ? 1 : 2)) usage("Not enough input filenames specified"); /* Check for misplaced input/output-specific options */ for (i = 0; i < input_count; ++i) { if (files[i]->encoding.compression != HUGE_VAL) usage("A compression factor can be given only for an output file"); if (files[i]->oob.comments != NULL) usage("Comments can be given only for an output file"); } if (ofile->volume != HUGE_VAL) usage("-v can be given only for an input file;\n" "\tuse the `gain' or `vol' effect to set the output file volume"); if (ofile->signal.length != SOX_UNSPEC) usage("--ignore-length can be given only for an input file"); signal(SIGINT, SIG_IGN); /* So child pipes aren't killed by track skip */ for (i = 0; i < input_count; i++) { int j = input_count - 1 - i; /* Open in reverse order 'cos of rec (below) */ file_t * f = files[j]; /* When mixing audio, default to input side volume adjustments that will * make sure no clipping will occur. Users probably won't be happy with * this, and will override it, possibly causing clipping to occur. */ if (combine_method == sox_mix && !uservolume) f->volume = 1.0 / input_count; else if (combine_method == sox_mix_power && !uservolume) f->volume = 1.0 / sqrt((double)input_count); if (sox_mode == sox_rec && !j) { /* Set the recording parameters: */ if (input_count > 1) { /* from the (just openned) next */ f->signal = files[1]->ft->signal; /* input file, or from the output */ f->encoding = files[1]->ft->encoding; } else { f->signal = files[1]->signal; /* file (which is not open yet). */ f->encoding = files[1]->encoding; } } files[j]->ft = sox_open_read(f->filename, &f->signal, &f->encoding, f->filetype); if (!files[j]->ft) /* sox_open_read() will call lsx_warn for most errors. * Rely on that printing something. */ exit(2); if (show_progress == SOX_OPTION_DEFAULT && (files[j]->ft->handler.flags & SOX_FILE_DEVICE) != 0 && (files[j]->ft->handler.flags & SOX_FILE_PHONY) == 0) show_progress = SOX_OPTION_YES; } if (replay_gain_mode == RG_default) replay_gain_mode = is_player? input_count > 1 && /* Simple heuristic to determine if */ cmp_comment_text( /* replay-gain should be in album mode */ sox_find_comment(files[0]->ft->oob.comments, "artist"), sox_find_comment(files[1]->ft->oob.comments, "artist")) && cmp_comment_text( sox_find_comment(files[0]->ft->oob.comments, "album"), sox_find_comment(files[1]->ft->oob.comments, "album"))? RG_album : RG_track : RG_off; for (i = 0; i < input_count; i++) set_replay_gain(files[i]->ft->oob.comments, files[i]); signal(SIGINT, SIG_DFL); init_eff_chains(); /* Loop through the rest of the arguments looking for effects */ parse_effects(argc, argv); if (eff_chain_count == 0 || nuser_effects[eff_chain_count] > 0) { eff_chain_count++; /* Note: Purposely not calling add_eff_chain() to save some * memory although it would be more consistent to do so. */ } /* Not the best way for users to do this; now deprecated in favour of soxi. */ if (!show_progress && !nuser_effects[current_eff_chain] && ofile->filetype && !strcmp(ofile->filetype, "null")) { for (i = 0; i < input_count; i++) report_file_info(files[i]); exit(0); } if (!sox_globals.repeatable) {/* Re-seed PRNG? */ struct timeval now; gettimeofday(&now, NULL); sox_globals.ranqd1 = (int32_t)(now.tv_sec - now.tv_usec); } /* Save things that sox_sequence needs to be reinitialised for each segued * block of input files.*/ ofile_signal_options = ofile->signal; ofile_encoding_options = ofile->encoding; /* If user specified an effects filename then use that file * to load user effects. Free any previously specified options * from the command line. */ if (effects_filename) { read_user_effects(effects_filename); } while (process() != SOX_EOF && !user_abort && current_input < input_count) { if (advance_eff_chain() == SOX_EOF) break; if (!save_output_eff) { sox_close(ofile->ft); ofile->ft = NULL; } } sox_delete_effects_chain(effects_chain); delete_eff_chains(); for (i = 0; i < file_count; ++i) if (files[i]->ft->clips != 0) lsx_warn(i < input_count?"`%s' input clipped %lu samples" : "`%s' output clipped %lu samples; decrease volume?", (files[i]->ft->handler.flags & SOX_FILE_DEVICE)? files[i]->ft->handler.names[0] : files[i]->ft->filename, (unsigned long)files[i]->ft->clips); if (mixing_clips > 0) lsx_warn("mix-combining clipped %lu samples; decrease volume?", (unsigned long)mixing_clips); for (i = 0; i < file_count; i++) if (files[i]->volume_clips > 0) lsx_warn("`%s' balancing clipped %lu samples; decrease volume?", files[i]->filename, (unsigned long)files[i]->volume_clips); if (show_progress) { if (user_abort) fprintf(stderr, "Aborted.\n"); else if (user_skip && sox_mode != sox_rec) fprintf(stderr, "Skipped.\n"); else fprintf(stderr, "Done.\n"); } success = 1; /* Signal success to cleanup so the output file isn't removed. */ return 0; }