- Tell the encoder to write a PADDING metadata block of the given length (in bytes) after the STREAMINFO block. -P 0 implies no PADDING block, which is the default. This is useful if you plan to tag the file later with an APPLICATION block; instead of having to rewrite the entire file later just to insert your block, you can write directly over the PADDING block.
+ Tell the encoder to write a PADDING metadata block of the given length (in bytes) after the STREAMINFO block. This is useful if you plan to tag the file later with an APPLICATION block; instead of having to rewrite the entire file later just to insert your block, you can write directly over the PADDING block. Note that the total length of the PADDING block will be 4 bytes longer than the length given because of the 4 metadata block header bytes. You can force no PADDING block at all to be written with -P-, which is the default.
@@ -641,7 +641,7 @@
- -S-, -m-, -e-, -E-, -p-, -V-, --delete-input-file-, --lax-, --sector-align- can all be used to turn off a particular option.
+ -S-, -P-, -m-, -e-, -E-, -p-, -V-, --delete-input-file-, --lax-, --sector-align- can all be used to turn off a particular option.
@@ -938,7 +938,7 @@
rice_parameter_search_dist - 0 to try only calculated parameter k; else try all [k-rice_parameter_search_dist..k+rice_parameter_search_dist] parameters and use the best.
total_samples_estimate - May be set to 0 if unknown. Otherwise, set this to the number of samples to be encoded. This will allow the STREAMINFO block to be more accurate during the first pass in the event that the encoder can't seek back to the beginning of the output file to write the updated STREAMINFO block.
seek_table - Optional seek table to prepend; NULL implies no seek table.
-
padding - Size of PADDING block to add (goes after seek table); 0 implies do not add a PADDING block.
+
padding - Length of PADDING block to add (goes after seek table); -1 implies do not add a PADDING block. Remember that this is length of the padding; the length of the overall PADDING block will be 4 bytes larger because of the metadata block header.
last_metadata_is_last - The value the encoder will use for the 'is_last' flag of the last metadata block it writes. In normal usage you would set this to true, but if you will be manually inserting more metadata blocks between the time of the first write callback (when the encoder sends the fLaC header and metadata) and the time actual audio encoding starts then set this to false.
diff --git a/man/flac.sgml b/man/flac.sgml
index 61298d1c..a8d0ab75 100644
--- a/man/flac.sgml
+++ b/man/flac.sgml
@@ -4,7 +4,7 @@
Matt">
Zimmerman">
- November 15, 2001">
+ May 16, 2002">
1">
@@ -264,12 +264,16 @@
Tell the encoder to write a PADDING metadata
block of the given length (in bytes) after the
- STREAMINFO block. -P 0 implies no PADDING block,
- which is the default. This is useful if you plan
- to tag the file later with an APPLICATION block;
+ STREAMINFO block. This is useful if you plan to
+ tag the file later with an APPLICATION block;
instead of having to rewrite the entire file later
just to insert your block, you can write directly
- over the PADDING block.
+ over the PADDING block. Note that the total length
+ of the PADDING block will be 4 bytes longer than
+ the length given because of the 4 metadata block
+ header bytes. You can force no PADDING block at
+ all to be written with -P-, which is the default.
+
@@ -494,7 +498,7 @@
-
+