mirror of
https://github.com/Swiftgram/Telegram-iOS.git
synced 2025-09-01 10:23:15 +00:00
d4725a51f2
* Add experimental text node implementation, based on YYText * Fix warnings and alert when unimplemented experimental features are used. * Address feedback from review * Extend the cthulog * Update license headers
69 lines
2.7 KiB
Objective-C
69 lines
2.7 KiB
Objective-C
//
|
|
// ASTextNode+Beta.h
|
|
// Texture
|
|
//
|
|
// Copyright (c) 2014-present, Facebook, Inc. All rights reserved.
|
|
// This source code is licensed under the BSD-style license found in the
|
|
// LICENSE file in the /ASDK-Licenses directory of this source tree. An additional
|
|
// grant of patent rights can be found in the PATENTS file in the same directory.
|
|
//
|
|
// Modifications to this file made after 4/13/2017 are: Copyright (c) 2017-present,
|
|
// Pinterest, Inc. Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
|
|
#import <UIKit/UIKit.h>
|
|
|
|
#import <AsyncDisplayKit/ASTextNode.h>
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
typedef NS_OPTIONS(NSUInteger, ASTextNodeExperimentOptions) {
|
|
// All subclass instances use the experimental implementation.
|
|
ASTextNodeExperimentSubclasses = 1 << 0,
|
|
// Random instances of ASTextNode (50% chance) (not subclasses) use experimental impl.
|
|
// Useful for profiling with apps that have no custom text node subclasses.
|
|
ASTextNodeExperimentRandomInstances = 1 << 1,
|
|
// All instances of ASTextNode itself use experimental implementation. Supersedes `.randomInstances`.
|
|
ASTextNodeExperimentAllInstances = 1 << 2,
|
|
// Add highlighting etc. for debugging.
|
|
ASTextNodeExperimentDebugging = 1 << 3
|
|
};
|
|
|
|
@interface ASTextNode ()
|
|
|
|
/**
|
|
@abstract An array of descending scale factors that will be applied to this text node to try to make it fit within its constrained size
|
|
@discussion This array should be in descending order and NOT contain the scale factor 1.0. For example, it could return @[@(.9), @(.85), @(.8)];
|
|
@default nil (no scaling)
|
|
*/
|
|
@property (nullable, nonatomic, copy) NSArray<NSNumber *> *pointSizeScaleFactors;
|
|
|
|
/**
|
|
@abstract Text margins for text laid out in the text node.
|
|
@discussion defaults to UIEdgeInsetsZero.
|
|
This property can be useful for handling text which does not fit within the view by default. An example: like UILabel,
|
|
ASTextNode will clip the left and right of the string "judar" if it's rendered in an italicised font.
|
|
*/
|
|
@property (nonatomic, assign) UIEdgeInsets textContainerInset;
|
|
|
|
/**
|
|
* Opt in to an experimental implementation of text node. The implementation may improve performance and correctness,
|
|
* but may not support all features and has not been thoroughly tested in production.
|
|
*
|
|
* @precondition You may not call this after allocating any text nodes. You may only call this once.
|
|
*/
|
|
+ (void)setExperimentOptions:(ASTextNodeExperimentOptions)options;
|
|
|
|
/**
|
|
* Returns YES if this node is using the experimental implementation. NO otherwise. Will not change.
|
|
*/
|
|
@property (atomic, readonly) BOOL usingExperiment;
|
|
|
|
@end
|
|
|
|
NS_ASSUME_NONNULL_END
|