/** * Copyright (c) 2020-2022 mol* contributors, licensed under MIT, See LICENSE file for more info. * * @author Alexander Rose */ import { ValueCell } from '../../../mol-util'; import { Mat4, Vec3, Vec4 } from '../../../mol-math/linear-algebra'; import { transformPositionArray, GroupMapping, createGroupMapping } from '../../util'; import { GeometryUtils } from '../geometry'; import { createColors } from '../color-data'; import { createMarkers } from '../marker-data'; import { createSizes, getMaxSize } from '../size-data'; import { TransformData } from '../transform-data'; import { LocationIterator, PositionLocation } from '../../util/location-iterator'; import { ParamDefinition as PD } from '../../../mol-util/param-definition'; import { calculateInvariantBoundingSphere, calculateTransformBoundingSphere } from '../../../mol-gl/renderable/util'; import { Sphere3D } from '../../../mol-math/geometry'; import { Theme } from '../../../mol-theme/theme'; import { Color } from '../../../mol-util/color'; import { BaseGeometry } from '../base'; import { createEmptyOverpaint } from '../overpaint-data'; import { createEmptyTransparency } from '../transparency-data'; import { hashFnv32a } from '../../../mol-data/util'; import { createEmptyClipping } from '../clipping-data'; import { CylindersValues } from '../../../mol-gl/renderable/cylinders'; import { RenderableState } from '../../../mol-gl/renderable'; import { createEmptySubstance } from '../substance-data'; export interface Cylinders { readonly kind: 'cylinders', /** Number of cylinders */ cylinderCount: number, /** Mapping buffer as array of uvw values wrapped in a value cell */ readonly mappingBuffer: ValueCell, /** Index buffer as array of vertex index triplets wrapped in a value cell */ readonly indexBuffer: ValueCell, /** Group buffer as array of group ids for each vertex wrapped in a value cell */ readonly groupBuffer: ValueCell, /** Cylinder start buffer as array of xyz values wrapped in a value cell */ readonly startBuffer: ValueCell, /** Cylinder end buffer as array of xyz values wrapped in a value cell */ readonly endBuffer: ValueCell, /** Cylinder scale buffer as array of scaling factors wrapped in a value cell */ readonly scaleBuffer: ValueCell, /** Cylinder cap buffer as array of cap flags wrapped in a value cell */ readonly capBuffer: ValueCell, /** Bounding sphere of the cylinders */ readonly boundingSphere: Sphere3D /** Maps group ids to cylinder indices */ readonly groupMapping: GroupMapping setBoundingSphere(boundingSphere: Sphere3D): void } export namespace Cylinders { export function create(mappings: Float32Array, indices: Uint32Array, groups: Float32Array, starts: Float32Array, ends: Float32Array, scales: Float32Array, caps: Float32Array, cylinderCount: number, cylinders?: Cylinders): Cylinders { return cylinders ? update(mappings, indices, groups, starts, ends, scales, caps, cylinderCount, cylinders) : fromArrays(mappings, indices, groups, starts, ends, scales, caps, cylinderCount); } export function createEmpty(cylinders?: Cylinders): Cylinders { const mb = cylinders ? cylinders.mappingBuffer.ref.value : new Float32Array(0); const ib = cylinders ? cylinders.indexBuffer.ref.value : new Uint32Array(0); const gb = cylinders ? cylinders.groupBuffer.ref.value : new Float32Array(0); const sb = cylinders ? cylinders.startBuffer.ref.value : new Float32Array(0); const eb = cylinders ? cylinders.endBuffer.ref.value : new Float32Array(0); const ab = cylinders ? cylinders.scaleBuffer.ref.value : new Float32Array(0); const cb = cylinders ? cylinders.capBuffer.ref.value : new Float32Array(0); return create(mb, ib, gb, sb, eb, ab, cb, 0, cylinders); } function hashCode(cylinders: Cylinders) { return hashFnv32a([ cylinders.cylinderCount, cylinders.mappingBuffer.ref.version, cylinders.indexBuffer.ref.version, cylinders.groupBuffer.ref.version, cylinders.startBuffer.ref.version, cylinders.endBuffer.ref.version, cylinders.scaleBuffer.ref.version, cylinders.capBuffer.ref.version ]); } function fromArrays(mappings: Float32Array, indices: Uint32Array, groups: Float32Array, starts: Float32Array, ends: Float32Array, scales: Float32Array, caps: Float32Array, cylinderCount: number): Cylinders { const boundingSphere = Sphere3D(); let groupMapping: GroupMapping; let currentHash = -1; let currentGroup = -1; const cylinders = { kind: 'cylinders' as const, cylinderCount, mappingBuffer: ValueCell.create(mappings), indexBuffer: ValueCell.create(indices), groupBuffer: ValueCell.create(groups), startBuffer: ValueCell.create(starts), endBuffer: ValueCell.create(ends), scaleBuffer: ValueCell.create(scales), capBuffer: ValueCell.create(caps), get boundingSphere() { const newHash = hashCode(cylinders); if (newHash !== currentHash) { const s = calculateInvariantBoundingSphere(cylinders.startBuffer.ref.value, cylinders.cylinderCount * 6, 6); const e = calculateInvariantBoundingSphere(cylinders.endBuffer.ref.value, cylinders.cylinderCount * 6, 6); Sphere3D.expandBySphere(boundingSphere, s, e); currentHash = newHash; } return boundingSphere; }, get groupMapping() { if (cylinders.groupBuffer.ref.version !== currentGroup) { groupMapping = createGroupMapping(cylinders.groupBuffer.ref.value, cylinders.cylinderCount, 6); currentGroup = cylinders.groupBuffer.ref.version; } return groupMapping; }, setBoundingSphere(sphere: Sphere3D) { Sphere3D.copy(boundingSphere, sphere); currentHash = hashCode(cylinders); } }; return cylinders; } function update(mappings: Float32Array, indices: Uint32Array, groups: Float32Array, starts: Float32Array, ends: Float32Array, scales: Float32Array, caps: Float32Array, cylinderCount: number, cylinders: Cylinders) { if (cylinderCount > cylinders.cylinderCount) { ValueCell.update(cylinders.mappingBuffer, mappings); ValueCell.update(cylinders.indexBuffer, indices); } cylinders.cylinderCount = cylinderCount; ValueCell.update(cylinders.groupBuffer, groups); ValueCell.update(cylinders.startBuffer, starts); ValueCell.update(cylinders.endBuffer, ends); ValueCell.update(cylinders.scaleBuffer, scales); ValueCell.update(cylinders.capBuffer, caps); return cylinders; } export function transform(cylinders: Cylinders, t: Mat4) { const start = cylinders.startBuffer.ref.value; transformPositionArray(t, start, 0, cylinders.cylinderCount * 6); ValueCell.update(cylinders.startBuffer, start); const end = cylinders.endBuffer.ref.value; transformPositionArray(t, end, 0, cylinders.cylinderCount * 6); ValueCell.update(cylinders.endBuffer, end); } // export const Params = { ...BaseGeometry.Params, sizeFactor: PD.Numeric(1, { min: 0, max: 10, step: 0.1 }), sizeAspectRatio: PD.Numeric(1, { min: 0, max: 3, step: 0.01 }), doubleSided: PD.Boolean(false, BaseGeometry.CustomQualityParamInfo), ignoreLight: PD.Boolean(false, BaseGeometry.ShadingCategory), xrayShaded: PD.Boolean(false, BaseGeometry.ShadingCategory), transparentBackfaces: PD.Select('off', PD.arrayToOptions(['off', 'on', 'opaque']), BaseGeometry.ShadingCategory), bumpFrequency: PD.Numeric(0, { min: 0, max: 10, step: 0.1 }, BaseGeometry.ShadingCategory), bumpAmplitude: PD.Numeric(1, { min: 0, max: 5, step: 0.1 }, BaseGeometry.ShadingCategory), }; export type Params = typeof Params export const Utils: GeometryUtils = { Params, createEmpty, createValues, createValuesSimple, updateValues, updateBoundingSphere, createRenderableState, updateRenderableState, createPositionIterator }; function createPositionIterator(cylinders: Cylinders, transform: TransformData): LocationIterator { const groupCount = cylinders.cylinderCount * 6; const instanceCount = transform.instanceCount.ref.value; const location = PositionLocation(); const p = location.position; const s = cylinders.startBuffer.ref.value; const e = cylinders.endBuffer.ref.value; const m = transform.aTransform.ref.value; const getLocation = (groupIndex: number, instanceIndex: number) => { const v = groupIndex % 6 === 0 ? s : e; if (instanceIndex < 0) { Vec3.fromArray(p, v, groupIndex * 3); } else { Vec3.transformMat4Offset(p, v, m, 0, groupIndex * 3, instanceIndex * 16); } return location; }; return LocationIterator(groupCount, instanceCount, 2, getLocation); } function createValues(cylinders: Cylinders, transform: TransformData, locationIt: LocationIterator, theme: Theme, props: PD.Values): CylindersValues { const { instanceCount, groupCount } = locationIt; const positionIt = createPositionIterator(cylinders, transform); const color = createColors(locationIt, positionIt, theme.color); const size = createSizes(locationIt, theme.size); const marker = createMarkers(instanceCount * groupCount); const overpaint = createEmptyOverpaint(); const transparency = createEmptyTransparency(); const material = createEmptySubstance(); const clipping = createEmptyClipping(); const counts = { drawCount: cylinders.cylinderCount * 4 * 3, vertexCount: cylinders.cylinderCount * 6, groupCount, instanceCount }; const padding = getMaxSize(size) * props.sizeFactor; const invariantBoundingSphere = Sphere3D.clone(cylinders.boundingSphere); const boundingSphere = calculateTransformBoundingSphere(invariantBoundingSphere, transform.aTransform.ref.value, instanceCount); return { dGeometryType: ValueCell.create('cylinders'), aMapping: cylinders.mappingBuffer, aGroup: cylinders.groupBuffer, aStart: cylinders.startBuffer, aEnd: cylinders.endBuffer, aScale: cylinders.scaleBuffer, aCap: cylinders.capBuffer, elements: cylinders.indexBuffer, boundingSphere: ValueCell.create(boundingSphere), invariantBoundingSphere: ValueCell.create(invariantBoundingSphere), uInvariantBoundingSphere: ValueCell.create(Vec4.ofSphere(invariantBoundingSphere)), ...color, ...size, ...marker, ...overpaint, ...transparency, ...material, ...clipping, ...transform, padding: ValueCell.create(padding), ...BaseGeometry.createValues(props, counts), uSizeFactor: ValueCell.create(props.sizeFactor * props.sizeAspectRatio), uDoubleSided: ValueCell.create(props.doubleSided), dIgnoreLight: ValueCell.create(props.ignoreLight), dXrayShaded: ValueCell.create(props.xrayShaded), dTransparentBackfaces: ValueCell.create(props.transparentBackfaces), uBumpFrequency: ValueCell.create(props.bumpFrequency), uBumpAmplitude: ValueCell.create(props.bumpAmplitude), }; } function createValuesSimple(cylinders: Cylinders, props: Partial>, colorValue: Color, sizeValue: number, transform?: TransformData) { const s = BaseGeometry.createSimple(colorValue, sizeValue, transform); const p = { ...PD.getDefaultValues(Params), ...props }; return createValues(cylinders, s.transform, s.locationIterator, s.theme, p); } function updateValues(values: CylindersValues, props: PD.Values) { BaseGeometry.updateValues(values, props); ValueCell.updateIfChanged(values.uSizeFactor, props.sizeFactor * props.sizeAspectRatio); ValueCell.updateIfChanged(values.uDoubleSided, props.doubleSided); ValueCell.updateIfChanged(values.dIgnoreLight, props.ignoreLight); ValueCell.updateIfChanged(values.dXrayShaded, props.xrayShaded); ValueCell.updateIfChanged(values.dTransparentBackfaces, props.transparentBackfaces); ValueCell.updateIfChanged(values.uBumpFrequency, props.bumpFrequency); ValueCell.updateIfChanged(values.uBumpAmplitude, props.bumpAmplitude); } function updateBoundingSphere(values: CylindersValues, cylinders: Cylinders) { const invariantBoundingSphere = Sphere3D.clone(cylinders.boundingSphere); const boundingSphere = calculateTransformBoundingSphere(invariantBoundingSphere, values.aTransform.ref.value, values.instanceCount.ref.value); if (!Sphere3D.equals(boundingSphere, values.boundingSphere.ref.value)) { ValueCell.update(values.boundingSphere, boundingSphere); } if (!Sphere3D.equals(invariantBoundingSphere, values.invariantBoundingSphere.ref.value)) { ValueCell.update(values.invariantBoundingSphere, invariantBoundingSphere); ValueCell.update(values.uInvariantBoundingSphere, Vec4.fromSphere(values.uInvariantBoundingSphere.ref.value, invariantBoundingSphere)); } } function createRenderableState(props: PD.Values): RenderableState { const state = BaseGeometry.createRenderableState(props); updateRenderableState(state, props); return state; } function updateRenderableState(state: RenderableState, props: PD.Values) { BaseGeometry.updateRenderableState(state, props); state.opaque = state.opaque && !props.xrayShaded; state.writeDepth = state.opaque; } }