sizes, int w, int h) {
final double ASPECT_TOLERANCE = 0.1;
double targetRatio = (double) h / w;
if (sizes == null) return null;
Camera.Size optimalSize = null;
double minDiff = Double.MAX_VALUE;
for (Camera.Size size : sizes) {
double ratio = (double) size.width / size.height;
if (Math.abs(ratio - targetRatio) > ASPECT_TOLERANCE) continue;
if (Math.abs(size.height - h) < minDiff) {
optimalSize = size;
minDiff = Math.abs(size.height - h);
}
}
if (optimalSize == null) {
minDiff = Double.MAX_VALUE;
for (Camera.Size size : sizes) {
if (Math.abs(size.height - h) < minDiff) {
optimalSize = size;
minDiff = Math.abs(size.height - h);
}
}
}
return optimalSize;
}
@Override
public boolean onSurfaceTextureDestroyed(SurfaceTexture surface) {
camera.stopPreview();
camera.release();
return true;
}
@Override
public void onSurfaceTextureSizeChanged(SurfaceTexture surface, int width, int height) {
}
@Override
public void onSurfaceTextureUpdated(SurfaceTexture surface) {
}
}
================================================
FILE: demo/src/main/java/io/github/muddz/quickshot/demo/fragments/ViewFragment.java
================================================
package io.github.muddz.quickshot.demo.fragments;
import android.os.Bundle;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.LinearLayout;
import androidx.annotation.NonNull;
import androidx.annotation.Nullable;
import io.github.muddz.quickshot.demo.DrawingBoardView;
import io.github.muddz.quickshot.demo.R;
/**
* Created by Muddz on 23-08-2017.
*/
public class ViewFragment extends BaseFragment implements DrawingBoardView.OnDrawingListener {
private DrawingBoardView drawingBoardView;
private LinearLayout drawHint;
@Nullable
@Override
public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
View v = inflater.inflate(R.layout.view_fragment, container, false);
drawingBoardView = v.findViewById(R.id.drawingview);
drawingBoardView.setOnDrawingListener(this);
drawHint = v.findViewById(R.id.drawhint);
return v;
}
@Override
public View getTargetView() {
return drawingBoardView;
}
@Override
public void onDrawingStarted() {
drawHint.setVisibility(View.GONE);
}
}
================================================
FILE: demo/src/main/res/drawable/ic_launcher_background.xml
================================================
================================================
FILE: demo/src/main/res/drawable/ic_save_black_24dp.xml
================================================
================================================
FILE: demo/src/main/res/drawable/ic_select.xml
================================================
================================================
FILE: demo/src/main/res/drawable-v24/ic_launcher_foreground.xml
================================================
* Directories which don't already exist will be automatically created.
*
* @param path if not set, path defaults to /Pictures/ regardless of any API level
*/
public QuickShot setPath(String path) {
this.path = path;
return this;
}
private void setFileExtension(String fileExtension) {
this.fileExtension = fileExtension;
}
/**
* Save as .jpg format in highest quality
* default is .jpg
*/
public QuickShot toJPG() {
jpgQuality = JPG_MAX_QUALITY;
setFileExtension(EXTENSION_JPG);
return this;
}
/**
* Save as .jpg format in a custom quality between 0-100
* default is 100
*/
public QuickShot toJPG(int jpgQuality) {
this.jpgQuality = jpgQuality;
setFileExtension(EXTENSION_JPG);
return this;
}
/**
* Save as .png format for lossless compression
* default is .jpg
*/
public QuickShot toPNG() {
setFileExtension(EXTENSION_PNG);
return this;
}
/**
* Save as .nomedia for making the picture invisible for photo viewer apps and galleries.
*/
public QuickShot toNomedia() {
setFileExtension(EXTENSION_NOMEDIA);
return this;
}
/**
* Enable QuickShot to log and print exception stacks
*/
public QuickShot enableLogging() {
printStackTrace = true;
return this;
}
/**
* Listen for successive or failure results when calling save()
*/
public QuickShot setResultListener(@NonNull QuickShotListener listener) {
this.listener = listener;
if (listener == null) {
throw new NullPointerException("QuickShot.setResultListener() was provided with a null object reference");
}
return this;
}
private Context getContext() {
if (context == null) {
throw new NullPointerException("Attempt to save the picture failed: View or Context was null");
}
return context;
}
private Bitmap getBitmap() {
if (bitmap != null) {
return bitmap;
} else if (view instanceof TextureView) {
bitmap = ((TextureView) view).getBitmap();
Canvas canvas = new Canvas(bitmap);
view.draw(canvas);
canvas.setBitmap(null);
return bitmap;
} else {
bitmap = Bitmap.createBitmap(view.getWidth(), view.getHeight(), Bitmap.Config.ARGB_8888);
Canvas canvas = new Canvas(bitmap);
view.draw(canvas);
canvas.setBitmap(null);
return bitmap;
}
}
/**
* save() runs in a asynchronous thread
*
* @throws NullPointerException if View is null.
*/
public void save() throws NullPointerException {
if (view instanceof SurfaceView) {
PixelCopyHelper.getSurfaceBitmap((SurfaceView) view, new PixelCopyHelper.PixelCopyListener() {
@Override
public void onSurfaceBitmapReady(Bitmap surfaceBitmap) {
new BitmapSaver(getContext(), surfaceBitmap, printStackTrace, path, filename, fileExtension, jpgQuality, listener).execute();
}
@Override
public void onSurfaceBitmapError(String errorMsg) {
listener.onQuickShotFailed(path, errorMsg);
}
});
} else {
new BitmapSaver(getContext(), getBitmap(), printStackTrace, path, filename, fileExtension, jpgQuality, listener).execute();
}
}
public interface QuickShotListener {
void onQuickShotSuccess(String path);
void onQuickShotFailed(String path, String errorMsg);
}
static class BitmapSaver extends AsyncTask {
private final WeakReference weakContext;
private Handler mainThreadHandler = new Handler(Looper.getMainLooper());
private boolean printStacktrace;
private int jpgQuality;
private String errorMsg;
private String path;
private String filename;
private String fileExtension;
private Bitmap bitmap;
private File file;
private QuickShotListener listener;
BitmapSaver(Context context, Bitmap bitmap, boolean printStacktrace, String path, String filename, String fileExtension, int jpgQuality, QuickShotListener listener) {
this.weakContext = new WeakReference<>(context);
this.bitmap = bitmap;
this.printStacktrace = printStacktrace;
this.path = path;
this.filename = filename;
this.fileExtension = fileExtension;
this.jpgQuality = jpgQuality;
this.listener = listener;
}
/**
* @deprecated
*/
private void saveLegacy() {
if (path == null) {
path = Environment.getExternalStorageDirectory() + File.separator + DIRECTORY_PICTURES;
}
File directory = new File(path);
directory.mkdirs();
file = new File(directory, filename + fileExtension);
try (OutputStream out = new BufferedOutputStream(new FileOutputStream(file))) {
switch (fileExtension) {
case EXTENSION_JPG:
bitmap.compress(Bitmap.CompressFormat.JPEG, jpgQuality, out);
break;
case EXTENSION_PNG:
bitmap.compress(Bitmap.CompressFormat.PNG, 0, out);
break;
}
} catch (Exception e) {
if (printStacktrace) {
e.printStackTrace();
}
errorMsg = e.toString();
cancel(true);
} finally {
bitmap = null;
}
}
@RequiresApi(Build.VERSION_CODES.Q)
private void saveScopedStorage() {
path = path != null ? (DIRECTORY_PICTURES + File.separator + path) : DIRECTORY_PICTURES;
ContentValues contentValues = new ContentValues();
contentValues.put(MediaStore.MediaColumns.DISPLAY_NAME, filename);
contentValues.put(MediaStore.MediaColumns.RELATIVE_PATH, path);
contentValues.put(MediaStore.MediaColumns.MIME_TYPE, QuickShotUtils.getMimeType(fileExtension));
ContentResolver resolver = weakContext.get().getContentResolver();
Uri imageUri = resolver.insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, contentValues);
if (imageUri == null) {
errorMsg = String.format("Couldn't insert ContentValues with data: [%s] into the ContentResolver", contentValues.toString());
cancel(true);
return;
}
try (OutputStream out = resolver.openOutputStream(imageUri)) {
switch (fileExtension) {
case EXTENSION_JPG:
bitmap.compress(Bitmap.CompressFormat.JPEG, jpgQuality, out);
break;
case EXTENSION_PNG:
bitmap.compress(Bitmap.CompressFormat.PNG, 0, out);
break;
}
file = new File(path, filename + fileExtension);
} catch (Exception e) {
if (printStacktrace) {
e.printStackTrace();
}
errorMsg = e.toString();
resolver.delete(imageUri, null, null);
cancel(true);
} finally {
bitmap = null;
}
}
@Override
protected Void doInBackground(Void... voids) {
if (QuickShotUtils.isAboveAPI29()) {
saveScopedStorage();
} else {
saveLegacy();
}
return null;
}
@Override
protected void onPostExecute(Void v) {
listener.onQuickShotSuccess(file.getAbsolutePath());
if (!QuickShotUtils.isAboveAPI29()) {
MediaScannerConnection.scanFile(weakContext.get(), new String[]{file.getAbsolutePath()}, null, null);
}
}
@Override
protected void onCancelled() {
mainThreadHandler.post(new Runnable() {
@Override
public void run() {
listener.onQuickShotFailed(file.getAbsolutePath(), errorMsg);
}
});
}
}
}
================================================
FILE: quickshot/src/main/java/io/github/muddz/quickshot/QuickShotUtils.java
================================================
package io.github.muddz.quickshot;
import android.graphics.Bitmap;
import android.graphics.Canvas;
import android.graphics.drawable.Drawable;
import android.os.Build;
import android.view.View;
import androidx.recyclerview.widget.RecyclerView;
import java.io.File;
class QuickShotUtils {
static String getMimeType(String src) {
src = src.substring(1);
if (src.equals("jpg")) {
src = "jpeg";
}
return "image" + File.separator + src;
}
static boolean isAboveAPI29() {
return Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q;
}
private Bitmap generateLongBitmap(RecyclerView recyclerView) {
int itemCount = recyclerView.getAdapter().getItemCount();
RecyclerView.ViewHolder viewHolder = recyclerView.getAdapter().createViewHolder(recyclerView, 0);
//Measure the sizes of list item views to find out how big itemView should be
viewHolder.itemView.measure(View.MeasureSpec.makeMeasureSpec(recyclerView.getWidth(), View.MeasureSpec.EXACTLY), View.MeasureSpec.makeMeasureSpec(0, View.MeasureSpec.UNSPECIFIED));
// Define measured widths/heights
int measuredItemHeight = viewHolder.itemView.getMeasuredHeight();
int measuredItemWidth = viewHolder.itemView.getMeasuredWidth();
//Set width/height of list item views
viewHolder.itemView.layout(0, 0, measuredItemWidth, measuredItemHeight);
//Create the Bitmap and Canvas to draw on
Bitmap recyclerViewBitmap = Bitmap.createBitmap(recyclerView.getMeasuredWidth(), measuredItemHeight * itemCount, Bitmap.Config.ARGB_8888);
Canvas canvas = new Canvas(recyclerViewBitmap);
//Draw RecyclerView Background:
if (recyclerView.getBackground() != null) {
Drawable drawable = recyclerView.getBackground().mutate();
drawable.setBounds(measuredItemWidth, measuredItemHeight * itemCount, 0, 0);
drawable.draw(canvas);
}
//Draw all list item views
int viewHolderTopPadding = 0;
for (int i = 0; i < itemCount; i++) {
recyclerView.getAdapter().onBindViewHolder(viewHolder, i);
viewHolder.itemView.setDrawingCacheEnabled(true);
viewHolder.itemView.buildDrawingCache();
canvas.drawBitmap(viewHolder.itemView.getDrawingCache(), 0f, viewHolderTopPadding, null);
viewHolderTopPadding += measuredItemHeight;
viewHolder.itemView.setDrawingCacheEnabled(false);
viewHolder.itemView.destroyDrawingCache();
// //TODO This should work but doesn't
// recyclerView.getAdapter().onBindViewHolder(viewHolder, i);
// viewHolder.itemView.draw(canvas);
// canvas.drawBitmap(recyclerViewBitmap, 0f, viewHolderTopPadding, null);
// viewHolderTopPadding += measuredItemHeight;
}
return recyclerViewBitmap;
}
}
================================================
FILE: readme.md
================================================
# QuickShot
[](https://android-arsenal.com/api?level=19)
[](https://github.com/Muddz/QuickShot/blob/master/QuickShotDemo.apk?raw=true)
An Android library that saves any `View`, `SurfaceView` or `Bitmap` as an image in `JPG`,`PNG` or `.nomedia`.
The library works on a asynchronous thread and handles errors and memory for you.
### Features
- Support for Android API 29+ and scoped storage
- Save in `JPG`,`PNG` or `.nomedia`.
- Save `Bitmap`, `View` or `SurfaceView` objects as images
- Set a path and filename for your captures or resort to auto defaults
- Asynchronous saving
## Example of simplest usage with defaults
You can use a simple one-liner and let QuickShot set default values like in the following example:
Filename defaults to a timestamp.
Path defaults to `/Pictures` in internal storage.
Image format defaults to `.JPG`
```java
QuickShot.of(view).setResultListener(this).save();
```
## Example of a detailed usage
```java
QuickShot.of(view).setResultListener(this)
.enableLogging()
.setFilename("QuickShot")
.setPath("MyApp")
.toPNG()
.save();
```
## Installation
Add the dependency in your `build.gradle`
```groovy
dependencies {
implementation 'io.github.muddz:quickshot:1.4.0'
}
```
----
## License
Copyright 2018 Muddi Walid
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.
================================================
FILE: settings.gradle
================================================
include ':demo', ':quickshot'