ref: 6122be83b22cd33e808af129357f81c704d7c8b2
parent: ed30fb2d15b5f2543df6679766f9f655b4915721
author: Ralph Giles <giles@thaumas.net>
date: Sun Sep 8 15:21:26 EDT 2013
Add new metadata switches to the manpage.
--- a/man/opusenc.1
+++ b/man/opusenc.1
@@ -65,6 +65,14 @@
.B --genre
.I genre
] [
+.B --picture
+.IB filename | specification
+] [
+.B --padding
+.I n
+] [
+.B --discard-comments
+] [
.B --raw
] [
.B --raw-bits
@@ -157,6 +165,7 @@
Preface with s: to direct the ctl to multistream s
.br
This may be used multiple times
+
.IP "--comment tag=value"
Add an extra comment. This may be used multiple times, and all
instances will be added to each of the input files specified. The argument
@@ -178,6 +187,116 @@
.IP "--genre genre"
Set the genre comment field to
.I genre
+.IP "--picture filename|specification"
+Attach album art for the track.
+
+Either a
+.I filename
+for the artwork or a more complete
+.I specification
+form can be used.
+The picture is added to a
+.B METADATA_BLOCK_PICTURE
+comment field similar to what is used in
+.SM FLAC.
+The
+.I specification
+is a string whose parts are separated by | (pipe) characters.
+Some parts may be left empty to invoke default values.
+Passing a plain filename is just shorthand for the "||||filename"
+specification.
+
+The format of
+.I specification
+is [\fBtype\fR]|[\fBmime-type\fR]|[\fBdescription\fR]|[\fBwidth\fRx\fBheight\fRx\fBdepth\fR[/\fBcolors\fR]]|\fBfilename\fR
+
+.I type
+is an optional number describing the nature of the picture.
+Defined values are from one of:
+
+ 0: Other
+.br
+ 1: 32x32 pixel 'file icon' (PNG only)
+.br
+ 2: Other file icon
+.br
+ 3: Cover (front)
+.br
+ 4: Cover (back)
+.br
+ 5: Leaflet page
+.br
+ 6: Media (e.g., label side of a CD)
+.br
+ 7: Lead artist/lead performer/soloist
+.br
+ 8: Artist/performer
+.br
+ 9: Conductor
+.br
+ 10: Band/Orchestra
+.br
+ 11: Composer
+.br
+ 12: Lyricist/text writer
+.br
+ 13: Recording location
+.br
+ 14: During recording
+.br
+ 15: During performance
+.br
+ 16: Movie/video screen capture
+.br
+ 17: A bright colored fish
+.br
+ 18: Illustration
+.br
+ 19: Band/artist logotype
+.br
+ 20: Publisher/studio logotype
+
+The default is 3 (front cover).
+More than one --picture option can be specified to attach multiple pictures.
+There may only be one picture each of type 1 and 2 in a file.
+
+.I mime-type
+is optional. If left blank, it will be detected from the file. For
+best compatibility with players, use pictures with a
+.I mime-type
+of image/jpeg or image/png. The
+.I mime-type
+can also be "-->" to mean that
+.I filename
+is actually a URL to an image, though this use is discouraged.
+The file at the URL will not be fetched.
+The URL itself is stored in the comment field.
+
+.I description
+is optional. The default is an empty string.
+
+The next part specifies the resolution and color information. If the
+.I mime-type
+is image/jpeg, image/png, or image/gif, you can usually leave this empty and
+they can be detected from the file. Otherwise, you must specify the width in
+pixels, height in pixels, and color depth in bits-per-pixel. If the image has
+indexed colors you should also specify the number of colors used. If possible,
+these are checked against the file for accuracy.
+
+.I filename
+is the path to the picture file to be imported, or the URL if the
+.I mime-type
+is -->.
+
+.I picture
+.IP "--padding n"
+Reserve
+.I n
+extra bytes for metadata tags. This can make later tag editing more
+efficient. Defaults to 512.
+.IP "--discard-comments"
+Don't propagate metadata tags from the input file.
+
.IP "--raw"
Raw (headerless) PCM input
.IP "--raw-bits N"