js-draw 0.0.10 → 0.1.2

package/dist/src/rendering/caching/RenderingCache.js

@@ -0,0 +1,42 @@
+import Rect2 from '../../geometry/Rect2';
+import RenderingCacheNode from './RenderingCacheNode';
+import { CacheRecordManager } from './CacheRecordManager';
+export default class RenderingCache {
+    constructor(cacheProps) {
+        this.partialSharedState = {
+            props: cacheProps,
+            currentRenderingCycle: 0,
+        };
+        this.recordManager = new CacheRecordManager(this.partialSharedState);
+    }
+    getSharedState() {
+        return Object.assign(Object.assign({}, this.partialSharedState), { recordManager: this.recordManager });
+    }
+    render(screenRenderer, image, viewport) {
+        var _a;
+        const visibleRect = viewport.visibleRect;
+        this.partialSharedState.currentRenderingCycle++;
+        // If we can't use the cache,
+        if (!this.partialSharedState.props.isOfCorrectType(screenRenderer)) {
+            image.render(screenRenderer, visibleRect);
+            return;
+        }
+        if (!this.rootNode) {
+            // Adjust the node so that it has the correct aspect ratio
+            const res = this.partialSharedState.props.blockResolution;
+            const topLeft = visibleRect.topLeft;
+            this.rootNode = new RenderingCacheNode(new Rect2(topLeft.x, topLeft.y, res.x, res.y), this.getSharedState());
+        }
+        while (!this.rootNode.region.containsRect(visibleRect)) {
+            this.rootNode = this.rootNode.generateParent();
+        }
+        this.rootNode = (_a = this.rootNode.smallestChildContaining(visibleRect)) !== null && _a !== void 0 ? _a : this.rootNode;
+        const visibleLeaves = image.getLeavesIntersectingRegion(viewport.visibleRect, rect => screenRenderer.isTooSmallToRender(rect));
+        if (visibleLeaves.length > this.partialSharedState.props.minComponentsToUseCache) {
+            this.rootNode.renderItems(screenRenderer, [image], viewport);
+        }
+        else {
+            image.render(screenRenderer, visibleRect);
+        }
+    }
+}

package/dist/src/rendering/caching/RenderingCacheNode.d.ts

@@ -0,0 +1,28 @@
+import { ImageNode } from '../../EditorImage';
+import Rect2 from '../../geometry/Rect2';
+import Viewport from '../../Viewport';
+import AbstractRenderer from '../renderers/AbstractRenderer';
+import { CacheState } from './types';
+export default class RenderingCacheNode {
+    readonly region: Rect2;
+    private readonly cacheState;
+    private instantiatedChildren;
+    private parent;
+    private cachedRenderer;
+    private renderedIds;
+    private renderedMaxZIndex;
+    constructor(region: Rect2, cacheState: CacheState);
+    generateParent(): RenderingCacheNode;
+    private generateChildren;
+    private getChildren;
+    smallestChildContaining(rect: Rect2): RenderingCacheNode | null;
+    private renderingWouldBeHighEnoughResolution;
+    private allChildrenCanRender;
+    private computeSortedByLeafIds;
+    private idsOfIntersecting;
+    private renderingIsUpToDate;
+    renderItems(screenRenderer: AbstractRenderer, items: ImageNode[], viewport: Viewport): void;
+    private isEmpty;
+    private onRegionDealloc;
+    private checkRep;
+}

package/dist/src/rendering/caching/RenderingCacheNode.js

