// // ASAbstractLayoutController.mm // 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 #import #include extern ASRangeTuningParameters const ASRangeTuningParametersZero = {}; extern BOOL ASRangeTuningParametersEqualToRangeTuningParameters(ASRangeTuningParameters lhs, ASRangeTuningParameters rhs) { return lhs.leadingBufferScreenfuls == rhs.leadingBufferScreenfuls && lhs.trailingBufferScreenfuls == rhs.trailingBufferScreenfuls; } extern ASDirectionalScreenfulBuffer ASDirectionalScreenfulBufferHorizontal(ASScrollDirection scrollDirection, ASRangeTuningParameters rangeTuningParameters) { ASDirectionalScreenfulBuffer horizontalBuffer = {0, 0}; BOOL movingRight = ASScrollDirectionContainsRight(scrollDirection); horizontalBuffer.positiveDirection = movingRight ? rangeTuningParameters.leadingBufferScreenfuls : rangeTuningParameters.trailingBufferScreenfuls; horizontalBuffer.negativeDirection = movingRight ? rangeTuningParameters.trailingBufferScreenfuls : rangeTuningParameters.leadingBufferScreenfuls; return horizontalBuffer; } extern ASDirectionalScreenfulBuffer ASDirectionalScreenfulBufferVertical(ASScrollDirection scrollDirection, ASRangeTuningParameters rangeTuningParameters) { ASDirectionalScreenfulBuffer verticalBuffer = {0, 0}; BOOL movingDown = ASScrollDirectionContainsDown(scrollDirection); verticalBuffer.positiveDirection = movingDown ? rangeTuningParameters.leadingBufferScreenfuls : rangeTuningParameters.trailingBufferScreenfuls; verticalBuffer.negativeDirection = movingDown ? rangeTuningParameters.trailingBufferScreenfuls : rangeTuningParameters.leadingBufferScreenfuls; return verticalBuffer; } extern CGRect CGRectExpandHorizontally(CGRect rect, ASDirectionalScreenfulBuffer buffer) { CGFloat negativeDirectionWidth = buffer.negativeDirection * rect.size.width; CGFloat positiveDirectionWidth = buffer.positiveDirection * rect.size.width; rect.size.width = negativeDirectionWidth + rect.size.width + positiveDirectionWidth; rect.origin.x -= negativeDirectionWidth; return rect; } extern CGRect CGRectExpandVertically(CGRect rect, ASDirectionalScreenfulBuffer buffer) { CGFloat negativeDirectionHeight = buffer.negativeDirection * rect.size.height; CGFloat positiveDirectionHeight = buffer.positiveDirection * rect.size.height; rect.size.height = negativeDirectionHeight + rect.size.height + positiveDirectionHeight; rect.origin.y -= negativeDirectionHeight; return rect; } extern CGRect CGRectExpandToRangeWithScrollableDirections(CGRect rect, ASRangeTuningParameters tuningParameters, ASScrollDirection scrollableDirections, ASScrollDirection scrollDirection) { // Can scroll horizontally - expand the range appropriately if (ASScrollDirectionContainsHorizontalDirection(scrollableDirections)) { ASDirectionalScreenfulBuffer horizontalBuffer = ASDirectionalScreenfulBufferHorizontal(scrollDirection, tuningParameters); rect = CGRectExpandHorizontally(rect, horizontalBuffer); } // Can scroll vertically - expand the range appropriately if (ASScrollDirectionContainsVerticalDirection(scrollableDirections)) { ASDirectionalScreenfulBuffer verticalBuffer = ASDirectionalScreenfulBufferVertical(scrollDirection, tuningParameters); rect = CGRectExpandVertically(rect, verticalBuffer); } return rect; } @interface ASAbstractLayoutController () { std::vector> _tuningParameters; CGSize _viewportSize; } @end @implementation ASAbstractLayoutController - (instancetype)init { if (!(self = [super init])) { return nil; } _tuningParameters = std::vector> (ASLayoutRangeModeCount, std::vector (ASLayoutRangeTypeCount)); _tuningParameters[ASLayoutRangeModeFull][ASLayoutRangeTypeDisplay] = { .leadingBufferScreenfuls = 1.0, .trailingBufferScreenfuls = 0.5 }; _tuningParameters[ASLayoutRangeModeFull][ASLayoutRangeTypePreload] = { .leadingBufferScreenfuls = 2.5, .trailingBufferScreenfuls = 1.5 }; _tuningParameters[ASLayoutRangeModeMinimum][ASLayoutRangeTypeDisplay] = { .leadingBufferScreenfuls = 0.25, .trailingBufferScreenfuls = 0.25 }; _tuningParameters[ASLayoutRangeModeMinimum][ASLayoutRangeTypePreload] = { .leadingBufferScreenfuls = 0.5, .trailingBufferScreenfuls = 0.25 }; _tuningParameters[ASLayoutRangeModeVisibleOnly][ASLayoutRangeTypeDisplay] = { .leadingBufferScreenfuls = 0, .trailingBufferScreenfuls = 0 }; _tuningParameters[ASLayoutRangeModeVisibleOnly][ASLayoutRangeTypePreload] = { .leadingBufferScreenfuls = 0, .trailingBufferScreenfuls = 0 }; // The Low Memory range mode has special handling. Because a zero range still includes the visible area / bounds, // in order to implement the behavior of releasing all graphics memory (backing stores), ASRangeController must check // for this range mode and use an empty set for displayIndexPaths rather than querying the ASLayoutController for the indexPaths. _tuningParameters[ASLayoutRangeModeLowMemory][ASLayoutRangeTypeDisplay] = { .leadingBufferScreenfuls = 0, .trailingBufferScreenfuls = 0 }; _tuningParameters[ASLayoutRangeModeLowMemory][ASLayoutRangeTypePreload] = { .leadingBufferScreenfuls = 0, .trailingBufferScreenfuls = 0 }; return self; } #pragma mark - Tuning Parameters - (ASRangeTuningParameters)tuningParametersForRangeType:(ASLayoutRangeType)rangeType { return [self tuningParametersForRangeMode:ASLayoutRangeModeFull rangeType:rangeType]; } - (void)setTuningParameters:(ASRangeTuningParameters)tuningParameters forRangeType:(ASLayoutRangeType)rangeType { return [self setTuningParameters:tuningParameters forRangeMode:ASLayoutRangeModeFull rangeType:rangeType]; } - (ASRangeTuningParameters)tuningParametersForRangeMode:(ASLayoutRangeMode)rangeMode rangeType:(ASLayoutRangeType)rangeType { ASDisplayNodeAssert(rangeMode < _tuningParameters.size() && rangeType < _tuningParameters[rangeMode].size(), @"Requesting a range that is OOB for the configured tuning parameters"); return _tuningParameters[rangeMode][rangeType]; } - (void)setTuningParameters:(ASRangeTuningParameters)tuningParameters forRangeMode:(ASLayoutRangeMode)rangeMode rangeType:(ASLayoutRangeType)rangeType { ASDisplayNodeAssert(rangeMode < _tuningParameters.size() && rangeType < _tuningParameters[rangeMode].size(), @"Setting a range that is OOB for the configured tuning parameters"); _tuningParameters[rangeMode][rangeType] = tuningParameters; } #pragma mark - Abstract Index Path Range Support - (NSSet *)indexPathsForScrolling:(ASScrollDirection)scrollDirection rangeMode:(ASLayoutRangeMode)rangeMode rangeType:(ASLayoutRangeType)rangeType { ASDisplayNodeAssertNotSupported(); return nil; } - (void)setViewportSize:(CGSize)viewportSize { _viewportSize = viewportSize; } - (CGSize)viewportSize { return _viewportSize; } @end