mirror of
https://github.com/Swiftgram/Telegram-iOS.git
synced 2025-06-16 05:55:20 +00:00
109 lines
3.3 KiB
Objective-C
109 lines
3.3 KiB
Objective-C
//
|
|
// ASTextKitRenderer.h
|
|
// Texture
|
|
//
|
|
// Copyright (c) Facebook, Inc. and its affiliates. All rights reserved.
|
|
// Changes after 4/13/2017 are: Copyright (c) Pinterest, Inc. All rights reserved.
|
|
// Licensed under Apache 2.0: http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
|
|
#import <UIKit/UIKit.h>
|
|
|
|
#import <AsyncDisplayKit/ASAvailability.h>
|
|
|
|
#if AS_ENABLE_TEXTNODE
|
|
|
|
#import <AsyncDisplayKit/ASTextKitAttributes.h>
|
|
|
|
#import <vector>
|
|
|
|
@class ASTextKitContext;
|
|
@class ASTextKitShadower;
|
|
@class ASTextKitFontSizeAdjuster;
|
|
@protocol ASTextKitTruncating;
|
|
|
|
/**
|
|
ASTextKitRenderer is a modular object that is responsible for laying out and drawing text.
|
|
|
|
A renderer will hold onto the TextKit layouts for the given attributes after initialization. This may constitute a
|
|
large amount of memory for large enough applications, so care must be taken when keeping many of these around in-memory
|
|
at once.
|
|
|
|
This object is designed to be modular and simple. All complex maintenance of state should occur in sub-objects or be
|
|
derived via pure functions or categories. No touch-related handling belongs in this class.
|
|
|
|
ALL sizing and layout information from this class is in the external coordinate space of the TextKit components. This
|
|
is an important distinction because all internal sizing and layout operations are carried out within the shadowed
|
|
coordinate space. Padding will be added for you in order to ensure clipping does not occur, and additional information
|
|
on this transform is available via the shadower should you need it.
|
|
*/
|
|
@interface ASTextKitRenderer : NSObject
|
|
|
|
/**
|
|
Designated Initializer
|
|
@discussion Sizing will occur as a result of initialization, so be careful when/where you use this.
|
|
*/
|
|
- (instancetype)initWithTextKitAttributes:(const ASTextKitAttributes &)textComponentAttributes
|
|
constrainedSize:(const CGSize)constrainedSize;
|
|
|
|
@property (nonatomic, readonly) ASTextKitContext *context;
|
|
|
|
@property (nonatomic, readonly) id<ASTextKitTruncating> truncater;
|
|
|
|
@property (nonatomic, readonly) ASTextKitFontSizeAdjuster *fontSizeAdjuster;
|
|
|
|
@property (nonatomic, readonly) ASTextKitShadower *shadower;
|
|
|
|
@property (nonatomic, readonly) ASTextKitAttributes attributes;
|
|
|
|
@property (nonatomic, readonly) CGSize constrainedSize;
|
|
|
|
@property (nonatomic, readonly) CGFloat currentScaleFactor;
|
|
|
|
#pragma mark - Drawing
|
|
/**
|
|
Draw the renderer's text content into the bounds provided.
|
|
|
|
@param bounds The rect in which to draw the contents of the renderer.
|
|
*/
|
|
- (void)drawInContext:(CGContextRef)context bounds:(CGRect)bounds;
|
|
|
|
#pragma mark - Layout
|
|
|
|
/**
|
|
Returns the computed size of the renderer given the constrained size and other parameters in the initializer.
|
|
*/
|
|
- (CGSize)size;
|
|
|
|
#pragma mark - Text Ranges
|
|
|
|
/**
|
|
The character range from the original attributedString that is displayed by the renderer given the parameters in the
|
|
initializer.
|
|
*/
|
|
@property (nonatomic, readonly) std::vector<NSRange> visibleRanges;
|
|
|
|
/**
|
|
The number of lines shown in the string.
|
|
*/
|
|
- (NSUInteger)lineCount;
|
|
|
|
/**
|
|
Whether or not the text is truncated.
|
|
*/
|
|
- (BOOL)isTruncated;
|
|
|
|
@end
|
|
|
|
@interface ASTextKitRenderer (ASTextKitRendererConvenience)
|
|
|
|
/**
|
|
Returns the first visible range or an NSRange with location of NSNotFound and size of 0 if no first visible
|
|
range exists
|
|
*/
|
|
@property (nonatomic, readonly) NSRange firstVisibleRange;
|
|
|
|
@end
|
|
|
|
#endif
|