Skip to content

qhutch/ElevationImageView

Repository files navigation

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.

About

Imageview with elevation shadow

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages