k
/
CameraView
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
419 Commits
7 Branches
43 Tags
35 MiB
 
 
Tag: Branch: Tree: 26f313c74e
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '26f313c74e'
${ noResults }
CameraView/docs/_posts/2018-12-20-preview-size.md

1.9 KiB
Raw Blame History

layout title subtitle category order date
page Preview Size Measuring behavior docs 7 2018-12-20 22:07:17

CameraView has a smart measuring behavior that will let you do what you want with a few flags. Measuring is controlled simply by layout_width and layout_height attributes, with this meaning:

Value Meaning
WRAP_CONTENT CameraView will choose this dimension, in order to show the whole preview without cropping. The aspect ratio will be respected.
MATCH_PARENT CameraView will fill this dimension. Part of the content might be cropped.
Fixed values (e.g. 500dp) Same as MATCH_PARENT

This means that your visible preview can be of any size, not just the presets. Whatever you do, the preview will never be distorted - it can only be cropped if needed.

Examples

Center Inside

By setting both dimensions to WRAP_CONTENT, you can emulate a center inside behavior. The view will try to fill the available space, but respecting the stream aspect ratio.

<com.otaliastudios.cameraview.CameraView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content" />

This means that the whole preview is visible, and the image output matches what was visible during the preview.

Center Crop

By setting both dimensions to MATCH_PARENT or fixed values, you can emulate a center crop behavior. The camera view will fill the rect. If your dimensions don't match the aspect ratio of the internal preview surface, the surface will be cropped to fill the view.

<com.otaliastudios.cameraview.CameraView
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

This means that part of the preview might be hidden, and the output might contain parts of the scene that were not visible during the capture, unless it is taken as a snapshot, since snapshots account for cropping.