src/metaflac/operations.c

   1 /* metaflac - Command-line FLAC metadata editor
   2  * Copyright (C) 2001,2002  Josh Coalson
   3  *
   4  * This program is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU General Public License
   6  * as published by the Free Software Foundation; either version 2
   7  * of the License, or (at your option) any later version.
   8  *
   9  * This program is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  * GNU General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU General Public License
  15  * along with this program; if not, write to the Free Software
  16  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  17  */
  18
  19 #include "operations.h"
  20 #include "usage.h"
  21 #include "utils.h"
  22 #include "FLAC/assert.h"
  23 #include "FLAC/metadata.h"
  24 #include "share/grabbag.h"
  25 #include <stdio.h>
  26 #include <stdlib.h>
  27 #include <string.h>
  28
  29 static void show_version();
  30 static FLAC__bool do_major_operation(const CommandLineOptions *options);
  31 static FLAC__bool do_major_operation_on_file(const char *filename, const CommandLineOptions *options);
  32 static FLAC__bool do_major_operation__list(const char *filename, FLAC__Metadata_Chain *chain, const CommandLineOptions *options);
  33 static FLAC__bool do_major_operation__append(FLAC__Metadata_Chain *chain, const CommandLineOptions *options);
  34 static FLAC__bool do_major_operation__remove(FLAC__Metadata_Chain *chain, const CommandLineOptions *options);
  35 static FLAC__bool do_major_operation__remove_all(FLAC__Metadata_Chain *chain, const CommandLineOptions *options);
  36 static FLAC__bool do_shorthand_operations(const CommandLineOptions *options);
  37 static FLAC__bool do_shorthand_operations_on_file(const char *filename, const CommandLineOptions *options);
  38 static FLAC__bool do_shorthand_operation(const char *filename, FLAC__bool prefix_with_filename, FLAC__Metadata_Chain *chain, const Operation *operation, FLAC__bool *needs_write, FLAC__bool utf8_convert);
  39 static FLAC__bool do_shorthand_operation__add_replay_gain(char **filenames, unsigned num_files, FLAC__bool preserve_modtime);
  40 static FLAC__bool do_shorthand_operation__add_padding(const char *filename, FLAC__Metadata_Chain *chain, unsigned length, FLAC__bool *needs_write);
  41
  42 static FLAC__bool passes_filter(const CommandLineOptions *options, const FLAC__StreamMetadata *block, unsigned block_number);
  43 static void write_metadata(const char *filename, FLAC__StreamMetadata *block, unsigned block_number, FLAC__bool raw, FLAC__bool hexdump_application);
  44
  45 /* from operations_shorthand_seektable.c */
  46 extern FLAC__bool do_shorthand_operation__add_seekpoints(const char *filename, FLAC__Metadata_Chain *chain, const char *specification, FLAC__bool *needs_write);
  47
  48 /* from operations_shorthand_streaminfo.c */
  49 extern FLAC__bool do_shorthand_operation__streaminfo(const char *filename, FLAC__bool prefix_with_filename, FLAC__Metadata_Chain *chain, const Operation *operation, FLAC__bool *needs_write);
  50
  51 /* from operations_shorthand_vorbiscomment.c */
  52 extern FLAC__bool do_shorthand_operation__vorbis_comment(const char *filename, FLAC__bool prefix_with_filename, FLAC__Metadata_Chain *chain, const Operation *operation, FLAC__bool *needs_write, FLAC__bool raw);
  53
  54 /* from operations_shorthand_cuesheet.c */
  55 extern FLAC__bool do_shorthand_operation__cuesheet(const char *filename, FLAC__Metadata_Chain *chain, const Operation *operation, FLAC__bool *needs_write, FLAC__bool cued_seekpoints);
  56
  57
  58 FLAC__bool do_operations(const CommandLineOptions *options)
  59 {
  60         FLAC__bool ok = true;
  61
  62         if(options->show_long_help) {
  63                 long_usage(0);
  64         }
  65         if(options->show_version) {
  66                 show_version();
  67         }
  68         else if(options->args.checks.num_major_ops > 0) {
  69                 FLAC__ASSERT(options->args.checks.num_shorthand_ops == 0);
  70                 FLAC__ASSERT(options->args.checks.num_major_ops == 1);
  71                 FLAC__ASSERT(options->args.checks.num_major_ops == options->ops.num_operations);
  72                 ok = do_major_operation(options);
  73         }
  74         else if(options->args.checks.num_shorthand_ops > 0) {
  75                 FLAC__ASSERT(options->args.checks.num_shorthand_ops == options->ops.num_operations);
  76                 ok = do_shorthand_operations(options);
  77         }
  78
  79         return ok;
  80 }
  81
  82 /*
  83  * local routines
  84  */
  85
  86 void show_version()
  87 {
  88         printf("metaflac %s\n", FLAC__VERSION_STRING);
  89 }
  90
  91 FLAC__bool do_major_operation(const CommandLineOptions *options)
  92 {
  93         unsigned i;
  94         FLAC__bool ok = true;
  95
  96         /*@@@ to die after first error,  v---  add '&& ok' here */
  97         for(i = 0; i < options->num_files; i++)
  98                 ok &= do_major_operation_on_file(options->filenames[i], options);
  99
 100         return ok;
 101 }
 102
 103 FLAC__bool do_major_operation_on_file(const char *filename, const CommandLineOptions *options)
 104 {
 105         FLAC__bool ok = true, needs_write = false;
 106         FLAC__Metadata_Chain *chain = FLAC__metadata_chain_new();
 107
 108         if(0 == chain)
 109                 die("out of memory allocating chain");
 110
 111         if(!FLAC__metadata_chain_read(chain, filename)) {
 112                 fprintf(stderr, "%s: ERROR: reading metadata, status = \"%s\"\n", filename, FLAC__Metadata_ChainStatusString[FLAC__metadata_chain_status(chain)]);
 113                 return false;
 114         }
 115
 116         switch(options->ops.operations[0].type) {
 117                 case OP__LIST:
 118                         ok = do_major_operation__list(options->prefix_with_filename? filename : 0, chain, options);
 119                         break;
 120                 case OP__APPEND:
 121                         ok = do_major_operation__append(chain, options);
 122                         needs_write = true;
 123                         break;
 124                 case OP__REMOVE:
 125                         ok = do_major_operation__remove(chain, options);
 126                         needs_write = true;
 127                         break;
 128                 case OP__REMOVE_ALL:
 129                         ok = do_major_operation__remove_all(chain, options);
 130                         needs_write = true;
 131                         break;
 132                 case OP__MERGE_PADDING:
 133                         FLAC__metadata_chain_merge_padding(chain);
 134                         needs_write = true;
 135                         break;
 136                 case OP__SORT_PADDING:
 137                         FLAC__metadata_chain_sort_padding(chain);
 138                         needs_write = true;
 139                         break;
 140                 default:
 141                         FLAC__ASSERT(0);
 142                         return false;
 143         }
 144
 145         if(ok && needs_write) {
 146                 if(options->use_padding)
 147                         FLAC__metadata_chain_sort_padding(chain);
 148                 ok = FLAC__metadata_chain_write(chain, options->use_padding, options->preserve_modtime);
 149                 if(!ok)
 150                         fprintf(stderr, "%s: ERROR: writing FLAC file, error = %s\n", filename, FLAC__Metadata_ChainStatusString[FLAC__metadata_chain_status(chain)]);
 151         }
 152
 153         FLAC__metadata_chain_delete(chain);
 154
 155         return ok;
 156 }
 157
 158 FLAC__bool do_major_operation__list(const char *filename, FLAC__Metadata_Chain *chain, const CommandLineOptions *options)
 159 {
 160         FLAC__Metadata_Iterator *iterator = FLAC__metadata_iterator_new();
 161         FLAC__StreamMetadata *block;
 162         FLAC__bool ok = true;
 163         unsigned block_number;
 164
 165         if(0 == iterator)
 166                 die("out of memory allocating iterator");
 167
 168         FLAC__metadata_iterator_init(iterator, chain);
 169
 170         block_number = 0;
 171         do {
 172                 block = FLAC__metadata_iterator_get_block(iterator);
 173                 ok &= (0 != block);
 174                 if(!ok)
 175                         fprintf(stderr, "%s: ERROR: couldn't get block from chain\n", filename);
 176                 else if(passes_filter(options, FLAC__metadata_iterator_get_block(iterator), block_number))
 177                         write_metadata(filename, block, block_number, !options->utf8_convert, options->application_data_format_is_hexdump);
 178                 block_number++;
 179         } while(ok && FLAC__metadata_iterator_next(iterator));
 180
 181         FLAC__metadata_iterator_delete(iterator);
 182
 183         return ok;
 184 }
 185
 186 FLAC__bool do_major_operation__append(FLAC__Metadata_Chain *chain, const CommandLineOptions *options)
 187 {
 188         (void) chain, (void) options;
 189         fprintf(stderr, "ERROR: --append not implemented yet\n"); /*@@@*/
 190         return false;
 191 }
 192
 193 FLAC__bool do_major_operation__remove(FLAC__Metadata_Chain *chain, const CommandLineOptions *options)
 194 {
 195         FLAC__Metadata_Iterator *iterator = FLAC__metadata_iterator_new();
 196         FLAC__bool ok = true;
 197         unsigned block_number;
 198
 199         if(0 == iterator)
 200                 die("out of memory allocating iterator");
 201
 202         FLAC__metadata_iterator_init(iterator, chain);
 203
 204         block_number = 0;
 205         while(ok && FLAC__metadata_iterator_next(iterator)) {
 206                 block_number++;
 207                 if(passes_filter(options, FLAC__metadata_iterator_get_block(iterator), block_number)) {
 208                         ok &= FLAC__metadata_iterator_delete_block(iterator, options->use_padding);
 209                         if(options->use_padding)
 210                                 ok &= FLAC__metadata_iterator_next(iterator);
 211                 }
 212         }
 213
 214         FLAC__metadata_iterator_delete(iterator);
 215
 216         return ok;
 217 }
 218
 219 FLAC__bool do_major_operation__remove_all(FLAC__Metadata_Chain *chain, const CommandLineOptions *options)
 220 {
 221         FLAC__Metadata_Iterator *iterator = FLAC__metadata_iterator_new();
 222         FLAC__bool ok = true;
 223
 224         if(0 == iterator)
 225                 die("out of memory allocating iterator");
 226
 227         FLAC__metadata_iterator_init(iterator, chain);
 228
 229         while(ok && FLAC__metadata_iterator_next(iterator)) {
 230                 ok &= FLAC__metadata_iterator_delete_block(iterator, options->use_padding);
 231                 if(options->use_padding)
 232                         ok &= FLAC__metadata_iterator_next(iterator);
 233         }
 234
 235         FLAC__metadata_iterator_delete(iterator);
 236
 237         return ok;
 238 }
 239
 240 FLAC__bool do_shorthand_operations(const CommandLineOptions *options)
 241 {
 242         unsigned i;
 243         FLAC__bool ok = true;
 244
 245         /* to die after first error,     v---  add '&& ok' here */
 246         for(i = 0; i < options->num_files; i++)
 247                 ok &= do_shorthand_operations_on_file(options->filenames[i], options);
 248
 249         /* check if OP__ADD_REPLAY_GAIN requested */
 250         if(ok && options->num_files > 0) {
 251                 for(i = 0; i < options->ops.num_operations; i++) {
 252                         if(options->ops.operations[i].type == OP__ADD_REPLAY_GAIN)
 253                                 ok = do_shorthand_operation__add_replay_gain(options->filenames, options->num_files, options->preserve_modtime);
 254                 }
 255         }
 256
 257         return ok;
 258 }
 259
 260 FLAC__bool do_shorthand_operations_on_file(const char *filename, const CommandLineOptions *options)
 261 {
 262         unsigned i;
 263         FLAC__bool ok = true, needs_write = false, use_padding = options->use_padding;
 264         FLAC__Metadata_Chain *chain = FLAC__metadata_chain_new();
 265
 266         if(0 == chain)
 267                 die("out of memory allocating chain");
 268
 269         if(!FLAC__metadata_chain_read(chain, filename)) {
 270                 fprintf(stderr, "%s: ERROR: reading metadata, status = \"%s\"\n", filename, FLAC__Metadata_ChainStatusString[FLAC__metadata_chain_status(chain)]);
 271                 return false;
 272         }
 273
 274         for(i = 0; i < options->ops.num_operations && ok; i++) {
 275                 ok &= do_shorthand_operation(filename, options->prefix_with_filename, chain, &options->ops.operations[i], &needs_write, options->utf8_convert);
 276
 277                 /* The following seems counterintuitive but the meaning
 278                  * of 'use_padding' is 'try to keep the overall metadata
 279                  * to its original size, adding or truncating extra
 280                  * padding if necessary' which is why we need to turn it
 281                  * off in this case.  If we don't, the extra padding block
 282                  * will just be truncated.
 283                  */
 284                 if(options->ops.operations[i].type == OP__ADD_PADDING)
 285                         use_padding = false;
 286         }
 287
 288         if(ok && needs_write) {
 289                 if(use_padding)
 290                         FLAC__metadata_chain_sort_padding(chain);
 291                 ok = FLAC__metadata_chain_write(chain, use_padding, options->preserve_modtime);
 292                 if(!ok)
 293                         fprintf(stderr, "%s: ERROR: writing FLAC file, error = %s\n", filename, FLAC__Metadata_ChainStatusString[FLAC__metadata_chain_status(chain)]);
 294         }
 295
 296         FLAC__metadata_chain_delete(chain);
 297
 298         return ok;
 299 }
 300
 301 FLAC__bool do_shorthand_operation(const char *filename, FLAC__bool prefix_with_filename, FLAC__Metadata_Chain *chain, const Operation *operation, FLAC__bool *needs_write, FLAC__bool utf8_convert)
 302 {
 303         FLAC__bool ok = true;
 304
 305         switch(operation->type) {
 306                 case OP__SHOW_MD5SUM:
 307                 case OP__SHOW_MIN_BLOCKSIZE:
 308                 case OP__SHOW_MAX_BLOCKSIZE:
 309                 case OP__SHOW_MIN_FRAMESIZE:
 310                 case OP__SHOW_MAX_FRAMESIZE:
 311                 case OP__SHOW_SAMPLE_RATE:
 312                 case OP__SHOW_CHANNELS:
 313                 case OP__SHOW_BPS:
 314                 case OP__SHOW_TOTAL_SAMPLES:
 315                 case OP__SET_MD5SUM:
 316                 case OP__SET_MIN_BLOCKSIZE:
 317                 case OP__SET_MAX_BLOCKSIZE:
 318                 case OP__SET_MIN_FRAMESIZE:
 319                 case OP__SET_MAX_FRAMESIZE:
 320                 case OP__SET_SAMPLE_RATE:
 321                 case OP__SET_CHANNELS:
 322                 case OP__SET_BPS:
 323                 case OP__SET_TOTAL_SAMPLES:
 324                         ok = do_shorthand_operation__streaminfo(filename, prefix_with_filename, chain, operation, needs_write);
 325                         break;
 326                 case OP__SHOW_VC_VENDOR:
 327                 case OP__SHOW_VC_FIELD:
 328                 case OP__REMOVE_VC_ALL:
 329                 case OP__REMOVE_VC_FIELD:
 330                 case OP__REMOVE_VC_FIRSTFIELD:
 331                 case OP__SET_VC_FIELD:
 332                 case OP__IMPORT_VC_FROM:
 333                 case OP__EXPORT_VC_TO:
 334                         ok = do_shorthand_operation__vorbis_comment(filename, prefix_with_filename, chain, operation, needs_write, !utf8_convert);
 335                         break;
 336                 case OP__IMPORT_CUESHEET_FROM:
 337                 case OP__EXPORT_CUESHEET_TO:
 338                         ok = do_shorthand_operation__cuesheet(filename, chain, operation, needs_write, /*@@@@cued_seekpoints=*/true);
 339                         break;
 340                 case OP__ADD_SEEKPOINT:
 341                         ok = do_shorthand_operation__add_seekpoints(filename, chain, operation->argument.add_seekpoint.specification, needs_write);
 342                         break;
 343                 case OP__ADD_REPLAY_GAIN:
 344                         /* this command is always executed last */
 345                         ok = true;
 346                         break;
 347                 case OP__ADD_PADDING:
 348                         ok = do_shorthand_operation__add_padding(filename, chain, operation->argument.add_padding.length, needs_write);
 349                         break;
 350                 default:
 351                         ok = false;
 352                         FLAC__ASSERT(0);
 353                         break;
 354         };
 355
 356         return ok;
 357 }
 358
 359 FLAC__bool do_shorthand_operation__add_replay_gain(char **filenames, unsigned num_files, FLAC__bool preserve_modtime)
 360 {
 361         FLAC__StreamMetadata streaminfo;
 362         float *title_gains = 0, *title_peaks = 0;
 363         float album_gain, album_peak;
 364         unsigned sample_rate = 0;
 365         unsigned bits_per_sample = 0;
 366         unsigned channels = 0;
 367         unsigned i;
 368         const char *error;
 369         FLAC__bool first = true;
 370
 371         FLAC__ASSERT(num_files > 0);
 372
 373         for(i = 0; i < num_files; i++) {
 374                 FLAC__ASSERT(0 != filenames[i]);
 375                 if(!FLAC__metadata_get_streaminfo(filenames[i], &streaminfo)) {
 376                         fprintf(stderr, "%s: ERROR: can't open file or get STREAMINFO block\n", filenames[i]);
 377                         return false;
 378                 }
 379                 if(first) {
 380                         first = false;
 381                         sample_rate = streaminfo.data.stream_info.sample_rate;
 382                         bits_per_sample = streaminfo.data.stream_info.bits_per_sample;
 383                         channels = streaminfo.data.stream_info.channels;
 384                 }
 385                 else {
 386                         if(sample_rate != streaminfo.data.stream_info.sample_rate) {
 387                                 fprintf(stderr, "%s: ERROR: sample rate of %u Hz does not match previous files' %u Hz\n", filenames[i], streaminfo.data.stream_info.sample_rate, sample_rate);
 388                                 return false;
 389                         }
 390                         if(bits_per_sample != streaminfo.data.stream_info.bits_per_sample) {
 391                                 fprintf(stderr, "%s: ERROR: resolution of %u bps does not match previous files' %u bps\n", filenames[i], streaminfo.data.stream_info.bits_per_sample, bits_per_sample);
 392                                 return false;
 393                         }
 394                         if(channels != streaminfo.data.stream_info.channels) {
 395                                 fprintf(stderr, "%s: ERROR: # channels (%u) does not match previous files' (%u)\n", filenames[i], streaminfo.data.stream_info.channels, channels);
 396                                 return false;
 397                         }
 398                 }
 399                 if(!grabbag__replaygain_is_valid_sample_frequency(sample_rate)) {
 400                         fprintf(stderr, "%s: ERROR: sample rate of %u Hz is not supported\n", filenames[i], sample_rate);
 401                         return false;
 402                 }
 403                 if(channels != 1 && channels != 2) {
 404                         fprintf(stderr, "%s: ERROR: # of channels (%u) is not supported, must be 1 or 2\n", filenames[i], channels);
 405                         return false;
 406                 }
 407         }
 408         FLAC__ASSERT(bits_per_sample >= FLAC__MIN_BITS_PER_SAMPLE && bits_per_sample <= FLAC__MAX_BITS_PER_SAMPLE);
 409
 410         if(!grabbag__replaygain_init(sample_rate))
 411                 FLAC__ASSERT(0);
 412
 413         if(
 414                 0 == (title_gains = (float*)malloc(sizeof(float) * num_files)) ||
 415                 0 == (title_peaks = (float*)malloc(sizeof(float) * num_files))
 416         )
 417                 die("out of memory allocating space for title gains/peaks");
 418
 419         for(i = 0; i < num_files; i++) {
 420                 if(0 != (error = grabbag__replaygain_analyze_file(filenames[i], title_gains+i, title_peaks+i))) {
 421                         fprintf(stderr, "%s: ERROR: during analysis (%s)\n", filenames[i], error);
 422                         free(title_gains);
 423                         free(title_peaks);
 424                         return false;
 425                 }
 426         }
 427         grabbag__replaygain_get_album(&album_gain, &album_peak);
 428
 429         for(i = 0; i < num_files; i++) {
 430                 if(0 != (error = grabbag__replaygain_store_to_file(filenames[i], album_gain, album_peak, title_gains[i], title_peaks[i], preserve_modtime))) {
 431                         fprintf(stderr, "%s: ERROR: writing tags (%s)\n", filenames[i], error);
 432                         free(title_gains);
 433                         free(title_peaks);
 434                         return false;
 435                 }
 436         }
 437
 438         free(title_gains);
 439         free(title_peaks);
 440         return true;
 441 }
 442
 443 FLAC__bool do_shorthand_operation__add_padding(const char *filename, FLAC__Metadata_Chain *chain, unsigned length, FLAC__bool *needs_write)
 444 {
 445         FLAC__StreamMetadata *padding = 0;
 446         FLAC__Metadata_Iterator *iterator = FLAC__metadata_iterator_new();
 447
 448         if(0 == iterator)
 449                 die("out of memory allocating iterator");
 450
 451         FLAC__metadata_iterator_init(iterator, chain);
 452
 453         while(FLAC__metadata_iterator_next(iterator))
 454                 ;
 455
 456         padding = FLAC__metadata_object_new(FLAC__METADATA_TYPE_PADDING);
 457         if(0 == padding)
 458                 die("out of memory allocating PADDING block");
 459
 460         padding->length = length;
 461
 462         if(!FLAC__metadata_iterator_insert_block_after(iterator, padding)) {
 463                 fprintf(stderr, "%s: ERROR: adding new PADDING block to metadata, status =\"%s\"\n", filename, FLAC__Metadata_ChainStatusString[FLAC__metadata_chain_status(chain)]);
 464                 FLAC__metadata_object_delete(padding);
 465                 FLAC__metadata_iterator_delete(iterator);
 466                 return false;
 467         }
 468
 469         FLAC__metadata_iterator_delete(iterator);
 470         *needs_write = true;
 471         return true;
 472 }
 473
 474 FLAC__bool passes_filter(const CommandLineOptions *options, const FLAC__StreamMetadata *block, unsigned block_number)
 475 {
 476         unsigned i, j;
 477         FLAC__bool matches_number = false, matches_type = false;
 478         FLAC__bool has_block_number_arg = false;
 479
 480         for(i = 0; i < options->args.num_arguments; i++) {
 481                 if(options->args.arguments[i].type == ARG__BLOCK_TYPE || options->args.arguments[i].type == ARG__EXCEPT_BLOCK_TYPE) {
 482                         for(j = 0; j < options->args.arguments[i].value.block_type.num_entries; j++) {
 483                                 if(options->args.arguments[i].value.block_type.entries[j].type == block->type) {
 484                                         if(block->type != FLAC__METADATA_TYPE_APPLICATION || !options->args.arguments[i].value.block_type.entries[j].filter_application_by_id || 0 == memcmp(options->args.arguments[i].value.block_type.entries[j].application_id, block->data.application.id, FLAC__STREAM_METADATA_APPLICATION_ID_LEN/8))
 485                                                 matches_type = true;
 486                                 }
 487                         }
 488                 }
 489                 else if(options->args.arguments[i].type == ARG__BLOCK_NUMBER) {
 490                         has_block_number_arg = true;
 491                         for(j = 0; j < options->args.arguments[i].value.block_number.num_entries; j++) {
 492                                 if(options->args.arguments[i].value.block_number.entries[j] == block_number)
 493                                         matches_number = true;
 494                         }
 495                 }
 496         }
 497
 498         if(!has_block_number_arg)
 499                 matches_number = true;
 500
 501         if(options->args.checks.has_block_type) {
 502                 FLAC__ASSERT(!options->args.checks.has_except_block_type);
 503         }
 504         else if(options->args.checks.has_except_block_type)
 505                 matches_type = !matches_type;
 506         else
 507                 matches_type = true;
 508
 509         return matches_number && matches_type;
 510 }
 511
 512 void write_metadata(const char *filename, FLAC__StreamMetadata *block, unsigned block_number, FLAC__bool raw, FLAC__bool hexdump_application)
 513 {
 514         unsigned i;
 515
 516 /*@@@ yuck, should do this with a varargs function or something: */
 517 #define PPR if(filename)printf("%s:",filename);
 518         PPR; printf("METADATA block #%u\n", block_number);
 519         PPR; printf("  type: %u (%s)\n", (unsigned)block->type, block->type < FLAC__METADATA_TYPE_UNDEFINED? FLAC__MetadataTypeString[block->type] : "UNKNOWN");
 520         PPR; printf("  is last: %s\n", block->is_last? "true":"false");
 521         PPR; printf("  length: %u\n", block->length);
 522
 523         switch(block->type) {
 524                 case FLAC__METADATA_TYPE_STREAMINFO:
 525                         PPR; printf("  minumum blocksize: %u samples\n", block->data.stream_info.min_blocksize);
 526                         PPR; printf("  maximum blocksize: %u samples\n", block->data.stream_info.max_blocksize);
 527                         PPR; printf("  minimum framesize: %u bytes\n", block->data.stream_info.min_framesize);
 528                         PPR; printf("  maximum framesize: %u bytes\n", block->data.stream_info.max_framesize);
 529                         PPR; printf("  sample_rate: %u Hz\n", block->data.stream_info.sample_rate);
 530                         PPR; printf("  channels: %u\n", block->data.stream_info.channels);
 531                         PPR; printf("  bits-per-sample: %u\n", block->data.stream_info.bits_per_sample);
 532                         PPR; printf("  total samples: %llu\n", block->data.stream_info.total_samples);
 533                         PPR; printf("  MD5 signature: ");
 534                         for(i = 0; i < 16; i++) {
 535                                 printf("%02x", (unsigned)block->data.stream_info.md5sum[i]);
 536                         }
 537                         printf("\n");
 538                         break;
 539                 case FLAC__METADATA_TYPE_PADDING:
 540                         /* nothing to print */
 541                         break;
 542                 case FLAC__METADATA_TYPE_APPLICATION:
 543                         PPR; printf("  application ID: ");
 544                         for(i = 0; i < 4; i++) {
 545                                 PPR; printf("%02x", block->data.application.id[i]);
 546                         }
 547                         PPR; printf("\n");
 548                         PPR; printf("  data contents:\n");
 549                         if(0 != block->data.application.data) {
 550                                 if(hexdump_application)
 551                                         hexdump(filename, block->data.application.data, block->length - FLAC__STREAM_METADATA_HEADER_LENGTH, "    ");
 552                                 else
 553                                         (void) fwrite(block->data.application.data, 1, block->length - FLAC__STREAM_METADATA_HEADER_LENGTH, stdout);
 554                         }
 555                         break;
 556                 case FLAC__METADATA_TYPE_SEEKTABLE:
 557                         PPR; printf("  seek points: %u\n", block->data.seek_table.num_points);
 558                         for(i = 0; i < block->data.seek_table.num_points; i++) {
 559                                 if(block->data.seek_table.points[i].sample_number != FLAC__STREAM_METADATA_SEEKPOINT_PLACEHOLDER) {
 560                                         PPR; printf("    point %d: sample_number=%llu, stream_offset=%llu, frame_samples=%u\n", i, block->data.seek_table.points[i].sample_number, block->data.seek_table.points[i].stream_offset, block->data.seek_table.points[i].frame_samples);
 561                                 }
 562                                 else {
 563                                         PPR; printf("    point %d: PLACEHOLDER\n", i);
 564                                 }
 565                         }
 566                         break;
 567                 case FLAC__METADATA_TYPE_VORBIS_COMMENT:
 568                         PPR; printf("  vendor string: ");
 569                         write_vc_field(0, &block->data.vorbis_comment.vendor_string, raw, stdout);
 570                         PPR; printf("  comments: %u\n", block->data.vorbis_comment.num_comments);
 571                         for(i = 0; i < block->data.vorbis_comment.num_comments; i++) {
 572                                 PPR; printf("    comment[%u]: ", i);
 573                                 write_vc_field(0, &block->data.vorbis_comment.comments[i], raw, stdout);
 574                         }
 575                         break;
 576                 case FLAC__METADATA_TYPE_CUESHEET:
 577                         PPR; printf("  media catalog number: %s\n", block->data.cue_sheet.media_catalog_number);
 578                         //@@@@ finish
 579                         break;
 580                 default:
 581                         PPR; printf("SKIPPING block of unknown type\n");
 582                         break;
 583         }
 584 #undef PPR
 585 }