@@ -0,0 +1,301 @@
+// A cache record with sub-nodes.
+import Color4 from '../../Color4';
+import { sortLeavesByZIndex } from '../../EditorImage';
+import Rect2 from '../../geometry/Rect2';
+// 3x3 divisions for each node.
+const cacheDivisionSize = 3;
+// True: Show rendering updates.
+const debugMode = false;
+export default class RenderingCacheNode {
+    constructor(region, cacheState) {
+        this.region = region;
+        this.cacheState = cacheState;
+        // invariant: instantiatedChildren.length === 9
+        this.instantiatedChildren = [];
+        this.parent = null;
+        this.cachedRenderer = null;
+        // invariant: sortedInAscendingOrder(renderedIds)
+        this.renderedIds = [];
+        this.renderedMaxZIndex = null;
+    }
+    // Creates a previous layer of the cache tree and adds this as a child near the
+    // center of the previous layer's children.
+    // Returns this' parent if it already exists.
+    generateParent() {
+        if (this.parent) {
+            return this.parent;
+        }
+        const parentRegion = Rect2.fromCorners(this.region.topLeft.minus(this.region.size), this.region.bottomRight.plus(this.region.size));
+        const parent = new RenderingCacheNode(parentRegion, this.cacheState);
+        parent.generateChildren();
+        // Ensure the new node is matches the middle child's region.
+        const checkTolerance = this.region.maxDimension / 100;
+        const middleChildIdx = (parent.instantiatedChildren.length - 1) / 2;
+        if (!parent.instantiatedChildren[middleChildIdx].region.eq(this.region, checkTolerance)) {
+            console.error(parent.instantiatedChildren[middleChildIdx].region, '≠', this.region);
+            throw new Error('Logic error: [this] is not contained within its parent\'s center child');
+        }
+        // Replace the middle child
+        parent.instantiatedChildren[middleChildIdx] = this;
+        this.parent = parent;
+        return parent;
+    }
+    // Generates children, if missing.
+    generateChildren() {
+        if (this.instantiatedChildren.length === 0) {
+            const childRects = this.region.divideIntoGrid(cacheDivisionSize, cacheDivisionSize);
+            for (const rect of childRects) {
+                const child = new RenderingCacheNode(rect, this.cacheState);
+                child.parent = this;
+                this.instantiatedChildren.push(child);
+            }
+        }
+        this.checkRep();
+    }
+    // Returns CacheNodes directly contained within this.
+    getChildren() {
+        this.checkRep();
+        this.generateChildren();
+        return this.instantiatedChildren;
+    }
+    smallestChildContaining(rect) {
+        var _a;
+        const largerThanChildren = rect.maxDimension > this.region.maxDimension / cacheDivisionSize;
+        if (!this.region.containsRect(rect) || largerThanChildren) {
+            return null;
+        }
+        for (const child of this.getChildren()) {
+            if (child.region.containsRect(rect)) {
+                return (_a = child.smallestChildContaining(rect)) !== null && _a !== void 0 ? _a : child;
+            }
+        }
+        return null;
+    }
+    // => [true] iff [this] can be rendered without too much scaling
+    renderingWouldBeHighEnoughResolution(viewport) {
+        // Determine how 1px in this corresponds to 1px on the canvas.
+        //  this.region.w is in canvas units. Thus,
+        const sizeOfThisPixelOnCanvas = this.region.w / this.cacheState.props.blockResolution.x;
+        const sizeOfThisPixelOnScreen = viewport.getScaleFactor() * sizeOfThisPixelOnCanvas;
+        if (sizeOfThisPixelOnScreen > this.cacheState.props.maxScale) {
+            return false;
+        }
+        return true;
+    }
+    // => [true] if all children of this can be rendered from their caches.
+    allChildrenCanRender(viewport, leavesSortedById) {
+        if (this.instantiatedChildren.length === 0) {
+            return false;
+        }
+        for (const child of this.instantiatedChildren) {
+            if (!child.region.intersects(viewport.visibleRect)) {
+                continue;
+            }
+            if (!child.renderingIsUpToDate(this.idsOfIntersecting(leavesSortedById))) {
+                return false;
+            }
+        }
+        return true;
+    }
+    computeSortedByLeafIds(leaves) {
+        const ids = leaves.slice();
+        ids.sort((a, b) => a.getId() - b.getId());
+        return ids;
+    }
+    // Returns a list of the ids of the nodes intersecting this
+    idsOfIntersecting(nodes) {
+        const result = [];
+        for (const node of nodes) {
+            if (node.getBBox().intersects(this.region)) {
+                result.push(node.getId());
+            }
+        }
+        return result;
+    }
+    renderingIsUpToDate(sortedIds) {
+        if (this.cachedRenderer === null || sortedIds.length !== this.renderedIds.length) {
+            return false;
+        }
+        for (let i = 0; i < sortedIds.length; i++) {
+            if (sortedIds[i] !== this.renderedIds[i]) {
+                return false;
+            }
+        }
+        return true;
+    }
+    // Render all [items] within [viewport]
+    renderItems(screenRenderer, items, viewport) {
+        var _a, _b;
+        if (!viewport.visibleRect.intersects(this.region)
+            || items.length === 0) {
+            return;
+        }
+        const newItems = [];
+        // Divide [items] until nodes are leaves or smaller than this
+        for (const item of items) {
+            const bbox = item.getBBox();
+            if (!bbox.intersects(this.region)) {
+                continue;
+            }
+            if (bbox.maxDimension >= this.region.maxDimension) {
+                newItems.push(...item.getChildrenOrSelfIntersectingRegion(this.region));
+            }
+            else {
+                newItems.push(item);
+            }
+        }
+        items = newItems;
+        // Can we cache at all?
+        if (!this.cacheState.props.isOfCorrectType(screenRenderer)) {
+            items.forEach(item => item.render(screenRenderer, viewport.visibleRect));
+            return;
+        }
+        if (debugMode) {
+            screenRenderer.drawRect(this.region, 0.5 * viewport.getSizeOfPixelOnCanvas(), { fill: Color4.yellow });
+        }
+        // Could we render direclty from [this] or do we need to recurse?
+        const couldRender = this.renderingWouldBeHighEnoughResolution(viewport);
+        if (!couldRender) {
+            for (const child of this.getChildren()) {
+                child.renderItems(screenRenderer, items.filter(item => {
+                    return item.getBBox().intersects(child.region);
+                }), viewport);
+            }
+        }
+        else {
+            // Determine whether we already have rendered the items
+            const leaves = [];
+            for (const item of items) {
+                leaves.push(...item.getLeavesIntersectingRegion(this.region, rect => rect.w / this.region.w < 2 / this.cacheState.props.blockResolution.x));
+            }
+            sortLeavesByZIndex(leaves);
+            const leavesByIds = this.computeSortedByLeafIds(leaves);
+            // No intersecting leaves? No need to render
+            if (leavesByIds.length === 0) {
+                return;
+            }
+            const leafIds = leavesByIds.map(leaf => leaf.getId());
+            let thisRenderer;
+            if (!this.renderingIsUpToDate(leafIds)) {
+                if (this.allChildrenCanRender(viewport, leavesByIds)) {
+                    for (const child of this.getChildren()) {
+                        child.renderItems(screenRenderer, items, viewport);
+                    }
+                    return;
+                }
+                // Is it worth it to render the items?
+                // TODO: Replace this with something performace based.
+                // TODO: Determine whether it is 'worth it' to cache this depending on rendering time.
+                if (leavesByIds.length > this.cacheState.props.minComponentsPerCache) {
+                    let fullRerenderNeeded = true;
+                    if (!this.cachedRenderer) {
+                        this.cachedRenderer = this.cacheState.recordManager.allocCanvas(this.region, () => this.onRegionDealloc());
+                    }
+                    else if (leavesByIds.length > this.renderedIds.length && this.renderedMaxZIndex !== null) {
+                        // We often don't need to do a full re-render even if something's changed.
+                        // Check whether we can just draw on top of the existing cache.
+                        const newLeaves = [];
+                        let minNewZIndex = null;
+                        for (let i = 0; i < leavesByIds.length; i++) {
+                            const leaf = leavesByIds[i];
+                            const content = leaf.getContent();
+                            const zIndex = content.getZIndex();
+                            if (i >= this.renderedIds.length || leaf.getId() !== this.renderedIds[i]) {
+                                newLeaves.push(leaf);
+                                if (minNewZIndex === null || zIndex < minNewZIndex) {
+                                    minNewZIndex = zIndex;
+                                }
+                            }
+                        }
+                        if (minNewZIndex !== null && minNewZIndex > this.renderedMaxZIndex) {
+                            fullRerenderNeeded = false;
+                            thisRenderer = this.cachedRenderer.startRender();
+                            // Looping is faster than re-sorting.
+                            for (let i = 0; i < leaves.length; i++) {
+                                const leaf = leaves[i];
+                                const zIndex = leaf.getContent().getZIndex();
+                                if (zIndex > this.renderedMaxZIndex) {
+                                    leaf.render(thisRenderer, this.region);
+                                    this.renderedMaxZIndex = zIndex;
+                                }
+                            }
+                            if (debugMode) {
+                                screenRenderer.drawRect(this.region, viewport.getSizeOfPixelOnCanvas(), { fill: Color4.clay });
+                            }
+                        }
+                    }
+                    if (fullRerenderNeeded) {
+                        thisRenderer = this.cachedRenderer.startRender();
+                        thisRenderer.clear();
+                        this.renderedMaxZIndex = null;
+                        for (const leaf of leaves) {
+                            const content = leaf.getContent();
+                            (_a = this.renderedMaxZIndex) !== null && _a !== void 0 ? _a : (this.renderedMaxZIndex = content.getZIndex());
+                            this.renderedMaxZIndex = Math.max(this.renderedMaxZIndex, content.getZIndex());
+                            leaf.render(thisRenderer, this.region);
+                        }
+                        if (debugMode) {
+                            screenRenderer.drawRect(this.region, viewport.getSizeOfPixelOnCanvas(), { fill: Color4.red });
+                        }
+                    }
+                    this.renderedIds = leafIds;
+                }
+                else {
+                    (_b = this.cachedRenderer) === null || _b === void 0 ? void 0 : _b.dealloc();
+                    // Slightly increase the clip region to prevent seams.
+                    // Divide by two because grownBy expands the rectangle on all sides.
+                    const pixelSize = viewport.getSizeOfPixelOnCanvas();
+                    const expandedRegion = new Rect2(this.region.x, this.region.y, this.region.w + pixelSize, this.region.h + pixelSize);
+                    const clip = true;
+                    screenRenderer.startObject(expandedRegion, clip);
+                    for (const leaf of leaves) {
+                        leaf.render(screenRenderer, this.region.intersection(viewport.visibleRect));
+                    }
+                    screenRenderer.endObject();
+                }
+            }
+            else {
+                thisRenderer = this.cachedRenderer.startRender();
+            }
+            if (thisRenderer) {
+                const transformMat = this.cachedRenderer.getTransform(this.region).inverse();
+                screenRenderer.renderFromOtherOfSameType(transformMat, thisRenderer);
+            }
+            // Can we clean up this' children? (Are they unused?)
+            if (this.instantiatedChildren.every(child => child.isEmpty())) {
+                this.instantiatedChildren = [];
+            }
+        }
+        this.checkRep();
+    }
+    // Returns true iff this/its children have no cached state.
+    isEmpty() {
+        if (this.cachedRenderer !== null) {
+            return false;
+        }
+        return this.instantiatedChildren.every(child => child.isEmpty());
+    }
+    onRegionDealloc() {
+        this.cachedRenderer = null;
+        if (this.isEmpty()) {
+            this.instantiatedChildren = [];
+        }
+    }
+    checkRep() {
+        if (this.instantiatedChildren.length !== cacheDivisionSize * cacheDivisionSize && this.instantiatedChildren.length !== 0) {
+            throw new Error('Repcheck: Wrong number of children');
+        }
+        if (this.renderedIds[1] !== undefined && this.renderedIds[0] >= this.renderedIds[1]) {
+            console.error(this.renderedIds);
+            throw new Error('Repcheck: First two ids are not in ascending order!');
+        }
+        for (const child of this.instantiatedChildren) {
+            if (child.parent !== this) {
+                throw new Error('Children should be linked to their parents!');
+            }
+        }
+        if (this.cachedRenderer && !this.cachedRenderer.isAllocd()) {
+            throw new Error('this\' cachedRenderer != null, but is dealloc\'d');
+        }
+    }
+}

