Skip to content

WasmGPU | Documentation

material.data#setScaleTransform

material.data#setScaleTransform¶

Summary¶

material.data#setScaleTransform normalizes and replaces the material's value-extraction and scale mapping, then recomputes the record count for the current data source. The change marks material state dirty and emits a "scale" visual-change notification; it does not rewrite source data.

Syntax¶

DataMaterial.setScaleTransform(transform: ScaleTransformDescriptor | ScaleTransform): void
material.setScaleTransform(transform);

Parameters¶

Name	Type	Required	Description
`transform`	`ScaleTransformDescriptor \\| ScaleTransform`	Yes	Scale transform descriptor/object applied by this call.

Type Details¶

ScaleTransformDescriptor¶

type ScaleTransformDescriptor = {

    mode?: ScaleMode;

    clampMode?: ScaleClampMode;

    valueMode?: ScaleValueMode;

    componentCount?: number;

    componentIndex?: number;

    stride?: number;

    offset?: number;

    domainMin?: number;

    domainMax?: number;

    clampMin?: number;

    clampMax?: number;

    percentileLow?: number;

    percentileHigh?: number;

    logBase?: number;

    symlogLinThresh?: number;

    gamma?: number;

    invert?: boolean;

};

ScaleTransformDescriptor Fields¶

Name	Type	Required	Description
`mode`	`ScaleMode`	No	Numeric transform applied before domain normalization.
`clampMode`	`ScaleClampMode`	No	Clamping mode used by scale transforms.
`valueMode`	`ScaleValueMode`	No	Value extraction mode used when mapping source data into scale inputs.
`componentCount`	`number`	No	Number of components considered when extracting each value.
`componentIndex`	`number`	No	Selected component for `"component"` value mode.
`stride`	`number`	No	Distance, in `f32` values, between source records.
`offset`	`number`	No	Initial source offset in `f32` values.
`domainMin`	`number`	No	Lower bound mapped into the normalized color domain.
`domainMax`	`number`	No	Upper bound mapped into the normalized color domain.
`clampMin`	`number`	No	Lower value clamp used when clamping is enabled.
`clampMax`	`number`	No	Upper value clamp used when clamping is enabled.
`percentileLow`	`number`	No	Requested lower percentile, expressed from `0` to `100`.

ScaleTransform¶

type ScaleTransform = {

    mode: ScaleMode;

    clampMode: ScaleClampMode;

    valueMode: ScaleValueMode;

    componentCount: number;

    componentIndex: number;

    stride: number;

    offset: number;

    domainMin: number;

    domainMax: number;

    clampMin: number;

    clampMax: number;

    percentileLow: number;

    percentileHigh: number;

    logBase: number;

    symlogLinThresh: number;

    gamma: number;

    invert: boolean;

};

ScaleTransform Fields¶

Name	Type	Required	Description
`mode`	`ScaleMode`	Yes	Numeric transform applied before domain normalization.
`clampMode`	`ScaleClampMode`	Yes	Clamping mode used by scale transforms.
`valueMode`	`ScaleValueMode`	Yes	Value extraction mode used when mapping source data into scale inputs.
`componentCount`	`number`	Yes	Number of components considered when extracting each value.
`componentIndex`	`number`	Yes	Selected component for `"component"` value mode.
`stride`	`number`	Yes	Distance, in `f32` values, between source records.
`offset`	`number`	Yes	Initial source offset in `f32` values.
`domainMin`	`number`	Yes	Lower bound mapped into the normalized color domain.
`domainMax`	`number`	Yes	Upper bound mapped into the normalized color domain.
`clampMin`	`number`	Yes	Lower value clamp used when clamping is enabled.
`clampMax`	`number`	Yes	Upper value clamp used when clamping is enabled.
`percentileLow`	`number`	Yes	Requested lower percentile, expressed from `0` to `100`.

ScaleMode¶

type ScaleMode = "linear" | "log" | "symlog";

ScaleClampMode¶

type ScaleClampMode = "none" | "range" | "percentile";

ScaleValueMode¶

type ScaleValueMode = "component" | "magnitude";

See Also¶