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: about 2 months ago
JSON representation

A apple music cover picture shadow style image library

Lists

README

        

# ShadowImageView

![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg)
![CocoaPods Support](https://img.shields.io/badge/Cocoapods-compatible-4BC51D.svg)
![Swift Version](https://img.shields.io/badge/Swift-3.0-orange.svg)
![License MIT](https://img.shields.io/badge/License-MIT-lightgrey.svg)

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](Screenshots/Rightoffset.png) ![Nooffset](Screenshots/NoOffset.png) ![largeRadius](Screenshots/largeRadius.png)

![lotus](Screenshots/lotus.png) ![Mountain](Screenshots/Mountain.png) ![CD1](Screenshots/CD1.png) ![CD2](Screenshots/CD2.png)

## 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)

![youdu](Screenshots/youdu.png)