/** * Copyright (c) 2019 mol* contributors, licensed under MIT, See LICENSE file for more info. * * @author Alexander Rose */ import { ParamDefinition as PD } from 'mol-util/param-definition'; import { ValueCell } from 'mol-util'; import { GeometryUtils } from '../geometry'; import { LocationIterator } from 'mol-geo/util/location-iterator'; import { TransformData } from '../transform-data'; import { Theme } from 'mol-theme/theme'; import { createColors } from '../color-data'; import { createSizes, getMaxSize } from '../size-data'; import { createMarkers } from '../marker-data'; import { ColorNames } from 'mol-util/color/tables'; import { Sphere3D } from 'mol-math/geometry'; import { calculateBoundingSphere, TextureImage, createTextureImage } from 'mol-gl/renderable/util'; import { TextValues } from 'mol-gl/renderable/text'; import { Color } from 'mol-util/color'; import { Vec3 } from 'mol-math/linear-algebra'; import { FontAtlasParams } from './font-atlas'; import { RenderableState } from 'mol-gl/renderable'; import { clamp } from 'mol-math/interpolate'; import { createRenderObject as _createRenderObject } from 'mol-gl/render-object'; import { BaseGeometry } from '../base'; import { createEmptyOverpaint } from '../overpaint-data'; type TextAttachment = ( 'bottom-left' | 'bottom-center' | 'bottom-right' | 'middle-left' | 'middle-center' | 'middle-right' | 'top-left' | 'top-center' | 'top-right' ) /** Text */ export interface Text { readonly kind: 'text', /** Number of characters in the text */ readonly charCount: number, /** Font Atlas */ readonly fontTexture: ValueCell>, /** Center buffer as array of xyz values wrapped in a value cell */ readonly centerBuffer: ValueCell, /** Mapping buffer as array of xy values wrapped in a value cell */ readonly mappingBuffer: ValueCell, /** Depth buffer as array of z values wrapped in a value cell */ readonly depthBuffer: ValueCell, /** Index buffer as array of center 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, /** Texture coordinates buffer as array of uv values wrapped in a value cell */ readonly tcoordBuffer: ValueCell, } export namespace Text { export function createEmpty(text?: Text): Text { const ft = text ? text.fontTexture.ref.value : createTextureImage(0, 1) const cb = text ? text.centerBuffer.ref.value : new Float32Array(0) const mb = text ? text.mappingBuffer.ref.value : new Float32Array(0) const db = text ? text.depthBuffer.ref.value : new Float32Array(0) const ib = text ? text.indexBuffer.ref.value : new Uint32Array(0) const gb = text ? text.groupBuffer.ref.value : new Float32Array(0) const tb = text ? text.tcoordBuffer.ref.value : new Float32Array(0) return { kind: 'text', charCount: 0, fontTexture: text ? ValueCell.update(text.fontTexture, ft) : ValueCell.create(ft), centerBuffer: text ? ValueCell.update(text.centerBuffer, cb) : ValueCell.create(cb), mappingBuffer: text ? ValueCell.update(text.mappingBuffer, mb) : ValueCell.create(mb), depthBuffer: text ? ValueCell.update(text.depthBuffer, db) : ValueCell.create(db), indexBuffer: text ? ValueCell.update(text.indexBuffer, ib) : ValueCell.create(ib), groupBuffer: text ? ValueCell.update(text.groupBuffer, gb) : ValueCell.create(gb), tcoordBuffer: text ? ValueCell.update(text.tcoordBuffer, tb) : ValueCell.create(tb) } } export const Params = { ...BaseGeometry.Params, ...FontAtlasParams, sizeFactor: PD.Numeric(1, { min: 0, max: 10, step: 0.1 }), borderWidth: PD.Numeric(0, { min: 0, max: 0.5, step: 0.01 }), borderColor: PD.Color(ColorNames.grey), offsetX: PD.Numeric(0, { min: 0, max: 10, step: 0.1 }), offsetY: PD.Numeric(0, { min: 0, max: 10, step: 0.1 }), offsetZ: PD.Numeric(0, { min: 0, max: 10, step: 0.1 }), background: PD.Boolean(false), backgroundMargin: PD.Numeric(0.2, { min: 0, max: 1, step: 0.01 }), backgroundColor: PD.Color(ColorNames.grey), backgroundOpacity: PD.Numeric(1, { min: 0, max: 1, step: 0.01 }), tether: PD.Boolean(false), tetherLength: PD.Numeric(1, { min: 0, max: 5, step: 0.1 }), tetherBaseWidth: PD.Numeric(0.3, { min: 0, max: 1, step: 0.01 }), attachment: PD.Select('middle-center', [ ['bottom-left', 'bottom-left'], ['bottom-center', 'bottom-center'], ['bottom-right', 'bottom-right'], ['middle-left', 'middle-left'], ['middle-center', 'middle-center'], ['middle-right', 'middle-right'], ['top-left', 'top-left'], ['top-center', 'top-center'], ['top-right', 'top-right'], ] as [TextAttachment, string][]), } export type Params = typeof Params export const Utils: GeometryUtils = { Params, createEmpty, createValues, createValuesSimple, updateValues, updateBoundingSphere, createRenderableState, updateRenderableState, } function createValues(text: Text, transform: TransformData, locationIt: LocationIterator, theme: Theme, props: PD.Values): TextValues { const { instanceCount, groupCount } = locationIt if (instanceCount !== transform.instanceCount.ref.value) { throw new Error('instanceCount values in TransformData and LocationIterator differ') } const color = createColors(locationIt, theme.color) const size = createSizes(locationIt, theme.size) const marker = createMarkers(instanceCount * groupCount) const overpaint = createEmptyOverpaint() const counts = { drawCount: text.charCount * 2 * 3, groupCount, instanceCount } const padding = getPadding(text.mappingBuffer.ref.value, text.depthBuffer.ref.value, text.charCount, getMaxSize(size)) const { boundingSphere, invariantBoundingSphere } = calculateBoundingSphere( text.centerBuffer.ref.value, text.charCount * 4, transform.aTransform.ref.value, instanceCount, padding ) return { aPosition: text.centerBuffer, aMapping: text.mappingBuffer, aDepth: text.depthBuffer, aGroup: text.groupBuffer, elements: text.indexBuffer, boundingSphere: ValueCell.create(boundingSphere), invariantBoundingSphere: ValueCell.create(invariantBoundingSphere), ...color, ...size, ...marker, ...overpaint, ...transform, aTexCoord: text.tcoordBuffer, tFont: text.fontTexture, padding: ValueCell.create(padding), ...BaseGeometry.createValues(props, counts), uSizeFactor: ValueCell.create(props.sizeFactor), uBorderWidth: ValueCell.create(clamp(props.borderWidth / 2, 0, 0.5)), uBorderColor: ValueCell.create(Color.toArrayNormalized(props.borderColor, Vec3.zero(), 0)), uOffsetX: ValueCell.create(props.offsetX), uOffsetY: ValueCell.create(props.offsetY), uOffsetZ: ValueCell.create(props.offsetZ), uBackgroundColor: ValueCell.create(Color.toArrayNormalized(props.backgroundColor, Vec3.zero(), 0)), uBackgroundOpacity: ValueCell.create(props.backgroundOpacity), } } function createValuesSimple(text: Text, props: Partial>, colorValue: Color, sizeValue: number, transform?: TransformData) { const s = BaseGeometry.createSimple(colorValue, sizeValue, transform) const p = { ...PD.getDefaultValues(Params), props } return createValues(text, s.transform, s.locationIterator, s.theme, p) } function updateValues(values: TextValues, props: PD.Values) { BaseGeometry.updateValues(values, props) ValueCell.updateIfChanged(values.uSizeFactor, props.sizeFactor) ValueCell.updateIfChanged(values.uBorderWidth, props.borderWidth) if (Color.fromNormalizedArray(values.uBorderColor.ref.value, 0) !== props.borderColor) { Color.toArrayNormalized(props.borderColor, values.uBorderColor.ref.value, 0) ValueCell.update(values.uBorderColor, values.uBorderColor.ref.value) } ValueCell.updateIfChanged(values.uOffsetX, props.offsetX) ValueCell.updateIfChanged(values.uOffsetY, props.offsetY) ValueCell.updateIfChanged(values.uOffsetZ, props.offsetZ) if (Color.fromNormalizedArray(values.uBackgroundColor.ref.value, 0) !== props.backgroundColor) { Color.toArrayNormalized(props.backgroundColor, values.uBackgroundColor.ref.value, 0) ValueCell.update(values.uBackgroundColor, values.uBackgroundColor.ref.value) } ValueCell.updateIfChanged(values.uBackgroundOpacity, props.backgroundOpacity) } function updateBoundingSphere(values: TextValues, text: Text) { const padding = getPadding(values.aMapping.ref.value, values.aDepth.ref.value, text.charCount, getMaxSize(values)) const { boundingSphere, invariantBoundingSphere } = calculateBoundingSphere( values.aPosition.ref.value, text.charCount * 4, values.aTransform.ref.value, values.instanceCount.ref.value, padding ) 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.padding, padding) } 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 = false } } function getPadding(mappings: Float32Array, depths: Float32Array, charCount: number, maxSize: number) { let maxOffset = 0 let maxDepth = 0 for (let i = 0, il = charCount * 4; i < il; ++i) { const i2 = 2 * i const ox = Math.abs(mappings[i2]) if (ox > maxOffset) maxOffset = ox const oy = Math.abs(mappings[i2 + 1]) if (oy > maxOffset) maxOffset = oy const d = Math.abs(depths[i]) if (d > maxDepth) maxDepth = d } // console.log(maxDepth + maxSize, maxDepth, maxSize, maxSize + maxSize * maxOffset, depths) return Math.max(maxDepth, maxSize + maxSize * maxOffset) // return maxSize + maxSize * maxOffset + maxDepth }