Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/maxkonovalov/mkgradientview

🌈 Highly customizable Core Graphics based gradient view for iOS
https://github.com/maxkonovalov/mkgradientview

axial-gradient bilinear-gradient circular-gradient conical-gradient four-point-gradient gradient gradient-view ios linear-gradient swift

Last synced: 11 days ago
JSON representation

🌈 Highly customizable Core Graphics based gradient view for iOS

Host: GitHub
URL: https://github.com/maxkonovalov/mkgradientview
Owner: maxkonovalov
License: mit
Created: 2015-10-20T17:44:53.000Z (about 9 years ago)
Default Branch: master
Last Pushed: 2021-02-15T08:40:56.000Z (almost 4 years ago)
Last Synced: 2024-10-03T10:17:19.528Z (about 1 month ago)
Topics: axial-gradient, bilinear-gradient, circular-gradient, conical-gradient, four-point-gradient, gradient, gradient-view, ios, linear-gradient, swift
Language: Swift
Homepage:
Size: 750 KB
Stars: 172
Watchers: 6
Forks: 15
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # MKGradientView

[![Language](http://img.shields.io/badge/language-swift-brightgreen.svg?style=flat)](https://developer.apple.com/swift)

[![Platform](https://img.shields.io/cocoapods/p/MKGradientView.svg?style=flat)](http://cocoapods.org/pods/MKGradientView)

[![License](https://img.shields.io/cocoapods/l/MKGradientView.svg?style=flat)](http://cocoapods.org/pods/MKGradientView)

[![Version](https://img.shields.io/cocoapods/v/MKGradientView.svg?style=flat)](http://cocoapods.org/pods/MKGradientView)

[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

Highly customizable Core Graphics based gradient view



## Features

#### Available gradient types:

- Linear (Axial)

- Radial (Circular)

- Conical (Angular)

- Bilinear (Four Point)

## Installation

### CocoaPods

To install `MKGradientView` via [CocoaPods](http://cocoapods.org), add the following line to your Podfile:

```

pod 'MKGradientView'

```

### Carthage

To install `MKGradientView` via [Carthage](https://github.com/Carthage/Carthage#if-youre-building-for-ios-tvos-or-watchos), add the following line to your Cartfile:

```

github "maxkonovalov/MKGradientView"

```

## Usage

See example Xcode project

### Interface Builder

Simple 2-color gradients can be set up in Interface Builder. Set your view's custom class to `MKGradientView`.

You can specify the following custom inspectable properties: 

- `Gradient Type`

- `Start Color`

- `End Color`

- `Start Point`

- `End Point`

### Code

```swift

let gradientView = GradientView(frame: CGRect(x: 0, y: 0, width: 100, height: 100))

gradientView.type = .linear

gradientView.colors = [.red, .green]

gradientView.locations = [0, 1]

gradientView.startPoint = CGPoint(x: 0, y: 0)

gradientView.endPoint = CGPoint(x: 1, y: 1)

view.addSubview(gradientView)

```

To set up a `Bilinear` gradient, you need to specify `colors2` array:

```swift

let gradientView = GradientView(frame: CGRect(x: 100, y: 0, width: 100, height: 100))

gradientView.type = .bilinear

gradientView.colors = [.red, .yellow]

gradientView.colors2 = [.blue, .cyan]

view.addSubview(gradientView)

```

## Performance

`GradientLayer` is image-backed, and the algorithm performance behind it highly depends on the size of the generated image. To speed it up, minimum possible layer size should be used. It can be adjusted with `GradientLayer`'s `contentsScale` property, `1.0` being an optimal value for performance/quality balance. Use lower values like `0.5` to speed up rendering time or set it equal to `UIScreen.main.scale` to get precise result.

## Requirements

- iOS 8.0

- Xcode 10, Swift 4+

## License

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