Introduction: ProfileImageView

Picture of ProfileImageView

The Profile Image View can be used to display profile picture or photo with frame, it is an advanced, flexible and optimized.

Now you can choose the view mode of operation and choose various frames and can also create your own custom frame. :D

Maven Repo
GitHub

This library is available in maven and jcenter, add this code in Android Studio and Build:

repositories { 
maven()
jcenter()
}

dependencies { compile 'org.pedrohc.profileimageview:profileimv:2.0.3'
}

About

This view regards most contracts of a View, is a list of supported features:

  • Attributes:
    • android:background: A View is not restricted to this attribute, then this attribute can be used in parallel without interfering with the operation of the View.
    • android:padding: Attribute working properly.
  • Bitmap and Optimizations:
    • This view does not create any scaled Bitmap and is well optimized avoiding redundant codes and slow methods.
    • If any image is assigned a resource in the xml or code, the view automatically release the memory image after being removed from the window thus avoiding unnecessary use of memory.
  • Visual Studio Design: This view is displayed correctly on Android Studio preview. Tutorial

Bests Pratices

  • For many galleries or view use bitmaps with the "setImage" or "setFeatureImage" and always recycle when not in use.Do not use large images, this can cause an overload on the heap.
  • Before building new frames always make sure there is no standard frames included in the frame class, as they are more optimized.


Tutorial

Eg. of usage in .xml:

To use the View you will have a list of optional attributes:

  • app:frame: Shapes used to frame the image, among them are:
    • circles
    • quare
    • pentagon
    • hexagon
    • heptagon
    • octagon
    • enneagon
    • decagon
    • diamond
    • star
    • triangle
  • app:shadow: To enable shadow use "true" and to disable use "false".
  • app:border: To enable border use "true" and to disable use "false".
  • app:image: Reference to image. eg: "@drawable/image".
  • app:mode: The view mode of operation, there are 3:
    • portrait: Normal operation, without any animation or interaction feature.
    • feature: This mode is used for animations such as buttons addition profile picture, it also includes animation interaction. This attribute works in conjunction with all attributes that include "feature" in its name.
    • selectable: This mode is used for selecting and includes animation interaction. This attribute works in conjunction with all attributes that include "selectable" in its name.
  • app:featureIcon: Set an icon for the mode "feature" that will be displayed over the image.
  • app:featureText: Set an text for the mode "feature" that will be displayed over the image.
  • app:featureColor: Set an color for the mode "feature", this color is used to color the icon and text.
  • app:selectableColor: Set an color for the mode "feature", This color is used to color the edge when the view receiving an interaction.
  • app:imageScale: Image scale.
  • app:imageScrollX: If the image scale is larger than 1.0, it can be adjusted using this attribute, use values between -1.0 and 1.0 which are the ends and to the center use 0.0.
  • app:imageScrollY: If the image scale is larger than 1.0, it can be adjusted using this attribute, use values between -1.0 and 1.0 which are the ends and to the center use 0.0.
  • app:borderRadius: Border Radius in dp.
  • app:borderColor: Border Color.
  • app:backgroundColor: Used to color the background when an image has a transparent background or is adjusted to maintain the appearance.
  • app:shadowColor: Shadow Color.
  • app:imageScaleMode: Standard image scale, among them are:
    • center: Adjust the image across Frame.
    • fit: Adjust the image across View.

Eg. of usage in .java:

// Uses
float density = context.getResources().getDisplayMetrics().density;
Bitmap image = ..
Bitmap featureIcon = ..

// Theme
ProfileImageView.Theme theme = new ProfileImageView.Theme();

theme.imageScale = 1; theme.imageScrollX = 0; theme.imageScrollY = 0; theme.borderRadius = 2 * density; theme.borderColor = Color.WHITE; theme.backgroundColor = Color.WHITE; theme.shadowColor = Color.BLACK; theme.featureColor = 0xFF58B094; theme.selectableColor = 0xFF58B094;

// Profile Image View
ProfileImageView view = new ProfileImageView(context);
view.setMode(ProfileImageView.Mode.FEATURE);
view.setScaleMode(ProfileImageView.Mode.FIT);
view.setImage(image);
view.setTheme(theme);
view.setFeatureIcon(featureIcon);
view.setFrame(ProfileImageView.Frame.CIRCLE);
view.setBorder(true);
view.setShadow(true);


Custom Frames in .java:

// To create custum Rounded Square use:
ProfileImageView.Frame frame = ProfileImageView.createRoundedSquare(radius); /* use radius between 0 - 1 */

// To create custom Ellipse use: ProfileImageView.Frame frame = ProfileImageView.createEllipse(width, height); /* use width/height between 0 - 1 */

// To create custom Polygon: ProfileImageView.Frame frame = ProfileImageView.createNgon(sides, rotate); /* use sides between 3-360, rotate used to align */

// To create custom shape, eg: // square ProfileImageView.Frame frame = new ProfileImageView.Frame(); frame.addVertex(-1, -1); frame.addVertex(1, -1); frame.addVertex(1, 1); frame.addVertex(-1, 1);


Changelog

  • 2.0.0 - First release

Licence

Copyright - Pedro H. Chaves
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.
Created by Pedro on 18/03/2016.

Comments

DIY Hacks and How Tos (author)2016-03-26

Welcome to Instructables. Thanks for sharing.