URWeatherView

by jegumhon

jegumhon /URWeatherView

Show the weather effects onto view written in Swift4.2

435 Stars 35 Forks Last release: Not found MIT License 154 Commits 20 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

URWeatherView

Awesome Swift podplatform pod poddoc license CocoaPods compatible Carthage compatible FOSSA Status <!-- travis codecov -->

What is this for?

Showing some kinds of the weather effect, written in Swift4.2.

This code style is the

Protocol Oriented Programming
.

To show the vector animation made by After Effect, Lottie can be used instead of UIImageView.

Before using URWeatherView, Which resources do you need?

1. main image or main lottie resource (Required)

  • The weather effect's main target
  • apply tone curve filter or gradient mask #### 2. backgroundImage of main (Optional)
  • The weather effect's background Image #### 3. upperImage of main (Optional)
  • The weather effect's upper Image
  • If you want extra effect, you can use it.

Usable Weather Effects

1. Snow

sample

2. Rain

sample

3. Dust

  • #1
    sample_dust1
  • #2
    sample_dust2

4. Lightning

sample_lightning

5. Hot

sample_hot

6. Cloudy

sample_cloudy

Used library stack

SpriteKit

CIFilter & CIKernel & Core Imager Kernel Language(like GLSL)

Lottie

  • I needed to apply color filter for the weather effect.
    So, I made custom Lottie library to get some properties from LOTAnimationView.
  • It's lottie-ios-extension.

Requirements

  • iOS 10.0+
  • Swift 4.2+ (Swift 3.x version is v0.6.4)

Installation

Cocoapods

Add the following to your

Podfile
.
pod "URWeatherView"

Dependency

lottie-ios-extension
(But, you don't need to care about this, when using URWeatherView. It's already included the dependency.)

Carthage

Add the following to your

Cartfile
.
github "jegumhon/URWeatherView"

Dependency

lottie-ios-extension
(But, you don't need to care about this, when using URWeatherView. It's already included the dependency.)

Examples

See the

Example
folder.
Run
pod install
and open the .xcworkspace.
(The Example source is made for using Carthage.
So, you remove the linked frameworks in
General
of the project settings.
And then, you remove the run script of Carthage in
Build Phases
of the project settings.)
or
Run
carthage update
and open the .xcodeproj.

Usage

import URWeatherView

1. initialize the weather view

    // for example...

// You can use the xib or storyboard to show the URWeatheView...
@IBOutlet var mainView: URWeatherView!

override func viewDidLoad() {
    super.viewDidLoad()

    // set the main Image to apply the weather effects...
    // and set the backgroundImage, if you want to apply...
    self.mainView.initView(mainWeatherImage: #imageLiteral(resourceName: "buildings"), backgroundImage: #imageLiteral(resourceName: "bluesky.en"))

    // or, to use Lottie, do like below..
    // self.mainView.initView(dataNameOfLottie: "data", backgroundImage: #imageLiteral(resourceName: "bluesky.en"))
}

1.1. How to use Lottie
  • You can find the detail Lottie usage guide at the Lottie-iOS
  • add the lottie files in the project, and then just use the json file name to load the Lottie View

2. show or remove the weather effects

    func showWeather() {
        let weather: URWeatherType = .cloudy
        self.mainView.startWeatherSceneBulk(weather, debugOption: true, additionalTask: {
            // task what you want to do after showing the weather effect...
        })
    }

func removeWeather() {
    self.mainView.stop()
}

3. ๐Ÿ˜€ Configurable parameters of URWeatherView ๐Ÿ˜€

Using or composing the functions in the URWeatherView, you can customize the weather effects. The default configurable parameters are like below. * birthRate : The particle's birth rate. This is used in the effects. e.g. Snow, Rain, Dust, Cloud. * upperImage : The image onto the weather view. (optional) * duration : The duration(in second). applied some effects among the URWeatherView's effects. * debugOption : enable to show the debug option of SpriteKit's. Default is "false". This is for the SpriteKit frame checking. * cloud effect's option : especially, you can customize the cloud effect with this structure. The sample codes is included in the example codes. Or you can see the codes below. ```swift case .cloudy: // self.mainView.startWeatherSceneBulk(cell.weather, duration: 33.0, debugOption: self.segment.selectedSegmentIndex == 0)

    self.mainView.initWeather()
    self.mainView.setUpperImageEffect(customImage: nil)
    let option = UREffectCloudOption(CGRect(x: 0.0, y: 0.5, width: 1.0, height: 0.5), angleInDegree: 0.0, movingDuration: 33.0)
    self.mainView.startWeatherScene(cell.weather, duration: 33.0, userInfo: [URWeatherKeyCloudOption: option])
## To-Do

  • exchange the Core Image Kernel to Metal.

License

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

FOSSA Status

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.