diff --git a/README.md b/README.md index 7f22631..bc4e5c8 100644 --- a/README.md +++ b/README.md @@ -71,7 +71,7 @@ like the next greater bit depth that fill a full sequence of bytes: - 17-bit is stored like 24-bit (3 bytes) - 27-bit is stored like 32-bit (4 bytes) -So even if wave files with those bit depth are valid (and playable in most players), they allow their samples to be greater than the actual limit of their bit depth. So: +So even if files like this are valid (and playable in most players), they allow their samples to be greater than the actual limit of their audio bit depth. So: - 11-bit files can contain 16-bit samples - 17-bit files can contain 24-bit samples - 29-bit files can contain 32-bit samples @@ -182,7 +182,7 @@ fs.writeFileSync("11bit-file.wav", wav.toBuffer()); ``` ### Change the bit depth of a file without re-scaling the samples -This may be needed when dealing with files whose bit depths do not fill a full sequence of bytes (like 12-bit files), as those files may contain samples that outrange their declared bit depth limits and re-scaling their samples may result in files with clipping audio. +This may be needed when dealing with files whose bit depths do not fill a full sequence of bytes (like 12-bit files), as those files may contain samples that outrange their declared bit depth limits and re-scaling their samples may result in clipping. You may want to change the bit depth of those files but don't touch their samples. You can do this by setting the optional changeResolution parameter to **false**. diff --git a/docs/WaveFile.html b/docs/WaveFile.html index fde74a9..ad17468 100644 --- a/docs/WaveFile.html +++ b/docs/WaveFile.html @@ -2027,7 +2027,7 @@
Bit depths that do not fill full bytes (like 11-
So even if wave files with those bit depth are valid (and playable in most players), they allow their samples to be greater than the actual limit of their bit depth. So:
+So even if files like this are valid (and playable in most players), they allow their samples to be greater than the actual limit of their audio bit depth. So:
16-bit wave files can be encoded as A-Law:
// You can use any supported bit depth: wav.toBitDepth("11"); -fs.writeFileSync("11bit-file.wav", wav.toBuffer());This may be needed when dealing with files whose bit depths do not fill a full sequence of bytes (like 12-bit files), as those files may contain samples that outrange their declared bit depth limits and re-scaling their samples may result in files with clipping audio.
+fs.writeFileSync("11bit-file.wav", wav.toBuffer());This may be needed when dealing with files whose bit depths do not fill a full sequence of bytes (like 12-bit files), as those files may contain samples that outrange their declared bit depth limits and re-scaling their samples may result in clipping.
You may want to change the bit depth of those files but don't touch their samples. You can do this by setting the optional changeResolution parameter to false.
// Load a wav file that say it has 11-bit audio, but has samples
// in the 16-bit range:
@@ -258,7 +258,7 @@ LICENSE
Copyright (c) 2017-2018 Rafael da Silva Rocha.
diff --git a/docs/index.js.html b/docs/index.js.html
index c8f27b8..0290eda 100644
--- a/docs/index.js.html
+++ b/docs/index.js.html
@@ -441,7 +441,7 @@ index.js