package/dist/src/rendering/caching/testUtils.d.ts

@@ -0,0 +1,9 @@
+import DummyRenderer from '../renderers/DummyRenderer';
+import RenderingCache from './RenderingCache';
+import { CacheProps } from './types';
+declare type RenderAllocCallback = (renderer: DummyRenderer) => void;
+export declare const createCache: (onRenderAlloc?: RenderAllocCallback, cacheOptions?: Partial<CacheProps>) => {
+    cache: RenderingCache;
+    editor: import("../../Editor").Editor;
+};
+export {};

package/dist/src/rendering/caching/testUtils.js

@@ -0,0 +1,20 @@
+import { Vec2 } from '../../geometry/Vec2';
+import DummyRenderer from '../renderers/DummyRenderer';
+import createEditor from '../../testing/createEditor';
+import RenderingCache from './RenderingCache';
+// Override any default test options with [cacheOptions]
+export const createCache = (onRenderAlloc, cacheOptions) => {
+    const editor = createEditor();
+    const cache = new RenderingCache(Object.assign({ createRenderer() {
+            const renderer = new DummyRenderer(editor.viewport);
+            onRenderAlloc === null || onRenderAlloc === void 0 ? void 0 : onRenderAlloc(renderer);
+            return renderer;
+        },
+        isOfCorrectType(renderer) {
+            return renderer instanceof DummyRenderer;
+        }, blockResolution: Vec2.of(500, 500), cacheSize: 500 * 10 * 4, maxScale: 2, minComponentsPerCache: 0, minComponentsToUseCache: 0 }, cacheOptions));
+    return {
+        cache,
+        editor
+    };
+};

