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.
 
 
CameraView/docs/_posts/2019-07-14-watermarks-and-o...

2.5 KiB

layout title subtitle description category order date disqus
page Watermarks and Overlays Static and animated overlays Static and animated overlays docs 10 2019-07-14 20:14:31 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

<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:

// 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);