[](https://travis-ci.org/natario1/CameraView)
[](https://codecov.io/gh/natario1/CameraView)
[](https://github.com/natario1/CameraView/releases)
[](https://github.com/natario1/CameraView/issues)
[](https://natario1.github.io/CameraView/extra/donate)
*This is a new major version (v2) of the library. It includes breaking changes, signature changes and new functionality.
Keep reading if interested, or head to the legacy-v1 branch to read v1 documentation and info.*
*The v2 version is still in beta and its API surface might still change. Functions might be renamed,
options might be removed (though they probably won't), signatures might change. If this is a problem,
please wait for the final release and keep using v1*.
< p align = "center" >
< img src = "docs/static/icon.png" vspace = "10" width = "250" height = "250" >
< / p >
# CameraView
CameraView is a well documented, high-level library that makes capturing pictures and videos easy,
addressing most of the common issues and needs, and still leaving you with flexibility where needed.
```groovy
compile 'com.otaliastudios:cameraview:2.0.0-beta06'
```
- Fast & reliable
- Gestures support [[docs]](https://natario1.github.io/CameraView/docs/gestures.html)
- Camera1 or Camera2 powered engine [[docs]](https://natario1.github.io/CameraView/docs/previews.html)
- Frame processing support [[docs]](https://natario1.github.io/CameraView/docs/frame-processing.html)
- Watermarks & animated overlays [[docs]](https://natario1.github.io/CameraView/docs/watermarks-and-overlays.html)
- OpenGL powered preview [[docs]](https://natario1.github.io/CameraView/docs/previews.html)
- Take high-quality content with `takePicture` and `takeVideo` [[docs]](https://natario1.github.io/CameraView/docs/capturing-media.html)
- Take super-fast snapshots with `takePictureSnapshot` and `takeVideoSnapshot` [[docs]](https://natario1.github.io/CameraView/docs/capturing-media.html)
- Smart sizing: create a `CameraView` of any size [[docs]](https://natario1.github.io/CameraView/docs/preview-size.html)
- Control HDR, flash, zoom, white balance, exposure, location, grid drawing & more [[docs]](https://natario1.github.io/CameraView/docs/controls.html)
- Lightweight
- Works down to API level 15
- Well tested
Read the [official website ](https://natario1.github.io/CameraView ) for setup instructions and documentation.
You might also be interested in [changelog ](https://natario1.github.io/CameraView/about/changelog.html )
or in the [v1 migration guide ](https://natario1.github.io/CameraView/extra/v1-migration-guide.html ).
< p >
< img src = "docs/static/screen1.jpg" width = "250" vspace = "20" hspace = "5" >
< img src = "docs/static/screen2.jpg" width = "250" vspace = "20" hspace = "5" >
< img src = "docs/static/screen3.jpg" width = "250" vspace = "20" hspace = "5" >
< / p >
If you like the project, use it with profit, or simply want to thank back, please consider [donating
to the project](https://natario1.github.io/CameraView/extra/donate) now! You can either make a one time
donation or become a sponsor, in which case your company logo will immediately show up here.
Thank you for any contribution - it is a nice reward for what has been done until now, and a
motivation boost to push the library forward.
```xml
< com.otaliastudios.cameraview.CameraView
xmlns:app="http://schemas.android.com/apk/res-auto"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
app:cameraPictureSizeMinWidth="@integer/picture_min_width"
app:cameraPictureSizeMinHeight="@integer/picture_min_height"
app:cameraPictureSizeMaxWidth="@integer/picture_max_width"
app:cameraPictureSizeMaxHeight="@integer/picture_max_height"
app:cameraPictureSizeMinArea="@integer/picture_min_area"
app:cameraPictureSizeMaxArea="@integer/picture_max_area"
app:cameraPictureSizeSmallest="false|true"
app:cameraPictureSizeBiggest="false|true"
app:cameraPictureSizeAspectRatio="@string/video_ratio"
app:cameraVideoSizeMinWidth="@integer/video_min_width"
app:cameraVideoSizeMinHeight="@integer/video_min_height"
app:cameraVideoSizeMaxWidth="@integer/video_max_width"
app:cameraVideoSizeMaxHeight="@integer/video_max_height"
app:cameraVideoSizeMinArea="@integer/video_min_area"
app:cameraVideoSizeMaxArea="@integer/video_max_area"
app:cameraVideoSizeSmallest="false|true"
app:cameraVideoSizeBiggest="false|true"
app:cameraVideoSizeAspectRatio="@string/video_ratio"
app:cameraSnapshotMaxWidth="@integer/snapshot_max_width"
app:cameraSnapshotMaxHeight="@integer/snapshot_max_height"
app:cameraVideoBitRate="@integer/video_bit_rate"
app:cameraAudioBitRate="@integer/audio_bit_rate"
app:cameraGestureTap="none|autoFocus|takePicture"
app:cameraGestureLongTap="none|autoFocus|takePicture"
app:cameraGesturePinch="none|zoom|exposureCorrection"
app:cameraGestureScrollHorizontal="none|zoom|exposureCorrection"
app:cameraGestureScrollVertical="none|zoom|exposureCorrection"
app:cameraEngine="camera1|camera2"
app:cameraPreview="glSurface|surface|texture"
app:cameraFacing="back|front"
app:cameraHdr="on|off"
app:cameraFlash="on|auto|torch|off"
app:cameraWhiteBalance="auto|cloudy|daylight|fluorescent|incandescent"
app:cameraMode="picture|video"
app:cameraAudio="on|off|mono|stereo"
app:cameraGrid="draw3x3|draw4x4|drawPhi|off"
app:cameraGridColor="@color/grid_color"
app:cameraPlaySounds="true|false"
app:cameraVideoMaxSize="@integer/video_max_size"
app:cameraVideoMaxDuration="@integer/video_max_duration"
app:cameraVideoCodec="deviceDefault|h264|h263"
app:cameraAutoFocusResetDelay="@integer/autofocus_delay"
app:cameraAutoFocusMarker="@string/cameraview_default_autofocus_marker"
app:cameraUseDeviceOrientation="true|false"
app:cameraExperimental="false|true">
<!-- Watermark! -->
< ImageView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="bottom|end"
android:src="@drawable/watermark"
app:layout_drawOnPreview="true|false"
app:layout_drawOnPictureSnapshot="true|false"
app:layout_drawOnVideoSnapshot="true|false"/>
< / com.otaliastudios.cameraview.CameraView >
```
## Backers
Thanks to all backers! [Become a backer. ](https://opencollective.com/cameraview#backer )
< a href = "https://opencollective.com/cameraview#backers" target = "_blank" > < img src = "https://opencollective.com/cameraview/backers.svg?width=890" > < / a >
## Sponsors
Thanks to sponsors! [Become a sponsor ](https://opencollective.com/cameraview#sponsor ) and have your logo here.
< a href = "https://opencollective.com/cameraview/sponsor/0/website" target = "_blank" > < img src = "https://opencollective.com/cameraview/sponsor/0/avatar.svg" > < / a >
< a href = "https://opencollective.com/cameraview/sponsor/1/website" target = "_blank" > < img src = "https://opencollective.com/cameraview/sponsor/1/avatar.svg" > < / a >
< a href = "https://opencollective.com/cameraview/sponsor/2/website" target = "_blank" > < img src = "https://opencollective.com/cameraview/sponsor/2/avatar.svg" > < / a >
< a href = "https://opencollective.com/cameraview/sponsor/3/website" target = "_blank" > < img src = "https://opencollective.com/cameraview/sponsor/3/avatar.svg" > < / a >
< a href = "https://opencollective.com/cameraview/sponsor/4/website" target = "_blank" > < img src = "https://opencollective.com/cameraview/sponsor/4/avatar.svg" > < / a >
< a href = "https://opencollective.com/cameraview/sponsor/5/website" target = "_blank" > < img src = "https://opencollective.com/cameraview/sponsor/5/avatar.svg" > < / a >
< a href = "https://opencollective.com/cameraview/sponsor/6/website" target = "_blank" > < img src = "https://opencollective.com/cameraview/sponsor/6/avatar.svg" > < / a >
< a href = "https://opencollective.com/cameraview/sponsor/7/website" target = "_blank" > < img src = "https://opencollective.com/cameraview/sponsor/7/avatar.svg" > < / a >
< a href = "https://opencollective.com/cameraview/sponsor/8/website" target = "_blank" > < img src = "https://opencollective.com/cameraview/sponsor/8/avatar.svg" > < / a >
< a href = "https://opencollective.com/cameraview/sponsor/9/website" target = "_blank" > < img src = "https://opencollective.com/cameraview/sponsor/9/avatar.svg" > < / a >
