//
|
// YYTextUtilities.h
|
// YYText <https://github.com/ibireme/YYText>
|
//
|
// Created by ibireme on 15/4/6.
|
// Copyright (c) 2015 ibireme.
|
//
|
// This source code is licensed under the MIT-style license found in the
|
// LICENSE file in the root directory of this source tree.
|
//
|
|
#import <UIKit/UIKit.h>
|
#import <QuartzCore/QuartzCore.h>
|
#import <CoreText/CoreText.h>
|
|
|
#ifndef YYTEXT_CLAMP // return the clamped value
|
#define YYTEXT_CLAMP(_x_, _low_, _high_) (((_x_) > (_high_)) ? (_high_) : (((_x_) < (_low_)) ? (_low_) : (_x_)))
|
#endif
|
|
#ifndef YYTEXT_SWAP // swap two value
|
#define YYTEXT_SWAP(_a_, _b_) do { __typeof__(_a_) _tmp_ = (_a_); (_a_) = (_b_); (_b_) = _tmp_; } while (0)
|
#endif
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
/**
|
Whether the character is 'line break char':
|
U+000D (\\r or CR)
|
U+2028 (Unicode line separator)
|
U+000A (\\n or LF)
|
U+2029 (Unicode paragraph separator)
|
|
@param c A character
|
@return YES or NO.
|
*/
|
static inline BOOL YYTextIsLinebreakChar(unichar c) {
|
switch (c) {
|
case 0x000D:
|
case 0x2028:
|
case 0x000A:
|
case 0x2029:
|
return YES;
|
default:
|
return NO;
|
}
|
}
|
|
/**
|
Whether the string is a 'line break':
|
U+000D (\\r or CR)
|
U+2028 (Unicode line separator)
|
U+000A (\\n or LF)
|
U+2029 (Unicode paragraph separator)
|
\\r\\n, in that order (also known as CRLF)
|
|
@param str A string
|
@return YES or NO.
|
*/
|
static inline BOOL YYTextIsLinebreakString(NSString * _Nullable str) {
|
if (str.length > 2 || str.length == 0) return NO;
|
if (str.length == 1) {
|
unichar c = [str characterAtIndex:0];
|
return YYTextIsLinebreakChar(c);
|
} else {
|
return ([str characterAtIndex:0] == '\r') && ([str characterAtIndex:1] == '\n');
|
}
|
}
|
|
/**
|
If the string has a 'line break' suffix, return the 'line break' length.
|
|
@param str A string.
|
@return The length of the tail line break: 0, 1 or 2.
|
*/
|
static inline NSUInteger YYTextLinebreakTailLength(NSString * _Nullable str) {
|
if (str.length >= 2) {
|
unichar c2 = [str characterAtIndex:str.length - 1];
|
if (YYTextIsLinebreakChar(c2)) {
|
unichar c1 = [str characterAtIndex:str.length - 2];
|
if (c1 == '\r' && c2 == '\n') return 2;
|
else return 1;
|
} else {
|
return 0;
|
}
|
} else if (str.length == 1) {
|
return YYTextIsLinebreakChar([str characterAtIndex:0]) ? 1 : 0;
|
} else {
|
return 0;
|
}
|
}
|
|
/**
|
Convert `UIDataDetectorTypes` to `NSTextCheckingType`.
|
|
@param types The `UIDataDetectorTypes` type.
|
@return The `NSTextCheckingType` type.
|
*/
|
static inline NSTextCheckingType YYTextNSTextCheckingTypeFromUIDataDetectorType(UIDataDetectorTypes types) {
|
NSTextCheckingType t = 0;
|
if (types & UIDataDetectorTypePhoneNumber) t |= NSTextCheckingTypePhoneNumber;
|
if (types & UIDataDetectorTypeLink) t |= NSTextCheckingTypeLink;
|
if (types & UIDataDetectorTypeAddress) t |= NSTextCheckingTypeAddress;
|
if (types & UIDataDetectorTypeCalendarEvent) t |= NSTextCheckingTypeDate;
|
return t;
|
}
|
|
/**
|
Whether the font is `AppleColorEmoji` font.
|
|
@param font A font.
|
@return YES: the font is Emoji, NO: the font is not Emoji.
|
*/
|
static inline BOOL YYTextUIFontIsEmoji(UIFont *font) {
|
return [font.fontName isEqualToString:@"AppleColorEmoji"];
|
}
|
|
/**
|
Whether the font is `AppleColorEmoji` font.
|
|
@param font A font.
|
@return YES: the font is Emoji, NO: the font is not Emoji.
|
*/
|
static inline BOOL YYTextCTFontIsEmoji(CTFontRef font) {
|
BOOL isEmoji = NO;
|
CFStringRef name = CTFontCopyPostScriptName(font);
|
if (name && CFEqual(CFSTR("AppleColorEmoji"), name)) isEmoji = YES;
|
if (name) CFRelease(name);
|
return isEmoji;
|
}
|
|
/**
|
Whether the font is `AppleColorEmoji` font.
|
|
@param font A font.
|
@return YES: the font is Emoji, NO: the font is not Emoji.
|
*/
|
static inline BOOL YYTextCGFontIsEmoji(CGFontRef font) {
|
BOOL isEmoji = NO;
|
CFStringRef name = CGFontCopyPostScriptName(font);
|
if (name && CFEqual(CFSTR("AppleColorEmoji"), name)) isEmoji = YES;
|
if (name) CFRelease(name);
|
return isEmoji;
|
}
|
|
/**
|
Whether the font contains color bitmap glyphs.
|
|
@discussion Only `AppleColorEmoji` contains color bitmap glyphs in iOS system fonts.
|
@param font A font.
|
@return YES: the font contains color bitmap glyphs, NO: the font has no color bitmap glyph.
|
*/
|
static inline BOOL YYTextCTFontContainsColorBitmapGlyphs(CTFontRef font) {
|
return (CTFontGetSymbolicTraits(font) & kCTFontTraitColorGlyphs) != 0;
|
}
|
|
/**
|
Whether the glyph is bitmap.
|
|
@param font The glyph's font.
|
@param glyph The glyph which is created from the specified font.
|
@return YES: the glyph is bitmap, NO: the glyph is vector.
|
*/
|
static inline BOOL YYTextCGGlyphIsBitmap(CTFontRef font, CGGlyph glyph) {
|
if (!font && !glyph) return NO;
|
if (!YYTextCTFontContainsColorBitmapGlyphs(font)) return NO;
|
CGPathRef path = CTFontCreatePathForGlyph(font, glyph, NULL);
|
if (path) {
|
CFRelease(path);
|
return NO;
|
}
|
return YES;
|
}
|
|
/**
|
Get the `AppleColorEmoji` font's ascent with a specified font size.
|
It may used to create custom emoji.
|
|
@param fontSize The specified font size.
|
@return The font ascent.
|
*/
|
static inline CGFloat YYTextEmojiGetAscentWithFontSize(CGFloat fontSize) {
|
if (fontSize < 16) {
|
return 1.25 * fontSize;
|
} else if (16 <= fontSize && fontSize <= 24) {
|
return 0.5 * fontSize + 12;
|
} else {
|
return fontSize;
|
}
|
}
|
|
/**
|
Get the `AppleColorEmoji` font's descent with a specified font size.
|
It may used to create custom emoji.
|
|
@param fontSize The specified font size.
|
@return The font descent.
|
*/
|
static inline CGFloat YYTextEmojiGetDescentWithFontSize(CGFloat fontSize) {
|
if (fontSize < 16) {
|
return 0.390625 * fontSize;
|
} else if (16 <= fontSize && fontSize <= 24) {
|
return 0.15625 * fontSize + 3.75;
|
} else {
|
return 0.3125 * fontSize;
|
}
|
return 0;
|
}
|
|
/**
|
Get the `AppleColorEmoji` font's glyph bounding rect with a specified font size.
|
It may used to create custom emoji.
|
|
@param fontSize The specified font size.
|
@return The font glyph bounding rect.
|
*/
|
static inline CGRect YYTextEmojiGetGlyphBoundingRectWithFontSize(CGFloat fontSize) {
|
CGRect rect;
|
rect.origin.x = 0.75;
|
rect.size.width = rect.size.height = YYTextEmojiGetAscentWithFontSize(fontSize);
|
if (fontSize < 16) {
|
rect.origin.y = -0.2525 * fontSize;
|
} else if (16 <= fontSize && fontSize <= 24) {
|
rect.origin.y = 0.1225 * fontSize -6;
|
} else {
|
rect.origin.y = -0.1275 * fontSize;
|
}
|
return rect;
|
}
|
|
|
/**
|
Get the character set which should rotate in vertical form.
|
@return The shared character set.
|
*/
|
NSCharacterSet *YYTextVerticalFormRotateCharacterSet();
|
|
/**
|
Get the character set which should rotate and move in vertical form.
|
@return The shared character set.
|
*/
|
NSCharacterSet *YYTextVerticalFormRotateAndMoveCharacterSet();
|
|
|
|
/// Convert degrees to radians.
|
static inline CGFloat YYTextDegreesToRadians(CGFloat degrees) {
|
return degrees * M_PI / 180;
|
}
|
|
/// Convert radians to degrees.
|
static inline CGFloat YYTextRadiansToDegrees(CGFloat radians) {
|
return radians * 180 / M_PI;
|
}
|
|
|
|
/// Get the transform rotation.
|
/// @return the rotation in radians [-PI,PI] ([-180°,180°])
|
static inline CGFloat YYTextCGAffineTransformGetRotation(CGAffineTransform transform) {
|
return atan2(transform.b, transform.a);
|
}
|
|
/// Get the transform's scale.x
|
static inline CGFloat YYTextCGAffineTransformGetScaleX(CGAffineTransform transform) {
|
return sqrt(transform.a * transform.a + transform.c * transform.c);
|
}
|
|
/// Get the transform's scale.y
|
static inline CGFloat YYTextCGAffineTransformGetScaleY(CGAffineTransform transform) {
|
return sqrt(transform.b * transform.b + transform.d * transform.d);
|
}
|
|
/// Get the transform's translate.x
|
static inline CGFloat YYTextCGAffineTransformGetTranslateX(CGAffineTransform transform) {
|
return transform.tx;
|
}
|
|
/// Get the transform's translate.y
|
static inline CGFloat YYTextCGAffineTransformGetTranslateY(CGAffineTransform transform) {
|
return transform.ty;
|
}
|
|
/**
|
If you have 3 pair of points transformed by a same CGAffineTransform:
|
p1 (transform->) q1
|
p2 (transform->) q2
|
p3 (transform->) q3
|
This method returns the original transform matrix from these 3 pair of points.
|
|
@see http://stackoverflow.com/questions/13291796/calculate-values-for-a-cgaffinetransform-from-three-points-in-each-of-two-uiview
|
*/
|
CGAffineTransform YYTextCGAffineTransformGetFromPoints(CGPoint before[3], CGPoint after[3]);
|
|
/// Get the transform which can converts a point from the coordinate system of a given view to another.
|
CGAffineTransform YYTextCGAffineTransformGetFromViews(UIView *from, UIView *to);
|
|
/// Create a skew transform.
|
static inline CGAffineTransform YYTextCGAffineTransformMakeSkew(CGFloat x, CGFloat y){
|
CGAffineTransform transform = CGAffineTransformIdentity;
|
transform.c = -x;
|
transform.b = y;
|
return transform;
|
}
|
|
/// Negates/inverts a UIEdgeInsets.
|
static inline UIEdgeInsets YYTextUIEdgeInsetsInvert(UIEdgeInsets insets) {
|
return UIEdgeInsetsMake(-insets.top, -insets.left, -insets.bottom, -insets.right);
|
}
|
|
/// Convert CALayer's gravity string to UIViewContentMode.
|
UIViewContentMode YYTextCAGravityToUIViewContentMode(NSString *gravity);
|
|
/// Convert UIViewContentMode to CALayer's gravity string.
|
NSString *YYTextUIViewContentModeToCAGravity(UIViewContentMode contentMode);
|
|
|
|
/**
|
Returns a rectangle to fit the @param rect with specified content mode.
|
|
@param rect The constrant rect
|
@param size The content size
|
@param mode The content mode
|
@return A rectangle for the given content mode.
|
@discussion UIViewContentModeRedraw is same as UIViewContentModeScaleToFill.
|
*/
|
CGRect YYTextCGRectFitWithContentMode(CGRect rect, CGSize size, UIViewContentMode mode);
|
|
/// Returns the center for the rectangle.
|
static inline CGPoint YYTextCGRectGetCenter(CGRect rect) {
|
return CGPointMake(CGRectGetMidX(rect), CGRectGetMidY(rect));
|
}
|
|
/// Returns the area of the rectangle.
|
static inline CGFloat YYTextCGRectGetArea(CGRect rect) {
|
if (CGRectIsNull(rect)) return 0;
|
rect = CGRectStandardize(rect);
|
return rect.size.width * rect.size.height;
|
}
|
|
/// Returns the distance between two points.
|
static inline CGFloat YYTextCGPointGetDistanceToPoint(CGPoint p1, CGPoint p2) {
|
return sqrt((p1.x - p2.x) * (p1.x - p2.x) + (p1.y - p2.y) * (p1.y - p2.y));
|
}
|
|
/// Returns the minmium distance between a point to a rectangle.
|
static inline CGFloat YYTextCGPointGetDistanceToRect(CGPoint p, CGRect r) {
|
r = CGRectStandardize(r);
|
if (CGRectContainsPoint(r, p)) return 0;
|
CGFloat distV, distH;
|
if (CGRectGetMinY(r) <= p.y && p.y <= CGRectGetMaxY(r)) {
|
distV = 0;
|
} else {
|
distV = p.y < CGRectGetMinY(r) ? CGRectGetMinY(r) - p.y : p.y - CGRectGetMaxY(r);
|
}
|
if (CGRectGetMinX(r) <= p.x && p.x <= CGRectGetMaxX(r)) {
|
distH = 0;
|
} else {
|
distH = p.x < CGRectGetMinX(r) ? CGRectGetMinX(r) - p.x : p.x - CGRectGetMaxX(r);
|
}
|
return MAX(distV, distH);
|
}
|
|
|
/// Get main screen's scale.
|
CGFloat YYTextScreenScale();
|
|
/// Get main screen's size. Height is always larger than width.
|
CGSize YYTextScreenSize();
|
|
/// Convert point to pixel.
|
static inline CGFloat YYTextCGFloatToPixel(CGFloat value) {
|
return value * YYTextScreenScale();
|
}
|
|
/// Convert pixel to point.
|
static inline CGFloat YYTextCGFloatFromPixel(CGFloat value) {
|
return value / YYTextScreenScale();
|
}
|
|
/// floor point value for pixel-aligned
|
static inline CGFloat YYTextCGFloatPixelFloor(CGFloat value) {
|
CGFloat scale = YYTextScreenScale();
|
return floor(value * scale) / scale;
|
}
|
|
/// round point value for pixel-aligned
|
static inline CGFloat YYTextCGFloatPixelRound(CGFloat value) {
|
CGFloat scale = YYTextScreenScale();
|
return round(value * scale) / scale;
|
}
|
|
/// ceil point value for pixel-aligned
|
static inline CGFloat YYTextCGFloatPixelCeil(CGFloat value) {
|
CGFloat scale = YYTextScreenScale();
|
return ceil(value * scale) / scale;
|
}
|
|
/// round point value to .5 pixel for path stroke (odd pixel line width pixel-aligned)
|
static inline CGFloat YYTextCGFloatPixelHalf(CGFloat value) {
|
CGFloat scale = YYTextScreenScale();
|
return (floor(value * scale) + 0.5) / scale;
|
}
|
|
/// floor point value for pixel-aligned
|
static inline CGPoint YYTextCGPointPixelFloor(CGPoint point) {
|
CGFloat scale = YYTextScreenScale();
|
return CGPointMake(floor(point.x * scale) / scale,
|
floor(point.y * scale) / scale);
|
}
|
|
/// round point value for pixel-aligned
|
static inline CGPoint YYTextCGPointPixelRound(CGPoint point) {
|
CGFloat scale = YYTextScreenScale();
|
return CGPointMake(round(point.x * scale) / scale,
|
round(point.y * scale) / scale);
|
}
|
|
/// ceil point value for pixel-aligned
|
static inline CGPoint YYTextCGPointPixelCeil(CGPoint point) {
|
CGFloat scale = YYTextScreenScale();
|
return CGPointMake(ceil(point.x * scale) / scale,
|
ceil(point.y * scale) / scale);
|
}
|
|
/// round point value to .5 pixel for path stroke (odd pixel line width pixel-aligned)
|
static inline CGPoint YYTextCGPointPixelHalf(CGPoint point) {
|
CGFloat scale = YYTextScreenScale();
|
return CGPointMake((floor(point.x * scale) + 0.5) / scale,
|
(floor(point.y * scale) + 0.5) / scale);
|
}
|
|
|
|
/// floor point value for pixel-aligned
|
static inline CGSize YYTextCGSizePixelFloor(CGSize size) {
|
CGFloat scale = YYTextScreenScale();
|
return CGSizeMake(floor(size.width * scale) / scale,
|
floor(size.height * scale) / scale);
|
}
|
|
/// round point value for pixel-aligned
|
static inline CGSize YYTextCGSizePixelRound(CGSize size) {
|
CGFloat scale = YYTextScreenScale();
|
return CGSizeMake(round(size.width * scale) / scale,
|
round(size.height * scale) / scale);
|
}
|
|
/// ceil point value for pixel-aligned
|
static inline CGSize YYTextCGSizePixelCeil(CGSize size) {
|
CGFloat scale = YYTextScreenScale();
|
return CGSizeMake(ceil(size.width * scale) / scale,
|
ceil(size.height * scale) / scale);
|
}
|
|
/// round point value to .5 pixel for path stroke (odd pixel line width pixel-aligned)
|
static inline CGSize YYTextCGSizePixelHalf(CGSize size) {
|
CGFloat scale = YYTextScreenScale();
|
return CGSizeMake((floor(size.width * scale) + 0.5) / scale,
|
(floor(size.height * scale) + 0.5) / scale);
|
}
|
|
|
|
/// floor point value for pixel-aligned
|
static inline CGRect YYTextCGRectPixelFloor(CGRect rect) {
|
CGPoint origin = YYTextCGPointPixelCeil(rect.origin);
|
CGPoint corner = YYTextCGPointPixelFloor(CGPointMake(rect.origin.x + rect.size.width,
|
rect.origin.y + rect.size.height));
|
CGRect ret = CGRectMake(origin.x, origin.y, corner.x - origin.x, corner.y - origin.y);
|
if (ret.size.width < 0) ret.size.width = 0;
|
if (ret.size.height < 0) ret.size.height = 0;
|
return ret;
|
}
|
|
/// round point value for pixel-aligned
|
static inline CGRect YYTextCGRectPixelRound(CGRect rect) {
|
CGPoint origin = YYTextCGPointPixelRound(rect.origin);
|
CGPoint corner = YYTextCGPointPixelRound(CGPointMake(rect.origin.x + rect.size.width,
|
rect.origin.y + rect.size.height));
|
return CGRectMake(origin.x, origin.y, corner.x - origin.x, corner.y - origin.y);
|
}
|
|
/// ceil point value for pixel-aligned
|
static inline CGRect YYTextCGRectPixelCeil(CGRect rect) {
|
CGPoint origin = YYTextCGPointPixelFloor(rect.origin);
|
CGPoint corner = YYTextCGPointPixelCeil(CGPointMake(rect.origin.x + rect.size.width,
|
rect.origin.y + rect.size.height));
|
return CGRectMake(origin.x, origin.y, corner.x - origin.x, corner.y - origin.y);
|
}
|
|
/// round point value to .5 pixel for path stroke (odd pixel line width pixel-aligned)
|
static inline CGRect YYTextCGRectPixelHalf(CGRect rect) {
|
CGPoint origin = YYTextCGPointPixelHalf(rect.origin);
|
CGPoint corner = YYTextCGPointPixelHalf(CGPointMake(rect.origin.x + rect.size.width,
|
rect.origin.y + rect.size.height));
|
return CGRectMake(origin.x, origin.y, corner.x - origin.x, corner.y - origin.y);
|
}
|
|
|
|
/// floor UIEdgeInset for pixel-aligned
|
static inline UIEdgeInsets YYTextUIEdgeInsetPixelFloor(UIEdgeInsets insets) {
|
insets.top = YYTextCGFloatPixelFloor(insets.top);
|
insets.left = YYTextCGFloatPixelFloor(insets.left);
|
insets.bottom = YYTextCGFloatPixelFloor(insets.bottom);
|
insets.right = YYTextCGFloatPixelFloor(insets.right);
|
return insets;
|
}
|
|
/// ceil UIEdgeInset for pixel-aligned
|
static inline UIEdgeInsets YYTextUIEdgeInsetPixelCeil(UIEdgeInsets insets) {
|
insets.top = YYTextCGFloatPixelCeil(insets.top);
|
insets.left = YYTextCGFloatPixelCeil(insets.left);
|
insets.bottom = YYTextCGFloatPixelCeil(insets.bottom);
|
insets.right = YYTextCGFloatPixelCeil(insets.right);
|
return insets;
|
}
|
|
|
|
static inline UIFont * _Nullable YYTextFontWithBold(UIFont *font) {
|
if (![font respondsToSelector:@selector(fontDescriptor)]) return font;
|
return [UIFont fontWithDescriptor:[font.fontDescriptor fontDescriptorWithSymbolicTraits:UIFontDescriptorTraitBold] size:font.pointSize];
|
}
|
|
static inline UIFont * _Nullable YYTextFontWithItalic(UIFont *font) {
|
if (![font respondsToSelector:@selector(fontDescriptor)]) return font;
|
return [UIFont fontWithDescriptor:[font.fontDescriptor fontDescriptorWithSymbolicTraits:UIFontDescriptorTraitItalic] size:font.pointSize];
|
}
|
|
static inline UIFont * _Nullable YYTextFontWithBoldItalic(UIFont *font) {
|
if (![font respondsToSelector:@selector(fontDescriptor)]) return font;
|
return [UIFont fontWithDescriptor:[font.fontDescriptor fontDescriptorWithSymbolicTraits:UIFontDescriptorTraitBold | UIFontDescriptorTraitItalic] size:font.pointSize];
|
}
|
|
|
|
/**
|
Convert CFRange to NSRange
|
@param range CFRange @return NSRange
|
*/
|
static inline NSRange YYTextNSRangeFromCFRange(CFRange range) {
|
return NSMakeRange(range.location, range.length);
|
}
|
|
/**
|
Convert NSRange to CFRange
|
@param range NSRange @return CFRange
|
*/
|
static inline CFRange YYTextCFRangeFromNSRange(NSRange range) {
|
return CFRangeMake(range.location, range.length);
|
}
|
|
|
/// Returns YES in App Extension.
|
BOOL YYTextIsAppExtension();
|
|
/// Returns nil in App Extension.
|
UIApplication * _Nullable YYTextSharedApplication();
|
|
NS_ASSUME_NONNULL_END
|
