mirror of
https://github.com/SoPat712/YTLitePlus.git
synced 2025-08-22 02:38:45 -04:00
added files via upload
This commit is contained in:
93
Tweaks/Alderis/README.md
Normal file
93
Tweaks/Alderis/README.md
Normal file
@@ -0,0 +1,93 @@
|
||||
# 
|
||||
|
||||
**<center>Try it yourself: `pod try Alderis`</center>**
|
||||
|
||||
Alderis is a fresh new color picker, with a gentle, fun, and dead simple user interface. It aims to incorporate the usual elements of a color picker, in a way that users will find easy and fun to use.
|
||||
|
||||
The user can start by selecting a color they like on the initial color palette tab, and either accept it, or refine it using the color wheel and adjustment sliders found on the two other tabs.
|
||||
|
||||
Alderis is named for the Alderamin (Alpha) star in the Cepheus (Cephei) constellation. (There is no dependency on the [Cephei](https://hbang.github.io/libcephei/) project.)
|
||||
|
||||
## Why do I want this? Isn’t there already a color picker in iOS?
|
||||
Alderis was [originally released](https://twitter.com/hbkirb/status/1239332547437326337) before iOS 14 was unveiled with a built-in [color picker](https://developer.apple.com/design/human-interface-guidelines/ios/controls/color-wells/) feature, which seems to be heavily inspired by Alderis. However, rather than throw in the towel here, I’m considering this an opportunity to continue building what I feel is a better, less cluttered user experience, with more configuration options for apps to fine-tune a color picker UI suitable for each use case and target market.
|
||||
|
||||
If this doesn’t seem important to you, the answer is simple: skip Alderis and use [UIColorPickerViewController](https://developer.apple.com/documentation/uikit/uicolorpickerviewcontroller). If it does, read on.
|
||||
|
||||
### Feature Comparison
|
||||
|
||||
<table>
|
||||
<tr> <th></th> <th>Alderis</th> <th>UIKit</th> </tr>
|
||||
<tr> <th>Minimal UI</th> <td>✔️</td> <td>✖️</td> </tr>
|
||||
<tr> <th>Drag and drop colors within app</th> <td>✔️</td> <td>✔️ *</td> </tr>
|
||||
<tr> <th>Drag and drop colors across apps</th> <td>✔️</td> <td>✖️</td> </tr>
|
||||
<tr> <th>Color grid</th> <td>✔️</td> <td>✔️</td> </tr>
|
||||
<tr> <th>Color spectrum/wheel</th> <td>✔️</td> <td>✔️</td> </tr>
|
||||
<tr> <th>RGB sliders</th> <td>✔️</td> <td>✔️</td> </tr>
|
||||
<tr> <th>HSB sliders</th> <td>✔️</td> <td>✖️</td> </tr>
|
||||
<tr> <th>Grayscale slider</th> <td>✔️</td> <td>✖️</td> </tr>
|
||||
<tr> <th>Opacity slider</th> <td>✔️</td> <td>✔️</td> </tr>
|
||||
<tr> <th>Hex color code support</th> <td>✔️</td> <td>✔️</td> </tr>
|
||||
<tr> <th>Color space support (Display P3)</th> <td>✖️</td> <td>✔️</td> </tr>
|
||||
<tr> <th>Save favorite colors</th> <td>✖️</td> <td>✔️</td> </tr>
|
||||
<tr> <th>Saved colors shared across apps</th> <td>✖️</td> <td>✔️</td> </tr>
|
||||
<tr> <th>Grab color from screen (eyedropper)</th> <td>✖️</td> <td>✔️</td> </tr>
|
||||
<tr> <th>Customise title label</th> <td>✔️</td> <td>✖️</td> </tr>
|
||||
<tr> <th>Customise tab row visibility</th> <td>✔️</td> <td>✖️</td> </tr>
|
||||
<tr> <th>Customise visible tabs</th> <td>✔️</td> <td>✖️</td> </tr>
|
||||
<tr> <th>Customise initially selected tab</th> <td>✔️</td> <td>✖️</td> </tr>
|
||||
<tr> <th>Customise opacity slider visibility</th> <td>✔️</td> <td>✔️</td> </tr>
|
||||
<tr> <th>Customise color grid</th> <td>✖️</td> <td>✖️</td> </tr>
|
||||
<tr> <th>Interface Builder support</th> <td>✖️</td> <td>✖️</td> </tr>
|
||||
<tr> <th>SwiftUI support w/o UIKit bridging</th> <td>✖️</td> <td>✖️</td> </tr>
|
||||
<tr> <th>Observe value change with KVO</th> <td>✖️</td> <td>✔️</td> </tr>
|
||||
</table>
|
||||
|
||||
\* UIColorWell supports dragging colors *onto* it, but not *out* of it. Alderis supports both directions, which are separately configurable. The default Alderis ColorWell behavior matches UIColorWell. Alderis supports drag and drop on the color picker window; UIKit does not.
|
||||
|
||||
## Installation
|
||||
|
||||
### CocoaPods
|
||||
Add to your Podfile:
|
||||
|
||||
```ruby
|
||||
pod 'Alderis', '~> 1.2.0'
|
||||
```
|
||||
|
||||
And then run `pod install`.
|
||||
|
||||
### Carthage
|
||||
Add to your Cartfile:
|
||||
|
||||
```ruby
|
||||
github 'hbang/Alderis' ~> 1.2.0
|
||||
```
|
||||
|
||||
And then run `carthage update`.
|
||||
|
||||
### Swift Package Manager
|
||||
1. Click File → Swift Packages → Add Package Dependency.
|
||||
2. Enter `http://github.com/hbang/Alderis.git`.
|
||||
3. Specify `1.2` as the version filter.
|
||||
|
||||
Or, manually add it to your Package.swift:
|
||||
|
||||
```swift
|
||||
dependencies: [
|
||||
.package(url: "http://github.com/hbang/Alderis.git", from: "1.2.0")
|
||||
]
|
||||
```
|
||||
|
||||
And then run `swift package update`.
|
||||
|
||||
### Jailbreak packages
|
||||
Add `ws.hbang.alderis (>= 1.2)` to your `Depends:` list.
|
||||
|
||||
#### Preference Bundles and libcolorpicker Compatibility
|
||||
Alderis acts as a drop-in replacement for [libcolorpicker](https://github.com/atomikpanda/libcolorpicker), an abandoned but still very popular color picker library on jailbroken iOS. Packages can simply change their dependencies list to replace `org.thebigboss.libcolorpicker` with `ws.hbang.alderis (>= 1.2)` to switch their color picker to Alderis. No other changes required!
|
||||
|
||||
For more information, refer to [the docs](https://hbang.github.io/Alderis/preference-bundles.html).
|
||||
|
||||
## License
|
||||
Licensed under the Apache License, version 2.0. Refer to [LICENSE.md](https://github.com/hbang/Alderis/blob/main/LICENSE.md).
|
||||
|
||||
Header backdrop photo credit: [John-Mark Smith](https://unsplash.com/@mrrrk_smith) on Unsplash
|
Reference in New Issue
Block a user