mirror of
https://github.com/Swiftgram/Telegram-iOS.git
synced 2025-09-03 03:10:47 +00:00
465abb1ded
* [License] Simplify the Texture license to be pure Apache 2 (removing ASDK-Licenses) With permission of the Facebook Open Source team, we are simplifying the Texture license so that clients can rely on the Apache 2 terms that most of Texture is already covered by. This means that code originally forked from AsyncDisplayKit will be re-licensed from "BSD 3-clause + PATENTS v2" to Apache 2 without a PATENTS file. After getting confirmation that the updates to these core files look good, we'll propagate this new license header to all files (in this same PR) and get sign-off from all parties before landing. * [License] Update all Texture source files to be pure Apache 2. * Changelog entry for Apache 2 license update. * Revert "[License] Update all Texture source files to be pure Apache 2." This reverts commit ffa0fbbba9717d871dd16c4b07539f2f8208fc2b. * [License] Update all Texture source files to be pure Apache 2, maintaining copyrights. * [License] Update CONTRIBUTING, README, Podspec & Dangerfile.
103 lines
4.4 KiB
Objective-C
103 lines
4.4 KiB
Objective-C
//
|
|
// ASTextKitRenderer+Positioning.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 <AsyncDisplayKit/ASTextKitRenderer.h>
|
|
|
|
typedef void (^as_text_component_index_block_t)(NSUInteger characterIndex,
|
|
CGRect glyphBoundingRect,
|
|
BOOL *stop);
|
|
|
|
/**
|
|
Measure options are used to specify which type of line height measurement to use.
|
|
|
|
ASTextNodeRendererMeasureOptionLineHeight is faster and will give the height from the baseline to the next line.
|
|
|
|
ASTextNodeRendererMeasureOptionCapHeight is a more nuanced measure of the glyphs in the given range that attempts to
|
|
produce a visually balanced rectangle above and below the glyphs to produce nice looking text highlights.
|
|
|
|
ASTextNodeRendererMeasureOptionBlock uses the cap height option to generate each glyph index, but combines all but the
|
|
first and last line rect into a single block. Looks nice for multiline selection.
|
|
*/
|
|
typedef NS_ENUM(NSUInteger, ASTextKitRendererMeasureOption) {
|
|
ASTextKitRendererMeasureOptionLineHeight,
|
|
ASTextKitRendererMeasureOptionCapHeight,
|
|
ASTextKitRendererMeasureOptionBlock
|
|
};
|
|
|
|
@interface ASTextKitRenderer (Positioning)
|
|
|
|
/**
|
|
Returns the bounding rect for the given character range.
|
|
|
|
@param textRange The character range for which the bounding rect will be computed. Should be within the range of the
|
|
attributedString of this renderer.
|
|
|
|
@discussion In the external, shadowed coordinate space.
|
|
*/
|
|
- (CGRect)frameForTextRange:(NSRange)textRange;
|
|
|
|
/**
|
|
Returns an array of rects representing the lines in the given character range
|
|
|
|
@param textRange The character range for which the rects will be computed. Should be within the range of the
|
|
attributedString of this renderer.
|
|
@param measureOption The measure option to use for construction of the rects. See ASTextKitRendererMeasureOption
|
|
docs for usage.
|
|
|
|
@discussion This method is useful for providing highlighting text. Returned rects are in the coordinate space of the
|
|
renderer.
|
|
|
|
Triggers initialization of textkit components, truncation, and sizing.
|
|
*/
|
|
- (NSArray *)rectsForTextRange:(NSRange)textRange
|
|
measureOption:(ASTextKitRendererMeasureOption)measureOption;
|
|
|
|
/**
|
|
Enumerate the text character indexes at a position within the coordinate space of the renderer.
|
|
|
|
@param position The point in the shadowed coordinate space at which text indexes will be enumerated.
|
|
@param block The block that will be executed for each index identified that may correspond to the given position. The
|
|
block is given the character index that corresponds to the glyph at each index in question, as well as the bounding
|
|
rect for that glyph.
|
|
|
|
@discussion Glyph location based on a touch point is not an exact science because user touches are not well-represented
|
|
by a simple point, especially in the context of link-heavy text. So we have this method to make it a bit easier. This
|
|
method checks a grid of candidate positions around the touch point you give it, and computes the bounding rect of the
|
|
glyph corresponding to the character index given.
|
|
|
|
The bounding rect of the glyph can be used to identify the best glyph index that corresponds to your touch. For
|
|
instance, comparing centroidal distance from the glyph bounding rect to the touch center is useful for identifying
|
|
which link a user actually intended to select.
|
|
|
|
Triggers initialization of textkit components, truncation, and sizing.
|
|
*/
|
|
- (void)enumerateTextIndexesAtPosition:(CGPoint)position
|
|
usingBlock:(as_text_component_index_block_t)block;
|
|
|
|
/**
|
|
Returns the single text index whose glyph's centroid is closest to the given position.
|
|
|
|
@param position The point in the shadowed coordinate space that should be checked.
|
|
|
|
@discussion This will use the grid enumeration function above, `enumerateTextIndexesAtPosition...`, in order to find
|
|
the closest glyph, so it is possible that a glyph could be missed, but ultimately unlikely.
|
|
*/
|
|
- (NSUInteger)nearestTextIndexAtPosition:(CGPoint)position;
|
|
|
|
/**
|
|
Returns the trailing rect unused by the renderer in the last rendered line.
|
|
|
|
@discussion In the external shadowed coordinate space.
|
|
|
|
Triggers initialization of textkit components, truncation, and sizing.
|
|
*/
|
|
- (CGRect)trailingRect;
|
|
|
|
@end
|