Class: TwoDataLayer
Defined in: layers.ts:1740
Layer with two data values mapped to a 2D colormap.
Maps two scalar fields (X and Y) to colors using a 2D colormap texture. Useful for visualizing relationships between variables, such as:
- Effect size (X) vs. statistical confidence (Y)
- Activation magnitude (X) vs. significance (Y)
- Any two correlated or independent scalar fields
Example
const layer = new TwoDataLayer(
'effect-confidence',
effectSizeData, // X values
confidenceData, // Y values
indices,
'confidence', // 2D colormap preset
{
rangeX: [-2, 2],
rangeY: [0, 1],
thresholdY: [0, 0.05] // Hide low-confidence values
}
);Extends
Constructors
Constructor
new TwoDataLayer(
id,
dataX,
dataY,
indices,
colorMap,
config?
): TwoDataLayer;Defined in: layers.ts:1754
Parameters
id
string
dataX
Float32Array<ArrayBufferLike> | number[]
dataY
Float32Array<ArrayBufferLike> | number[]
indices
number[] | Uint32Array<ArrayBufferLike> | null
colorMap
| ColorMap2DPreset | ColorMap2D
config?
TwoDataLayerConfig = {}
Returns
TwoDataLayer
Overrides
Properties
id
id: string;Defined in: layers.ts:303
Inherited from
visible
visible: boolean;Defined in: layers.ts:304
Inherited from
opacity
opacity: number;Defined in: layers.ts:305
Inherited from
blendMode
blendMode: BlendMode;Defined in: layers.ts:306
Inherited from
needsUpdate
needsUpdate: boolean;Defined in: layers.ts:307
Inherited from
_onChangeCallback
_onChangeCallback: ((changes) => void) | null;Defined in: layers.ts:309
Callback set by the parent surface to propagate observable layer changes.
Inherited from
is2DLayer
readonly is2DLayer: boolean = true;Defined in: layers.ts:1752
Flag to identify this as a 2D data layer for GPU compositor
Accessors
order
Get Signature
get order(): number;Defined in: layers.ts:352
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
set order(order): void;Defined in: layers.ts:356
Parameters
order
number
Returns
void
Inherited from
Methods
getOrderConstraints()
getOrderConstraints(): LayerOrderConstraints;Defined in: layers.ts:370
Returns
Inherited from
getPresentation()
getPresentation(): LayerPresentation;Defined in: layers.ts:374
Returns
Inherited from
setPresentation()
setPresentation(presentation): void;Defined in: layers.ts:378
Parameters
presentation
Partial<LayerPresentation>
Returns
void
Inherited from
getDataSummary()
getDataSummary(_options?): LayerDataSummary | null;Defined in: layers.ts:386
Scalar layers override this without exposing their underlying arrays.
Parameters
_options?
Returns
LayerDataSummary | null
Inherited from
setVisible()
setVisible(visible): void;Defined in: layers.ts:441
Parameters
visible
boolean
Returns
void
Inherited from
setOpacity()
setOpacity(opacity): void;Defined in: layers.ts:448
Parameters
opacity
number
Returns
void
Inherited from
setBlendMode()
setBlendMode(mode): void;Defined in: layers.ts:456
Parameters
mode
Returns
void
Inherited from
fromConfig()
static fromConfig(config): Layer;Defined in: layers.ts:510
Backward-compatible throwing factory. The package entry point installs the same explicit registry exposed by createLayerFromConfig.
Parameters
config
unknown
Returns
Inherited from
setData()
setData(
dataX,
dataY,
indices?
): void;Defined in: layers.ts:1773
Parameters
dataX
Float32Array<ArrayBufferLike> | number[]
dataY
Float32Array<ArrayBufferLike> | number[]
indices?
number[] | Uint32Array<ArrayBufferLike> | null
Returns
void
getDataX()
getDataX(): Float32Array<ArrayBufferLike> | null;Defined in: layers.ts:1807
Returns
Float32Array<ArrayBufferLike> | null
getDataY()
getDataY(): Float32Array<ArrayBufferLike> | null;Defined in: layers.ts:1811
Returns
Float32Array<ArrayBufferLike> | null
setColorMap()
setColorMap(colorMap): void;Defined in: layers.ts:1815
Parameters
colorMap
| ColorMap2DPreset | ColorMap2D
Returns
void
getColorMap()
getColorMap(): ColorMap2D | null;Defined in: layers.ts:1844
Returns
ColorMap2D | null
setRangeX()
setRangeX(range): void;Defined in: layers.ts:1848
Parameters
range
[number, number]
Returns
void
setRangeY()
setRangeY(range): void;Defined in: layers.ts:1857
Parameters
range
[number, number]
Returns
void
setThresholdX()
setThresholdX(threshold): void;Defined in: layers.ts:1866
Parameters
threshold
[number, number]
Returns
void
setThresholdY()
setThresholdY(threshold): void;Defined in: layers.ts:1875
Parameters
threshold
[number, number]
Returns
void
getRangeX()
getRangeX(): [number, number];Defined in: layers.ts:1884
Returns
[number, number]
getRangeY()
getRangeY(): [number, number];Defined in: layers.ts:1885
Returns
[number, number]
getThresholdX()
getThresholdX(): [number, number];Defined in: layers.ts:1886
Returns
[number, number]
getThresholdY()
getThresholdY(): [number, number];Defined in: layers.ts:1887
Returns
[number, number]
getColorMapName()
getColorMapName(): string;Defined in: layers.ts:1888
Returns
string
getRGBAData()
getRGBAData(vertexCount): Float32Array;Defined in: layers.ts:1890
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
update()
update(updates): void;Defined in: layers.ts:1940
Update layer data Must be implemented by subclasses
Parameters
updates
Returns
void
Overrides
toStateJSON()
toStateJSON(): Record<string, unknown>;Defined in: layers.ts:1995
Serialize common layer state for state persistence. Override in subclasses.
Returns
Record<string, unknown>
Overrides
dispose()
dispose(): void;Defined in: layers.ts:2007
Returns
void