/** * Copyright (c) 2018-2026 mol* contributors, licensed under MIT, See LICENSE file for more info. * * @author Alexander Rose * @author Gianluca Tomasello */ import { ParamDefinition as PD } from '../../mol-util/param-definition.js'; import { Visual, VisualContext } from '../visual.js'; import { Structure } from '../../mol-model/structure.js'; import { Geometry, GeometryUtils } from '../../mol-geo/geometry/geometry.js'; import { LocationIterator } from '../../mol-geo/util/location-iterator.js'; import { Theme } from '../../mol-theme/theme.js'; import { RenderObjectValues } from '../../mol-gl/render-object.js'; import { PickingId } from '../../mol-geo/geometry/picking.js'; import { Loci } from '../../mol-model/loci.js'; import { Interval } from '../../mol-data/int.js'; import { VisualUpdateState } from '../util.js'; import { Mesh } from '../../mol-geo/geometry/mesh/mesh.js'; import { Cylinders } from '../../mol-geo/geometry/cylinders/cylinders.js'; import { Lines } from '../../mol-geo/geometry/lines/lines.js'; import { Text } from '../../mol-geo/geometry/text/text.js'; import { DirectVolume } from '../../mol-geo/geometry/direct-volume/direct-volume.js'; import { StructureParams } from './params.js'; import { TextureMesh } from '../../mol-geo/geometry/texture-mesh/texture-mesh.js'; import { WebGLContext } from '../../mol-gl/webgl/context.js'; import { Spheres } from '../../mol-geo/geometry/spheres/spheres.js'; import { Points } from '../../mol-geo/geometry/points/points.js'; import { Image } from '../../mol-geo/geometry/image/image.js'; export interface ComplexVisual

extends Visual { } interface ComplexVisualBuilder

{ defaultProps: PD.Values

; createGeometry(ctx: VisualContext, structure: Structure, theme: Theme, props: PD.Values

, geometry?: G): Promise | G; createLocationIterator(structure: Structure, props: PD.Values

): LocationIterator; getLoci(pickingId: PickingId, structure: Structure, id: number): Loci; eachLocation(loci: Loci, structure: Structure, apply: (interval: Interval) => boolean, isMarking: boolean): boolean; setUpdateState(state: VisualUpdateState, newProps: PD.Values

, currentProps: PD.Values

, newTheme: Theme, currentTheme: Theme, newStructure: Structure, currentStructure: Structure): void; mustRecreate?: (structure: Structure, props: PD.Values

) => boolean; processValues?: (values: RenderObjectValues, geometry: G, props: PD.Values

, theme: Theme, webgl?: WebGLContext) => void; dispose?: (geometry: G) => void; } interface ComplexVisualGeometryBuilder

extends ComplexVisualBuilder { geometryUtils: GeometryUtils; } export declare function ComplexVisual>(builder: ComplexVisualGeometryBuilder, materialId: number): ComplexVisual

; export declare const ComplexMeshParams: { unitKinds: PD.MultiSelect<"spheres" | "gaussians" | "atomic">; includeParent: PD.BooleanParam; doubleSided: PD.BooleanParam; flipSided: PD.BooleanParam; flatShaded: PD.BooleanParam; ignoreLight: PD.BooleanParam; celShaded: PD.BooleanParam; xrayShaded: PD.Select; transparentBackfaces: PD.Select<"off" | "on" | "opaque">; bumpFrequency: PD.Numeric; bumpAmplitude: PD.Numeric; interior: PD.Group; substanceStrength: number; }>>; alpha: PD.Numeric; quality: PD.Select<"auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest">; material: PD.Group>; clip: PD.Group[]; }>>; emissive: PD.Numeric; density: PD.Numeric; instanceGranularity: PD.BooleanParam; lod: PD.Vec3; cellSize: PD.Numeric; batchSize: PD.Numeric; }; export type ComplexMeshParams = typeof ComplexMeshParams; export interface ComplexMeshVisualBuilder

extends ComplexVisualBuilder { } export declare function ComplexMeshVisual

(builder: ComplexMeshVisualBuilder

, materialId: number): ComplexVisual

