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.
513 Commits
7 Branches
43 Tags
35 MiB
 
 
Tag: Branch: Tree: stop-video
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'stop-video'
${ noResults }
CameraView/docs/_posts/2019-02-24-snapshot-size.md

2.2 KiB
Raw Permalink Blame History

layout title subtitle description category order date disqus
page Snapshot Size Sizing the snapshots output Sizing the snapshots output docs 9 2019-02-24 17:36:39 1

Snapshots are captured from the preview stream instead of using a separate capture channel. They are extremely fast, small in size, and give you a low-quality output that can be easily uploaded or processed.

The snapshot size is based on the size of the preview stream, which is described in the Preview Size document. Although the preview stream size is customizable, note that this is considered an advanced feature, as the best preview stream size selector already does a good job for the vast majority of use cases.

When taking snapshots, the preview stream size is then changed to match some constraints.

Matching the preview ratio

Snapshots will automatically be cropped to match the preview aspect ratio. This means that if your preview is square, you can finally take a square picture or video, regardless of the available sensor sizes.

Take a look at the Preview Size document to learn about preview sizing.

Other constraints

You can refine the size further by applying maxWidth and a maxHeight constraints:

cameraView.setSnapshotMaxWidth(500);
cameraView.setSnapshotMaxHeight(500);

These values apply to both picture and video snapshots. If the snapshot dimensions exceed these values (both default Integer.MAX_VALUE), the snapshot will be scaled down to match the constraints.

This is very useful as it decouples the snapshot size logic from the preview. By using small constraints, you can have a pleasant, good looking preview stream, while still capturing fast, low-res snapshots with no issues.

XML Attributes

<com.otaliastudios.cameraview.CameraView
    app:cameraSnapshotMaxWidth="500"
    app:cameraSnapshotMaxHeight="500"/>

Related APIs

Method Description
setSnapshotMaxWidth(int) Sets the max width for snapshots. If out of bounds, the output will be scaled down.
setSnapshotMaxHeight(int) Sets the max height for snapshots. If out of bounds, the output will be scaled down.