ElevationImageView
qhutch
312
Visit GitHub RepoImage Views

Android Arsenal

ElevationImageView

Imageview with elevation shadow

alt text

How to use ?

Install

Add this to your app build.gradle

dependencies {
    ...
    implementation 'com.qhutch.elevationimageview:elevationimageview:2.4'
}

You will also need support renderscript, also in your build.gradle :

android {
    ...
    defaultConfig {
        ...

        renderscriptTargetApi 18
        renderscriptSupportModeEnabled true
    }
}

Usage

Use as any ImageView, set your image and add elevation (either with elevation attribute, or compatEvelation if your minSdk is below 21)

The clipShadow attribute is set to false by default, if true, it will clip the shadow to the View boundaries.

To set the elevation programmatically, you can use setElevation() and pass a value in pixels or setElevationDp() and pass a value in dp.

Use translucent attribute or setTranslucent() method to make the shadow keep the color of the image

Changelog

  • V2.4 : fixed clipped shadows and migrate to androidX

  • V2.3 : fixed npe when drawable was null

  • V2.1 : support for android P (thanks to @jlurena)

  • V2.0 : Boolean attribute 'forceClip' to use another clipping method if set as true

  • V1.7 : Fixed NPE when no drawable was set

  • V1.6 : Use color matrix instead of custom script

  • V1.5 : Added translucent attribute

  • V1.4 : Opened ElevationImageView class

  • V1.3 : Fixed crash in edit mode by disabling renderscript

  • V1.2 : Extend AppCompatImageView to allow usage of app:srcCompat attribute

  • V1.1 : Fixed NPE when view was detached from window and the reattached

Contact

Pull requests are more than welcome.

License

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.
Become a better Android Developer
Millions of developers are learning at MindOrks

Online Training Program

Featured Blogs

Our Team

MindOrks is Certainly one of the best online blog to stay on top of all the Android development news, coding and design patterns. Finally a blog I can count on to keep myself updated with latest and greatest things happening in Android world.

Vipul Shah
Android Developer
Microsoft

Become Pro in Android by watching videos

OUR LEARNERS WORK AT