; export declare const ComplexSpheresParams: { unitKinds: PD.MultiSelect<"spheres" | "gaussians" | "atomic">; includeParent: PD.BooleanParam; sizeFactor: PD.Numeric; doubleSided: PD.BooleanParam; ignoreLight: PD.BooleanParam; celShaded: PD.BooleanParam; xrayShaded: PD.Select; transparentBackfaces: PD.Select<"off" | "on" | "opaque">; solidInterior: PD.BooleanParam; clipPrimitive: PD.BooleanParam; approximate: PD.BooleanParam; alphaThickness: PD.Numeric; bumpFrequency: PD.Numeric; bumpAmplitude: PD.Numeric; interior: PD.Group; substanceStrength: number; }>>; lodLevels: PD.ObjectList>; alpha: PD.Numeric; quality: PD.Select<"auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest">; material: PD.Group>; clip: PD.Group[]; }>>; emissive: PD.Numeric; density: PD.Numeric; instanceGranularity: PD.BooleanParam; lod: PD.Vec3; cellSize: PD.Numeric; batchSize: PD.Numeric; }; export type ComplexSpheresParams = typeof ComplexSpheresParams; export interface ComplexSpheresVisualBuilder

extends ComplexVisualBuilder { } export declare function ComplexSpheresVisual

(builder: ComplexSpheresVisualBuilder

, materialId: number): ComplexVisual

; export declare const ComplexCylindersParams: { unitKinds: PD.MultiSelect<"spheres" | "gaussians" | "atomic">; includeParent: PD.BooleanParam; sizeFactor: PD.Numeric; sizeAspectRatio: PD.Numeric; doubleSided: PD.BooleanParam; ignoreLight: PD.BooleanParam; celShaded: PD.BooleanParam; xrayShaded: PD.Select; transparentBackfaces: PD.Select<"off" | "on" | "opaque">; solidInterior: PD.BooleanParam; bumpFrequency: PD.Numeric; bumpAmplitude: PD.Numeric; interior: PD.Group; substanceStrength: number; }>>; colorMode: PD.Select<"default" | "interpolate">; alpha: PD.Numeric; quality: PD.Select<"auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest">; material: PD.Group>; clip: PD.Group[]; }>>; emissive: PD.Numeric; density: PD.Numeric; instanceGranularity: PD.BooleanParam; lod: PD.Vec3; cellSize: PD.Numeric; batchSize: PD.Numeric; }; export type ComplexCylindersParams = typeof ComplexCylindersParams; export interface ComplexCylindersVisualBuilder

extends ComplexVisualBuilder { } export declare function ComplexCylindersVisual

(builder: ComplexCylindersVisualBuilder

, materialId: number): ComplexVisual

; export declare const ComplexPointsParams: { unitKinds: PD.MultiSelect<"spheres" | "gaussians" | "atomic">; includeParent: PD.BooleanParam; sizeFactor: PD.Numeric; pointSizeAttenuation: PD.BooleanParam; pointStyle: PD.Select<"square" | "circle" | "fuzzy">; alpha: PD.Numeric; quality: PD.Select<"auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest">; material: PD.Group>; clip: PD.Group[]; }>>; emissive: PD.Numeric; density: PD.Numeric; instanceGranularity: PD.BooleanParam; lod: PD.Vec3; cellSize: PD.Numeric; batchSize: PD.Numeric; }; export type ComplexPointsParams = typeof ComplexPointsParams; export interface ComplexPointsVisualBuilder

extends ComplexVisualBuilder { } export declare function ComplexPointsVisual

(builder: ComplexPointsVisualBuilder

, materialId: number): ComplexVisual

; export declare const ComplexLinesParams: { unitKinds: PD.MultiSelect<"spheres" | "gaussians" | "atomic">; includeParent: PD.BooleanParam; sizeFactor: PD.Numeric; lineSizeAttenuation: PD.BooleanParam; alpha: PD.Numeric; quality: PD.Select<"auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest">; material: PD.Group>; clip: PD.Group[]; }>>; emissive: PD.Numeric; density: PD.Numeric; instanceGranularity: PD.BooleanParam; lod: PD.Vec3; cellSize: PD.Numeric; batchSize: PD.Numeric; }; export type ComplexLinesParams = typeof ComplexLinesParams; export interface ComplexLinesVisualBuilder

extends ComplexVisualBuilder { } export declare function ComplexLinesVisual

(builder: ComplexLinesVisualBuilder

, materialId: number): ComplexVisual

