No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
Latest commit e77c67e Sep 29, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
1.0_release Fixed some bugs. Improved device support. Sep 13, 2014
public_headers
.gitignore fix header errors Jul 7, 2015
.gitlab-ci.yml Build should succeed now Sep 24, 2015
ColorPicker.h updated method of reading colors. Now use Jul 7, 2015
LICENSE.md Fixed some bugs. Improved device support. Sep 13, 2014
Makefile added welcome screen Oct 24, 2015
PFColorAlert.h
PFColorAlert.mm
PFColorCell.mm added simple cell fixed some stuffs Aug 5, 2015
PFColorLitePreviewView.h fix where prev color view didn't work Aug 5, 2015
PFColorLitePreviewView.m fix where prev color view didn't work Aug 5, 2015
PFColorLiteSlider.h
PFColorLiteSlider.m fix warnings Aug 7, 2015
PFColorPicker.h Fixed some bugs. Improved device support. Sep 13, 2014
PFColorPicker.m
PFColorPickerWelcome.mm added welcome screen Oct 24, 2015
PFColorTransparentView.h
PFColorTransparentView.m
PFColorViewController.h Refactored lots of code + fixed a bunch of memory leaks Jul 26, 2015
PFColorViewController.m fixed iOS9 bug where tweaks wouldn't be loaded due to the alignment c… Oct 22, 2015
PFHaloHueView.h Refactored lots of code + fixed a bunch of memory leaks Jul 26, 2015
PFHaloHueView.m fixed hue slider angle yay! Jan 20, 2016
PFLiteColorCell.mm Fixed #leeks and some issues Sep 25, 2015
PFSimpleLiteColorCell.mm (Hopefully) fixed build Sep 25, 2015
PSSpecifier.h Fixed some bugs. Improved device support. Sep 13, 2014
PSTableCell.h fix header errors Jul 7, 2015
README.md Update README.md Sep 29, 2017
UIColor+PFColor.h Fixed issue that would cause some apps like Alien Blue to crash due t… Jan 4, 2015
UIColor+PFColor.m
control 1.6 Aug 22, 2016
libcolorpicker.h added simple cell fixed some stuffs Aug 5, 2015
libcolorpicker.mm updated method of reading colors. Now use Jul 7, 2015

README.md

libcolorpicker

The new libcolorpicker:

The new libcolorpicker PFColorAlert is focused on being lightweight, portable, and easy to use.

How to implement:

  • Search and install the latest libcolorpicker from Cydia.

  • Copy /usr/lib/libcolorpicker.dylib from your iOS device to your $THEOS/lib folder.

  • Add TWEAKNAME_LIBRARIES = colorpicker to your Tweak's Makefile if needed

  • Add TWEAKNAMEPREFS_LIBRARIES = colorpicker to your Pref's Makefile if needed

  • Download libcolorpicker.h from the root of this git and place in $THEOS/include folder.

Adding libcolorpicker into your tweak prefs bundle (Simple)

This simple method is for devs that don't need much customization.

add a new dictionary in your preference's specifier plist like this (also see example below)

** Preferences Plist Specifier Format **

		<dict>
			<key>cell</key>
			<string>PSLinkCell</string>
			<key>cellClass</key>
			<string>PFSimpleLiteColorCell</string>
			<key>libcolorpicker</key>
			<dict>
				<key>defaults</key>
				<string>YOUR PREFS PLIST IDENTIFIER</string>
				<key>key</key>
				<string>SAVE KEY</string>
				<key>fallback</key>
				<string>FALLBACK HEX COLOR</string>
				<key>PostNotification</key>
				<string>NOTIFICATION TO POST (OPTIONAL)</string>
				<key>alpha</key>
				<true/> <!-- <true/> or <false/> Show alpha slider -->
			</dict>
			<key>label</key>
			<string>COLOR TEXT LABEL</string>
		</dict>

** Example Preferences Plist**

		<dict>
			<key>cell</key>
			<string>PSLinkCell</string>
			<key>cellClass</key>
			<string>PFSimpleLiteColorCell</string>
			<key>libcolorpicker</key>
			<dict>
				<key>defaults</key>
				<string>com.baileyseymour.someawesometweak</string>
				<key>key</key>
				<string>favoriteColor</string>
				<key>fallback</key>
				<string>#ff0000</string>
				<key>alpha</key>
				<false/>
			</dict>
			<key>label</key>
			<string>Favorite Color 1</string>
		</dict>

Advanced

Showing the alert (Advanced):

this way can be used inside any application like a UIAlertView and is fully customizable.

NSString *readFromKey = @"someCoolKey"; //  (You want to load from prefs probably)
NSString *fallbackHex = @"#ff0000";  // (You want to load from prefs probably)

UIColor *startColor = LCPParseColorString(readFromKey, fallbackHex); // this color will be used at startup
PFColorAlert *alert = [PFColorAlert colorAlertWithStartColor:startColor showAlpha:YES];

