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.
74 lines
2.5 KiB
74 lines
2.5 KiB
5 years ago
|
---
|
||
|
|
layout: page
|
||
|
|
title: "Watermarks and Overlays"
|
||
|
|
subtitle: "Static and animated overlays"
|
||
|
|
description: "Static and animated overlays"
|
||
|
|
category: docs
|
||
|
|
order: 10
|
||
|
|
date: 2019-07-14 20:14:31
|
||
|
|
disqus: 1
|
||
|
|
---
|
||
|
|
|
||
|
|
CameraView offers a simple yet powerful framework for watermarks and overlays of any kind.
|
||
|
|
These overlays can be shown on the live camera preview, plus they appear on the media results
|
||
|
|
taken with `takePictureSnapshot()` or `takeVideoSnapshot()`.
|
||
|
|
|
||
|
|
### Simple Usage
|
||
|
|
|
||
|
|
```xml
|
||
|
|
<com.otaliastudios.cameraview.CameraView
|
||
|
|
android:layout_width="wrap_content"
|
||
|
|
android:layout_height="wrap_content">
|
||
|
|
|
||
|
|
<!-- Watermark in bottom/end corner -->
|
||
|
|
<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"/>
|
||
|
|
|
||
|
|
<!-- More overlays here... -->
|
||
|
|
|
||
|
|
</com.otaliastudios.cameraview.CameraView>
|
||
|
|
```
|
||
|
|
|
||
|
|
As you can see, the overlay system is View-based - each overlay is just a real `View` attached
|
||
|
|
into the hierarchy. This is a powerful and creative tool. You can, for instance, retrieve the
|
||
|
|
overlay with `findViewById` and:
|
||
|
|
|
||
|
|
- Animate it!
|
||
|
|
- Change its visibility
|
||
|
|
- Change its position or appearance
|
||
|
|
- Do so while video is being recorded
|
||
|
|
|
||
|
|
Any changes in the overlay appearance will be recorded in real-time in the picture snapshot
|
||
|
|
or video snapshot that you are capturing.
|
||
|
|
|
||
|
|
As you can see in the example, you can also selectively choose, for each overlay, whether it
|
||
|
|
will draw on the preview (`layout_drawOnPreview`), on picture snapshots (`layout_drawOnPreview`),
|
||
|
|
on video snapshots (`layout_drawOnPreview`).
|
||
|
|
|
||
|
|
### Advanced Usage
|
||
|
|
|
||
|
|
If you need to change these flags at runtime, you should cast the overlay `LayoutParams` as follows:
|
||
|
|
|
||
|
|
```java
|
||
|
|
// Cast to OverlayLayout.LayoutParams
|
||
|
|
View overlay = findViewById(R.id.watermark);
|
||
|
|
OverlayLayout.LayoutParams params = (OverlayLayout.LayoutParams) overlay.getLayoutParams();
|
||
|
|
|
||
|
|
// Perform changes
|
||
|
|
params.drawOnPreview = true; // draw on preview
|
||
|
|
params.drawOnPreview = false; // do not draw on preview
|
||
|
|
params.drawOnPictureSnapshot = true; // draw on picture snapshots
|
||
|
|
params.drawOnPictureSnapshot = false; // do not draw on picture snapshots
|
||
|
|
params.drawOnVideoSnapshot = true; // draw on video snapshots
|
||
|
|
params.drawOnVideoSnapshot = false; // do not draw on video snapshots
|
||
|
|
|
||
|
|
// When done, apply
|
||
|
|
overlay.setLayoutParams(params);
|
||
|
|
```
|