mirror of
https://github.com/Swiftgram/Telegram-iOS.git
synced 2025-09-06 20:54:04 +00:00
* Introduce ASCollectionViewLayout - `ASCollectionViewLayout` is an async `UICollectionViewLayout` that encapsulates its layout calculation logic into a separate thread-safe object which can be used ahead of time and/or on multiple threads. - `ASDataController` now can prepare for a new layout resulted from a change set before `ASCollectionView` even knows about it. By the time the change set it ready to be consumed by `ASCollectionView`, its new layout is also ready. - New `ASCollectionViewLayoutCalculating` protocol that is simple and generic enough that many types of calculators can be built on top. `ASCollectionViewLayoutSpecCalculator` conforms to `ASCollectionViewLayoutCalculating` protocol and can be backed by any layout spec (e.g `ASStackLayoutSpec`, `PIMasonryLayoutSpec`, etc). We can even build a `ASCollectionViewLayoutYogaCalculator` that uses Yoga internally. - A built-in `ASCollectionViewFlowLayoutCalculator` that is a subclass of `ASCollectionViewLayoutSpecCalculator` and uses a multi-threaded multi-line `ASStackLayoutSpec` internally. The result is a performant and thread-safe flow layout calculator. - Finally, `ASCollectionViewLayout` can be subclassed to handle a specific type of calculator with optimizations implemented based on the knowledge of such calculator. For example, `ASCollectionViewFlowLayout` can have a highly optimized implementation of `-layoutAttributesForElementsInRect:`. Protocolize layout calculator providing and consuming Add flex wrap documentation Add a `multithreaded` flag to ASStackLayoutSpec that forces it to dispatch even if it's off main - Update ASCollectionViewFlowLayoutSpecCalculator to use that flag. Minor change in ASCollectionViewLayout Implement Mosaic layout calculator Minor change Fix project file Rename and fix project file Skip fetching constrained size only if a layout calculator is available Update examples/ASCollectionView Remove unnecessary change in ASTableView Address comments Rename collection view calculator protocols Minor changes after rebasing with master Add ASLegacyCollectionLayoutCalculator for backward compatibility Remove ASCollectionLayoutSpecCalculator Remove ASLegacyCollectionLayoutCalculator Introduce ASCollectionLayout - A wrapper object that contains content size and an element to rect table. - Collection layout calculators to return this new object instead of an ASLayout. Before adding a content cache Finishing hooking up ASCollectionLayoutDataSource to ASCollectionNode Stash Finish ASCollectionLayout Rough impl of ASCollectionFlowLayout Revert changes in CustomCollectionView example Move ASRectTable back to Private * Rename ASCollectionContentAttributes to ASCollectionLayoutState * Address other comments * Introduce ASCollectionLayoutDelegate and make ASCollectionLayout private * Address comments * API tweaks: - Replace `-layoutContextWithElementMap:` in ASCollectionLayoutDelegate with `-additionalInfoForLayoutWithElements:`. The returned object is then stored in ASCollectionLayoutContext for later lookups. - ASCollectionLayoutContext has no public initializer. - ASDataControllerLayoutDelegate no longer requires a context of type ASCollectionLayoutContext but simply an `id`. This helps decouple ASDataController and ASCollectionLayout. - Rename `elementMap` to `elements`. - Rename `visibleMap` to `visibleElements`. - Other minor changes. * Rename ASCGSizeHash to ASHashFromCGSize * Make sure to call super in -[ASCollectionLayout prepareLayout] * Update example/ASCollectionView to use ASCollectionFlowLayoutDelegate * Remove unnecessary change
110 lines
3.7 KiB
Objective-C
110 lines
3.7 KiB
Objective-C
//
|
||
// ASTwoDimensionalArrayUtils.m
|
||
// AsyncDisplayKit
|
||
//
|
||
// 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 root directory of this source tree. An additional grant
|
||
// of patent rights can be found in the PATENTS file in the same directory.
|
||
//
|
||
|
||
#import <AsyncDisplayKit/ASAssert.h>
|
||
#import <AsyncDisplayKit/ASInternalHelpers.h>
|
||
#import <AsyncDisplayKit/ASTwoDimensionalArrayUtils.h>
|
||
|
||
// Import UIKit to get [NSIndexPath indexPathForItem:inSection:] which uses
|
||
// tagged pointers.
|
||
#import <UIKit/UIKit.h>
|
||
|
||
#pragma mark - Public Methods
|
||
|
||
NSMutableArray<NSMutableArray *> *ASTwoDimensionalArrayDeepMutableCopy(NSArray<NSArray *> *array)
|
||
{
|
||
NSMutableArray *newArray = [NSMutableArray arrayWithCapacity:array.count];
|
||
NSInteger i = 0;
|
||
for (NSArray *subarray in array) {
|
||
ASDisplayNodeCAssert([subarray isKindOfClass:[NSArray class]], @"This function expects NSArray<NSArray *> *");
|
||
newArray[i++] = [subarray mutableCopy];
|
||
}
|
||
return newArray;
|
||
}
|
||
|
||
void ASDeleteElementsInTwoDimensionalArrayAtIndexPaths(NSMutableArray *mutableArray, NSArray *indexPaths)
|
||
{
|
||
if (indexPaths.count == 0) {
|
||
return;
|
||
}
|
||
|
||
#if ASDISPLAYNODE_ASSERTIONS_ENABLED
|
||
NSArray *sortedIndexPaths = [indexPaths sortedArrayUsingSelector:@selector(asdk_inverseCompare:)];
|
||
ASDisplayNodeCAssert([sortedIndexPaths isEqualToArray:indexPaths], @"Expected array of index paths to be sorted in descending order.");
|
||
#endif
|
||
|
||
/**
|
||
* It is tempting to do something clever here and collect indexes into ranges or NSIndexSets
|
||
* but deep down, __NSArrayM only implements removeObjectAtIndex: and so doing all that extra
|
||
* work ends up running the same code.
|
||
*/
|
||
for (NSIndexPath *indexPath in indexPaths) {
|
||
NSInteger section = indexPath.section;
|
||
if (section >= mutableArray.count) {
|
||
ASDisplayNodeCFailAssert(@"Invalid section index %zd – only %zd sections", section, mutableArray.count);
|
||
continue;
|
||
}
|
||
|
||
NSMutableArray *subarray = mutableArray[section];
|
||
NSInteger item = indexPath.item;
|
||
if (item >= subarray.count) {
|
||
ASDisplayNodeCFailAssert(@"Invalid item index %zd – only %zd items in section %zd", item, subarray.count, section);
|
||
continue;
|
||
}
|
||
[subarray removeObjectAtIndex:item];
|
||
}
|
||
}
|
||
|
||
NSArray *ASIndexPathsForTwoDimensionalArray(NSArray <NSArray *>* twoDimensionalArray)
|
||
{
|
||
NSMutableArray *result = [NSMutableArray array];
|
||
NSInteger section = 0;
|
||
NSInteger i = 0;
|
||
for (NSArray *subarray in twoDimensionalArray) {
|
||
ASDisplayNodeCAssert([subarray isKindOfClass:[NSArray class]], @"This function expects NSArray<NSArray *> *");
|
||
NSInteger itemCount = subarray.count;
|
||
for (NSInteger item = 0; item < itemCount; item++) {
|
||
result[i++] = [NSIndexPath indexPathForItem:item inSection:section];
|
||
}
|
||
section++;
|
||
}
|
||
return result;
|
||
}
|
||
|
||
NSArray *ASElementsInTwoDimensionalArray(NSArray <NSArray *>* twoDimensionalArray)
|
||
{
|
||
NSMutableArray *result = [NSMutableArray array];
|
||
NSInteger i = 0;
|
||
for (NSArray *subarray in twoDimensionalArray) {
|
||
ASDisplayNodeCAssert([subarray isKindOfClass:[NSArray class]], @"This function expects NSArray<NSArray *> *");
|
||
for (id element in subarray) {
|
||
result[i++] = element;
|
||
}
|
||
}
|
||
return result;
|
||
}
|
||
|
||
id ASGetElementInTwoDimensionalArray(NSArray *array, NSIndexPath *indexPath)
|
||
{
|
||
ASDisplayNodeCAssertNotNil(indexPath, @"Expected non-nil index path");
|
||
ASDisplayNodeCAssert(indexPath.length == 2, @"Expected index path of length 2. Index path: %@", indexPath);
|
||
NSInteger section = indexPath.section;
|
||
if (array.count <= section) {
|
||
return nil;
|
||
}
|
||
|
||
NSArray *innerArray = array[section];
|
||
NSInteger item = indexPath.item;
|
||
if (innerArray.count <= item) {
|
||
return nil;
|
||
}
|
||
return innerArray[item];
|
||
}
|