@openglobus/og 1.0.0-rc2 → 1.0.0-rc21

package/lib/control/entityEditor/CameraEditorView.d.ts

@@ -0,0 +1,60 @@
+import type { Camera } from "../../camera/Camera";
+import type { DepthCamera } from "../depthCamera/DepthCamera";
+import { Entity } from "../../entity/Entity";
+import { Checkbox } from "../../ui/Checkbox";
+import { Input } from "../../ui/Input";
+import { TitleBarView } from "../../ui/TitleBarView";
+import { View, type IViewParams } from "../../ui/View";
+interface ICameraEditorViewParams extends IViewParams {
+    entity: Entity;
+}
+export declare function hasEntityEditorDepthCamera(entity: Entity): boolean;
+export declare class CameraEditorView extends View<Entity> {
+    protected _nearView: Input;
+    protected _farView: Input;
+    protected _leftView: Input;
+    protected _rightView: Input;
+    protected _bottomView: Input;
+    protected _topView: Input;
+    protected _verticalFovView: Input;
+    protected _horizontalFovView: Input;
+    protected _viewportWidthView: Input;
+    protected _viewportHeightView: Input;
+    protected _orthographicView: Checkbox;
+    protected _focusDistanceView: Input;
+    protected _showFrustumView: Checkbox;
+    protected _showFootprintView: Checkbox;
+    protected _biasView: Input;
+    protected _normalBiasView: Input;
+    protected _titleBarView: TitleBarView;
+    protected _bodyEl: HTMLElement | null;
+    protected _depthCamera: DepthCamera | null;
+    constructor(params: ICameraEditorViewParams);
+    bindEntity(entity: Entity): void;
+    render(params?: unknown): this;
+    refresh(): void;
+    protected _getCamera(): Camera | null;
+    remove(): void;
+    protected _onTitleBarChange: (isCollapsed: boolean) => void;
+    protected _setNearFar(near: number, far: number): void;
+    protected _setBounds(left: number, right: number, bottom: number, top: number): void;
+    protected _syncFrustumEntityScale(): void;
+    protected _onChangeNear: (value: string) => void;
+    protected _onChangeFar: (value: string) => void;
+    protected _onChangeLeft: (value: string) => void;
+    protected _onChangeRight: (value: string) => void;
+    protected _onChangeBottom: (value: string) => void;
+    protected _onChangeTop: (value: string) => void;
+    protected _onChangeVerticalFov: (value: string) => void;
+    protected _onChangeHorizontalFov: (value: string) => void;
+    protected _setViewportSize(width: number, height: number): void;
+    protected _onChangeViewportWidth: (value: string) => void;
+    protected _onChangeViewportHeight: (value: string) => void;
+    protected _onChangeOrthographic: (isOrthographic: boolean) => void;
+    protected _onChangeFocusDistance: (value: string) => void;
+    protected _onChangeShowFrustum: (showFrustum: boolean) => void;
+    protected _onChangeShowFootprint: (showFootprint: boolean) => void;
+    protected _onChangeBias: (value: string) => void;
+    protected _onChangeNormalBias: (value: string) => void;
+}
+export {};

package/lib/control/entityEditor/EntityEditor.d.ts

@@ -1,9 +1,10 @@
 import { Control, type IControlParams } from "../Control";
