fprintf(out, " Unless --no-utf8-convert is specified, the contents will\n");
fprintf(out, " be converted to UTF-8 from the local charset. This can\n");
fprintf(out, " be used to store a cuesheet in a tag (e.g.\n");
- fprintf(out, " --set-tag-from-file=\"CUESHEET=image.cue\"). Do not try to\n");
- fprintf(out, " store binary data in tag fields! Use APPLICATION blocks\n");
- fprintf(out, " for that.\n");
+ fprintf(out, " --set-tag-from-file=\"CUESHEET=image.cue\"). Do not try\n");
+ fprintf(out, " to store binary data in tag fields! Use APPLICATION\n");
+ fprintf(out, " blocks for that.\n");
fprintf(out, "--import-tags-from=FILE Import tags from a file. Use '-' for stdin. Each line\n");
fprintf(out, " should be of the form NAME=VALUE. Multi-line comments\n");
fprintf(out, " are currently not supported. Specify --remove-all-tags\n");
fprintf(out, " --no-utf8-convert if necessary.\n");
fprintf(out, "--import-cuesheet-from=FILE Import a cuesheet from a file. Use '-' for stdin.\n");
fprintf(out, " Only one FLAC file may be specified. A seekpoint will be\n");
- fprintf(out, " added for each index point in the cuesheet to the SEEKTABLE\n");
- fprintf(out, " unless --no-cued-seekpoints is specified.\n");
+ fprintf(out, " added for each index point in the cuesheet to the\n");
+ fprintf(out, " SEEKTABLE unless --no-cued-seekpoints is specified.\n");
fprintf(out, "--export-cuesheet-to=FILE Export CUESHEET block to a cuesheet file, suitable\n");
fprintf(out, " for use by CD authoring software. Use '-' for stdout.\n");
fprintf(out, " Only one FLAC file may be specified on the command line.\n");
+ fprintf(out, "--import-picture=SPECIFICATION Import a picture and store it in a PICTURE block.\n");
+ fprintf(out, " The SPECIFICATION is a string whose parts are separated\n");
+ fprintf(out, " by | characters. Some parts may be left empty to invoke\n");
+ fprintf(out, " default values. The specification format is:\n");
+ fprintf(out, " [TYPE]|MIME-TYPE|[DESCRIPTION]|[WIDTHxHEIGHTxDEPTH[/COLORS]]|FILE\n");
+ fprintf(out, " TYPE is optional; it is a number from one of:\n");
+ fprintf(out, " 0: Other\n");
+ fprintf(out, " 1: 32x32 pixels 'file icon' (PNG only)\n");
+ fprintf(out, " 2: Other file icon\n");
+ fprintf(out, " 3: Cover (front)\n");
+ fprintf(out, " 4: Cover (back)\n");
+ fprintf(out, " 5: Leaflet page\n");
+ fprintf(out, " 6: Media (e.g. label side of CD)\n");
+ fprintf(out, " 7: Lead artist/lead performer/soloist\n");
+ fprintf(out, " 8: Artist/performer\n");
+ fprintf(out, " 9: Conductor\n");
+ fprintf(out, " 10: Band/Orchestra\n");
+ fprintf(out, " 11: Composer\n");
+ fprintf(out, " 12: Lyricist/text writer\n");
+ fprintf(out, " 13: Recording Location\n");
+ fprintf(out, " 14: During recording\n");
+ fprintf(out, " 15: During performance\n");
+ fprintf(out, " 16: Movie/video screen capture\n");
+ fprintf(out, " 17: A bright coloured fish\n");
+ fprintf(out, " 18: Illustration\n");
+ fprintf(out, " 19: Band/artist logotype\n");
+ fprintf(out, " 20: Publisher/Studio logotype\n");
+ fprintf(out, " The default is 3 (front cover). There may only be one picture each\n");
+ fprintf(out, " of type 1 and 2 in a file.\n");
+ fprintf(out, " MIME-TYPE is mandatory; for best compatibility with players, use\n");
+ fprintf(out, " pictures with MIME type image/jpeg or image/png. The MIME type can\n");
+ fprintf(out, " also be --> to mean that FILE is actually a URL to an image, though\n");
+ fprintf(out, " this use is discouraged.\n");
+ fprintf(out, " DESCRIPTION is optional; the default is an empty string\n");
+ fprintf(out, " The next part specfies the resolution and color information. If\n");
+ fprintf(out, " the MIME-TYPE is image/jpeg, image/png, or image/gif, you can\n");
+ fprintf(out, " usually leave this empty and they can be detected from the file.\n");
+ fprintf(out, " Otherwise, you must specify the width in pixels, height in pixels,\n");
+ fprintf(out, " and color depth in bits-per-pixel. If the image has indexed colors\n");
+ fprintf(out, " you should also specify the number of colors used.\n");
+ fprintf(out, " FILE is the path to the picture file to be imported, or the URL if\n");
+ fprintf(out, " MIME type is -->\n");
fprintf(out, "--add-replay-gain Calculates the title and album gains/peaks of the given\n");
fprintf(out, " FLAC files as if all the files were part of one album,\n");
fprintf(out, " then stores them in the VORBIS_COMMENT block. The tags\n");
projects / platform / upstream / flac.git / blobdiff