// show alert and set completion callback
[alert displayWithCompletion:
	^void (UIColor *pickedColor) {
		// save pickedColor or do something with it
		NSString *hexString = [UIColor hexFromColor:pickedColor];
		hexString = [hexString stringByAppendingFormat:@":%f", pickedColor.alpha];
		// you probably want to save hexString to your prefs
		// maybe post a notification here if you need to
	}];
Reading saved color later on (From Tweak):
NSDictionary *prefsDict = ... // assuming this holds your prefs
NSString *coolColorHex = [prefsDict objectForKey:@"someCoolKey"]; // assuming that the key has a value saved like #FFFFFF:0.75423

UIColor *coolColor = LCPParseColorString(coolColorHex, @"#ff0000"); // fallback to red (#ff0000)
// do something with coolColor

Example Tweak to change UILabel text's color and shadow:

https://bitbucket.org/rob311/pflibcolorpickerexample

screen shot

The old libcolorpicker:

libcolorpicker is a iOS library that provides an easy to implement Color Picker. Here are some of it's main features:

  • iPhone & iPad Compatible
  • HSB touch color picker
  • Option to Use HSB or RGB sliders
  • Option for color transparency/opacity/alpha
  • No images or "extra components" just the library
  • Post settings changed notifications on save (Optional)
  • Enter a hex color or copy one to your clipboard
  • Made for iOS 7 & 8, Compatible with iOS 6
  • Saves colors instantly to your preferences plist
  • iPhone 3.5 inch & 4inch screen compatibility
  • Open Source

How to add libcolorpicker into your tweak:

First add a this into your Tweaks Preferences specifier plist and modify to your liking:

		<dict>
			<key>cell</key>
			<string>PSLinkCell</string>
			<key>cellClass</key>
			<string>PFColorCell</string>
			<key>label</key>
			<string>A Color</string>
			<key>color_defaults</key>
			<string>com.yourcompany.tweak</string>
			<key>color_key</key>
			<string>aColor</string>
			<key>title</key>
			<string>A Color</string>
			<key>color_fallback</key>
			<string>#10b6ec</string>
			<key>usesRGB</key>
			<false/>
			<key>usesAlpha</key>
			<true/>
			<key>color_postNotification</key>
			<string>com.yourcompany.tweak.settingschanged</string>
		</dict>

Using Version on BigBoss (Recommended)

  • Search and install libcolorpicker from Cydia.

  • Copy /usr/lib/libcolorpicker.dylib from your iOS device to your $THEOS/lib folder.

  • Add TWEAKNAME_LIBRARIES = colorpicker to your Tweak's Makefile

  • Add TWEAKNAMEPREFS_LIBRARIES = colorpicker to your Pref's Makefile

  • Next Add the following to to your Preference Bundle's PSListController @implementation

      - (void)viewWillAppear:(BOOL)animated
      {
      	[self clearCache];
      	[self reload];
      	[super viewWillAppear:animated];
      }
    

PLEASE DO NOT DO THIS :P It will result in loading different versions of libcolorpicker.

Using Custom Build

Next, Place the libcolorpicker.dylib in TweakPreferencesFolder/lib/

Next, Add the following to your Preference Bundle's Makefile:

$(shell install_name_tool -id /usr/lib/libcolorpicker_PUTTWEAKNAMEHERE.dylib lib/libcolorpicker.dylib)

TWEAKNAMEPREFERENCES_LDFLAGS = -Llib -lcolorpicker

include $(THEOS_MAKE_PATH)/bundle.mk

internal-stage::
$(ECHO_NOTHING)mkdir -p $(THEOS_STAGING_DIR)/Library/PreferenceLoader/Preferences$(ECHO_END)
$(ECHO_NOTHING)mkdir -p $(THEOS_STAGING_DIR)/usr/lib/$(ECHO_END)
$(ECHO_NOTHING)cp lib/libcolorpicker.dylib $(THEOS_STAGING_DIR)/usr/lib/libcolorpicker_PUTTWEAKNAMEHERE.dylib$(ECHO_END)

Next, Add the following to to your Preference Bundle's PSListController @implementation:

- (void)viewWillAppear:(BOOL)animated
{
	[self clearCache];
	[self reload];  
	[super viewWillAppear:animated];
}

Getting the color from the plist:

To get the color from your tweak you can use the UIColor *colorFromDefaultsWithKey(NSString *defaults, NSString *key, NSString *fallback) function found in libcolorpicker.mm

First you need to define the function in your header (.h) file: UIColor *colorFromDefaultsWithKey(NSString *defaults, NSString *key, NSString *fallback);

An example on how to use it would be: UIColor *someColor = colorFromDefaultsWithKey(@"com.example.tweak", @"someColor", @"#ffffff");

This would fallback to white (#ffffff) if the color is nil;

Example Tweak to change UILabel text's color and shadow:

https://bitbucket.org/rob311/pflibcolorpickerexample

Check out the screen shots below

iOS Simulator Screen shot Aug 27, 2014, 3.49.02 PM.pngiOS Simulator Screen shot Aug 27, 2014, 3.55.09 PM.png

License

The MIT License (MIT)

Copyright (c) 2014 PixelFireDev

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.