A Magic library to take photos and select pictures in Android. In a simple way and if you need it also save the pictures in device.
SDK
- It requires 14+ API.
Getting Started
Download Sources
use git (sourcetree or others)
git clone https://github.com/fabian7593/MagicalCamera.gitDownload from Here
Another type download by Bintray from 
Give me a question in 
What you need?
You need for usage the library in the best way, call any permissions in Android Manifest.xml
//1.0 version
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.CAMERA"/>
//and for 3.0 version add this
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="com.google.android.providers.gsf.permission.READ_GSERVICES" />
<uses-permission android:name="android.permission.MANAGE_DOCUMENTS"/>### How to use #####Add dependecies If you need to take photo or select picture, this is your solution. This library give a magical solution for take a picture, you only need to download this and integrate this in your project, maybe downloading it or import in your gradle, like this.
repositories {
jcenter()
}
dependencies {
compile 'com.frosquivel:magicalcamera:1.0'
//or the version 3.0
compile 'com.frosquivel:magicalcamera:3.0'
}If you have any problem with this dependence, because the library override any styles or others, please change the last line for this code:
compile('com.frosquivel:magicalcamera:1.0@aar') {
transitive = false;
}#####Import library You need to import the library ```bash import com.frosquivel.magicalcamera.MagicalCamera; ```
#####Declare variable to resize photo ( with pixels percentage ) You need to declare and constant or a simple int variable for the quality of the photo, while greater be, greater be the quality, and otherwise, worst be the quality, like this ```bash //a regular quality, if you declare with 50 is a worst quality and if you declare with 4000 is the better quality //only need to play with this variable (0 to 4000 ... or in other words, worst to better :D)
private int RESIZE_PHOTO_PIXELS_PERCENTAGE = 1000;
<br>
#####Instance Class MagicalCamera
You need to instance the MagicalCamera Class, like this:
The fisrt param is the current Activity, and the second the resize percentage photo
```bash
MagicalCamera magicalCamera = new MagicalCamera(this,RESIZE_PHOTO_PIXELS_PERCENTAGE);
#####Activities Methods You need to call the methods for take or select pictures in activities that this form:
//take photo
magicalCamera.takePhoto();
//select picture
magicalCamera.selectedPicture("my_header_name");#####Fragments Methods You need to call the methods for take or select pictures in fragments that this form:
//take photo
if(magicalCamera.takeFragmentPhoto()){
startActivityForResult(magicalCamera.getIntentFragment(),MagicalCamera.TAKE_PHOTO);
}
//select picture
if(magicalCamera.selectedFragmentPicture()){
startActivityForResult(Intent.createChooser(magicalCamera.getIntentFragment(), "My Header Example"),
MagicalCamera.SELECT_PHOTO);
}#####Remeber override the event onActivityResult You need to override the method onActivityResult in your activity or fragment like this ```bash @Override public void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); //call this method ever magicalCamera.resultPhoto(requestCode, resultCode, data);
//with this form you obtain the bitmap
imageView.setImageBitmap(magicalCamera.getMyPhoto());
String path = magicalCamera.savePhotoInMemoryDevice(magicalCamera.getMyPhoto(),"myPhotoName","myDirectoryName", MagicalCamera.JPEG, true);
//if you need save your bitmap in device use this method
if(path != null){
Toast.makeText(MainActivity.this, "The photo is save in device, please check this path: " + path, Toast.LENGTH_SHORT).show();
}else{
Toast.makeText(MainActivity.this, "Sorry your photo dont write in devide, please contact with fabian7593@gmail and say this error", Toast.LENGTH_SHORT).show();
}
}
<br>
#####The savePhotoInMemoryDevice Method
This method save your bitmap in internal memory device or if the internal memory is full this library save in sdcard (if you have anything :'D)
This method have a lot of params that you can need to use the library:
* **Bitmap:** This is the bitmap that you need to save in memory device.
* **PhotoName:** The name of the photo
* **DirectoryName:** The name of directory that you need to save the image
* **Format:** the format of the photo, maybe png, jpeg or webp. Depends of that you need.
* **AutoIncrementNameByDate:** This variable save the photo with the photo name and the current date and hour. (Only if is true).
For example: myTestMagicalCameraPhoto_20160520131344 -> This is the year 2016, month 5, day 20, hour 13, minute 13 and second 44.
The method:
```bash
public String savePhotoInMemoryDevice(Bitmap bitmap, String photoName, String directoryName,
Bitmap.CompressFormat format, boolean autoIncrementNameByDate)
#####Types of Formats for save photos You have any type of formats for save the pictures and the bitmaps. You can use, the static variables of the library MagicalCamera. ```bash Bitmap.CompressFormat jpeg = MagicalCamera.JPEG; Bitmap.CompressFormat png = MagicalCamera.PNG; Bitmap.CompressFormat webp = MagicalCamera.WEBP; ```
#####Resize photo in real time You can resize the photo in any moment with this: ```bash magicalCamera.setResizePhoto(newResizeInteger); ```
#####Conversion Methods The library have any methods to convert the bitmap in other formats that you need. All of this methods are public statics, I mean that you dont have to instance the library for usage this. * **bitmapToBytes:** Convert the bitmap to array bytes, only need the bitmap param and the compress format, return array bytes. * **bytesToBitmap:** Convert the array bytes to bitmap, only need the array bytes in param, return bitmap. * **bytesToStringBase64:** Convert the array bytes to String base 64, only need the array bytes format in param, return String. * **stringBase64ToBytes:** Convert string to array bytes, only need the String in param, return array bytes.
#3.0 Version Modifications
###New functionalities
- Facial Recognition
- Take photo private information (like, gps location coordinates, the date time photo, brand and company devices).
###Explain New functionalities
Facial Recognition:
This is a method to return your bitmap (magicalCamera.getMyPhoto()) like another bitmap with a square draws arround the face of the photo, with the posibillity of modify the color and the stroke of the square. And this is not all, you have the posibility of call the List of the photo with facial recognitions, for save data of all faces, for example the distance between eyes, the nose position and mounth position, all of this is important information for facials recognitions.
You need to write for example:
if(magicalCamera != null){
if(magicalCamera.getMyPhoto() != null){
//this comment line is the strok 5 and color red for default
//imageView.setImageBitmap(magicalCamera.faceDetector());
imageView.setImageBitmap(magicalCamera.faceDetector(50, Color.GREEN));
List<Landmark> listMark = magicalCamera.getListLandMarkPhoto();
}else{
Toast.makeText(MainActivity.this,
"Your image is null, please select or take one",
Toast.LENGTH_SHORT).show();
}
}else{
Toast.makeText(MainActivity.this,
"Please initialized magical camera, maybe in static context for use in all activity",
Toast.LENGTH_SHORT).show();
}The photo and bitmap converted is like to:
Private information Photo:
This method show you the private information photo if the photo is saved in device or not... For view all information the device need to activate GPS locations (and maybe internet), else not show all information :(.
You need to write this code for example:
if(magicalCamera.getMyPhoto()!=null) {
if(magicalCamera.getImageInformation()) {
StringBuilder builderInformation = new StringBuilder();
if (notNullNotFill(magicalCamera.getLatitude() + ""))
builderInformation.append("Latitude: " + magicalCamera.getLatitude() + "\n");
if (notNullNotFill(magicalCamera.getLatitudeReference()))
builderInformation.append("Latitude Reference: " + magicalCamera.getLatitudeReference() + "\n");
if (notNullNotFill(magicalCamera.getLongitude() + ""))
builderInformation.append("Longitude: " + magicalCamera.getLongitude() + "\n");
if (notNullNotFill(magicalCamera.getLongitudeReference()))
builderInformation.append("Longitude Reference: " + magicalCamera.getLongitudeReference() + "\n");
if (notNullNotFill(magicalCamera.getDateTimeTakePhoto()))
builderInformation.append("Date time to photo: " + magicalCamera.getDateTimeTakePhoto() + "\n");
if (notNullNotFill(magicalCamera.getDateStamp()))
builderInformation.append("Date stamp to photo: " + magicalCamera.getDateStamp() + "\n");
if (notNullNotFill(magicalCamera.getIso()))
builderInformation.append("ISO: " + magicalCamera.getIso() + "\n");
if (notNullNotFill(magicalCamera.getOrientation()))
builderInformation.append("Orientation photo: " + magicalCamera.getOrientation() + "\n");
if (notNullNotFill(magicalCamera.getImageLength()))
builderInformation.append("Image lenght: " + magicalCamera.getImageLength() + "\n");
if (notNullNotFill(magicalCamera.getImageWidth()))
builderInformation.append("Image Width: " + magicalCamera.getImageWidth() + "\n");
if (notNullNotFill(magicalCamera.getModelDevice()))
builderInformation.append("Model Device: " + magicalCamera.getModelDevice() + "\n");
if (notNullNotFill(magicalCamera.getMakeCompany()))
builderInformation.append("Make company: " + magicalCamera.getMakeCompany() + "\n");
new MaterialDialog.Builder(MainActivity.this)
.title("See photo information")
.content(builderInformation.toString())
.positiveText("ok")
.show();
}else{
Toast.makeText(MainActivity.this,
"You dont have data to show because the real path photo is wrong contact with fabian7593@gmail.com",
Toast.LENGTH_SHORT).show();
}
}else{
Toast.makeText(MainActivity.this,
"You dont have data to show because the photo is null (your photo isn't in memory device)",
Toast.LENGTH_SHORT).show();
}
and the method that I use in the example is for validate not null or empty
private boolean notNullNotFill(String validate){
if(validate != null){
if(!validate.trim().equals("")){
return true;
}else{
return false;
}
}else{
return false;
}
}See the example of this infomartion return:
###Issues Fixed
- This version fix the issue of permission of android Marshmallow.
- Fix the land scape photo in any devices (in general Samsung and Sony brands), and the posibility of turn manually. The code that you use is like that in the event override of public void onActivityResult:
@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
//Please see this line, the last flag is for if camera land scape rotate
//or false if you dont need to rotate photo
magicalCamera.resultPhoto(requestCode, resultCode, data, true);
if(magicalCamera.getMyPhoto()!=null) {
imageView.setImageBitmap(magicalCamera.getMyPhoto());
}
}##Internal documentation All the code has a internal documentation for more explanation of this example.
##Preview of Example
##You can see the video explication here (in spanish)
https://www.youtube.com/watch?v=U-JxaFZDSn4
License
Source code can be found on github
Licenced under APACHE 2.0.
About Developer
Developed by Fabian Rosales
Known as Frosquivel Developer
Web Page www.frosquivel.com
Blog (Spanish) www.frosquivel.com/blog