Skip to content

olddonkey/ShadowImageView

Repository files navigation

ShadowImageView

Carthage compatible CocoaPods Support Swift Version License MIT

A apple music cover picture shadow style image library

ShadowImageView is a iOS 10 Apple Music style image view, help you create elegent image with shadow.

Renderings

ShadowOffsetRight Nooffset largeRadius

lotus Mountain CD1 CD2

Features

  • Auto resizing based on content mode.
  • Easy to change paramenters including offset, radius, alpha etc.
  • Storyboard(Nib) support.

TODO

  • Add support for UIView.
  • Change the way of layout, to minimize the resource usa.

Usage

Import

CocoaPods

You can use CocoaPods to install ShadowImageView by adding it to your Podfile:

platform :ios, '8.0'
use_frameworks!
pod 'ShadowImageView'

Carthage

Create a Cartfile that lists the framework and run carthage update. Follow the instructions to add $(SRCROOT)/Carthage/Build/iOS/YourLibrary.framework to an iOS project.

github "olddonkey/ShadowImageView"

Manually

  1. Download and drop ShadowImageView.swift in your project.
  2. Congratulations!

Parameters

    /// Gaussian Blur radius, larger will make the back ground shadow lighter (warning: do not set it too large, 2 or 3 for most cases)
    @IBInspectable
    public var blurRadius: CGFloat
    
    /// The image view contains target image
    @IBInspectable
    public var image: UIImage
    
    /// Image's corner radius
    @IBInspectable
    public var imageCornerRaidus: CGFloat
    
    /// shadow radius offset in percentage, if you want shadow radius larger, set a postive number for this, if you want it be smaller, then set a negative number
    @IBInspectable
    public var shadowRadiusOffSetPercentage: CGFloat
    
    /// Shadow offset value on x axis, postive -> right, negative -> left
    @IBInspectable
    public var shadowOffSetByX: CGFloat
    
    
    /// Shadow offset value on y axis, postive -> right, negative -> left
    @IBInspectable
    public var shadowOffSetByY: CGFloat
    
    /// Shadow alpha value
    @IBInspectable
    public var shadowAlpha: CGFloat

If you want to add by storyboard or nib, just drap a UIView into your canvas, and change the class to ShadowImageView, you will see the change in storyboard or nib, it is @IBDesignable supported.

Requirements

  • iOS 8.0+
  • Swift 3+

The main development of ShadowImageView is based on Swift 3.

Support

Contact

Follow and contact me through email: olddonkeyblog@gmail.com. If you find an issue, just open a ticket on it. Pull requests are warmly welcome as well.

License

ShadowImageView is released under the MIT license. See LICENSE for details.

Kudos

Thanks to PierrePerrin, his PPMusicImageShadow inspires me, though the implementation is diffrent, the main idea comes from GaussianBlur.

App using ShadowImageView

  1. 优读

    youdu