Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rryam/meshingkit
Ultimate framework to add mesh gradients to your iOS/macOS/visionOS/tvOS and watchOS apps!
https://github.com/rryam/meshingkit
ios ios-sdk macos mesh-gradient mesh-gradients swift-library swift-package tvos visionos watchos
Last synced: 3 months ago
JSON representation
Ultimate framework to add mesh gradients to your iOS/macOS/visionOS/tvOS and watchOS apps!
- Host: GitHub
- URL: https://github.com/rryam/meshingkit
- Owner: rryam
- License: mit
- Created: 2024-10-14T05:06:09.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-10-27T16:50:09.000Z (3 months ago)
- Last Synced: 2024-10-28T00:57:17.419Z (3 months ago)
- Topics: ios, ios-sdk, macos, mesh-gradient, mesh-gradients, swift-library, swift-package, tvos, visionos, watchos
- Language: Swift
- Homepage:
- Size: 368 KB
- Stars: 22
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# MeshingKit
MeshingKit provides an easy way to create mesh gradients in SwiftUI with predefined gradient templates to directly render beautiful, gorgeous gradients!
## Meshing
MeshingKit is based on [Meshing](https://apps.apple.com/in/app/ai-mesh-gradient-tool-meshing/id6567933550), an AI Mesh Gradient Tool. You can support my work by downloading the app or sponsoring this package.
## Features
- 63 predefined gradient templates:
- 30 templates with 2x2 grid size
- 22 templates with 3x3 grid size
- 11 templates with 4x4 grid size
- Easily extendable for custom gradients
- Support for iOS 18.0+, macOS 15.0+, tvOS 18.0+, watchOS 11.0+, and visionOS 2.0+
## Installation
### Swift Package Manager
Add MeshingKit to your project using Swift Package Manager. In Xcode, go to File > Swift Packages > Add Package Dependency and enter the following URL:
```
https://github.com/rryam/MeshingKit.git
```
## Usage
To use a predefined gradient template:
```swift
import SwiftUI
import MeshingKit
struct ContentView: View {
var body: some View {
MeshingKit.gradientSize3(template: .cosmicAurora)
.frame(width: 300, height: 300)
}
}
```
## Animated Gradient Views
To create an animated gradient view:
```swift
import SwiftUI
import MeshingKit
struct AnimatedGradientView: View {
@State private var showAnimation = true
var body: some View {
MeshingKit.animatedGradientSize3(template: .cosmicAurora, showAnimation: $showAnimation)
.frame(width: 300, height: 300)
.padding()
// Toggle animation
Toggle("Animate Gradient", isOn: $showAnimation)
.padding()
}
}
```
## Noise Effect with Gradients
You can add a noise effect to your gradients using the ParameterizedNoiseView:
```swift
import SwiftUI
import MeshingKit
struct NoiseEffectGradientView: View {
@State private var intensity: Float = 0.5
@State private var frequency: Float = 0.2
@State private var opacity: Float = 0.9
var body: some View {
ParameterizedNoiseView(intensity: $intensity, frequency: $frequency, opacity: $opacity) {
MeshingKit.gradientSize3(template: .cosmicAurora)
}
.frame(width: 300, height: 300)
// Controls for adjusting the noise effect
VStack {
Slider(value: $intensity, in: 0...1) {
Text("Intensity")
}
.padding()
Slider(value: $frequency, in: 0...1) {
Text("Frequency")
}
.padding()
Slider(value: $opacity, in: 0...1) {
Text("Opacity")
}
.padding()
}
}
}
```
## Available Gradient Templates
MeshingKit provides three sets of predefined gradient templates:
### GradientTemplateSize2 (2x2 grid)
- mysticTwilight
- tropicalParadise
- cherryBlossom
- arcticFrost
- goldenSunrise
- emeraldForest
- desertMirage
- midnightGalaxy
- autumnHarvest
- oceanBreeze
- lavenderDreams
- citrusBurst
- northernLights
- strawberryLemonade
- deepSea
- cottonCandy
- volcanicAsh
- springMeadow
- cosmicDust
- peacockFeathers
- crimsonSunset
- enchantedForest
- blueberryMuffin
- saharaDunes
- grapeSoda
- frostyWinter
- dragonFire
- mermaidLagoon
- chocolateTruffle
- neonNights
### GradientTemplateSize3 (3x3 grid)
- intelligence
- auroraBorealis
- sunsetGlow
- oceanDepths
- neonNight
- autumnLeaves
- cosmicAurora
- lavaFlow
- etherealMist
- tropicalParadise
- midnightGalaxy
- desertMirage
- frostedCrystal
- enchantedForest
- rubyFusion
- goldenSunrise
- cosmicNebula
- arcticAurora
- volcanicEmber
- mintBreeze
- twilightSerenade
- saharaDunes
### GradientTemplateSize4 (4x4 grid)
- auroraBorealis
- sunsetHorizon
- mysticForest
- cosmicNebula
- coralReef
- etherealTwilight
- volcanicOasis
- arcticFrost
- jungleMist
- desertMirage
- neonMetropolis
## Custom Gradients
Ccreate custom gradients by defining your own `GradientTemplate`:
```swift
let customTemplate = GradientTemplate(
name: "Custom Gradient",
size: 3,
points: [
.init(x: 0.0, y: 0.0), .init(x: 0.5, y: 0.0), .init(x: 1.0, y: 0.0),
.init(x: 0.0, y: 0.5), .init(x: 0.5, y: 0.5), .init(x: 1.0, y: 0.5),
.init(x: 0.0, y: 1.0), .init(x: 0.5, y: 1.0), .init(x: 1.0, y: 1.0)
],
colors: [
Color.red, Color.orange, Color.yellow,
Color.green, Color.blue, Color.indigo,
Color.purple, Color.pink, Color.white
],
background: Color.black
)
let customGradient = MeshGradient(
width: customTemplate.size,
height: customTemplate.size,
points: customTemplate.points,
colors: customTemplate.colors
)
```
## Hex Color Initialization
There is an extension on `Color` that allows to initialise colors using hexadecimal strings:
```swift
let color = Color(hex: "#FF5733")
```
This extension supports various hex formats:
- "#RGB" (12-bit)
- "#RRGGBB" (24-bit)
- "#AARRGGBB" (32-bit with alpha)
## Contributing
Contributions to MeshingKit are welcome! Please feel free to submit a Pull Request.
## License
MeshingKit is available under the MIT license. See the LICENSE file for more info.