-import { EntityEditorScene } from "./EntityEditorScene";
+import { EntityEditorScene, type EditModeName } from "./EntityEditorScene";
 import { EntityEditorDialog } from "./EntityEditorDialog";
 import { Entity } from "../../entity/Entity";
 import { Dialog } from "../../ui";
 export interface IEntityEditorParams extends IControlParams {
+    editMode?: EditModeName;
 }
 export declare class EntityEditor extends Control {
     protected _entityEditorScene: EntityEditorScene;

package/lib/control/entityEditor/EntityEditorDialog.d.ts

@@ -1,35 +1,17 @@
 import { Dialog, type IDialogParams } from "../../ui/Dialog";
 import { EntityEditorScene } from "./EntityEditorScene";
 import { Entity } from "../../entity/Entity";
-import { Input } from "../../ui/Input";
-import { Checkbox } from "../../ui/Checkbox";
 import { Vec3 } from "../../math/Vec3";
-import { Slider } from "../../ui/Slider";
+import { CameraEditorView } from "./CameraEditorView";
+import { EntityEditorView } from "./EntityEditorView";
+import { ProjectorEditorView } from "./ProjectorEditorView";
 interface IEntityEditorDialog extends IDialogParams {
     model: EntityEditorScene;
 }
 export declare class EntityEditorDialog extends Dialog<EntityEditorScene> {
-    protected _relativePositionView: Checkbox;
-    protected _lonView: Input;
-    protected _latView: Input;
-    protected _heightView: Input;
-    protected _xView: Input;
-    protected _yView: Input;
-    protected _zView: Input;
-    protected _absXView: Input;
-    protected _absYView: Input;
-    protected _absZView: Input;
-    protected _pitchView: Input;
-    protected _yawView: Input;
-    protected _rollView: Input;
-    protected _absolutePitchView: Input;
-    protected _absoluteYawView: Input;
-    protected _absoluteRollView: Input;
-    protected _scaleView: Input;
-    protected _scaleXView: Input;
-    protected _scaleYView: Input;
-    protected _scaleZView: Input;
-    protected _opacityView: Slider;
+    protected _entityView: EntityEditorView | null;
+    protected _cameraView: CameraEditorView | null;
+    protected _projectorView: ProjectorEditorView | null;
     constructor(params: IEntityEditorDialog);
     render(params: any): this;
     protected _onVisibility: (vis: boolean) => void;
@@ -37,34 +19,20 @@ export declare class EntityEditorDialog extends Dialog<EntityEditorScene> {
     protected _initSceneEvents(): void;
     protected _clearSceneEvents(): void;
     protected _onSelect: (entity: Entity) => void;
-    protected _refresh(entity: Entity): void;
+    protected _refreshViews(entity: Entity): void;
+    protected _refreshEntityView(entity: Entity): void;
+    protected _removeEntityView(): void;
+    protected _refreshCameraView(entity: Entity): void;
+    protected _removeCameraView(): void;
+    protected _refreshProjectorView(entity: Entity): void;
+    protected _removeProjectorView(): void;
+    protected _removeViews(): void;
     protected _setDialogTitle(entity: Entity): void;
     hide(): void;
-    protected _onUnselect: (entity: Entity) => void;
-    protected _onChangeRelativePosition: (checked: boolean) => void;
+    protected _onUnselect: () => void;
     protected _onPosition: (pos: Vec3, entity: Entity) => void;
     protected _onPitch: (a: number, entity: Entity) => void;
     protected _onYaw: (a: number, entity: Entity) => void;
     protected _onRoll: (a: number, entity: Entity) => void;
-    protected _onChangeLon: (val: string) => void;
-    protected _onChangeLat: (val: string) => void;
-    protected _onChangeHeight: (val: string) => void;
-    protected _onChangeX: (val: string) => void;
-    protected _onChangeY: (val: string) => void;
-    protected _onChangeZ: (val: string) => void;
-    protected _onChangeAbsoluteX: (val: string) => void;
-    protected _onChangeAbsoluteY: (val: string) => void;
-    protected _onChangeAbsoluteZ: (val: string) => void;
-    protected _onChangePitch: (val: string) => void;
-    protected _onChangeYaw: (val: string) => void;
-    protected _onChangeRoll: (val: string) => void;
-    protected _onChangeAbsolutePitch: (val: string) => void;
-    protected _onChangeAbsoluteYaw: (val: string) => void;
-    protected _onChangeAbsoluteRoll: (val: string) => void;
-    protected _onChangeScale: (val: string) => void;
-    protected _onChangeScaleX: (val: string) => void;
-    protected _onChangeScaleY: (val: string) => void;
-    protected _onChangeScaleZ: (val: string) => void;
-    protected _onChangeOpacity: (val: number) => void;
 }
 export {};

package/lib/control/entityEditor/EntityEditorScene.d.ts

@@ -15,7 +15,12 @@ import { EntityCollection } from "../../entity/EntityCollection";
 export interface IEntityEditorSceneParams {
     planet?: Planet;
     name?: string;
+    editMode?: EditModeName;
 }
+export declare const NATIVE_MODE = 0;
+export declare const YAW_MODE = 1;
+export type EditMode = typeof NATIVE_MODE | typeof YAW_MODE;
+export type EditModeName = "native" | "yaw";
 type EntityEditorSceneEventsList = [
     "mousemove",
     "mouseenter",
@@ -62,6 +67,7 @@ declare class EntityEditorScene extends Scene {
     protected _axisTrackLayer: EntityCollection;
     protected _selectedEntity: Entity | null;
     protected _selectedEntityCart: Vec3;
+    protected _selectedEntityRotation: Quat;
     protected _selectedEntityPitch: number;
     protected _selectedEntityYaw: number;
     protected _selectedEntityRoll: number;
@@ -73,10 +79,14 @@ declare class EntityEditorScene extends Scene {
     protected _selectedMove: string | null;
     protected _ops: Record<string, (mouseState: IMouseState) => void>;
     protected _axisTrackVisibility: boolean;
+    protected _editMode: EditMode;
     constructor(options?: IEntityEditorSceneParams);
     get ellipsoid(): Ellipsoid | undefined;
     get planet(): Planet | null;
+    get editMode(): EditMode;
+    set editMode(mode: EditMode);
     bindPlanet(planet: Planet): void;
+    protected _parseEditMode(mode: EditModeName | undefined): EditMode;
     init(): void;
     onremove(): void;
     protected _addAxisLayers(): void;
@@ -113,6 +123,12 @@ declare class EntityEditorScene extends Scene {
     protected _moveXY: (e: IMouseState) => void;
     protected _moveZY: (e: IMouseState) => void;
     getFrameRotation(cartesian: Vec3): Quat;
+    protected _isPlanetEntity(entity: Entity): boolean;
+    protected _isYawMode(): boolean;
+    protected _getYawModeFrameRotation(entity: Entity, cart: Vec3): Quat;
+    protected _getEntityRotation(entity: Entity, cart: Vec3): Quat;
+    protected _setRotateEntityCartesian3v(entity: Entity, cart: Vec3): void;
+    protected _setEntityRotation(entity: Entity, rotation: Quat, cart: Vec3): void;
     protected _rotatePitch: (e: IMouseState) => void;
     protected _rotateYaw: (e: IMouseState) => void;
     protected _rotateRoll: (e: IMouseState) => void;

package/lib/control/entityEditor/EntityEditorView.d.ts

@@ -0,0 +1,68 @@
+import { Entity } from "../../entity/Entity";
+import { Checkbox } from "../../ui/Checkbox";
+import { Input } from "../../ui/Input";
+import { Slider } from "../../ui/Slider";
+import { TitleBarView } from "../../ui/TitleBarView";
+import { View, type IViewParams } from "../../ui/View";
+import { EntityEditorScene } from "./EntityEditorScene";
+interface IEntityEditorViewParams extends IViewParams {
+    model: EntityEditorScene;
+    entity?: Entity;
+}
+export declare class EntityEditorView extends View<EntityEditorScene> {
+    protected _entity: Entity | null;
+    protected _titleBarView: TitleBarView;
+    protected _bodyEl: HTMLElement | null;
+    protected _relativePositionView: Checkbox;
+    protected _yawModeView: Checkbox;
+    protected _lonView: Input;
+    protected _latView: Input;
+    protected _heightView: Input;
+    protected _xView: Input;
+    protected _yView: Input;
+    protected _zView: Input;
+    protected _absXView: Input;
+    protected _absYView: Input;
+    protected _absZView: Input;
+    protected _pitchView: Input;
+    protected _yawView: Input;
+    protected _rollView: Input;
+    protected _absolutePitchView: Input;
+    protected _absoluteYawView: Input;
+    protected _absoluteRollView: Input;
+    protected _scaleView: Input;
+    protected _scaleXView: Input;
+    protected _scaleYView: Input;
+    protected _scaleZView: Input;
+    protected _opacityView: Slider;
+    constructor(params: IEntityEditorViewParams);
+    bindEntity(entity: Entity): void;
+    render(params?: unknown): this;
+    refresh(entity?: Entity | null): void;
+    refreshRotation(entity?: Entity | null): void;
+    remove(): void;
+    protected _onTitleBarChange: (isCollapsed: boolean) => void;
+    protected _onChangeRelativePosition: (checked: boolean) => void;
+    protected _onChangeYawMode: (checked: boolean) => void;
+    protected _onChangeLon: (val: string) => void;
+    protected _onChangeLat: (val: string) => void;
+    protected _onChangeHeight: (val: string) => void;
+    protected _onChangeX: (val: string) => void;
+    protected _onChangeY: (val: string) => void;
+    protected _onChangeZ: (val: string) => void;
+    protected _onChangeAbsoluteX: (val: string) => void;
+    protected _onChangeAbsoluteY: (val: string) => void;
+    protected _onChangeAbsoluteZ: (val: string) => void;
+    protected _onChangePitch: (val: string) => void;
+    protected _onChangeYaw: (val: string) => void;
+    protected _onChangeRoll: (val: string) => void;
+    protected _onChangeAbsolutePitch: (val: string) => void;
+    protected _onChangeAbsoluteYaw: (val: string) => void;
+    protected _onChangeAbsoluteRoll: (val: string) => void;
+    protected _onChangeScale: (val: string) => void;
+    protected _onChangeScaleX: (val: string) => void;
+    protected _onChangeScaleY: (val: string) => void;
+    protected _onChangeScaleZ: (val: string) => void;
+    protected _onChangeOpacity: (val: number) => void;
+}
+export {};

package/lib/control/entityEditor/ProjectorEditorView.d.ts

@@ -0,0 +1,31 @@
+import { Checkbox } from "../../ui/Checkbox";
+import { Color } from "../../ui/Color";
+import { Input } from "../../ui/Input";
+import { TitleBarView } from "../../ui/TitleBarView";
+import { View, type IViewParams } from "../../ui/View";
+import { type Projector } from "../../renderer/projectors/Projector";
+interface IProjectorEditorViewParams extends IViewParams {
+    projector: Projector;
+}
+export declare class ProjectorEditorView extends View<Projector> {
+    protected _enabledView: Checkbox;
+    protected _colorView: Color;
+    protected _opacityView: Input;
+    protected _priorityView: Input;
+    protected _modeEl: HTMLSelectElement | null;
+    protected _modeRowEl: HTMLElement | null;
+    protected _titleBarView: TitleBarView;
+    protected _bodyEl: HTMLElement | null;
+    constructor(params: IProjectorEditorViewParams);
+    bindProjector(projector: Projector): void;
+    render(params?: unknown): this;
+    refresh(): void;
+    remove(): void;
+    protected _onTitleBarChange: (isCollapsed: boolean) => void;
+    protected _onChangeEnabled: (enabled: boolean) => void;
+    protected _onChangeColor: (color: string) => void;
+    protected _onChangeOpacity: (value: string) => void;
+    protected _onChangePriority: (value: string) => void;
+    protected _onChangeMode: () => void;
+}
+export {};

package/lib/control/entityEditor/RotateEntity.d.ts

@@ -1,9 +1,13 @@
 import { Entity, type IEntityParams } from "../../entity/Entity";
 import { Vec3 } from "../../math/Vec3";
+import { Quat } from "../../math/Quat";
 export interface IRotationEntityParams extends IEntityParams {
 }
 export declare class RotateEntity extends Entity {
     constructor(params?: IRotationEntityParams);
     private _init;
-    setCartesian3v(cart: Vec3, yaw?: number): void;
+    setCartesian3v(cart: Vec3): void;
+    setCartesian3v(cart: Vec3, rotation: Quat): void;
+    setYawCartesian3v(cart: Vec3, yaw: number): void;
+    protected _updateGizmo(cart: Vec3, qRot: Quat, qYaw: Quat): void;
 }

package/lib/control/index.d.ts

@@ -3,6 +3,7 @@ export * from "./Control";
 export * from "./DebugInfo";
 export * from "./DrawingSwitcher";
 export * from "./EarthCoordinates";
+export * from "./FreeNavigation";
 export * from "./GeoImageDragControl";
 export * from "./KeyboardNavigation";
 export * from "./LayerAnimation";
@@ -28,9 +29,8 @@ export * from "./atmosphere/AtmosphereConfig";
 export * from "./entityEditor/EntityEditor";
 export * from "./CameraLock";
 export * from "./object3dManager/Object3dManager";
-export * from "./CameraFrameComposer";
-export * from "./CameraFrameHandler";
-export * from "./cameraDepthHandler/CameraDepthHandler";
+export * from "./depthCamera/DepthCamera";
+export * from "./depthCamera/DepthCameraHandler";
 export * from "./FramebufferPreview";
 export * from "./SimpleTouchNavigation";
 export * from "./entityTree/EntityTree";

package/lib/control/timeline/TimelineControl.d.ts

@@ -2,6 +2,25 @@ import { Dialog } from "../../ui/Dialog";
 import { ToggleButton } from "../../ui/ToggleButton";
 import { Control, type IControlParams } from "../Control";
 import { TimelineView } from "./TimelineView";
+import type { ITimelineSpan, ITimelineSpanParams, TimelineModel } from "./TimelineModel";
+import { type EventsHandler } from "../../Events";
+type TimelineControlEventsList = [
+    "visibility",
+    "change",
+    "setcurrent",
+    "current",
+    "play",
+    "playback",
+    "pause",
+    "reset",
+    "startdrag",
+    "stopdrag",
+    "startdragcurrent",
+    "stopdragcurrent",
+    "localtime",
+    "suntime",
+    "sundate"
+];
 interface ITimelineControlParams extends IControlParams {
     name?: string;
     current?: Date;
@@ -12,7 +31,74 @@ declare class TimelineControl extends Control {
     protected _timelineView: TimelineView;
     protected _toggleBtn: ToggleButton;
     protected _dialog: Dialog<null>;
+    protected _defaultClockWasRunningBeforeDrag: boolean;
+    events: EventsHandler<TimelineControlEventsList>;
     constructor(options?: ITimelineControlParams);
+    /**
+     * Returns timeline data model.
+     * @public
+     */
+    get model(): TimelineModel;
+    /** Date the Sun marker stands on. Setting it moves the marker without dispatching. */
+    get sunDate(): Date;
+    set sunDate(date: Date);
+    /**
+     * Adds a colored time interval drawn on the scale, e.g. one per telemetry track.
+     * Spans that overlap in time are placed on separate rows automatically, and the
+     * rows share the scale height between them.
+     * @public
+     * @param {ITimelineSpanParams} params - Span start, end and color. An omitted id is generated.
+     * @returns {ITimelineSpan} - Stored span, with its id and assigned row.
+     */
+    addSpan(params: ITimelineSpanParams): ITimelineSpan;
+    /**
+     * Adds several spans at once, keeping the ones already on the scale.
+     * @public
+     * @param {ITimelineSpanParams[]} params - Spans to add.
+     * @returns {ITimelineSpan[]} - Stored spans, in the order they were given.
+     */
+    addSpans(params: ITimelineSpanParams[]): ITimelineSpan[];
+    /**
+     * Replaces every span on the scale, e.g. to redraw the whole set after a source
+     * was added or removed.
+     * @public
+     * @param {ITimelineSpanParams[]} params - Spans the scale is left with.
+     * @returns {ITimelineSpan[]} - Stored spans, in the order they were given.
+     */
+    setSpans(params: ITimelineSpanParams[]): ITimelineSpan[];
+    /**
+     * Replaces the time range, color and payload of a span, and reassigns the rows when
+     * its time range moved.
+     * @public
+     * @param {string} id - Span id.
+     * @param {ITimelineSpanParams} params - New span fields. Every field is replaced, the id is kept.
+     * @returns {ITimelineSpan | undefined} - Updated span, or undefined when the id is unknown.
+     */
+    updateSpan(id: string, params: ITimelineSpanParams): ITimelineSpan | undefined;
+    /**
+     * Removes a single span from the scale. An unknown id is ignored.
+     * @public
+     * @param {string} id - Span id.
+     */
+    removeSpan(id: string): void;
+    /**
+     * Removes every span from the scale.
+     * @public
+     */
+    clearSpans(): void;
+    /**
+     * Returns the spans currently on the scale.
+     * @public
+     * @returns {ITimelineSpan[]} - Stored spans, each carrying its assigned row.
+     */
+    getSpans(): ITimelineSpan[];
+    /**
+     * Returns a single span by its id.
+     * @public
+     * @param {string} id - Span id.
+     * @returns {ITimelineSpan | undefined} - Stored span, or undefined when the id is unknown.
+     */
+    getSpan(id: string): ITimelineSpan | undefined;
     oninit(): void;
 }
 export { TimelineControl };

package/lib/control/timeline/TimelineModel.d.ts

@@ -1,5 +1,22 @@
 import { type EventsHandler } from "../../Events";
-type TimelineEventsList = ["change", "current"];
+type TimelineEventsList = ["change", "current", "play", "stop", "spanschange"];
+/** A colored time interval shown on the timeline scale. */
+export interface ITimelineSpanParams {
+    id?: string;
+    start: Date;
+    end: Date;
+    color?: string;
+    data?: unknown;
+}
+export interface ITimelineSpan {
+    id: string;
+    start: Date;
+    end: Date;
+    color: string;
+    data?: unknown;
+    /** Row the span is drawn in, assigned so that overlapping spans never share one. */
+    lane: number;
+}
 interface ITimelineParams {
     current?: Date;
     rangeStart?: Date;
@@ -9,6 +26,7 @@ interface ITimelineParams {
     multiplier?: number;
 }
 declare class TimelineModel {
+    static __spanCounter__: number;
     events: EventsHandler<TimelineEventsList>;
     protected _current: Date;
     protected _rangeStart: Date;
@@ -18,9 +36,36 @@ declare class TimelineModel {
     protected _maxDate: Date | null;
     protected _requestAnimationFrameId: number;
     protected _prevNow: number;
+    protected _spans: ITimelineSpan[];
+    protected _laneCount: number;
     multiplier: number;
     dt: number;
+    /**
+     * While set, playing does not advance
+     * the time: something else sets `current` instead.
+     */
+    driven: boolean;
+    /**
+     * While set, playing takes the current time
+     * from this source instead of the frame delta.
+     */
+    clock: (() => number) | null;
     constructor(options?: ITimelineParams);
+    addSpan(params: ITimelineSpanParams): ITimelineSpan;
+    addSpans(params: ITimelineSpanParams[]): ITimelineSpan[];
+    setSpans(params: ITimelineSpanParams[]): ITimelineSpan[];
+    updateSpan(id: string, params: ITimelineSpanParams): ITimelineSpan | undefined;
+    removeSpan(id: string): void;
+    clearSpans(): void;
+    getSpans(): ITimelineSpan[];
+    getSpan(id: string): ITimelineSpan | undefined;
+    /**
+     * Number of rows the current spans need, at least one when
+     * there are any.
+     */
+    get laneCount(): number;
+    protected _onSpansChange(): void;
+    protected _assignLanes(): void;
     play(): void;
     stop(): void;
     stopped(): boolean;

package/lib/control/timeline/TimelineView.d.ts

@@ -17,6 +17,7 @@ declare const TOUCH_MODE_NONE = 0;
 declare const TOUCH_MODE_CURRENT = 1;
 declare const TOUCH_MODE_PINCH = 2;
 declare const TOUCH_MODE_SCALE = 3;
+declare const TOUCH_MODE_SUN = 4;
 type TimelineViewEventsList = [
     "startdrag",
     "stopdrag",
@@ -27,9 +28,12 @@ type TimelineViewEventsList = [
     "play",
     "playback",
     "pause",
-    "visibility"
+    "visibility",
+    "localtime",
+    "suntime",
+    "sundate"
 ];
-type TimelineTouchMode = typeof TOUCH_MODE_NONE | typeof TOUCH_MODE_CURRENT | typeof TOUCH_MODE_PINCH | typeof TOUCH_MODE_SCALE;
+type TimelineTouchMode = typeof TOUCH_MODE_NONE | typeof TOUCH_MODE_CURRENT | typeof TOUCH_MODE_PINCH | typeof TOUCH_MODE_SCALE | typeof TOUCH_MODE_SUN;
 interface ITimelineTouchPointer {
     pointerId: number;
     clientX: number;
@@ -41,12 +45,20 @@ declare class TimelineView extends View<TimelineModel> {
     $controls: HTMLElement | null;
     protected _frameEl: HTMLElement | null;
     protected _currentEl: HTMLElement | null;
+    protected _sunEl: HTMLElement | null;
     protected _canvasEl: HTMLCanvasElement;
     protected _ctx: CanvasRenderingContext2D;
+    protected _spansCanvasEl: HTMLCanvasElement;
+    protected _spansCtx: CanvasRenderingContext2D;
+    protected _appliedFillStyle: string;
     protected _isMouseOver: boolean;
     protected _isDragging: boolean;
     protected _isCurrentDragging: boolean;
     protected _isCurrentMouseOver: boolean;
+    protected _isSunDragging: boolean;
+    protected _isSunMouseOver: boolean;
+    protected _sunDate: Date;
+    protected _sunTime: boolean;
     protected _minWidth: number;
     protected _canvasScale: number;
     protected _millisecondsInPixel: number;
@@ -54,6 +66,7 @@ declare class TimelineView extends View<TimelineModel> {
     protected _clickRangeStart: Date;
     protected _clickRangeEnd: Date;
     protected _clickCurrentDate: Date;
+    protected _clickSunDate: Date;
     protected _clickTime: number;
     protected _clickDelay: number;
     protected _clickMoveTolerance: number;
@@ -62,11 +75,16 @@ declare class TimelineView extends View<TimelineModel> {
     protected _touchPointers: Map<number, ITimelineTouchPointer>;
     protected _touchScalePointerId: number | null;
     protected _touchCurrentPointerId: number | null;
+    protected _touchSunPointerId: number | null;
     protected _onResizeObserver_: () => void;
     protected _resizeObserver: ResizeObserver;
     protected _pauseBtn: ToggleButton;
     protected _playBtn: ToggleButton;
+    protected _playBackBtn: ToggleButton;
+    protected _multiplierEl: HTMLSelectElement | null;
     protected _buttons: ButtonGroup;
+    protected _localTimeBtn: ToggleButton;
+    protected _sunTimeBtn: ToggleButton;
     protected _visibility: boolean;
     constructor(options?: ITimelineViewParams);
     protected _onResizeObserver(): void;
@@ -75,7 +93,31 @@ declare class TimelineView extends View<TimelineModel> {
     resize(): void;
     afterRender(parentNode: HTMLElement): void;
     render(): this;
+    /**
+     * True when the timeline scale is read as the local date and time at the viewed location.
+     * @public
+     * @type {boolean}
+     */
+    get localTime(): boolean;
+    set localTime(localTime: boolean);
+    /**
+     * True while the Sun is set from its own marker instead of the timeline.
+     * @public
+     * @type {boolean}
+     */
+    get sunTime(): boolean;
+    set sunTime(sunTime: boolean);
+    /**
+     * Date the Sun marker stands on.
+     * @public
+     * @type {Date}
+     */
+    get sunDate(): Date;
+    set sunDate(date: Date);
     setVisibility(visibility: boolean): void;
+    protected _createMultiplier(): HTMLSelectElement;
+    protected _syncMultiplier(): void;
+    protected _syncPlayButtons: () => void;
     reset(): void;
     play(): void;
     pause(): void;
@@ -90,7 +132,12 @@ declare class TimelineView extends View<TimelineModel> {
     protected _startCurrentDrag(clientX: number, sourceEvent: Event, pointerId?: number | null): void;
     protected _moveCurrentDrag(clientX: number): void;
     protected _stopCurrentDrag(): void;
+    protected _startSunDrag(clientX: number, pointerId?: number | null): void;
+    /** The Sun marker carries its own date: the model, and everything reading it, stay put. */
+    protected _moveSunDrag(clientX: number): void;
+    protected _stopSunDrag(): void;
     protected _isClickGesture(clientX: number): boolean;
+    protected _setSunByClientX(clientX: number): Date;
     protected _setCurrentByClientX(clientX: number): Date;
     protected _captureTouchPointer(e: PointerEvent): void;
     protected _updateTouchPointer(e: PointerEvent): void;
@@ -107,8 +154,11 @@ declare class TimelineView extends View<TimelineModel> {
     protected _onMouseOut: () => void;
     protected _onCurrentMouseEnter: () => void;
     protected _onCurrentMouseOut: () => void;
+    protected _onSunMouseEnter: () => void;
+    protected _onSunMouseOut: () => void;
     protected _onScalePointerDown: (e: PointerEvent) => void;
     protected _onCurrentPointerDown: (e: PointerEvent) => void;
+    protected _onSunPointerDown: (e: PointerEvent) => void;
     protected _onPointerMove: (e: PointerEvent) => void;
     protected _onPointerUp: (e: PointerEvent) => void;
     protected _onMouseMove: (e: MouseEvent) => void;
@@ -119,7 +169,10 @@ declare class TimelineView extends View<TimelineModel> {
     protected _clearEvents(): void;
     remove(): void;
     protected _clearCanvas(): void;
+    protected _applyScaleBackground(): void;
+    protected _drawSpans: () => void;
     protected _drawCurrent(): void;
+    protected _drawSun(): void;
     draw(): void;
 }
 export { TimelineView };