From 097420a96b3d8f6b43e9f45ea08f97a599034081 Mon Sep 17 00:00:00 2001 From: Mattia Iavarone Date: Mon, 16 Dec 2019 16:03:52 +0100 Subject: [PATCH] Release v2.5.0 (#708) --- README.md | 2 +- cameraview/build.gradle | 2 +- docs/_posts/2018-12-20-changelog.md | 27 +++++++++++++++++++++++++++ docs/_posts/2018-12-20-install.md | 2 +- 4 files changed, 30 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index ec06f86b..1590186c 100644 --- a/README.md +++ b/README.md @@ -22,7 +22,7 @@ CameraView is a well documented, high-level library that makes capturing picture addressing most of the common issues and needs, and still leaving you with flexibility where needed. ```groovy -api 'com.otaliastudios:cameraview:2.4.0' +api 'com.otaliastudios:cameraview:2.5.0' ``` - Fast & reliable diff --git a/cameraview/build.gradle b/cameraview/build.gradle index 692e9baa..e58e54be 100644 --- a/cameraview/build.gradle +++ b/cameraview/build.gradle @@ -3,7 +3,7 @@ apply plugin: 'com.github.dcendents.android-maven' apply plugin: 'com.jfrog.bintray' // Required by bintray -version = '2.4.0' +version = '2.5.0' group = 'com.otaliastudios' //region android dependencies diff --git a/docs/_posts/2018-12-20-changelog.md b/docs/_posts/2018-12-20-changelog.md index c3c207e9..184f7a49 100644 --- a/docs/_posts/2018-12-20-changelog.md +++ b/docs/_posts/2018-12-20-changelog.md @@ -11,6 +11,29 @@ New versions are released through GitHub, so the reference page is the [GitHub R Starting from 2.4.0, you can now [support development](https://github.com/sponsors/natario1) through the GitHub Sponsors program. Companies can share a tiny part of their revenue and get private support hours in return. Thanks! +## v2.5.0 + +- [*Camera2*] New: support for RAW pictures with new APIs `setPictureFormat()` and `CameraOptions.getSupportedPictureFormats()`. Contains a **breaking change**: `PictureResult.getFormat()` is not an integer anymore but rather a `PictureFormat`. This API had no real purpose so this might not affect you ([#691][691]) +- [*Camera2*] New: support for constraining the frame processing size through `setFrameProcessingMaxWidth()` and `setFrameProcessingMaxHeight()`. This can improve processing performance ([#691][691]) +- [*Camera2*] New: support for choosing the frame processing format through `setFrameProcessingFormat()` and `CameraOptions.getSupportedFrameProcessingFormats()` ([#691][691]) +- [*Camera2*] Improvement: Frame processing FPS for Camera2 is now smooth and typically better than Camera1. This required some **breaking changes** (see below) ([#691][691]) +- [*Camera1, Camera2*] Improvement: improved internal threading ([#697][697]) +- [*Camera1, Camera2*] Improvement: improvements to stability and edge cases behavior ([#696][696]) +- [*Real time filters*] Change: filters do not need the experimental flag anymore ([#691][691]) + +The new frame processing approach will force you to update your code, because `Frame.getData()` is +not a a byte[] anymore. The class of this object now depends on the engine being used. You can use +`frame.getDataClass()` (or instanceof) to check. + +If you are using the Camera1 engine, you will still receive byte arrays, so you can just cast `frame.getData()` to +`byte[]`, assuming it's not done already by the compiler. + +If you are using the experimental Camera2 engine, you will receive `android.media.Image`s instead. +This object will likely be accepted by frame processing libraries, and also offers access to raw byte data. +This change greatly improved the FPS performance, which is what matters the most at the library level. + +https://github.com/natario1/CameraView/compare/v2.4.0...v2.5.0 + ## v2.4.0 - [*Camera2*] New: support for `previewFrameRate`. Controls preview FPS, snapshot FPS, processor FPS, thanks to [@vaibhavbhandula][vaibhavbhandula] ([#653][653]) @@ -353,3 +376,7 @@ https://github.com/natario1/CameraView/compare/v1.2.3...v1.3.0 [651]: https://github.com/natario1/CameraView/pull/651 [653]: https://github.com/natario1/CameraView/pull/653 [661]: https://github.com/natario1/CameraView/pull/661 +[691]: https://github.com/natario1/CameraView/pull/691 +[696]: https://github.com/natario1/CameraView/pull/696 +[697]: https://github.com/natario1/CameraView/pull/697 +[704]: https://github.com/natario1/CameraView/pull/704 diff --git a/docs/_posts/2018-12-20-install.md b/docs/_posts/2018-12-20-install.md index a51303ce..fa7ae2ac 100644 --- a/docs/_posts/2018-12-20-install.md +++ b/docs/_posts/2018-12-20-install.md @@ -24,7 +24,7 @@ allprojects { Then simply download the latest version: ```groovy -api 'com.otaliastudios:cameraview:2.4.0' +api 'com.otaliastudios:cameraview:2.5.0' ``` No other configuration steps are needed. \ No newline at end of file