molstar 2.3.9 → 3.0.0-dev.10

package/lib/extensions/rcsb/graphql/types.d.ts

@@ -1,4 +1,5 @@
 export declare type Maybe<T> = T | null;
+export declare type InputMaybe<T> = Maybe<T>;
 export declare type Exact<T extends {
     [key: string]: unknown;
 }> = {
@@ -6653,7 +6654,7 @@ export declare type Query = {
 };
 /** Query root */
 export declare type QueryAssembliesArgs = {
-    assembly_ids: ReadonlyArray<Maybe<Scalars['String']>>;
+    assembly_ids: ReadonlyArray<InputMaybe<Scalars['String']>>;
 };
 /** Query root */
 export declare type QueryAssemblyArgs = {
@@ -6676,7 +6677,7 @@ export declare type QueryBranched_Entity_InstanceArgs = {
 };
 /** Query root */
 export declare type QueryBranched_Entity_InstancesArgs = {
-    instance_ids: ReadonlyArray<Maybe<Scalars['String']>>;
+    instance_ids: ReadonlyArray<InputMaybe<Scalars['String']>>;
 };
 /** Query root */
 export declare type QueryChem_CompArgs = {
@@ -6684,7 +6685,7 @@ export declare type QueryChem_CompArgs = {
 };
 /** Query root */
 export declare type QueryChem_CompsArgs = {
-    comp_ids: ReadonlyArray<Maybe<Scalars['String']>>;
+    comp_ids: ReadonlyArray<InputMaybe<Scalars['String']>>;
 };
 /** Query root */
 export declare type QueryEntriesArgs = {
@@ -6710,7 +6711,7 @@ export declare type QueryNonpolymer_Entity_InstanceArgs = {
 };
 /** Query root */
 export declare type QueryNonpolymer_Entity_InstancesArgs = {
-    instance_ids: ReadonlyArray<Maybe<Scalars['String']>>;
+    instance_ids: ReadonlyArray<InputMaybe<Scalars['String']>>;
 };
 /** Query root */
 export declare type QueryPolymer_EntitiesArgs = {
@@ -6728,7 +6729,7 @@ export declare type QueryPolymer_Entity_InstanceArgs = {
 };
 /** Query root */
 export declare type QueryPolymer_Entity_InstancesArgs = {
-    instance_ids: ReadonlyArray<Maybe<Scalars['String']>>;
+    instance_ids: ReadonlyArray<InputMaybe<Scalars['String']>>;
 };
 /** Query root */
 export declare type QueryPubmedArgs = {
@@ -10843,11 +10844,11 @@ export declare type RcsbUniprotAlignments = {
 };
 export declare type RcsbUniprotAlignmentsCoreEntityAlignments = {
     /** Aligned region */
-    readonly aligned_regions?: Maybe<ReadonlyArray<Maybe<CoreEntityAlignmentsAlignedRegions>>>;
+    readonly aligned_regions: ReadonlyArray<Maybe<CoreEntityAlignmentsAlignedRegions>>;
     /** core_entity identifiers */
     readonly core_entity_identifiers?: Maybe<CoreEntityAlignmentsCoreEntityIdentifiers>;
     /** Alignment scores */
-    readonly scores?: Maybe<CoreEntityAlignmentsScores>;
+    readonly scores: CoreEntityAlignmentsScores;
 };
 export declare type RcsbUniprotAnnotation = {
     /** An identifier for the annotation. */
@@ -12849,25 +12850,25 @@ export declare type AssemblySymmetryQueryVariables = Exact<{
     entry_id: Scalars['String'];
 }>;
 export declare type AssemblySymmetryQuery = {
-    readonly assembly?: Maybe<{
-        readonly rcsb_struct_symmetry?: Maybe<ReadonlyArray<Maybe<{
+    readonly assembly?: {
+        readonly rcsb_struct_symmetry?: ReadonlyArray<{
             readonly kind: string;
             readonly oligomeric_state: string;
-            readonly stoichiometry: ReadonlyArray<Maybe<string>>;
+            readonly stoichiometry: ReadonlyArray<string | null | undefined>;
             readonly symbol: string;
             readonly type: string;
-            readonly clusters: ReadonlyArray<Maybe<{
-                readonly avg_rmsd?: Maybe<number>;
-                readonly members: ReadonlyArray<Maybe<{
+            readonly clusters: ReadonlyArray<{
+                readonly avg_rmsd?: number | null | undefined;
+                readonly members: ReadonlyArray<{
                     readonly asym_id: string;
-                    readonly pdbx_struct_oper_list_ids?: Maybe<ReadonlyArray<Maybe<string>>>;
-                }>>;
-            }>>;
-            readonly rotation_axes?: Maybe<ReadonlyArray<Maybe<{
-                readonly order?: Maybe<number>;
-                readonly start: ReadonlyArray<Maybe<number>>;
-                readonly end: ReadonlyArray<Maybe<number>>;
-            }>>>;
-        }>>>;
-    }>;
+                    readonly pdbx_struct_oper_list_ids?: ReadonlyArray<string | null | undefined> | null | undefined;
+                } | null | undefined>;
+            } | null | undefined>;
+            readonly rotation_axes?: ReadonlyArray<{
+                readonly order?: number | null | undefined;
+                readonly start: ReadonlyArray<number | null | undefined>;
+                readonly end: ReadonlyArray<number | null | undefined>;
+            } | null | undefined> | null | undefined;
+        } | null | undefined> | null | undefined;
+    } | null | undefined;
 };

package/lib/extensions/rcsb/validation-report/behavior.d.ts

@@ -12,7 +12,7 @@ export declare const RCSBValidationReport: import("../../../mol-state/transforme
 }>;
 export declare const ValidationReportGeometryQualityPreset: StructureRepresentationPresetProvider<{
     ignoreHydrogens: boolean | undefined;
-    quality: "custom" | "auto" | "highest" | "higher" | "high" | "medium" | "low" | "lower" | "lowest" | undefined;
+    quality: "auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest" | undefined;
     theme: PD.Normalize<{
         globalName: any;
         carbonColor: any;
@@ -48,7 +48,7 @@ export declare const ValidationReportGeometryQualityPreset: StructureRepresentat
 }>;
 export declare const ValidationReportDensityFitPreset: StructureRepresentationPresetProvider<{
     ignoreHydrogens: boolean | undefined;
-    quality: "custom" | "auto" | "highest" | "higher" | "high" | "medium" | "low" | "lower" | "lowest" | undefined;
+    quality: "auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest" | undefined;
     theme: PD.Normalize<{
         globalName: any;
         carbonColor: any;
@@ -76,7 +76,7 @@ export declare const ValidationReportDensityFitPreset: StructureRepresentationPr
 }>;
 export declare const ValidationReportRandomCoilIndexPreset: StructureRepresentationPresetProvider<{
     ignoreHydrogens: boolean | undefined;
-    quality: "custom" | "auto" | "highest" | "higher" | "high" | "medium" | "low" | "lower" | "lowest" | undefined;
+    quality: "auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest" | undefined;
     theme: PD.Normalize<{
         globalName: any;
         carbonColor: any;

package/lib/extensions/rcsb/validation-report/prop.js

@@ -37,7 +37,7 @@ var ValidationReport;
     }
     ValidationReport.getEntryUrl = getEntryUrl;
     function isApplicable(model) {
-        return !!model && Model.isFromPdbArchive(model);
+        return !!model && Model.hasPdbId(model);
     }
     ValidationReport.isApplicable = isApplicable;
     function fromXml(xml, model) {

package/lib/extensions/rcsb/validation-report/representation.d.ts

@@ -31,8 +31,25 @@ export declare const IntraUnitClashParams: {
     flatShaded: PD.BooleanParam;
     ignoreLight: PD.BooleanParam;
     xrayShaded: PD.BooleanParam;
+    bumpFrequency: PD.Numeric;
+    bumpAmplitude: PD.Numeric;
     alpha: PD.Numeric;
-    quality: PD.Select<"custom" | "auto" | "highest" | "higher" | "high" | "medium" | "low" | "lower" | "lowest">;
+    quality: PD.Select<"auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest">;
+    material: PD.Group<PD.Normalize<{
+        metalness: number;
+        roughness: number;
+        bumpiness: number;
+    }>>;
+    clip: PD.Group<PD.Normalize<{
+        variant: import("../../../mol-util/clip").Clip.Variant;
+        objects: PD.Normalize<{
+            type: any;
+            invert: any;
+            position: any;
+            rotation: any;
+            scale: any;
+        }>[];
+    }>>;
 };
 export declare type IntraUnitClashParams = typeof IntraUnitClashParams;
 export declare function IntraUnitClashVisual(materialId: number): UnitsVisual<IntraUnitClashParams>;
@@ -56,8 +73,25 @@ export declare const InterUnitClashParams: {
     flatShaded: PD.BooleanParam;
     ignoreLight: PD.BooleanParam;
     xrayShaded: PD.BooleanParam;
+    bumpFrequency: PD.Numeric;
+    bumpAmplitude: PD.Numeric;
     alpha: PD.Numeric;
-    quality: PD.Select<"custom" | "auto" | "highest" | "higher" | "high" | "medium" | "low" | "lower" | "lowest">;
+    quality: PD.Select<"auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest">;
+    material: PD.Group<PD.Normalize<{
+        metalness: number;
+        roughness: number;
+        bumpiness: number;
+    }>>;
+    clip: PD.Group<PD.Normalize<{
+        variant: import("../../../mol-util/clip").Clip.Variant;
+        objects: PD.Normalize<{
+            type: any;
+            invert: any;
+            position: any;
+            rotation: any;
+            scale: any;
+        }>[];
+    }>>;
 };
 export declare type InterUnitClashParams = typeof InterUnitClashParams;
 export declare function InterUnitClashVisual(materialId: number): ComplexVisual<InterUnitClashParams>;
@@ -82,8 +116,25 @@ export declare const ClashesParams: {
     flatShaded: PD.BooleanParam;
     ignoreLight: PD.BooleanParam;
     xrayShaded: PD.BooleanParam;
+    bumpFrequency: PD.Numeric;
+    bumpAmplitude: PD.Numeric;
     alpha: PD.Numeric;
-    quality: PD.Select<"custom" | "auto" | "highest" | "higher" | "high" | "medium" | "low" | "lower" | "lowest">;
+    quality: PD.Select<"auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest">;
+    material: PD.Group<PD.Normalize<{
+        metalness: number;
+        roughness: number;
+        bumpiness: number;
+    }>>;
+    clip: PD.Group<PD.Normalize<{
+        variant: import("../../../mol-util/clip").Clip.Variant;
+        objects: PD.Normalize<{
+            type: any;
+            invert: any;
+            position: any;
+            rotation: any;
+            scale: any;
+        }>[];
+    }>>;
 };
 export declare type ClashesParams = typeof ClashesParams;
 export declare function getClashesParams(ctx: ThemeRegistryContext, structure: Structure): {
@@ -107,8 +158,25 @@ export declare function getClashesParams(ctx: ThemeRegistryContext, structure: S
     flatShaded: PD.BooleanParam;
     ignoreLight: PD.BooleanParam;
     xrayShaded: PD.BooleanParam;
+    bumpFrequency: PD.Numeric;
+    bumpAmplitude: PD.Numeric;
     alpha: PD.Numeric;
-    quality: PD.Select<"custom" | "auto" | "highest" | "higher" | "high" | "medium" | "low" | "lower" | "lowest">;
+    quality: PD.Select<"auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest">;
+    material: PD.Group<PD.Normalize<{
+        metalness: number;
+        roughness: number;
+        bumpiness: number;
+    }>>;
+    clip: PD.Group<PD.Normalize<{
+        variant: import("../../../mol-util/clip").Clip.Variant;
+        objects: PD.Normalize<{
+            type: any;
+            invert: any;
+            position: any;
+            rotation: any;
+            scale: any;
+        }>[];
+    }>>;
 };
 export declare type ClashesRepresentation = StructureRepresentation<ClashesParams>;
 export declare function ClashesRepresentation(ctx: RepresentationContext, getParams: RepresentationParamsGetter<Structure, ClashesParams>): ClashesRepresentation;
@@ -133,6 +201,23 @@ export declare const ClashesRepresentationProvider: StructureRepresentationProvi
     flatShaded: PD.BooleanParam;
     ignoreLight: PD.BooleanParam;
     xrayShaded: PD.BooleanParam;
+    bumpFrequency: PD.Numeric;
+    bumpAmplitude: PD.Numeric;
     alpha: PD.Numeric;
-    quality: PD.Select<"custom" | "auto" | "highest" | "higher" | "high" | "medium" | "low" | "lower" | "lowest">;
+    quality: PD.Select<"auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest">;
+    material: PD.Group<PD.Normalize<{
+        metalness: number;
+        roughness: number;
+        bumpiness: number;
+    }>>;
+    clip: PD.Group<PD.Normalize<{
+        variant: import("../../../mol-util/clip").Clip.Variant;
+        objects: PD.Normalize<{
+            type: any;
+            invert: any;
+            position: any;
+            rotation: any;
+            scale: any;
+        }>[];
+    }>>;
 }, ValidationReport.Tag.Clashes>;

package/lib/mol-canvas3d/canvas3d.d.ts

@@ -67,6 +67,7 @@ export declare const Canvas3DParams: {
         outline: PD.NamedParams<PD.Normalize<unknown>, "off"> | PD.NamedParams<PD.Normalize<{
             scale: any;
             threshold: any;
+            color: any;
         }>, "on">;
         antialiasing: PD.NamedParams<PD.Normalize<unknown>, "off"> | PD.NamedParams<PD.Normalize<{
             edgeThreshold: any;
@@ -98,25 +99,26 @@ export declare const Canvas3DParams: {
         selectStrength: number;
         markerPriority: number;
         xrayEdgeFalloff: number;
-        style: PD.NamedParams<PD.Normalize<{
-            lightIntensity: any;
-            ambientIntensity: any;
-            metalness: any;
-            roughness: any;
-            reflectivity: any;
-        }>, "custom"> | PD.NamedParams<PD.Normalize<unknown>, "matte"> | PD.NamedParams<PD.Normalize<unknown>, "flat"> | PD.NamedParams<PD.Normalize<unknown>, "glossy"> | PD.NamedParams<PD.Normalize<unknown>, "metallic"> | PD.NamedParams<PD.Normalize<unknown>, "plastic">;
-        clip: PD.Normalize<{
-            variant: any;
-            objects: any;
-        }>;
+        light: PD.Normalize<{
+            inclination: number;
+            azimuth: number;
+            color: import("../mol-util/color").Color;
+            intensity: number;
+        }>[];
+        ambientColor: import("../mol-util/color").Color;
+        ambientIntensity: number;
     }>>;
     trackball: PD.Group<PD.Normalize<{
         noScroll: boolean;
         rotateSpeed: number;
         zoomSpeed: number;
         panSpeed: number;
-        spin: boolean;
-        spinSpeed: number;
+        animate: PD.NamedParams<PD.Normalize<unknown>, "off"> | PD.NamedParams<PD.Normalize<{
+            speed: any;
+        }>, "spin"> | PD.NamedParams<PD.Normalize<{
+            speed: any;
+            angle: any;
+        }>, "rock">;
         staticMoving: boolean;
         dynamicDampingFactor: number;
         minDistance: number;
@@ -163,7 +165,11 @@ export declare const Canvas3DParams: {
             flipSided: any;
             flatShaded: any;
             xrayShaded: any;
+            bumpFrequency: any;
+            bumpAmplitude: any;
             quality: any;
+            material: any;
+            clip: any;
         }>, "on">;
     }>>;
 };
@@ -213,6 +219,7 @@ export declare const DefaultCanvas3DParams: PD.Values<{
         outline: PD.NamedParams<PD.Normalize<unknown>, "off"> | PD.NamedParams<PD.Normalize<{
             scale: any;
             threshold: any;
+            color: any;
         }>, "on">;
         antialiasing: PD.NamedParams<PD.Normalize<unknown>, "off"> | PD.NamedParams<PD.Normalize<{
             edgeThreshold: any;
@@ -244,25 +251,26 @@ export declare const DefaultCanvas3DParams: PD.Values<{
         selectStrength: number;
         markerPriority: number;
         xrayEdgeFalloff: number;
-        style: PD.NamedParams<PD.Normalize<{
-            lightIntensity: any;
-            ambientIntensity: any;
-            metalness: any;
-            roughness: any;
-            reflectivity: any;
-        }>, "custom"> | PD.NamedParams<PD.Normalize<unknown>, "matte"> | PD.NamedParams<PD.Normalize<unknown>, "flat"> | PD.NamedParams<PD.Normalize<unknown>, "glossy"> | PD.NamedParams<PD.Normalize<unknown>, "metallic"> | PD.NamedParams<PD.Normalize<unknown>, "plastic">;
-        clip: PD.Normalize<{
-            variant: any;
-            objects: any;
-        }>;
+        light: PD.Normalize<{
+            inclination: number;
+            azimuth: number;
+            color: import("../mol-util/color").Color;
+            intensity: number;
+        }>[];
+        ambientColor: import("../mol-util/color").Color;
+        ambientIntensity: number;
     }>>;
     trackball: PD.Group<PD.Normalize<{
         noScroll: boolean;
         rotateSpeed: number;
         zoomSpeed: number;
         panSpeed: number;
-        spin: boolean;
-        spinSpeed: number;
+        animate: PD.NamedParams<PD.Normalize<unknown>, "off"> | PD.NamedParams<PD.Normalize<{
+            speed: any;
+        }>, "spin"> | PD.NamedParams<PD.Normalize<{
+            speed: any;
+            angle: any;
+        }>, "rock">;
         staticMoving: boolean;
         dynamicDampingFactor: number;
         minDistance: number;
@@ -309,7 +317,11 @@ export declare const DefaultCanvas3DParams: PD.Values<{
             flipSided: any;
             flatShaded: any;
             xrayShaded: any;
+            bumpFrequency: any;
+            bumpAmplitude: any;
             quality: any;
+            material: any;
+            clip: any;
         }>, "on">;
     }>>;
 }>;
@@ -370,7 +382,7 @@ interface Canvas3D {
     update(repr?: Representation.Any, keepBoundingSphere?: boolean): void;
     clear(): void;
     syncVisibility(): void;
-    requestDraw(force?: boolean): void;
+    requestDraw(): void;
     /** Reset the timers, used by "animate" */
     resetTime(t: number): void;
     animate(): void;

package/lib/mol-canvas3d/canvas3d.js

@@ -35,6 +35,7 @@ import { Helper } from './helper/helper';
 import { Passes } from './passes/passes';
 import { shallowEqual } from '../mol-util';
 import { MarkingParams } from './passes/marking';
+import { GraphicsRenderVariantsBlended, GraphicsRenderVariantsWboit } from '../mol-gl/webgl/render-item';
 export var Canvas3DParams = {
     camera: PD.Group({
         mode: PD.Select('perspective', PD.arrayToOptions(['perspective', 'orthographic']), { label: 'Camera' }),
@@ -200,7 +201,7 @@ var Canvas3D;
         var width = 128;
         var height = 128;
         updateViewport();
-        var scene = Scene.create(webgl);
+        var scene = Scene.create(webgl, passes.draw.wboitEnabled ? GraphicsRenderVariantsWboit : GraphicsRenderVariantsBlended);
         var camera = new Camera({
             position: Vec3.create(0, 0, 100),
             mode: p.camera.mode,
@@ -252,16 +253,24 @@ var Canvas3D;
                 changed = helper.camera.mark(loci, action) || changed;
                 reprRenderObjects.forEach(function (_, _repr) { changed = _repr.mark(loci, action) || changed; });
             }
-            if (changed && !noDraw) {
-                scene.update(void 0, true);
-                helper.handle.scene.update(void 0, true);
-                helper.camera.scene.update(void 0, true);
-                var prevPickDirty = pickHelper.dirty;
-                draw(true);
-                pickHelper.dirty = prevPickDirty; // marking does not change picking buffers
+            if (changed) {
+                if (noDraw) {
+                    // Even with `noDraw` make sure changes will be rendered.
+                    // Note that with this calling mark (with or without `noDraw`) multiple times
+                    // during a JS event loop iteration will only result in a single render call.
+                    forceNextRender = true;
+                }
+                else {
+                    scene.update(void 0, true);
+                    helper.handle.scene.update(void 0, true);
+                    helper.camera.scene.update(void 0, true);
+                    var prevPickDirty = pickHelper.dirty;
+                    draw({ force: true, allowMulti: true });
+                    pickHelper.dirty = prevPickDirty; // marking does not change picking buffers
+                }
             }
         }
-        function render(force) {
+        function render(force, allowMulti) {
             if (webgl.isContextLost)
                 return false;
             var resized = false;
@@ -285,11 +294,13 @@ var Canvas3D;
                     stereoCamera.update();
                     cam = stereoCamera;
                 }
+                var ctx = { renderer: renderer, camera: cam, scene: scene, helper: helper };
                 if (MultiSamplePass.isEnabled(p.multiSample)) {
-                    multiSampleHelper.render(renderer, cam, scene, helper, true, p.transparentBackground, p);
+                    var forceOn = !cameraChanged && allowMulti && !controls.isAnimating;
+                    multiSampleHelper.render(ctx, p, true, forceOn);
                 }
                 else {
-                    passes.draw.render(renderer, cam, scene, helper, true, p.transparentBackground, p.postprocessing, p.marking);
+                    passes.draw.render(ctx, p, true);
                 }
                 pickHelper.dirty = true;
                 didRender = true;
@@ -300,15 +311,15 @@ var Canvas3D;
         var forceDrawAfterAllCommited = false;
         var currentTime = 0;
         var drawPaused = false;
-        function draw(force) {
+        function draw(options) {
             if (drawPaused)
                 return;
-            if (render(!!force) && notifyDidDraw) {
+            if (render(!!(options === null || options === void 0 ? void 0 : options.force), !!(options === null || options === void 0 ? void 0 : options.allowMulti)) && notifyDidDraw) {
                 didDraw.next(now() - startTime);
             }
         }
-        function requestDraw(force) {
-            forceNextRender = forceNextRender || !!force;
+        function requestDraw() {
+            forceNextRender = true;
         }
         var animationFrameHandle = 0;
         function tick(t, options) {
@@ -318,7 +329,7 @@ var Canvas3D;
             if (options === null || options === void 0 ? void 0 : options.manualDraw) {
                 return;
             }
-            draw(false);
+            draw();
             if (!camera.transition.inTransition && !webgl.isContextLost) {
                 interactionHelper.tick(currentTime);
             }
@@ -356,7 +367,7 @@ var Canvas3D;
                 if (forceDrawAfterAllCommited) {
                     if (helper.debug.isEnabled)
                         helper.debug.update();
-                    draw(true);
+                    draw({ force: true });
                     forceDrawAfterAllCommited = false;
                 }
                 commited.next(now());
@@ -391,7 +402,7 @@ var Canvas3D;
                 return true;
             if (camera.transition.inTransition || nextCameraResetSnapshot)
                 return false;
-            var cameraSphereOverlapsNone = true;
+            var cameraSphereOverlapsNone = true, isEmpty = true;
             Sphere3D.set(cameraSphere, camera.state.target, camera.state.radius);
             // check if any renderable has moved outside of the old bounding sphere
             // and if no renderable is overlapping with the camera sphere
@@ -402,13 +413,14 @@ var Canvas3D;
                 var b = r.values.boundingSphere.ref.value;
                 if (!b.radius)
                     continue;
+                isEmpty = false;
                 var cameraDist = Vec3.distance(cameraSphere.center, b.center);
                 if ((cameraDist > cameraSphere.radius || cameraDist > b.radius || b.radius > camera.state.radiusMax) && !Sphere3D.includes(oldBoundingSphereVisible, b))
                     return true;
                 if (Sphere3D.overlaps(cameraSphere, b))
                     cameraSphereOverlapsNone = false;
             }
-            return cameraSphereOverlapsNone;
+            return cameraSphereOverlapsNone || (!isEmpty && cameraSphere.radius <= 0.1);
         }
         var sceneCommitTimeoutMs = 250;
         function commitScene(isSynchronous) {
@@ -524,11 +536,11 @@ var Canvas3D;
         }
         var contextRestoredSub = contextRestored.subscribe(function () {
             pickHelper.dirty = true;
-            draw(true);
+            draw({ force: true });
             // Unclear why, but in Chrome with wboit enabled the first `draw` only clears
             // the drawingBuffer. Note that in Firefox the drawingBuffer is preserved after
             // context loss so it is unclear if it behaves the same.
-            draw(true);
+            draw({ force: true });
         });
         var resized = new BehaviorSubject(0);
         function handleResize(draw) {
@@ -537,7 +549,7 @@ var Canvas3D;
             updateViewport();
             syncViewport();
             if (draw)
-                requestDraw(true);
+                requestDraw();
             resized.next(+new Date());
         }
         return {
@@ -562,7 +574,7 @@ var Canvas3D;
                 reprRenderObjects.clear();
                 scene.clear();
                 helper.debug.clear();
-                requestDraw(true);
+                requestDraw();
                 reprCount.next(reprRenderObjects.size);
             },
             syncVisibility: function () {
@@ -574,7 +586,7 @@ var Canvas3D;
                     if (helper.debug.isEnabled)
                         helper.debug.update();
                 }
-                requestDraw(true);
+                requestDraw();
             },
             requestDraw: requestDraw,
             tick: tick,
@@ -671,7 +683,7 @@ var Canvas3D;
                     p.camera.stereo.name = 'off';
                 }
                 if (!doNotRequestDraw) {
-                    requestDraw(true);
+                    requestDraw();
                 }
             },
             getImagePass: function (props) {

package/lib/mol-canvas3d/controls/trackball.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) 2018-2021 mol* contributors, licensed under MIT, See LICENSE file for more info.
+ * Copyright (c) 2018-2022 mol* contributors, licensed under MIT, See LICENSE file for more info.
  *
  * @author Alexander Rose <alexander.rose@weirdbyte.de>
  * @author David Sehnal <david.sehnal@gmail.com>
@@ -28,8 +28,12 @@ export declare const TrackballControlsParams: {
     rotateSpeed: PD.Numeric;
     zoomSpeed: PD.Numeric;
     panSpeed: PD.Numeric;
-    spin: PD.BooleanParam;
-    spinSpeed: PD.Numeric;
+    animate: PD.Mapped<PD.NamedParams<PD.Normalize<unknown>, "off"> | PD.NamedParams<PD.Normalize<{
+        speed: number;
+    }>, "spin"> | PD.NamedParams<PD.Normalize<{
+        speed: number;
+        angle: number;
+    }>, "rock">>;
     staticMoving: PD.BooleanParam;
     dynamicDampingFactor: PD.Numeric;
     minDistance: PD.Numeric;
@@ -61,7 +65,8 @@ export declare const TrackballControlsParams: {
 export declare type TrackballControlsProps = PD.Values<typeof TrackballControlsParams>;
 export { TrackballControls };
 interface TrackballControls {
-    viewport: Viewport;
+    readonly viewport: Viewport;
+    readonly isAnimating: boolean;
     readonly props: Readonly<TrackballControlsProps>;
     setProps: (props: Partial<TrackballControlsProps>) => void;
     start: (t: number) => void;