README.md in format_parser-2.1.0 vs README.md in format_parser-2.2.0
- old
+ new
@@ -10,33 +10,41 @@
[](https://badge.fury.io/rb/format_parser) [](https://travis-ci.org/WeTransfer/format_parser)
## Currently supported filetypes:
-* TIFF
+* AAC
+* AIFF
+* ARW
+* BMP
* CR2
-* NEF
-* PSD
-* PNG
-* MP3
-* JPEG
-* GIF
-* PDF
+* CR3
+* DOCX
* DPX
-* AIFF
-* WAV
-* FLAC
* FDX
+* FLAC
+* GIF
+* HEIC
+* HEIF
+* JPEG
+* M3U
+* M4A
* MOV
+* MP3
* MP4
-* M4A
-* ZIP
-* DOCX, PPTX, XLSX
+* MPEG
+* NEF
* OGG
-* MPEG, MPG
-* M3U
+* PDF
+* PNG
+* PPTX
+* PSD
+* TIFF
+* WAV
* WEBP
+* XLSX
+* ZIP
...with [more](https://github.com/WeTransfer/format_parser/issues?q=is%3Aissue+is%3Aopen+label%3Aformats) on the way!
## Basic usage
@@ -130,97 +138,101 @@
## Fixture Sources
Unless specified otherwise in this section the fixture files are MIT licensed and from the FastImage and Dimensions projects.
-### JPEG
-- `divergent_pixel_dimensions_exif.jpg` is used with permission from LiveKom GmbH
-- `extended_reads.jpg` has kindly been made available by Raphaelle Pellerin for use exclusively with format_parser
-- `too_many_APP1_markers_surrogate.jpg` was created by the project maintainers
-* `orient_6.jpg` is used with permission from [Renaud Chaput](https://github.com/renchap)
-
-### AIFF
-- fixture.aiff was created by one of the project maintainers and is MIT licensed
-
-### WAV
-- c_11k16bitpcm.wav and c_8kmp316.wav are from [Wikipedia WAV](https://en.wikipedia.org/wiki/WAV#Comparison_of_coding_schemes), retrieved January 7, 2018
-- c_39064__alienbomb__atmo-truck.wav is from [freesound](https://freesound.org/people/alienbomb/sounds/39064/) and is CC0 licensed
-- c_M1F1-Alaw-AFsp.wav and d_6_Channel_ID.wav are from a [McGill Engineering site](http://www-mmsp.ece.mcgill.ca/Documents/AudioFormats/WAVE/Samples.html)
-
-### MP3
-- Cassy.mp3 has been produced by WeTransfer and may be used with the library for the purposes of testing
-
### AAC
- Originals music files: “Furious Freak” and “Galway”, Kevin MacLeod (incompetech.com), Licensed under Creative Commons: By Attribution 3.0, http://creativecommons.org/licenses/by/3.0/
- The AAC samples were converted from 'wav' format and made available [here](https://espressif-docs.readthedocs-hosted.com/projects/esp-adf/en/latest/design-guide/audio-samples.html) by Espressif Systems, as part of their audio development framework (under the ESPRESSIF MIT License).
- Files:
- ff-16b-2c-44100hz.aac
- ff-16b-1c-44100hz.aac
- gs-16b-2c-44100hz.aac
- gs-16b-1c-44100hz.aac
-### FDX
-- fixture.fdx was created by one of the project maintainers and is MIT licensed
-### DPX
-- DPX files were created by one of the project maintainers and may be used with the library for the purposes of testing
+### AIFF
+- fixture.aiff was created by one of the project maintainers and is MIT licensed
-### MOOV
-- bmff.mp4 is borrowed from the [bmff](https://github.com/zuku/bmff) project
-- Test_Circular MOV files were created by one of the project maintainers and are MIT licensed
+### ARW
+- ARW examples are downloaded from http://www.rawsamples.ch/ and are Creative Common Licensed.
### CR2
- CR2 examples are downloaded from http://www.rawsamples.ch/ and are Creative Common Licensed.
-### NEF
-- NEF examples are downloaded from http://www.rawsamples.ch/ and are Creative Common Licensed.
+### CR3
+- CR3 examples are downloaded from https://raw.pixls.us/ and are in the public domain (CC0).
+### DOCX
+- The .docx files were generated by the project maintainers
+
+### DPX
+- DPX files were created by one of the project maintainers and may be used with the library for the purposes of testing
+
### ERF
- ERF examples are downloaded from http://www.rawsamples.ch/ and are Creative Common Licensed.
+### FDX
+- fixture.fdx was created by one of the project maintainers and is MIT licensed
+
### FLAC
- atc_fixture_vbr.flac is a converted version of the MP3 with the same name
- c_11k16btipcm.flac is a converted version of the WAV with the same name
-### OGG
-- `hi.ogg`, `vorbis.ogg`, `with_confusing_magic_string.ogg`, `with_garbage_at_the_end.ogg` have been generated by the project contributors
+### JPEG
+- `divergent_pixel_dimensions_exif.jpg` is used with permission from LiveKom GmbH
+- `extended_reads.jpg` has kindly been made available by Raphaelle Pellerin for use exclusively with format_parser
+- `too_many_APP1_markers_surrogate.jpg` was created by the project maintainers
+* `orient_6.jpg` is used with permission from [Renaud Chaput](https://github.com/renchap)
-### M4A
-- fixture.m4a was created by one of the project maintainers and is MIT licensed
+### JPEG (EXIF orientation)
+- Downloaded from Unspash (and thus freely avaliable) - https://unsplash.com/license and have then been
+ manipulated using the [https://github.com/recurser/exif-orientation-examples](exif-orientation-examples)
+ script.
-### PNG
-- `simulator_screenie.png` provided by [Rens Verhoeven](https://github.com/renssies)
+### KEY
+- The `keynote_recognized_as_jpeg.key` file was created by the project maintainers
-### TIFF
-- `Shinbutsureijoushuincho.tiff` is obtained from Wikimedia Commons and is Creative Commons licensed
-- `IMG_9266_*.tif` and all it's variations were created by the project maintainers
+### M3U
+- The M3U fixture files were created by one of the project maintainers
-### ARW
-- ARW examples are downloaded from http://www.rawsamples.ch/ and are Creative Common Licensed.
+### M4A
+- fixture.m4a was created by one of the project maintainers and is MIT licensed
-### ZIP
-- The .zip fixture files have been created by the project maintainers
+### MOOV
+- bmff.mp4 is borrowed from the [bmff](https://github.com/zuku/bmff) project
+- Test_Circular MOV files were created by one of the project maintainers and are MIT licensed
-### .docx
-- The .docx files were generated by the project maintainers
+### MP3
+- Cassy.mp3 has been produced by WeTransfer and may be used with the library for the purposes of testing
-### .mpg and .mpeg
+### MPEG
- The files (video 1 to 4) were downloaded from https://standaloneinstaller.com/blog/big-list-of-sample-videos-for-testers-124.html.
- Video 5 was downloaded from https://archive.org/details/ligouHDR-HC1_sample1.
-### JPEG examples of EXIF orientation
-- Downloaded from Unspash (and thus freely avaliable) - https://unsplash.com/license and have then been
- manipulated using the [https://github.com/recurser/exif-orientation-examples](exif-orientation-examples)
- script.
+### NEF
+- NEF examples are downloaded from http://www.rawsamples.ch/ and are Creative Common Licensed.
-### M3U
-- The M3U fixture files were created by one of the project maintainers
+### OGG
+- `hi.ogg`, `vorbis.ogg`, `with_confusing_magic_string.ogg`, `with_garbage_at_the_end.ogg` have been generated by the project contributors
+### PNG
+- `simulator_screenie.png` provided by [Rens Verhoeven](https://github.com/renssies)
+
+### TIFF
+- `Shinbutsureijoushuincho.tiff` is obtained from Wikimedia Commons and is Creative Commons licensed
+- `IMG_9266_*.tif` and all it's variations were created by the project maintainers
+
+### WAV
+- c_11k16bitpcm.wav and c_8kmp316.wav are from [Wikipedia WAV](https://en.wikipedia.org/wiki/WAV#Comparison_of_coding_schemes), retrieved January 7, 2018
+- c_39064__alienbomb__atmo-truck.wav is from [freesound](https://freesound.org/people/alienbomb/sounds/39064/) and is CC0 licensed
+- c_M1F1-Alaw-AFsp.wav and d_6_Channel_ID.wav are from a [McGill Engineering site](http://www-mmsp.ece.mcgill.ca/Documents/AudioFormats/WAVE/Samples.html)
+
### WEBP
-- With the exception of extended-animation.webp, which was obtained from Wikimedia Commons and is Creative Commons
-licensed, all of the WebP fixture files have been created by one of the project maintainers.
+- With the exception of extended-animation.webp, which was obtained from Wikimedia Commons and is Creative Commons
+ licensed, all of the WebP fixture files have been created by one of the project maintainers.
-### .key
-- The `keynote_recognized_as_jpeg.key` file was created by the project maintainers
+### ZIP
+- The .zip fixture files have been created by the project maintainers
## Copyright
Copyright (c) 2020 WeTransfer.