anasanasanas/InstaCapture

Android library to capture screenshot from your app

InstaCapture

Android library to capture screenshot from your app

Features

• Capture all the contents of the screen, includes:

  • Google Maps (MapView, SupportMapFragment)
  • Dialogs, context menus, toasts
  • TextureView
  • GLSurfaceView

• Set a specific view(s) to prevent it from capturing.

• No permissions are required.

Installation

Add this to your module build.gradle file:

dependencies {
	...
	 compile "com.github.tarek360:instacapture:1.2.2"
}

Add this to your root build.gradle file (not your module build.gradle file) :

allprojects {
	repositories {
		...
		maven { url "https://jitpack.io" }
	}
}

How to use InstaCapture ?

• To capture a screenshot with ScreenCaptureListener.

   InstaCapture.getInstance(activity).capture().setScreenCapturingListener(new ScreenCaptureListener() {

      @Override public void onCaptureStarted() {
          //TODO..
      }
      @Override public void onCaptureFailed(Throwable e) {
          //TODO..
      }
      @Override public void onCaptureComplete(Bitmap bitmap) {
          //TODO..
      }
    });

OR

• To capture a screenshot with RxJava 1

 Subscription subscription = InstaCapture.getInstance(activity).captureRxV1().subscribe(new SingleSubscriber<Bitmap>() {
        @Override public void onSuccess(Bitmap bitmap) {
            //TODO..
        }

        @Override public void onError(Throwable error) {
            //TODO..
        }
 });

//OnDestroy
 subscription.unsubscribe();

• To capture a screenshot with RxJava 2

Disposable disposable = InstaCapture.getInstance(activity).captureRx().subscribeWith(new DisposableSingleObserver<Bitmap>() {
        @Override public void onSuccess(Bitmap bitmap) {
            //TODO..
        }
        @Override  public void onError(Throwable e) {
            //TODO..
        }
});

//OnDestroy
disposable.dispose();

• To ignore view(s) from the screenshot.

.capture(ignoredView); or .captureRx(ignoredView);

• To enable logging.

InstaCaptureConfiguration config = new InstaCaptureConfiguration.Builder().logging(true).build();
InstaCapture.setConfiguration(config);

License

Copyright 2016 Tarek360

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.