; export declare const ComplexTextParams: { unitKinds: PD.MultiSelect<"spheres" | "gaussians" | "atomic">; includeParent: PD.BooleanParam; sizeFactor: PD.Numeric; borderWidth: PD.Numeric; borderColor: PD.Color; offsetX: PD.Numeric; offsetY: PD.Numeric; offsetZ: PD.Numeric; background: PD.BooleanParam; backgroundMargin: PD.Numeric; backgroundColor: PD.Color; backgroundOpacity: PD.Numeric; tether: PD.BooleanParam; tetherLength: PD.Numeric; tetherBaseWidth: PD.Numeric; attachment: PD.Select<"bottom-left" | "bottom-center" | "bottom-right" | "middle-left" | "middle-center" | "middle-right" | "top-left" | "top-center" | "top-right">; fontFamily: PD.Select; fontQuality: PD.Select; fontStyle: PD.Select; fontVariant: PD.Select; fontWeight: PD.Select; alpha: PD.Numeric; quality: PD.Select<"auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest">; material: PD.Group>; clip: PD.Group[]; }>>; emissive: PD.Numeric; density: PD.Numeric; instanceGranularity: PD.BooleanParam; lod: PD.Vec3; cellSize: PD.Numeric; batchSize: PD.Numeric; }; export type ComplexTextParams = typeof ComplexTextParams; export interface ComplexTextVisualBuilder

extends ComplexVisualBuilder { } export declare function ComplexTextVisual

(builder: ComplexTextVisualBuilder

, materialId: number): ComplexVisual

; export declare const ComplexDirectVolumeParams: { unitKinds: PD.MultiSelect<"spheres" | "gaussians" | "atomic">; includeParent: PD.BooleanParam; ignoreLight: PD.BooleanParam; celShaded: PD.BooleanParam; xrayShaded: PD.Select; controlPoints: PD.LineGraph; stepsPerCell: PD.Numeric; jumpLength: PD.Numeric; alpha: PD.Numeric; quality: PD.Select<"auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest">; material: PD.Group>; clip: PD.Group[]; }>>; emissive: PD.Numeric; density: PD.Numeric; instanceGranularity: PD.BooleanParam; lod: PD.Vec3; cellSize: PD.Numeric; batchSize: PD.Numeric; }; export type ComplexDirectVolumeParams = typeof ComplexDirectVolumeParams; export interface ComplexDirectVolumeVisualBuilder

extends ComplexVisualBuilder { } export declare function ComplexDirectVolumeVisual

(builder: ComplexDirectVolumeVisualBuilder

, materialId: number): ComplexVisual

; export declare const ComplexTextureMeshParams: { unitKinds: PD.MultiSelect<"spheres" | "gaussians" | "atomic">; includeParent: PD.BooleanParam; doubleSided: PD.BooleanParam; flipSided: PD.BooleanParam; flatShaded: PD.BooleanParam; ignoreLight: PD.BooleanParam; celShaded: PD.BooleanParam; xrayShaded: PD.Select; transparentBackfaces: PD.Select<"off" | "on" | "opaque">; bumpFrequency: PD.Numeric; bumpAmplitude: PD.Numeric; interior: PD.Group; substanceStrength: number; }>>; alpha: PD.Numeric; quality: PD.Select<"auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest">; material: PD.Group>; clip: PD.Group[]; }>>; emissive: PD.Numeric; density: PD.Numeric; instanceGranularity: PD.BooleanParam; lod: PD.Vec3; cellSize: PD.Numeric; batchSize: PD.Numeric; }; export type ComplexTextureMeshParams = typeof ComplexTextureMeshParams; export interface ComplexTextureMeshVisualBuilder

extends ComplexVisualBuilder { } export declare function ComplexTextureMeshVisual

(builder: ComplexTextureMeshVisualBuilder

, materialId: number): ComplexVisual

; export declare const ComplexImageParams: { unitKinds: PD.MultiSelect<"spheres" | "gaussians" | "atomic">; includeParent: PD.BooleanParam; interpolation: PD.Select<"nearest" | "catmulrom" | "mitchell" | "bspline">; alpha: PD.Numeric; quality: PD.Select<"auto" | "medium" | "high" | "low" | "custom" | "highest" | "higher" | "lower" | "lowest">; material: PD.Group>; clip: PD.Group[]; }>>; emissive: PD.Numeric; density: PD.Numeric; instanceGranularity: PD.BooleanParam; lod: PD.Vec3; cellSize: PD.Numeric; batchSize: PD.Numeric; }; export type ComplexImageParams = typeof ComplexImageParams; export interface ComplexImageVisualBuilder

extends ComplexVisualBuilder { } export declare function ComplexImageVisual

(builder: ComplexImageVisualBuilder

, materialId: number): ComplexVisual

; export {};