您最多选择25个主题 主题必须以中文或者字母或数字开头,可以包含连字符 (-),并且长度不得超过35个字符
 
 
 
 
 
 

1483 行
59 KiB

using System;
using System.Collections.Generic;
using Unity.UIWidgets.animation;
using Unity.UIWidgets.foundation;
using Unity.UIWidgets.gestures;
using Unity.UIWidgets.painting;
using Unity.UIWidgets.ui;
using UnityEngine;
using Canvas = Unity.UIWidgets.ui.Canvas;
using Color = Unity.UIWidgets.ui.Color;
using Rect = Unity.UIWidgets.ui.Rect;
namespace Unity.UIWidgets.rendering {
public enum CacheExtentStyle {
pixel,
viewport,
}
public interface RenderAbstractViewport {
RevealedOffset getOffsetToReveal(RenderObject target, float alignment, Rect rect = null);
RenderObject parent { get; }
}
public static class RenderViewportUtils {
public static RenderAbstractViewport of(RenderObject obj) {
while (obj != null) {
if (obj is RenderAbstractViewport) {
return (RenderAbstractViewport) obj;
}
obj = (RenderObject) obj.parent;
}
return null;
}
public const float defaultCacheExtent = 250.0f;
}
public class RevealedOffset {
public RevealedOffset(
float offset,
Rect rect) {
D.assert(rect != null);
this.offset = offset;
this.rect = rect;
}
public readonly float offset;
public readonly Rect rect;
public override string ToString() {
return $"{GetType()}(offset: {offset}, rect: {rect})";
}
}
public abstract class RenderViewportBase<ParentDataClass> :
ContainerRenderObjectMixinRenderBox<RenderSliver, ParentDataClass>,
RenderAbstractViewport
where ParentDataClass : ParentData, ContainerParentDataMixin<RenderSliver> {
protected RenderViewportBase(
AxisDirection axisDirection = AxisDirection.down,
AxisDirection crossAxisDirection = AxisDirection.right,
ViewportOffset offset = null,
float? cacheExtent = null,
CacheExtentStyle cacheExtentStyle = CacheExtentStyle.pixel
) {
D.assert(offset != null);
D.assert(AxisUtils.axisDirectionToAxis(axisDirection) != AxisUtils.axisDirectionToAxis(crossAxisDirection));
D.assert(cacheExtent != null || cacheExtentStyle == CacheExtentStyle.pixel);
_axisDirection = axisDirection;
_crossAxisDirection = crossAxisDirection;
_offset = offset;
_cacheExtent = cacheExtent ?? RenderViewportUtils.defaultCacheExtent;
_cacheExtentStyle = cacheExtentStyle;
}
public new RenderObject parent {
get { return (RenderObject) base.parent; }
}
public AxisDirection axisDirection {
get { return _axisDirection; }
set {
if (value == _axisDirection) {
return;
}
_axisDirection = value;
markNeedsLayout();
}
}
AxisDirection _axisDirection;
public AxisDirection crossAxisDirection {
get { return _crossAxisDirection; }
set {
if (value == _crossAxisDirection) {
return;
}
_crossAxisDirection = value;
markNeedsLayout();
}
}
AxisDirection _crossAxisDirection;
public Axis axis {
get { return AxisUtils.axisDirectionToAxis(axisDirection); }
}
public ViewportOffset offset {
get { return _offset; }
set {
D.assert(value != null);
if (value == _offset) {
return;
}
if (attached) {
_offset.removeListener(markNeedsLayout);
}
_offset = value;
if (attached) {
_offset.addListener(markNeedsLayout);
}
markNeedsLayout();
}
}
ViewportOffset _offset;
public float cacheExtent {
get { return _cacheExtent; }
set {
if (value == _cacheExtent) {
return;
}
_cacheExtent = value;
markNeedsLayout();
}
}
float _cacheExtent;
public float _calculatedCacheExtent;
public CacheExtentStyle cacheExtentStyle {
get {
return _cacheExtentStyle;
}
set {
if (value == _cacheExtentStyle) {
return;
}
_cacheExtentStyle = value;
markNeedsLayout();
}
}
CacheExtentStyle _cacheExtentStyle;
public override void attach(object owner) {
base.attach(owner);
_offset.addListener(markNeedsLayout);
}
public override void detach() {
_offset.removeListener(markNeedsLayout);
base.detach();
}
protected virtual bool debugThrowIfNotCheckingIntrinsics() {
D.assert(() => {
if (!debugCheckingIntrinsics) {
D.assert(!(this is RenderShrinkWrappingViewport));
throw new UIWidgetsError(new List<DiagnosticsNode>{
new ErrorSummary($"{GetType()} does not support returning intrinsic dimensions."),
new ErrorDescription(
"Calculating the intrinsic dimensions would require instantiating every child of " +
"the viewport, which defeats the point of viewports being lazy."
),
new ErrorHint(
"If you are merely trying to shrink-wrap the viewport in the main axis direction, " +
"consider a RenderShrinkWrappingViewport render object (ShrinkWrappingViewport widget), " +
"which achieves that effect without implementing the intrinsic dimension API."
),
});
}
return true;
});
return true;
}
protected internal override float computeMinIntrinsicWidth(float height) {
D.assert(debugThrowIfNotCheckingIntrinsics());
return 0.0f;
}
protected internal override float computeMaxIntrinsicWidth(float height) {
D.assert(debugThrowIfNotCheckingIntrinsics());
return 0.0f;
}
protected internal override float computeMinIntrinsicHeight(float width) {
D.assert(debugThrowIfNotCheckingIntrinsics());
return 0.0f;
}
protected internal override float computeMaxIntrinsicHeight(float width) {
D.assert(debugThrowIfNotCheckingIntrinsics());
return 0.0f;
}
public override bool isRepaintBoundary {
get { return true; }
}
protected float layoutChildSequence(
RenderSliver child,
float scrollOffset,
float overlap,
float layoutOffset,
float remainingPaintExtent,
float mainAxisExtent,
float crossAxisExtent,
GrowthDirection growthDirection,
Func<RenderSliver, RenderSliver> advance,
float remainingCacheExtent,
float cacheOrigin
) {
D.assert(scrollOffset.isFinite());
D.assert(scrollOffset >= 0.0);
float initialLayoutOffset = layoutOffset;
ScrollDirection adjustedUserScrollDirection =
GrowthDirectionUtils.applyGrowthDirectionToScrollDirection(
offset.userScrollDirection, growthDirection);
float maxPaintOffset = layoutOffset + overlap;
float precedingScrollExtent = 0.0f;
while (child != null) {
float sliverScrollOffset = scrollOffset <= 0.0 ? 0.0f : scrollOffset;
float correctedCacheOrigin = Mathf.Max(cacheOrigin, -sliverScrollOffset);
float cacheExtentCorrection = cacheOrigin - correctedCacheOrigin;
D.assert(sliverScrollOffset >= correctedCacheOrigin.abs());
D.assert(correctedCacheOrigin <= 0.0);
D.assert(sliverScrollOffset >= 0.0);
D.assert(cacheExtentCorrection <= 0.0);
child.layout(new SliverConstraints(
axisDirection: axisDirection,
growthDirection: growthDirection,
userScrollDirection: adjustedUserScrollDirection,
scrollOffset: sliverScrollOffset,
precedingScrollExtent: precedingScrollExtent,
overlap: maxPaintOffset - layoutOffset,
remainingPaintExtent: Mathf.Max(0.0f,
remainingPaintExtent - layoutOffset + initialLayoutOffset),
crossAxisExtent: crossAxisExtent,
crossAxisDirection: crossAxisDirection,
viewportMainAxisExtent: mainAxisExtent,
remainingCacheExtent: Mathf.Max(0.0f, remainingCacheExtent + cacheExtentCorrection),
cacheOrigin: correctedCacheOrigin
), parentUsesSize: true);
var childLayoutGeometry = child.geometry;
D.assert(childLayoutGeometry.debugAssertIsValid());
if (childLayoutGeometry.scrollOffsetCorrection != null) {
return childLayoutGeometry.scrollOffsetCorrection.Value;
}
float effectiveLayoutOffset = layoutOffset + childLayoutGeometry.paintOrigin;
if (childLayoutGeometry.visible || scrollOffset > 0) {
updateChildLayoutOffset(child, effectiveLayoutOffset, growthDirection);
}
else {
updateChildLayoutOffset(child, -scrollOffset + initialLayoutOffset, growthDirection);
}
maxPaintOffset = Mathf.Max(effectiveLayoutOffset + childLayoutGeometry.paintExtent,
maxPaintOffset);
scrollOffset -= childLayoutGeometry.scrollExtent;
precedingScrollExtent += childLayoutGeometry.scrollExtent;
layoutOffset += childLayoutGeometry.layoutExtent;
if (childLayoutGeometry.cacheExtent != 0.0) {
remainingCacheExtent -= childLayoutGeometry.cacheExtent - cacheExtentCorrection;
cacheOrigin = Mathf.Min(correctedCacheOrigin + childLayoutGeometry.cacheExtent, 0.0f);
}
updateOutOfBandData(growthDirection, childLayoutGeometry);
child = advance(child);
}
return 0.0f;
}
public override Rect describeApproximatePaintClip(RenderObject childRaw) {
RenderSliver child = (RenderSliver) childRaw;
Rect viewportClip = Offset.zero & size;
if (child.constraints.overlap == 0.0 || !child.constraints.viewportMainAxisExtent.isFinite()) {
return viewportClip;
}
float left = viewportClip.left;
float right = viewportClip.right;
float top = viewportClip.top;
float bottom = viewportClip.bottom;
float startOfOverlap = child.constraints.viewportMainAxisExtent - child.constraints.remainingPaintExtent;
float overlapCorrection = startOfOverlap + child.constraints.overlap;
switch (GrowthDirectionUtils.applyGrowthDirectionToAxisDirection(
axisDirection, child.constraints.growthDirection)) {
case AxisDirection.down:
top += overlapCorrection;
break;
case AxisDirection.up:
bottom -= overlapCorrection;
break;
case AxisDirection.right:
left += overlapCorrection;
break;
case AxisDirection.left:
right -= overlapCorrection;
break;
}
return Rect.fromLTRB(left, top, right, bottom);
}
public override void paint(PaintingContext context, Offset offset) {
if (firstChild == null) {
return;
}
if (hasVisualOverflow) {
context.pushClipRect(needsCompositing, offset, Offset.zero & size, _paintContents);
}
else {
_paintContents(context, offset);
}
}
public void _paintContents(PaintingContext context, Offset offset) {
foreach (RenderSliver child in childrenInPaintOrder) {
if (child.geometry.visible) {
context.paintChild(child, offset + paintOffsetOf(child));
}
}
}
protected override void debugPaintSize(PaintingContext context, Offset offset) {
D.assert(() => {
base.debugPaintSize(context, offset);
Paint paint = new Paint {
color = new Color(0xFF00FF00),
strokeWidth = 1.0f,
style = PaintingStyle.stroke,
};
Canvas canvas = context.canvas;
RenderSliver child = firstChild;
while (child != null) {
Size size = null;
switch (axis) {
case Axis.vertical:
size = new Size(child.constraints.crossAxisExtent, child.geometry.layoutExtent);
break;
case Axis.horizontal:
size = new Size(child.geometry.layoutExtent, child.constraints.crossAxisExtent);
break;
}
D.assert(size != null);
canvas.drawRect(((offset + paintOffsetOf(child)) & size).deflate(0.5f), paint);
child = childAfter(child);
}
return true;
});
}
protected override bool hitTestChildren(BoxHitTestResult result, Offset position = null) {
D.assert(position != null);
float mainAxisPosition = 0, crossAxisPosition = 0;
switch (axis) {
case Axis.vertical:
mainAxisPosition = position.dy;
crossAxisPosition = position.dx;
break;
case Axis.horizontal:
mainAxisPosition = position.dx;
crossAxisPosition = position.dy;
break;
}
SliverHitTestResult sliverResult = new SliverHitTestResult(result);
foreach (RenderSliver child in childrenInHitTestOrder) {
if (!child.geometry.visible) {
continue;
}
Matrix4 transform = Matrix4.identity();
applyPaintTransform(child, transform);
bool isHit = result.addWithPaintTransform(
transform: transform,
position: null, // Manually adapting from box to sliver position below.
hitTest: (BoxHitTestResult resultIn, Offset _) => {
return child.hitTest(
sliverResult,
mainAxisPosition: computeChildMainAxisPosition(child, mainAxisPosition),
crossAxisPosition: crossAxisPosition
);
}
);
if (isHit) {
return true;
}
}
return false;
}
public RevealedOffset getOffsetToReveal(RenderObject target, float alignment, Rect rect = null) {
float leadingScrollOffset = 0.0f;
float targetMainAxisExtent = 0.0f;
rect = rect ?? target.paintBounds;
Matrix4 transform;
RenderObject child = target;
RenderBox pivot = null;
bool onlySlivers = target is RenderSliver;
while (child.parent != this) {
D.assert(child.parent != null, () => $"{target} must be a descendant of {this}");
if (child is RenderBox) {
pivot = (RenderBox) child;
}
if (child.parent is RenderSliver) {
RenderSliver parent = (RenderSliver) child.parent;
leadingScrollOffset += parent.childScrollOffset(child) ?? 0.0f;
}
else {
onlySlivers = false;
leadingScrollOffset = 0.0f;
}
child = (RenderObject) child.parent;
}
if (pivot != null) {
D.assert(pivot.parent != null);
D.assert(pivot.parent != this);
D.assert(pivot != this);
D.assert(pivot.parent is RenderSliver);
RenderSliver pivotParent = (RenderSliver) pivot.parent;
transform = target.getTransformTo(pivot);
Rect bounds = MatrixUtils.transformRect(transform, rect);
float offset = 0.0f;
GrowthDirection growthDirection = pivotParent.constraints.growthDirection;
switch (GrowthDirectionUtils.applyGrowthDirectionToAxisDirection(axisDirection, growthDirection)) {
case AxisDirection.up:
switch (growthDirection) {
case GrowthDirection.forward:
offset = bounds.bottom;
break;
case GrowthDirection.reverse:
offset = bounds.top;
break;
}
leadingScrollOffset += pivot.size.height - offset;
targetMainAxisExtent = bounds.height;
break;
case AxisDirection.right:
float offset2 = 0.0f;
switch (growthDirection) {
case GrowthDirection.forward:
offset2 = bounds.left;
break;
case GrowthDirection.reverse:
offset2 = bounds.right;
break;
}
leadingScrollOffset += offset2;
targetMainAxisExtent = bounds.width;
break;
case AxisDirection.down:
float offset3 = 0.0f;
switch (growthDirection) {
case GrowthDirection.forward:
offset3 = bounds.top;
break;
case GrowthDirection.reverse:
offset3 = bounds.bottom;
break;
}
leadingScrollOffset += offset3;
targetMainAxisExtent = bounds.height;
break;
case AxisDirection.left:
switch (growthDirection) {
case GrowthDirection.forward:
offset = bounds.right;
break;
case GrowthDirection.reverse:
offset = bounds.left;
break;
}
leadingScrollOffset += pivot.size.width - offset;
targetMainAxisExtent = bounds.width;
break;
}
}
else if (onlySlivers) {
RenderSliver targetSliver = (RenderSliver) target;
targetMainAxisExtent = targetSliver.geometry.scrollExtent;
}
else {
return new RevealedOffset(offset: offset.pixels, rect: rect);
}
D.assert(child.parent == this);
D.assert(child is RenderSliver);
RenderSliver sliver = (RenderSliver) child;
float extentOfPinnedSlivers = maxScrollObstructionExtentBefore(sliver);
leadingScrollOffset = scrollOffsetOf(sliver, leadingScrollOffset);
switch (sliver.constraints.growthDirection) {
case GrowthDirection.forward:
leadingScrollOffset -= extentOfPinnedSlivers;
break;
case GrowthDirection.reverse:
break;
}
float mainAxisExtent = 0.0f;
switch (axis) {
case Axis.horizontal:
mainAxisExtent = size.width - extentOfPinnedSlivers;
break;
case Axis.vertical:
mainAxisExtent = size.height - extentOfPinnedSlivers;
break;
}
float targetOffset = leadingScrollOffset - (mainAxisExtent - targetMainAxisExtent) * alignment;
float offsetDifference = this.offset.pixels - targetOffset;
transform = target.getTransformTo(this);
applyPaintTransform(child, transform);
Rect targetRect = MatrixUtils.transformRect(transform, rect);
switch (axisDirection) {
case AxisDirection.down:
targetRect = targetRect.translate(0.0f, offsetDifference);
break;
case AxisDirection.right:
targetRect = targetRect.translate(offsetDifference, 0.0f);
break;
case AxisDirection.up:
targetRect = targetRect.translate(0.0f, -offsetDifference);
break;
case AxisDirection.left:
targetRect = targetRect.translate(-offsetDifference, 0.0f);
break;
}
return new RevealedOffset(offset: targetOffset, rect: targetRect);
}
protected Offset computeAbsolutePaintOffset(RenderSliver child, float layoutOffset,
GrowthDirection growthDirection) {
D.assert(hasSize);
D.assert(child != null);
D.assert(child.geometry != null);
switch (GrowthDirectionUtils.applyGrowthDirectionToAxisDirection(axisDirection, growthDirection)) {
case AxisDirection.up:
return new Offset(0.0f, size.height - (layoutOffset + child.geometry.paintExtent));
case AxisDirection.right:
return new Offset(layoutOffset, 0.0f);
case AxisDirection.down:
return new Offset(0.0f, layoutOffset);
case AxisDirection.left:
return new Offset(size.width - (layoutOffset + child.geometry.paintExtent), 0.0f);
}
return null;
}
public override void debugFillProperties(DiagnosticPropertiesBuilder properties) {
base.debugFillProperties(properties);
properties.add(new EnumProperty<AxisDirection>("axisDirection", axisDirection));
properties.add(new EnumProperty<AxisDirection>("crossAxisDirection", crossAxisDirection));
properties.add(new DiagnosticsProperty<ViewportOffset>("offset", offset));
}
public override List<DiagnosticsNode> debugDescribeChildren() {
var children = new List<DiagnosticsNode>();
RenderSliver child = firstChild;
if (child == null) {
return children;
}
int count = indexOfFirstChild;
while (true) {
children.Add(child.toDiagnosticsNode(name: labelForChild(count)));
if (child == lastChild) {
break;
}
count += 1;
child = childAfter(child);
}
return children;
}
protected abstract bool hasVisualOverflow { get; }
protected abstract void
updateOutOfBandData(GrowthDirection growthDirection, SliverGeometry childLayoutGeometry);
protected abstract void updateChildLayoutOffset(RenderSliver child, float layoutOffset,
GrowthDirection growthDirection);
protected abstract Offset paintOffsetOf(RenderSliver child);
protected abstract float scrollOffsetOf(RenderSliver child, float scrollOffsetWithinChild);
protected abstract float maxScrollObstructionExtentBefore(RenderSliver child);
protected abstract float computeChildMainAxisPosition(RenderSliver child, float parentMainAxisPosition);
protected abstract int indexOfFirstChild { get; }
protected abstract string labelForChild(int index);
protected abstract IEnumerable<RenderSliver> childrenInPaintOrder { get; }
protected abstract IEnumerable<RenderSliver> childrenInHitTestOrder { get; }
public override void showOnScreen(
RenderObject descendant,
Rect rect,
TimeSpan? duration = null,
Curve curve = null
) {
duration = duration ?? TimeSpan.Zero;
curve = curve ?? Curves.ease;
if (!offset.allowImplicitScrolling) {
base.showOnScreen(
descendant: descendant,
rect: rect,
duration: duration,
curve: curve
);
return;
}
Rect newRect = showInViewport(
descendant: descendant,
viewport: this,
offset: offset,
rect: rect,
duration: duration,
curve: curve
);
base.showOnScreen(
rect: newRect,
duration: duration,
curve: curve
);
}
public static Rect showInViewport(
RenderObject descendant = null,
Rect rect = null,
RenderAbstractViewport viewport = null,
ViewportOffset offset = null,
TimeSpan? duration = null,
Curve curve = null
) {
duration = duration ?? TimeSpan.Zero;
curve = curve ?? Curves.ease;
D.assert(viewport != null);
D.assert(offset != null);
if (descendant == null) {
return rect;
}
RevealedOffset leadingEdgeOffset = viewport.getOffsetToReveal(descendant, 0.0f, rect: rect);
RevealedOffset trailingEdgeOffset = viewport.getOffsetToReveal(descendant, 1.0f, rect: rect);
float currentOffset = offset.pixels;
RevealedOffset targetOffset = null;
if (leadingEdgeOffset.offset < trailingEdgeOffset.offset) {
float leadingEdgeDiff = (offset.pixels - leadingEdgeOffset.offset).abs();
float trailingEdgeDiff = (offset.pixels - trailingEdgeOffset.offset).abs();
targetOffset = leadingEdgeDiff < trailingEdgeDiff ? leadingEdgeOffset : trailingEdgeOffset;
}
else if (currentOffset > leadingEdgeOffset.offset) {
targetOffset = leadingEdgeOffset;
}
else if (currentOffset < trailingEdgeOffset.offset) {
targetOffset = trailingEdgeOffset;
}
else {
var transform = descendant.getTransformTo(viewport.parent);
return MatrixUtils.transformRect(transform, rect ?? descendant.paintBounds);
}
offset.moveTo(targetOffset.offset, duration: duration.Value, curve: curve);
return targetOffset.rect;
}
}
public class RenderViewport : RenderViewportBase<SliverPhysicalContainerParentData> {
public RenderViewport(
AxisDirection axisDirection = AxisDirection.down,
AxisDirection crossAxisDirection = AxisDirection.right,
ViewportOffset offset = null,
float anchor = 0.0f,
List<RenderSliver> children = null,
RenderSliver center = null,
float cacheExtent = RenderViewportUtils.defaultCacheExtent,
CacheExtentStyle cacheExtentStyle = CacheExtentStyle.pixel
) : base(axisDirection, crossAxisDirection, offset, cacheExtent,cacheExtentStyle) {
D.assert(anchor >= 0.0 && anchor <= 1.0);
D.assert(anchor != null);
D.assert(cacheExtentStyle != CacheExtentStyle.viewport || cacheExtent != null);
_anchor = anchor;
_center = center;
addAll(children);
if (center == null && firstChild != null) {
_center = firstChild;
}
}
public override void setupParentData(RenderObject child) {
if (!(child.parentData is SliverPhysicalContainerParentData)) {
child.parentData = new SliverPhysicalContainerParentData();
}
}
public float anchor {
get { return _anchor; }
set {
D.assert(value >= 0.0 && value <= 1.0);
if (value == _anchor) {
return;
}
_anchor = value;
markNeedsLayout();
}
}
public float _anchor;
public RenderSliver center {
get { return _center; }
set {
if (value == _center) {
return;
}
_center = value;
markNeedsLayout();
}
}
public RenderSliver _center;
protected override bool sizedByParent {
get { return true; }
}
protected override void performResize() {
D.assert(() => {
if (!constraints.hasBoundedHeight || !constraints.hasBoundedWidth) {
switch (axis) {
case Axis.vertical:
if (!constraints.hasBoundedHeight) {
throw new UIWidgetsError(new List<DiagnosticsNode> {
new ErrorSummary("Vertical viewport was given unbounded height."),
new ErrorDescription(
"Vertical viewport was given unbounded height.\n" +
"Viewports expand in the scrolling direction to fill their container." +
"In this case, a vertical viewport was given an unlimited amount of " +
"vertical space in which to expand. This situation typically happens " +
"when a scrollable widget is nested inside another scrollable widget.\n"
),
new ErrorHint("If this widget is always nested in a scrollable widget there " +
"is no need to use a viewport because there will always be enough " +
"vertical space for the children. In this case, consider using a " +
"Column instead. Otherwise, consider using the \"shrinkWrap\" property " +
"(or a ShrinkWrappingViewport) to size the height of the viewport " +
"to the sum of the heights of its children."
)
});
}
if (!constraints.hasBoundedWidth) {
throw new UIWidgetsError(
"Vertical viewport was given unbounded width.\n" +
"Viewports expand in the cross axis to fill their container and " +
"constrain their children to match their extent in the cross axis. " +
"In this case, a vertical viewport was given an unlimited amount of " +
"horizontal space in which to expand."
);
}
break;
case Axis.horizontal:
if (!constraints.hasBoundedWidth) {
throw new UIWidgetsError(new List<DiagnosticsNode>{
new ErrorSummary("Horizontal viewport was given unbounded width."),
new ErrorDescription(
"Viewports expand in the scrolling direction to fill their container. " +
"In this case, a horizontal viewport was given an unlimited amount of " +
"horizontal space in which to expand. This situation typically happens " +
"when a scrollable widget is nested inside another scrollable widget."
),
new ErrorHint(
"If this widget is always nested in a scrollable widget there " +
"is no need to use a viewport because there will always be enough " +
"horizontal space for the children. In this case, consider using a " +
"Row instead. Otherwise, consider using the \"shrinkWrap\" property " +
"(or a ShrinkWrappingViewport) to size the width of the viewport " +
"to the sum of the widths of its children."
)
});
}
if (!constraints.hasBoundedHeight) {
throw new UIWidgetsError(
"Horizontal viewport was given unbounded height.\n" +
"Viewports expand in the cross axis to fill their container and " +
"constrain their children to match their extent in the cross axis. " +
"In this case, a horizontal viewport was given an unlimited amount of " +
"vertical space in which to expand."
);
}
break;
}
}
return true;
});
size = constraints.biggest;
switch (axis) {
case Axis.vertical:
offset.applyViewportDimension(size.height);
break;
case Axis.horizontal:
offset.applyViewportDimension(size.width);
break;
}
}
const int _maxLayoutCycles = 10;
float _minScrollExtent;
float _maxScrollExtent;
bool _hasVisualOverflow = false;
protected override void performLayout() {
if (center == null) {
D.assert(firstChild == null);
_minScrollExtent = 0.0f;
_maxScrollExtent = 0.0f;
_hasVisualOverflow = false;
offset.applyContentDimensions(0.0f, 0.0f);
return;
}
D.assert(center.parent == this);
float mainAxisExtent = 0.0f;
float crossAxisExtent = 0.0f;
switch (axis) {
case Axis.vertical:
mainAxisExtent = size.height;
crossAxisExtent = size.width;
break;
case Axis.horizontal:
mainAxisExtent = size.width;
crossAxisExtent = size.height;
break;
}
float centerOffsetAdjustment = center.centerOffsetAdjustment;
int count = 0;
do {
var correction = _attemptLayout(mainAxisExtent, crossAxisExtent,
offset.pixels + centerOffsetAdjustment);
if (correction != 0.0) {
offset.correctBy(correction);
}
else {
if (offset.applyContentDimensions(
Mathf.Min(0.0f, _minScrollExtent + mainAxisExtent * anchor),
Mathf.Max(0.0f, _maxScrollExtent - mainAxisExtent * (1.0f - anchor))
)) {
break;
}
}
count += 1;
} while (count < _maxLayoutCycles);
D.assert(() => {
if (count >= _maxLayoutCycles) {
D.assert(count != 1);
throw new UIWidgetsError(
"A RenderViewport exceeded its maximum number of layout cycles.\n" +
"RenderViewport render objects, during layout, can retry if either their " +
"slivers or their ViewportOffset decide that the offset should be corrected " +
"to take into account information collected during that layout.\n" +
$"In the case of this RenderViewport object, however, this happened {count} " +
"times and still there was no consensus on the scroll offset. This usually " +
"indicates a bug. Specifically, it means that one of the following three " +
"problems is being experienced by the RenderViewport object:\n" +
" * One of the RenderSliver children or the ViewportOffset have a bug such" +
" that they always think that they need to correct the offset regardless.\n" +
" * Some combination of the RenderSliver children and the ViewportOffset" +
" have a bad interaction such that one applies a correction then another" +
" applies a reverse correction, leading to an infinite loop of corrections.\n" +
" * There is a pathological case that would eventually resolve, but it is" +
" so complicated that it cannot be resolved in any reasonable number of" +
" layout passes."
);
}
return true;
});
}
float _attemptLayout(float mainAxisExtent, float crossAxisExtent, float correctedOffset) {
D.assert(!mainAxisExtent.isNaN());
D.assert(mainAxisExtent >= 0.0);
D.assert(crossAxisExtent.isFinite());
D.assert(crossAxisExtent >= 0.0);
D.assert(correctedOffset.isFinite());
_minScrollExtent = 0.0f;
_maxScrollExtent = 0.0f;
_hasVisualOverflow = false;
float centerOffset = mainAxisExtent * anchor - correctedOffset;
float reverseDirectionRemainingPaintExtent = centerOffset.clamp(0.0f, mainAxisExtent);
float forwardDirectionRemainingPaintExtent = (mainAxisExtent - centerOffset).clamp(0.0f, mainAxisExtent);
switch (cacheExtentStyle) {
case CacheExtentStyle.pixel:
_calculatedCacheExtent = cacheExtent;
break;
case CacheExtentStyle.viewport:
_calculatedCacheExtent = mainAxisExtent * cacheExtent;
break;
}
float fullCacheExtent = mainAxisExtent + 2 * _calculatedCacheExtent;
float centerCacheOffset = centerOffset + _calculatedCacheExtent;
float reverseDirectionRemainingCacheExtent = centerCacheOffset.clamp(0.0f, fullCacheExtent);
float forwardDirectionRemainingCacheExtent =
(fullCacheExtent - centerCacheOffset).clamp(0.0f, fullCacheExtent);
RenderSliver leadingNegativeChild = childBefore(center);
if (leadingNegativeChild != null) {
float result = layoutChildSequence(
child: leadingNegativeChild,
scrollOffset: Mathf.Max(mainAxisExtent, centerOffset) - mainAxisExtent,
overlap: 0.0f,
layoutOffset: forwardDirectionRemainingPaintExtent,
remainingPaintExtent: reverseDirectionRemainingPaintExtent,
mainAxisExtent: mainAxisExtent,
crossAxisExtent: crossAxisExtent,
growthDirection: GrowthDirection.reverse,
advance: childBefore,
remainingCacheExtent: reverseDirectionRemainingCacheExtent,
cacheOrigin: (mainAxisExtent - centerOffset).clamp(-_calculatedCacheExtent, 0.0f)
);
if (result != 0.0f) {
return -result;
}
}
return layoutChildSequence(
child: center,
scrollOffset: Mathf.Max(0.0f, -centerOffset),
overlap: leadingNegativeChild == null ? Mathf.Min(0.0f, -centerOffset) : 0.0f,
layoutOffset: centerOffset >= mainAxisExtent
? centerOffset
: reverseDirectionRemainingPaintExtent,
remainingPaintExtent: forwardDirectionRemainingPaintExtent,
mainAxisExtent: mainAxisExtent,
crossAxisExtent: crossAxisExtent,
growthDirection: GrowthDirection.forward,
advance: childAfter,
remainingCacheExtent: forwardDirectionRemainingCacheExtent,
cacheOrigin: centerOffset.clamp(-_calculatedCacheExtent, 0.0f)
);
}
protected override bool hasVisualOverflow {
get { return _hasVisualOverflow; }
}
protected override void
updateOutOfBandData(GrowthDirection growthDirection, SliverGeometry childLayoutGeometry) {
switch (growthDirection) {
case GrowthDirection.forward:
_maxScrollExtent += childLayoutGeometry.scrollExtent;
break;
case GrowthDirection.reverse:
_minScrollExtent -= childLayoutGeometry.scrollExtent;
break;
}
if (childLayoutGeometry.hasVisualOverflow) {
_hasVisualOverflow = true;
}
}
protected override void updateChildLayoutOffset(RenderSliver child, float layoutOffset,
GrowthDirection growthDirection) {
var childParentData = (SliverPhysicalParentData) child.parentData;
childParentData.paintOffset = computeAbsolutePaintOffset(child, layoutOffset, growthDirection);
}
protected override Offset paintOffsetOf(RenderSliver child) {
var childParentData = (SliverPhysicalParentData) child.parentData;
return childParentData.paintOffset;
}
protected override float scrollOffsetOf(RenderSliver child, float scrollOffsetWithinChild) {
D.assert(child.parent == this);
GrowthDirection growthDirection = child.constraints.growthDirection;
switch (growthDirection) {
case GrowthDirection.forward: {
float scrollOffsetToChild = 0.0f;
RenderSliver current = center;
while (current != child) {
scrollOffsetToChild += current.geometry.scrollExtent;
current = childAfter(current);
}
return scrollOffsetToChild + scrollOffsetWithinChild;
}
case GrowthDirection.reverse: {
float scrollOffsetToChild = 0.0f;
RenderSliver current = childBefore(center);
while (current != child) {
scrollOffsetToChild -= current.geometry.scrollExtent;
current = childBefore(current);
}
return scrollOffsetToChild - scrollOffsetWithinChild;
}
}
D.assert(false);
return 0.0f;
}
protected override float maxScrollObstructionExtentBefore(RenderSliver child) {
D.assert(child.parent == this);
GrowthDirection growthDirection = child.constraints.growthDirection;
switch (growthDirection) {
case GrowthDirection.forward: {
float pinnedExtent = 0.0f;
RenderSliver current = center;
while (current != child) {
pinnedExtent += current.geometry.maxScrollObstructionExtent;
current = childAfter(current);
}
return pinnedExtent;
}
case GrowthDirection.reverse: {
float pinnedExtent = 0.0f;
RenderSliver current = childBefore(center);
while (current != child) {
pinnedExtent += current.geometry.maxScrollObstructionExtent;
current = childBefore(current);
}
return pinnedExtent;
}
}
D.assert(false);
return 0.0f;
}
public override void applyPaintTransform(RenderObject child, Matrix4 transform) {
D.assert(child != null);
var childParentData = (SliverPhysicalParentData) child.parentData;
childParentData.applyPaintTransform(transform);
}
protected override float computeChildMainAxisPosition(RenderSliver child, float parentMainAxisPosition) {
D.assert(child != null);
D.assert(child.constraints != null);
SliverPhysicalParentData childParentData = (SliverPhysicalParentData) child.parentData;
switch (GrowthDirectionUtils.applyGrowthDirectionToAxisDirection(child.constraints.axisDirection,
child.constraints.growthDirection)) {
case AxisDirection.down:
return parentMainAxisPosition - childParentData.paintOffset.dy;
case AxisDirection.right:
return parentMainAxisPosition - childParentData.paintOffset.dx;
case AxisDirection.up:
return child.geometry.paintExtent - (parentMainAxisPosition - childParentData.paintOffset.dy);
case AxisDirection.left:
return child.geometry.paintExtent - (parentMainAxisPosition - childParentData.paintOffset.dx);
}
D.assert(false);
return 0.0f;
}
protected override int indexOfFirstChild {
get {
D.assert(center != null);
D.assert(center.parent == this);
D.assert(firstChild != null);
int count = 0;
RenderSliver child = center;
while (child != firstChild) {
count -= 1;
child = childBefore(child);
}
return count;
}
}
protected override string labelForChild(int index) {
if (index == 0) {
return "center child";
}
return "child " + index;
}
protected override IEnumerable<RenderSliver> childrenInPaintOrder {
get {
if (firstChild == null) {
yield break;
}
var child = firstChild;
while (child != center) {
yield return child;
child = childAfter(child);
}
child = lastChild;
while (true) {
yield return child;
if (child == center) {
yield break;
}
child = childBefore(child);
}
}
}
protected override IEnumerable<RenderSliver> childrenInHitTestOrder {
get {
if (firstChild == null) {
yield break;
}
RenderSliver child = center;
while (child != null) {
yield return child;
child = childAfter(child);
}
child = childBefore(center);
while (child != null) {
yield return child;
child = childBefore(child);
}
}
}
public override void debugFillProperties(DiagnosticPropertiesBuilder properties) {
base.debugFillProperties(properties);
properties.add(new FloatProperty("anchor", anchor));
}
}
public class RenderShrinkWrappingViewport : RenderViewportBase<SliverLogicalContainerParentData> {
public RenderShrinkWrappingViewport(
AxisDirection axisDirection = AxisDirection.down,
AxisDirection crossAxisDirection = AxisDirection.right,
ViewportOffset offset = null,
List<RenderSliver> children = null
) : base(
axisDirection: axisDirection,
crossAxisDirection: crossAxisDirection,
offset: offset) {
addAll(children);
}
public override void setupParentData(RenderObject child) {
if (!(child.parentData is SliverLogicalContainerParentData)) {
child.parentData = new SliverLogicalContainerParentData();
}
}
protected override bool debugThrowIfNotCheckingIntrinsics() {
D.assert(() => {
if (!debugCheckingIntrinsics) {
throw new UIWidgetsError(new List<DiagnosticsNode>{
new ErrorSummary($"{GetType()} does not support returning intrinsic dimensions."),
new ErrorDescription(
"Calculating the intrinsic dimensions would require instantiating every child of " +
"the viewport, which defeats the point of viewports being lazy."
),
new ErrorHint(
"If you are merely trying to shrink-wrap the viewport in the main axis direction, " +
"you should be able to achieve that effect by just giving the viewport loose " +
"constraints, without needing to measure its intrinsic dimensions."
)
});
}
return true;
});
return true;
}
float _maxScrollExtent = 0.0f;
float _shrinkWrapExtent = 0.0f;
bool _hasVisualOverflow = false;
protected override void performLayout() {
BoxConstraints constraints = this.constraints;
if (firstChild == null) {
switch (axis) {
case Axis.vertical:
D.assert(constraints.hasBoundedWidth);
size = new Size(constraints.maxWidth, constraints.minHeight);
break;
case Axis.horizontal:
D.assert(constraints.hasBoundedHeight);
size = new Size(constraints.minWidth, constraints.maxHeight);
break;
}
offset.applyViewportDimension(0.0f);
_maxScrollExtent = 0.0f;
_shrinkWrapExtent = 0.0f;
_hasVisualOverflow = false;
offset.applyContentDimensions(0.0f, 0.0f);
return;
}
float mainAxisExtent = 0.0f;
float crossAxisExtent = 0.0f;
switch (axis) {
case Axis.vertical:
D.assert(constraints.hasBoundedWidth);
mainAxisExtent = constraints.maxHeight;
crossAxisExtent = constraints.maxWidth;
break;
case Axis.horizontal:
D.assert(constraints.hasBoundedHeight);
mainAxisExtent = constraints.maxWidth;
crossAxisExtent = constraints.maxHeight;
break;
}
float effectiveExtent = 0.0f;
do {
var correction = _attemptLayout(mainAxisExtent, crossAxisExtent, offset.pixels);
if (correction != 0.0) {
offset.correctBy(correction);
}
else {
switch (axis) {
case Axis.vertical:
effectiveExtent = constraints.constrainHeight(_shrinkWrapExtent);
break;
case Axis.horizontal:
effectiveExtent = constraints.constrainWidth(_shrinkWrapExtent);
break;
}
bool didAcceptViewportDimension = offset.applyViewportDimension(effectiveExtent);
bool didAcceptContentDimension =
offset.applyContentDimensions(0.0f,
Mathf.Max(0.0f, _maxScrollExtent - effectiveExtent));
if (didAcceptViewportDimension && didAcceptContentDimension) {
break;
}
}
} while (true);
switch (axis) {
case Axis.vertical:
size = constraints.constrainDimensions(crossAxisExtent, effectiveExtent);
break;
case Axis.horizontal:
size = constraints.constrainDimensions(effectiveExtent, crossAxisExtent);
break;
}
}
float _attemptLayout(float mainAxisExtent, float crossAxisExtent, float correctedOffset) {
D.assert(!mainAxisExtent.isNaN());
D.assert(mainAxisExtent >= 0.0);
D.assert(crossAxisExtent.isFinite());
D.assert(crossAxisExtent >= 0.0);
D.assert(correctedOffset.isFinite());
_maxScrollExtent = 0.0f;
_shrinkWrapExtent = 0.0f;
_hasVisualOverflow = false;
return layoutChildSequence(
child: firstChild,
scrollOffset: Mathf.Max(0.0f, correctedOffset),
overlap: Mathf.Min(0.0f, correctedOffset),
layoutOffset: 0.0f,
remainingPaintExtent: mainAxisExtent,
mainAxisExtent: mainAxisExtent,
crossAxisExtent: crossAxisExtent,
growthDirection: GrowthDirection.forward,
advance: childAfter,
remainingCacheExtent: mainAxisExtent + 2 * cacheExtent,
cacheOrigin: -cacheExtent
);
}
protected override bool hasVisualOverflow {
get { return _hasVisualOverflow; }
}
protected override void
updateOutOfBandData(GrowthDirection growthDirection, SliverGeometry childLayoutGeometry) {
D.assert(growthDirection == GrowthDirection.forward);
_maxScrollExtent += childLayoutGeometry.scrollExtent;
if (childLayoutGeometry.hasVisualOverflow) {
_hasVisualOverflow = true;
}
_shrinkWrapExtent += childLayoutGeometry.maxPaintExtent;
}
protected override void updateChildLayoutOffset(RenderSliver child, float layoutOffset,
GrowthDirection growthDirection) {
D.assert(growthDirection == GrowthDirection.forward);
var childParentData = (SliverLogicalParentData) child.parentData;
childParentData.layoutOffset = layoutOffset;
}
protected override Offset paintOffsetOf(RenderSliver child) {
var childParentData = (SliverLogicalParentData) child.parentData;
return computeAbsolutePaintOffset(child, childParentData.layoutOffset ?? 0.0f, GrowthDirection.forward);
}
protected override float scrollOffsetOf(RenderSliver child, float scrollOffsetWithinChild) {
D.assert(child.parent == this);
D.assert(child.constraints.growthDirection == GrowthDirection.forward);
float scrollOffsetToChild = 0.0f;
RenderSliver current = firstChild;
while (current != child) {
scrollOffsetToChild += current.geometry.scrollExtent;
current = childAfter(current);
}
return scrollOffsetToChild + scrollOffsetWithinChild;
}
protected override float maxScrollObstructionExtentBefore(RenderSliver child) {
D.assert(child.parent == this);
D.assert(child.constraints.growthDirection == GrowthDirection.forward);
float pinnedExtent = 0.0f;
RenderSliver current = firstChild;
while (current != child) {
pinnedExtent += current.geometry.maxScrollObstructionExtent;
current = childAfter(current);
}
return pinnedExtent;
}
public override void applyPaintTransform(RenderObject child, Matrix4 transform) {
D.assert(child != null);
Offset offset = paintOffsetOf((RenderSliver) child);
transform.translate(offset.dx, offset.dy);
}
protected override float computeChildMainAxisPosition(RenderSliver child, float parentMainAxisPosition) {
D.assert(child != null);
D.assert(child.constraints != null);
D.assert(hasSize);
SliverLogicalParentData childParentData = (SliverLogicalParentData) child.parentData;
switch (GrowthDirectionUtils.applyGrowthDirectionToAxisDirection(
child.constraints.axisDirection, child.constraints.growthDirection)) {
case AxisDirection.down:
case AxisDirection.right:
return parentMainAxisPosition - childParentData.layoutOffset ?? 0.0f;
case AxisDirection.up:
return (size.height - parentMainAxisPosition) - childParentData.layoutOffset ?? 0.0f;
case AxisDirection.left:
return (size.width - parentMainAxisPosition) - childParentData.layoutOffset ?? 0.0f;
}
D.assert(false);
return 0.0f;
}
protected override int indexOfFirstChild {
get { return 0; }
}
protected override string labelForChild(int index) {
return "child " + index;
}
protected override IEnumerable<RenderSliver> childrenInPaintOrder {
get {
RenderSliver child = firstChild;
while (child != null) {
yield return child;
child = childAfter(child);
}
}
}
protected override IEnumerable<RenderSliver> childrenInHitTestOrder {
get {
RenderSliver child = lastChild;
while (child != null) {
yield return child;
child = childBefore(child);
}
}
}
}
}