Skip to content

Class: DataLayer ​

Defined in: layers.ts:580

Layer with data values and colormap (smart mode)

Extends ​

Extended by ​

Constructors ​

Constructor ​

ts
new DataLayer(
   id, 
   data, 
   indices, 
   colorMap, 
   config?
): DataLayer;

Defined in: layers.ts:595

Parameters ​

id ​

string

data ​

Float32Array<ArrayBufferLike> | number[]

indices ​

number[] | Uint32Array<ArrayBufferLike> | null

colorMap ​

string | ColorMap | Color[]

config? ​

DataLayerConfig = {}

Returns ​

DataLayer

Overrides ​

Layer.constructor

Properties ​

id ​

ts
id: string;

Defined in: layers.ts:294

Inherited from ​

Layer.id


visible ​

ts
visible: boolean;

Defined in: layers.ts:295

Inherited from ​

Layer.visible


opacity ​

ts
opacity: number;

Defined in: layers.ts:296

Inherited from ​

Layer.opacity


blendMode ​

ts
blendMode: BlendMode;

Defined in: layers.ts:297

Inherited from ​

Layer.blendMode


needsUpdate ​

ts
needsUpdate: boolean;

Defined in: layers.ts:298

Inherited from ​

Layer.needsUpdate


_onChangeCallback ​

ts
_onChangeCallback: ((changes) => void) | null;

Defined in: layers.ts:300

Callback set by the parent surface to propagate observable layer changes.

Inherited from ​

Layer._onChangeCallback

Accessors ​

order ​

Get Signature ​

ts
get order(): number;

Defined in: layers.ts:343

Numeric initialization hint used when this layer first enters a stack. Runtime ordering is owned exclusively by LayerStack.

Deprecated ​

Use LayerStack.setLayerOrder() or LayerStack.moveLayer() after the layer has been added. Runtime writes are ignored.

Returns ​

number

Set Signature ​

ts
set order(order): void;

Defined in: layers.ts:347

Parameters ​
order ​

number

Returns ​

void

Inherited from ​

ParcelConnectivityLayer.order

Methods ​

getOrderConstraints() ​

ts
getOrderConstraints(): LayerOrderConstraints;

Defined in: layers.ts:361

Returns ​

LayerOrderConstraints

Inherited from ​

Layer.getOrderConstraints


getPresentation() ​

ts
getPresentation(): LayerPresentation;

Defined in: layers.ts:365

Returns ​

LayerPresentation

Inherited from ​

Layer.getPresentation


setPresentation() ​

ts
setPresentation(presentation): void;

Defined in: layers.ts:369

Parameters ​

presentation ​

Partial<LayerPresentation>

Returns ​

void

Inherited from ​

Layer.setPresentation


setVisible() ​

ts
setVisible(visible): void;

Defined in: layers.ts:432

Parameters ​

visible ​

boolean

Returns ​

void

Inherited from ​

Layer.setVisible


setOpacity() ​

ts
setOpacity(opacity): void;

Defined in: layers.ts:439

Parameters ​

opacity ​

number

Returns ​

void

Inherited from ​

Layer.setOpacity


setBlendMode() ​

ts
setBlendMode(mode): void;

Defined in: layers.ts:447

Parameters ​

mode ​

BlendMode

Returns ​

void

Inherited from ​

Layer.setBlendMode


fromConfig() ​

ts
static fromConfig(config): Layer;

Defined in: layers.ts:501

Backward-compatible throwing factory. The package entry point installs the same explicit registry exposed by createLayerFromConfig.

Parameters ​

config ​

unknown

Returns ​

Layer

Inherited from ​

Layer.fromConfig


setData() ​

ts
setData(data, indices?): void;

Defined in: layers.ts:617

Parameters ​

data ​

Float32Array<ArrayBufferLike> | number[]

indices? ​

number[] | Uint32Array<ArrayBufferLike> | null

Returns ​

void


getData() ​

ts
getData(): Float32Array<ArrayBufferLike> | null;

Defined in: layers.ts:645

Returns ​

Float32Array<ArrayBufferLike> | null


