Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/olddonkey/ShadowImageView
A apple music cover picture shadow style image library
https://github.com/olddonkey/ShadowImageView
image shadow swift ui
Last synced: 7 days ago
JSON representation
A apple music cover picture shadow style image library
- Host: GitHub
- URL: https://github.com/olddonkey/ShadowImageView
- Owner: olddonkey
- License: mit
- Created: 2017-05-06T08:14:54.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-03-31T11:21:00.000Z (over 5 years ago)
- Last Synced: 2024-11-15T23:48:54.751Z (27 days ago)
- Topics: image, shadow, swift, ui
- Language: Swift
- Size: 17.7 MB
- Stars: 798
- Watchers: 9
- Forks: 46
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - ShadowImageView - ShadowImageView is a iOS 10 Apple Music style image view, help you create elegent image with shadow. (Media / Image)
- awesome-ios-star - ShadowImageView - ShadowImageView is a iOS 10 Apple Music style image view, help you create elegent image with shadow. (Media / Image)
README
# ShadowImageView
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
  
   
## Features
- [x] Auto resizing based on content mode.
- [x] Easy to change paramenters including offset, radius, alpha etc.
- [x] 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](http://cocoapods.org/) to install `ShadowImageView` by adding it to your `Podfile`:
```ruby
platform :ios, '8.0'
use_frameworks!
pod 'ShadowImageView'
```
#### Carthage
Create a `Cartfile` that lists the framework and run `carthage update`. Follow the [instructions](https://github.com/Carthage/Carthage#if-youre-building-for-ios) 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
```swift
/// 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: [email protected]. If you find an issue, just [open a ticket](https://github.com/olddonkey/ShadowImageView/issues/new) 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](https://github.com/PierrePerrin), his [PPMusicImageShadow](https://github.com/PierrePerrin/PPMusicImageShadow) inspires me, though the implementation is diffrent, the main idea comes from GaussianBlur.
### App using ShadowImageView
1. [优读](https://itunes.apple.com/us/app/优读-订阅收藏和碎片知识管理神器/id1175225244)