package/dist/src/rendering/caching/types.d.ts

@@ -0,0 +1,21 @@
+import { Vec2 } from '../../geometry/Vec2';
+import AbstractRenderer from '../renderers/AbstractRenderer';
+import { CacheRecordManager } from './CacheRecordManager';
+export declare type CacheAddress = number;
+export declare type BeforeDeallocCallback = () => void;
+export interface CacheProps {
+    createRenderer(): AbstractRenderer;
+    isOfCorrectType(renderer: AbstractRenderer): boolean;
+    blockResolution: Vec2;
+    cacheSize: number;
+    maxScale: number;
+    minComponentsPerCache: number;
+    minComponentsToUseCache: number;
+}
+export interface PartialCacheState {
+    currentRenderingCycle: number;
+    props: CacheProps;
+}
+export interface CacheState extends PartialCacheState {
+    recordManager: CacheRecordManager;
+}

package/dist/src/rendering/caching/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/rendering/{AbstractRenderer.d.ts → renderers/AbstractRenderer.d.ts}

@@ -1,8 +1,10 @@
-import Color4 from '../Color4';
-import { PathCommand } from '../geometry/Path';
-import Rect2 from '../geometry/Rect2';
-import { Point2, Vec2 } from '../geometry/Vec2';
-import Viewport from '../Viewport';
+import Color4 from '../../Color4';
+import { LoadSaveDataTable } from '../../components/AbstractComponent';
+import Mat33 from '../../geometry/Mat33';
+import { PathCommand } from '../../geometry/Path';
+import Rect2 from '../../geometry/Rect2';
+import { Point2, Vec2 } from '../../geometry/Vec2';
+import Viewport from '../../Viewport';
 export interface RenderingStyle {
     fill: Color4;
     stroke?: {
@@ -16,8 +18,10 @@ export interface RenderablePathSpec {
     style: RenderingStyle;
 }
 export default abstract class AbstractRenderer {
-    protected viewport: Viewport;
+    private viewport;
+    private selfTransform;
     protected constructor(viewport: Viewport);
+    protected getViewport(): Viewport;
     abstract displaySize(): Vec2;
     abstract clear(): void;
     protected abstract beginPath(startPoint: Point2): void;
@@ -26,14 +30,21 @@ export default abstract class AbstractRenderer {
     protected abstract moveTo(point: Point2): void;
     protected abstract traceCubicBezierCurve(p1: Point2, p2: Point2, p3: Point2): void;
     protected abstract traceQuadraticBezierCurve(controlPoint: Point2, endPoint: Point2): void;
+    abstract isTooSmallToRender(rect: Rect2): boolean;
     setDraftMode(_draftMode: boolean): void;
-    private objectLevel;
+    protected objectLevel: number;
     private currentPaths;
     private flushPath;
     drawPath(path: RenderablePathSpec): void;
     drawRect(rect: Rect2, lineWidth: number, lineFill: RenderingStyle): void;
-    startObject(_boundingBox: Rect2): void;
-    endObject(): void;
+    startObject(_boundingBox: Rect2, _clip?: boolean): void;
+    endObject(_loaderData?: LoadSaveDataTable): void;
     protected getNestingLevel(): number;
     abstract drawPoints(...points: Point2[]): void;
+    canRenderFromWithoutDataLoss(_other: AbstractRenderer): boolean;
+    renderFromOtherOfSameType(_renderTo: Mat33, other: AbstractRenderer): void;
+    setTransform(transform: Mat33 | null): void;
+    getCanvasToScreenTransform(): Mat33;
+    canvasToScreen(vec: Vec2): Vec2;
+    getSizeOfCanvasPixelOnScreen(): number;
 }

package/dist/src/rendering/{AbstractRenderer.js → renderers/AbstractRenderer.js}

@@ -1,4 +1,5 @@
-import Path, { PathCommandType } from '../geometry/Path';
+import Path, { PathCommandType } from '../../geometry/Path';
+import { Vec2 } from '../../geometry/Vec2';
 const stylesEqual = (a, b) => {
     var _a, _b, _c, _d, _e;
     return a === b || (a.fill.eq(b.fill)
@@ -8,9 +9,14 @@ const stylesEqual = (a, b) => {
 export default class AbstractRenderer {
     constructor(viewport) {
         this.viewport = viewport;
+        // If null, this' transformation is linked to the Viewport
+        this.selfTransform = null;
         this.objectLevel = 0;
         this.currentPaths = null;
     }
+    // this.canvasToScreen, etc. should be used instead of the corresponding
+    // methods on Viewport.
+    getViewport() { return this.viewport; }
     setDraftMode(_draftMode) { }
     flushPath() {
         if (!this.currentPaths) {
@@ -68,11 +74,12 @@ export default class AbstractRenderer {
         this.drawPath(path.toRenderable(lineFill));
     }
     // Note the start/end of an object with the given bounding box.
-    startObject(_boundingBox) {
+    // Renderers are not required to support [clip]
+    startObject(_boundingBox, _clip) {
         this.currentPaths = [];
         this.objectLevel++;
     }
-    endObject() {
+    endObject(_loaderData) {
         // Render the paths all at once
         this.flushPath();
         this.currentPaths = null;
@@ -84,4 +91,31 @@ export default class AbstractRenderer {
     getNestingLevel() {
         return this.objectLevel;
     }
+    // Returns true iff other can be rendered onto this without data loss.
+    canRenderFromWithoutDataLoss(_other) {
+        return false;
+    }
+    // MUST throw if other and this are not of the same base class.
+    renderFromOtherOfSameType(_renderTo, other) {
+        throw new Error(`Unable to render from ${other}: Not implemented`);
+    }
+    // Set a transformation to apply to things before rendering,
+    // replacing the viewport's transform.
+    setTransform(transform) {
+        this.selfTransform = transform;
+    }
+    // Get the matrix that transforms a vector on the canvas to a vector on this'
+    // rendering target.
+    getCanvasToScreenTransform() {
+        if (this.selfTransform) {
+            return this.selfTransform;
+        }
+        return this.viewport.canvasToScreenTransform;
+    }
+    canvasToScreen(vec) {
+        return this.getCanvasToScreenTransform().transformVec2(vec);
+    }
+    getSizeOfCanvasPixelOnScreen() {
+        return this.getCanvasToScreenTransform().transformVec3(Vec2.unitX).length();
+    }
 }

package/dist/src/rendering/{CanvasRenderer.d.ts → renderers/CanvasRenderer.d.ts}

@@ -1,7 +1,8 @@
-import Rect2 from '../geometry/Rect2';
-import { Point2, Vec2 } from '../geometry/Vec2';
-import Vec3 from '../geometry/Vec3';
-import Viewport from '../Viewport';
+import Mat33 from '../../geometry/Mat33';
+import Rect2 from '../../geometry/Rect2';
+import { Point2, Vec2 } from '../../geometry/Vec2';
+import Vec3 from '../../geometry/Vec3';
+import Viewport from '../../Viewport';
 import AbstractRenderer, { RenderablePathSpec, RenderingStyle } from './AbstractRenderer';
 export default class CanvasRenderer extends AbstractRenderer {
     private ctx;
@@ -11,6 +12,8 @@ export default class CanvasRenderer extends AbstractRenderer {
     private minRenderSizeAnyDimen;
     private minRenderSizeBothDimens;
     constructor(ctx: CanvasRenderingContext2D, viewport: Viewport);
+    canRenderFromWithoutDataLoss(other: AbstractRenderer): boolean;
+    renderFromOtherOfSameType(transformBy: Mat33, other: AbstractRenderer): void;
     setDraftMode(draftMode: boolean): void;
     displaySize(): Vec2;
     clear(): void;
@@ -21,7 +24,9 @@ export default class CanvasRenderer extends AbstractRenderer {
     protected traceCubicBezierCurve(p1: Point2, p2: Point2, p3: Point2): void;
     protected traceQuadraticBezierCurve(controlPoint: Vec3, endPoint: Vec3): void;
     drawPath(path: RenderablePathSpec): void;
-    startObject(boundingBox: Rect2): void;
+    private clipLevels;
+    startObject(boundingBox: Rect2, clip: boolean): void;
     endObject(): void;
     drawPoints(...points: Point2[]): void;
+    isTooSmallToRender(rect: Rect2): boolean;
 }