getDataRevision() ​

ts
getDataRevision(): number;

Defined in: layers.ts:649

Returns ​

number


sampleValueAtVertex() ​

ts
sampleValueAtVertex(vertexIndex): number | null;

Defined in: layers.ts:658

Sample the scalar mapped to one surface vertex without exposing private dense or sparse storage. Unmapped, out-of-domain, non-finite, and disposed values return null.

Parameters ​

vertexIndex ​

number

Returns ​

number | null


getDataSummary() ​

ts
getDataSummary(options?): LayerDataSummary;

Defined in: layers.ts:684

Scalar layers override this without exposing their underlying arrays.

Parameters ​

options? ​

LayerDataSummaryOptions = {}

Returns ​

LayerDataSummary

Overrides ​

Layer.getDataSummary


setColorMap() ​

ts
setColorMap(colorMap): void;

Defined in: layers.ts:762

Parameters ​

colorMap ​

string | ColorMap | Color[]

Returns ​

void


setRange() ​

ts
setRange(range): void;

Defined in: layers.ts:803

Parameters ​

range ​

[number, number]

Returns ​

void


setThreshold() ​

ts
setThreshold(threshold): void;

Defined in: layers.ts:812

Parameters ​

threshold ​

[number, number]

Returns ​

void


getRange() ​

ts
getRange(): [number, number];

Defined in: layers.ts:821

Returns ​

[number, number]


getThreshold() ​

ts
getThreshold(): [number, number];

Defined in: layers.ts:825

Returns ​

[number, number]


writeThresholdEdgeAttributes() ​

ts
writeThresholdEdgeAttributes(
   vertexCount, 
   colors, 
   edges
): boolean;

Defined in: layers.ts:839

Per-vertex inputs for fragment-level threshold edges.

Writes, for every vertex, the layer colour it would take just outside the masked interval (colors, straight RGBA, alpha = 1 where data exist) and a signed distance to the mask in data units (edges: > 0 outside the mask, shown; < 0 inside or without data, hidden). Interpolating the distance across triangles lets a shader draw the threshold as a smooth isoline instead of a per-vertex staircase. Returns false when no mask is active.

Parameters ​

vertexCount ​

number

colors ​

Float32Array

edges ​

Float32Array

Returns ​

boolean


getColorMapName() ​

ts
getColorMapName(): string;

Defined in: layers.ts:873

Returns ​

string


getColorKeyRange() ​

ts
getColorKeyRange(): [number, number];

Defined in: layers.ts:882

The value interval a colour key for this layer spans: the display range by default. Layers that map values through more than one scale (e.g. a dual-threshold statistical map) widen it to cover every drawn value.

Returns ​

[number, number]


sampleColorMap() ​

ts
sampleColorMap(count?): ColorArray[] | null;

Defined in: layers.ts:891

Colour-key stops: count colours sampled evenly from the low to the high end of getColorKeyRange() with the layer's own colour lookup, ignoring the threshold mask. Returns null without a colormap.

Parameters ​

count? ​

number = 256

Returns ​

ColorArray[] | null


toStateJSON() ​

ts
toStateJSON(): Record<string, unknown>;

Defined in: layers.ts:909

Serialize common layer state for state persistence. Override in subclasses.

Returns ​

Record<string, unknown>

Overrides ​

Layer.toStateJSON


getRGBAData() ​

ts
getRGBAData(vertexCount): Float32Array;

Defined in: layers.ts:919

Get straight RGBA values for this layer.

Alpha here is intrinsic data/colormap coverage only. Layer.opacity is applied exactly once by the CPU or GPU compositor.

Parameters ​

vertexCount ​

number

Returns ​

Float32Array

Overrides ​

Layer.getRGBAData


update() ​

ts
update(updates): void;

Defined in: layers.ts:987

Update layer data Must be implemented by subclasses

Parameters ​

updates ​

DataLayerUpdateData

Returns ​

void

Overrides ​

Layer.update


dispose() ​

ts
dispose(): void;

Defined in: layers.ts:1021

Returns ​

void

Overrides ​

Layer.dispose

Released under the MIT License.