diff --git a/docs/_posts/2018-12-20-changelog.md b/docs/_posts/2018-12-20-changelog.md index 80b42004..dfa5f24e 100644 --- a/docs/_posts/2018-12-20-changelog.md +++ b/docs/_posts/2018-12-20-changelog.md @@ -8,6 +8,10 @@ order: 3 New versions are released through GitHub, so the reference page is the [GitHub Releases](https://github.com/natario1/CameraView/releases) page. +### v2.0.0-*** (to be released) + +- New: `cameraUseDeviceOrientation` XML attribute and `setUseDeviceOrientation()` method to disable considering the device orientation for outputs. ([#497][497]) + ### v2.0.0-beta06 - New: Full featured Camera2 integration! Use `cameraExperimental="true"` and `cameraEngine="camera2"` to test this out. ([#490][490]) @@ -64,4 +68,5 @@ This is the first beta release. For changes with respect to v1, please take a lo [477]: https://github.com/natario1/CameraView/pull/477 [482]: https://github.com/natario1/CameraView/pull/482 [484]: https://github.com/natario1/CameraView/pull/484 -[490]: https://github.com/natario1/CameraView/pull/490 \ No newline at end of file +[490]: https://github.com/natario1/CameraView/pull/490 +[497]: https://github.com/natario1/CameraView/pull/497 \ No newline at end of file diff --git a/docs/_posts/2018-12-20-more-features.md b/docs/_posts/2018-12-20-more-features.md index 1f6062c0..e1e3931f 100644 --- a/docs/_posts/2018-12-20-more-features.md +++ b/docs/_posts/2018-12-20-more-features.md @@ -16,7 +16,8 @@ disqus: 1 app:cameraPlaySounds="true|false" app:cameraGrid="off|draw3x3|draw4x4|drawPhi" app:cameraGridColor="@color/black" - app:cameraAutoFocusResetDelay="0"/> + app:cameraAutoFocusResetDelay="0" + app:cameraUseDeviceOrientation="true"/> ``` ##### cameraPlaySounds @@ -89,6 +90,18 @@ cameraView.setCameraAutoFocusResetDelay(-1); // NO reset cameraView.setCameraAutoFocusResetDelay(Long.MAX_VALUE); // NO reset ``` +##### cameraUseDeviceOrientation + +Controls whether we should consider the device orientation for picture and video outputs. +This defaults to true, but can be set to false for specific usages, where you don't want the +output to be rotated based on the device rotation at the moment of capturing. +Defaults to true. + +```java +cameraView.setUseDeviceOrientation(true); // rotate media +cameraView.setUseDeviceOrientation(false); // don't +``` + ### UI Orientation Within a Camera app, it's common to rotate buttons and other UI elements as the device is tilted around. diff --git a/docs/_posts/2018-12-20-previews.md b/docs/_posts/2018-12-20-previews.md index 5e185e9f..7987c496 100644 --- a/docs/_posts/2018-12-20-previews.md +++ b/docs/_posts/2018-12-20-previews.md @@ -64,4 +64,6 @@ The engine method should only be called when the `CameraView` is closed. Otherwi |Method|Description| |------|-----------| |`setPreview(Preview)`|Sets the preview implementation.| +|`getPreview()`|Gets the current preview implementation.| |`setEngine(Engine)`|Sets the engine implementation.| +|`getEngine()`|Gets the current engine implementation.|