pile-audio refactor

crates/pile-flac/tests/files/flac_subset/LICENSE.txt

@@ -0,0 +1,121 @@
+Creative Commons Legal Code
+
+CC0 1.0 Universal
+
+    CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
+    LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
+    ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
+    INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
+    REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
+    PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
+    THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
+    HEREUNDER.
+
+Statement of Purpose
+
+The laws of most jurisdictions throughout the world automatically confer
+exclusive Copyright and Related Rights (defined below) upon the creator
+and subsequent owner(s) (each and all, an "owner") of an original work of
+authorship and/or a database (each, a "Work").
+
+Certain owners wish to permanently relinquish those rights to a Work for
+the purpose of contributing to a commons of creative, cultural and
+scientific works ("Commons") that the public can reliably and without fear
+of later claims of infringement build upon, modify, incorporate in other
+works, reuse and redistribute as freely as possible in any form whatsoever
+and for any purposes, including without limitation commercial purposes.
+These owners may contribute to the Commons to promote the ideal of a free
+culture and the further production of creative, cultural and scientific
+works, or to gain reputation or greater distribution for their Work in
+part through the use and efforts of others.
+
+For these and/or other purposes and motivations, and without any
+expectation of additional consideration or compensation, the person
+associating CC0 with a Work (the "Affirmer"), to the extent that he or she
+is an owner of Copyright and Related Rights in the Work, voluntarily
+elects to apply CC0 to the Work and publicly distribute the Work under its
+terms, with knowledge of his or her Copyright and Related Rights in the
+Work and the meaning and intended legal effect of CC0 on those rights.
+
+1. Copyright and Related Rights. A Work made available under CC0 may be
+protected by copyright and related or neighboring rights ("Copyright and
+Related Rights"). Copyright and Related Rights include, but are not
+limited to, the following:
+
+  i. the right to reproduce, adapt, distribute, perform, display,
+     communicate, and translate a Work;
+ ii. moral rights retained by the original author(s) and/or performer(s);
+iii. publicity and privacy rights pertaining to a person's image or
+     likeness depicted in a Work;
+ iv. rights protecting against unfair competition in regards to a Work,
+     subject to the limitations in paragraph 4(a), below;
+  v. rights protecting the extraction, dissemination, use and reuse of data
+     in a Work;
+ vi. database rights (such as those arising under Directive 96/9/EC of the
+     European Parliament and of the Council of 11 March 1996 on the legal
+     protection of databases, and under any national implementation
+     thereof, including any amended or successor version of such
+     directive); and
+vii. other similar, equivalent or corresponding rights throughout the
+     world based on applicable law or treaty, and any national
+     implementations thereof.
+
+2. Waiver. To the greatest extent permitted by, but not in contravention
+of, applicable law, Affirmer hereby overtly, fully, permanently,
+irrevocably and unconditionally waives, abandons, and surrenders all of
+Affirmer's Copyright and Related Rights and associated claims and causes
+of action, whether now known or unknown (including existing as well as
+future claims and causes of action), in the Work (i) in all territories
+worldwide, (ii) for the maximum duration provided by applicable law or
+treaty (including future time extensions), (iii) in any current or future
+medium and for any number of copies, and (iv) for any purpose whatsoever,
+including without limitation commercial, advertising or promotional
+purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each
+member of the public at large and to the detriment of Affirmer's heirs and
+successors, fully intending that such Waiver shall not be subject to
+revocation, rescission, cancellation, termination, or any other legal or
+equitable action to disrupt the quiet enjoyment of the Work by the public
+as contemplated by Affirmer's express Statement of Purpose.
+
+3. Public License Fallback. Should any part of the Waiver for any reason
+be judged legally invalid or ineffective under applicable law, then the
+Waiver shall be preserved to the maximum extent permitted taking into
+account Affirmer's express Statement of Purpose. In addition, to the
+extent the Waiver is so judged Affirmer hereby grants to each affected
+person a royalty-free, non transferable, non sublicensable, non exclusive,
+irrevocable and unconditional license to exercise Affirmer's Copyright and
+Related Rights in the Work (i) in all territories worldwide, (ii) for the
+maximum duration provided by applicable law or treaty (including future
+time extensions), (iii) in any current or future medium and for any number
+of copies, and (iv) for any purpose whatsoever, including without
+limitation commercial, advertising or promotional purposes (the
+"License"). The License shall be deemed effective as of the date CC0 was
+applied by Affirmer to the Work. Should any part of the License for any
+reason be judged legally invalid or ineffective under applicable law, such
+partial invalidity or ineffectiveness shall not invalidate the remainder
+of the License, and in such case Affirmer hereby affirms that he or she
+will not (i) exercise any of his or her remaining Copyright and Related
+Rights in the Work or (ii) assert any associated claims and causes of
+action with respect to the Work, in either case contrary to Affirmer's
+express Statement of Purpose.
+
+4. Limitations and Disclaimers.
+
+ a. No trademark or patent rights held by Affirmer are waived, abandoned,
+    surrendered, licensed or otherwise affected by this document.
+ b. Affirmer offers the Work as-is and makes no representations or
+    warranties of any kind concerning the Work, express, implied,
+    statutory or otherwise, including without limitation warranties of
+    title, merchantability, fitness for a particular purpose, non
+    infringement, or the absence of latent or other defects, accuracy, or
+    the present or absence of errors, whether or not discoverable, all to
+    the greatest extent permissible under applicable law.
+ c. Affirmer disclaims responsibility for clearing rights of other persons
+    that may apply to the Work or any use thereof, including without
+    limitation any person's Copyright and Related Rights in the Work.
+    Further, Affirmer disclaims responsibility for obtaining any necessary
+    consents, permissions or other rights required for any use of the
+    Work.
+ d. Affirmer understands and acknowledges that Creative Commons is not a
+    party to this document and has no duty or obligation with respect to
+    this CC0 or use of the Work.

crates/pile-flac/tests/files/flac_subset/README.md

@@ -0,0 +1,127 @@
+# Group subset
+
+The FLAC format specifies a subset of itself to ensure
+streamability and limits the decoding requirements for hardware
+implementations. The reference FLAC encoder will enforce this
+subset unless specifically disabled.
+
+The files in this group are considered a baseline for general
+decoders: these files should be properly decoded or properly
+rejected before playback is attempted by any decoder. A
+decoder can choose to reject certain files, for example
+multichannel files, files with high or unusual samplerates,
+files with a high bit depth. Crashing or mangled playback of
+these files is probably going to be noticed by unsuspecting
+users of a decoder. Read the README.txt in the directory
+subset for details on each file.
+
+
+## Files \#1 - \#27
+
+The first 10 files tests 44.1kHz, 16-bit audio with various
+blocksizes that are within subset.
+
+Files 11 through 23 tests the ability to decode FLAC files
+with various features that are within subset but aren't used
+often.
+
+- File 11 uses the maximal allowed rice partition order (8)
+- File 12 uses the maximal allowed qlp precision (15)
+- File 13 uses the smallest sane qlp precision (2)
+- File 14 uses wasted bits
+- File 15 uses only 'verbatim' frames
+- File 16 uses rice escape codes and partition order 8
+- File 17 uses all possible fixed orders (especially order 0 which isn't used often)
+- File 18 is encoded with precision search, using qlp precisions between 3 and 15
+- File 19 uses a samplerate of 35467Hz
+- File 20 uses a samplerate of 39kHz
+- File 21 uses a samplerate of 22050Hz
+- File 22 has 12 bits per sample
+- File 23 has 8 bits per sample
+
+Files 24 through 27 test the ability to decode a FLAC file with
+a variable blocksize. This is a subset feature which is
+currently (August 2021) only implemented in the Flake decoder
+and its forks/decendants and is not enabled by default.
+
+With the release of FLAC 1.2.0 in July 2007, the FLAC
+specification was augmented to more clearly signal variable
+blocksize streams by the use of a special bit in the header.
+File 24, 25 and 26 use this format. File 27 follows the old
+specification, which is much harder to detect
+
+- File 24 uses the current format and is created by flake r264
+- File 25 uses the current format and is created by a modified flake r264 creating smaller blocks
+- File 26 uses the current format and is created by CUETools.Flake 2.1.6
+- File 27 uses the old format and is created by flake 0.11
+
+## Files \#28 - \#37
+
+Files 28 through 37 test the ability to decode various
+high-resolution FLAC file (96kHz, 24-bit)
+
+- File 28 uses default settings
+- File 29 uses the largest allowed blocksize (16384)
+- File 30 uses non-standard blocksize 13456
+- File 31 uses only 32th order predictors
+- File 32 uses escape codes and partition order 8
+- File 33 is upsampled to 192kHz
+- File 34 is upsampled to 192kHz, uses blocksize 16384, 32th
+    order predictors only, maximum LPC precision and maximum
+    partition order
+- File 35 uses non-standard samplerate 134560Hz
+- File 36 is upsampled to 384kHz
+- File 37 has 20 bits per sample
+
+## Files \#38 - \#44
+
+Files 38 through 43 test the ability to decode various
+multichannel FLAC files. Each file contains a voice description
+of the channels present, so as to see whether the channels are
+decoded in the correct lay-out.
+
+- File 38 is 3.0-channel (left, right, center)
+- File 39 is 4.0-channel or quadraphonic
+- File 40 is 5.0-channel
+- File 41 is 5.1-channel
+- File 42 is 6.1-channel
+- File 43 is 7.1-channel
+
+File 44 tests the ability to decode a file with the highest
+possible data input per second, staying within subset and using
+a standard samplerate. It also only uses 32th order predictors
+at the highest possible predictor precision and the largest
+blocksize allowed within the FLAC subset making it especially
+challenging to decode.
+
+## Files \#45 - \#59
+
+Files 45 through 59 test the ability to handle various streams
+with valid but rather unusual or extreme metadata.
+
+- File 45 has 'unknown number of samples' in STREAMINFO
+- File 46 has maximum and minimum framesize set to 'unknown'
+- File 47 has only a STREAMINFO block
+- File 48 has an extremely large SEEKTABLE
+- File 49 has an extremely large PADDING block
+- File 50 has an extremely large PICTURE block (JPG of 15.8MB)
+- File 51 has an extremely large VORBISCOMMENT block
+- File 52 has an extremely large APPLICATION block
+- File 53 has a CUESHEET block with absurdly many indexes
+- File 54 with the same 20 VORBISCOMMENTs repeated 1000 times
+- File 55 has the metadata of track 47-52 combined
+- File 56 has a PICTURE with mimetype image/jpeg
+- File 57 has a PICTURE with mimetype image/png
+- File 58 has a PICTURE with mimetype image/gif
+- File 59 has a PICTURE with mimetype image/avif
+
+## Files \#60 - \#64
+
+Miscellaneous, later additions
+
+- File 60 is mono audio
+- File 61, 62 and 63 are signals with rather extreme
+    characteristics that might trigger overflow if a decoder
+    uses 32-bit integers to calculate the predictor where 64-bit
+    integers are appropriate
+- File 64 contains rice codes with escape code zero