Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/gkye/ComplimentaryGradientView

Create complementary gradients generated from dominant and prominent colors in supplied image. Inspired by Grade.js
https://github.com/gkye/ComplimentaryGradientView

cocoapods color gradient ios swift

Last synced: 6 days ago
JSON representation

Create complementary gradients generated from dominant and prominent colors in supplied image. Inspired by Grade.js

Awesome Lists containing this project

README

        

[![codebeat badge](https://codebeat.co/badges/a41cd890-63e5-4738-9081-51af2bcfc4b8)](https://codebeat.co/projects/github-com-gkye-complimentarygradientview)

# ComplimentaryGradientView
Create complementary gradients generated from dominant and prominent colors in supplied image.
Inspired by Grade.js :heart:

`.all`
gradientStartPoint: `left` | `colors(start: .primary, end: .background)`
gradientStartPoint:`top`
:-------------------------:|:-------------------------:
![](https://cloud.githubusercontent.com/assets/14007152/17952751/733ba4ba-6a3b-11e6-9ae6-2b23d92b0dea.png) | ![](https://cloud.githubusercontent.com/assets/14007152/18399831/099a7c94-76a1-11e6-8362-e9504d33104f.png)

`colors(start: .detail, end: .background)`
gradientStartPoint:`top` |
`colors(start: .secondary, end: .background)`
gradientStartPoint:`bottom`
:-------------------------:|:-------------------------:
![](https://cloud.githubusercontent.com/assets/14007152/18399974/c8a7ba48-76a1-11e6-86e8-d1df76092855.png) | ![](https://cloud.githubusercontent.com/assets/14007152/18400039/23b266e0-76a2-11e6-819f-9d53f5376e54.png)

## Demo
#### Sorry for the poor quality gif
![Demo](https://github.com/gkye/ComplimentaryGradientView/blob/master/Resources/demo.gif)

## Usage

### Code
```swift
let gradientView = ComplimentaryGradientView(frame: CGRect(x: 0, y: 0, width: 300, height: 300))

//Colors for gradient are derived from the provided image
gradientView.image = UIImage(named: "myImg")

gradientView.gradientTpye = .colors(start: .primary, end: .secondary)

// Default = `.left`
gradientView.gradientStartPoint = .left

// Default = `.high`
gradientView.quality = .high
```

### Storyboard
![Demo](https://github.com/gkye/ComplimentaryGradientView/blob/master/Resources/storyboard_usage.png)

### Migration [Guide](https://github.com/gkye/ComplimentaryGradientView/wiki/3.0-Migration-Guide).
Version 3.0 introduces `GradientVariant` and reduces `GradientType` to two simple options:
``` swift
// Create a gradient using all colors found in image
case all
// Create gradient using variants. ie. .colors(start: .primary, end: .detail)
case colors(start: GradientVariant, end: GradientVariant)
```

## Installation

### CocoaPods
ComplimentaryGradientView is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:

### Swift 4.2
```ruby
pod 'ComplimentaryGradientView', '~> 3.0'

```
### Swift3.
```ruby
pod 'ComplimentaryGradientView', '~> 0.1.7'
```

### Swift 2.2
```ruby
pod 'ComplimentaryGradientView', '~> 0.1.0'
```

### Manually
Download and drop `ComplimentaryGradientView.xcodeproj` into your project
OR
Drag `Source` folder into your project.

## Dependencies

UIImageColors

## License

ComplimentaryGradientView is available under the MIT license. See the LICENSE file for more info.