@univerjs/engine-render 0.2.7 → 0.2.9

package/lib/types/shape/rich-text.d.ts

@@ -1,8 +1,7 @@
-import { IDocumentData, IStyleBase, ITransformState, LocaleService } from '@univerjs/core';
+import { IDocumentData, IStyleBase, ITransformState, LocaleService, DocumentDataModel } from '@univerjs/core';
 import { BASE_OBJECT_ARRAY, BaseObject, ObjectType } from '../base-object';
 import { IViewportInfo } from '../basics/vector2';
 import { UniverRenderingContext } from '../context';
-
 export interface IRichTextProps extends ITransformState, IStyleBase {
     text?: string;
     richText?: IDocumentData;
@@ -22,6 +21,7 @@ export declare class RichText extends BaseObject {
     private _documentData;
     private _documentSkeleton;
     private _documents;
+    documentModel: DocumentDataModel;
     /**
      * fontFamily
      */
@@ -90,11 +90,7 @@ export declare class RichText extends BaseObject {
     private _convertToDocumentData;
     private _initialProps;
     /**
-     *
-     * it should be invoked when _documentData changed.
-     * _documentData changed ---> update _documentSkeleton & _documentSkeleton
-     *
-     * now it is invoked when transformByState(change editor size) & end of editing
+     * After changing editor size & end of editing, update skeleton of doc.
      */
     refreshDocumentByDocData(): void;
     /**

package/lib/types/shape/scroll-bar.d.ts

@@ -3,7 +3,6 @@ import { UniverRenderingContext } from '../context';
 import { Viewport } from '../viewport';
 import { IScrollBarProps, BaseScrollBar } from './base-scroll-bar';
 import { Rect } from './rect';
-
 export declare class ScrollBar extends BaseScrollBar {
     protected _view: Viewport;
     private _mainScene;

package/lib/types/shape/shape.d.ts

@@ -3,7 +3,6 @@ import { BaseObject, ObjectType } from '../base-object';
 import { IObjectFullState } from '../basics/interfaces';
 import { IViewportInfo, Vector2 } from '../basics/vector2';
 import { UniverRenderingContext } from '../context';
-
 export type LineJoin = 'round' | 'bevel' | 'miter';
 export type LineCap = 'butt' | 'round' | 'square';
 export type PaintFirst = 'fill' | 'stroke';

package/lib/types/shape/text.d.ts

@@ -1,5 +1,4 @@
 import { IShapeProps, Shape } from './shape';
-
 export interface ITextProps extends IShapeProps {
     width: number;
 }

package/lib/types/thin-engine.d.ts

@@ -3,7 +3,6 @@ import { CURSOR_TYPE, RENDER_CLASS_TYPE } from './basics/const';
 import { IEvent } from './basics/i-events';
 import { ITransformChangeState } from './basics/interfaces';
 import { Canvas } from './canvas';
-
 export declare abstract class ThinEngine<T extends IDisposable> extends Disposable {
     onInputChanged$: EventSubject<IEvent>;
     onTransformChange$: EventSubject<ITransformChangeState>;

package/lib/types/thin-scene.d.ts

@@ -8,7 +8,6 @@ import { Vector2 } from './basics/vector2';
 import { UniverRenderingContext } from './context';
 import { ThinEngine } from './thin-engine';
 import { Scene } from './scene';
-
 export declare abstract class ThinScene extends Disposable {
     onTransformChange$: EventSubject<ITransformChangeState>;
     onFileLoaded$: EventSubject<string>;

package/lib/types/viewport.d.ts

@@ -6,7 +6,6 @@ import { IBoundRectNoAngle, IViewportInfo, Vector2 } from './basics/vector2';
 import { UniverRenderingContext } from './context';
 import { BaseScrollBar } from './shape/base-scroll-bar';
 import { ThinScene } from './thin-scene';
-
 interface IViewPosition {
     top?: number;
     left?: number;
@@ -196,10 +195,6 @@ export declare class Viewport {
     set preCacheBound(val: IBoundRectNoAngle | null);
     enable(): void;
     disable(): void;
-    /**
-     * invoked when canvas element size change
-     * engineResizeObserver --> engine.resizeBySize --> scene._setTransForm
-     */
     resetCanvasSizeAndUpdateScroll(): void;
     setScrollBar(instance: BaseScrollBar): void;
     removeScrollBar(): void;
@@ -217,32 +212,8 @@ export declare class Viewport {
     setPadding(param: IPosition): void;
     resetPadding(): void;
     /**
-     * There are serval cases to call this method.
-     * the most common case is scrolling. Other situations include:
-     * 1. changing the frozen row & col settings
-     * 2. changing curr skeleton
-     * 3. changing selection which cross viewport
-     * 4. changing the viewport size (also include change window size)
-     * 5. changing the scroll bar position
-     *
-     * when scrolling by trackpad:
-     * scene.input-manager@_onMouseWheel --> scene@triggerMouseWheel --> sheet-render.controller@scene.onMouseWheel$.add -->
-     * set-scroll.command.ts --> scroll.operation.ts -->
-     * scrollManagerService.setScrollInfoAndEmitEvent
-     *
-     * when change skelenton:
-     * _currentSkeletonBefore$ ---> scroll.render-controller@_updateSceneSize --> setSearchParam --> scene@_setTransForm ---> viewport.resetCanvasSizeAndUpdateScrollBar ---> scrollToXX
-     * --> onScrollAfterObserver.notifyObservers --> scroll.render-controller@onScrollAfterObserver ---> setScrollInfoToCurrSheetWithoutNotify  ---> sms._setScrollInfo
-     *
-     * _currentSkeleton$ ---> selection.render-controller ---> formula@_autoScroll ---> viewport.resize ---> get scrollXY by viewportScrollXY ---> scrollTo
-     * _currentSkeleton$ ---> selection.render-controller ---> setCurrentSelection ---> formula@_autoScroll ---> scrollTo
-     * _currentSkeleton$ ---> freeze.render-controller@_refreshFreeze --> viewport.resize ---> scrollTo  ---> _scroll
-     *
-     * Debug
-     * window.scene.getViewports()[0].scrollTo({x: 14.2, y: 1.8}, true)
-     *
-     * @param pos
-     *
+     * ScrollBar scroll to certain position.
+     * @param pos position of scrollBar
      */
     scrollToBarPos(pos: Partial<IScrollBarPosition>): {
         scrollX: number;
@@ -263,6 +234,12 @@ export declare class Viewport {
         isLimitedY: boolean;
     } | undefined;
     scrollByBar(delta: Partial<IScrollBarPosition>, isTrigger?: boolean): void;
+    /**
+     * Viewport scroll to certain position.
+     * @param pos
+     * @param isTrigger
+     * @returns IViewportScrollPosition
+     */
     scrollToViewportPos(pos: Partial<IViewportScrollPosition>, isTrigger?: boolean): {
         viewportScrollX: number;
         viewportScrollY: number;
@@ -304,12 +281,16 @@ export declare class Viewport {
         y: number;
     };
     getScrollBar(): Nullable<BaseScrollBar>;
+    /**
+     * Just record state of scroll. This method won't scroll viewport and scrollbar.
+     * @param current
+     * @returns Viewport
+     */
     updateScrollVal(current: Partial<IScrollObserverParam>): this;
     getScrollBarTransForm(): Transform;
     shouldIntoRender(): boolean;
     /**
-     * call stack: engine.renderLoop ---> scene.render ---> layer.render ---> viewport.render
-     * that means each layer call all viewports to render
+     * Render function in each render loop.
      * @param parentCtx parentCtx is cacheCtx from layer when layer._allowCache is true
      * @param objects
      * @param isMaxLayer
@@ -366,7 +347,7 @@ export declare class Viewport {
      */
     private _resizeCacheCanvas;
     /**
-     * This method will be invoked when viewport is resizing and removing rol & col
+     * Update scroll when viewport is resizing and removing rol & col
      */
     private _updateScrollByViewportScrollValue;
     private _getViewPortSize;