Class LineBasicMaterial2

And extension of three.js LineBasicMaterial that can be assigned to lines, and support threepipe features, uiconfig, and serialization.

Hierarchy (View Summary)

UnlitLineMaterial
- LineBasicMaterial2

Constructors

constructor

new LineBasicMaterial2(
parameters?: LineBasicMaterialParameters,
): LineBasicMaterial2
Parameters
- Optionalparameters: LineBasicMaterialParameters
Returns LineBasicMaterial2
Overrides UnlitLineMaterial.constructor
- Defined in src/core/material/UnlitLineMaterial.ts:234

Properties

`Readonly`appliedMeshes

appliedMeshes: Set<IObject3D> = ...

Managed internally, do not change manually

assetType

assetType: "material" = ...

constructor

constructor: typeof UnlitLineMaterial

The initial value of Object.prototype.constructor is the standard built-in Object constructor.

extraUniformsToUpload

extraUniformsToUpload: Record<string, IUniform> = {}

`Optional`generator

generator?: IMaterialGenerator

Managed internally, do not change manually

`Readonly`isUnlitLineMaterial

isUnlitLineMaterial: true

materialExtensions

materialExtensions: MaterialExtension[] = []

onAfterRender

onAfterRender: (
    renderer: WebGLRenderer,
    scene: Scene,
    camera: Camera,
    geometry: BufferGeometry,
    object: Object3D,
) => void = ...

onBeforeRender

onBeforeRender: (
    renderer: WebGLRenderer,
    scene: Scene,
    camera: Camera,
    geometry: BufferGeometry,
    object: Object3D,
) => void = ...

registerMaterialExtensions

registerMaterialExtensions: (
this: IMaterial,
customMaterialExtensions: MaterialExtension[],
) => void = iMaterialCommons.registerMaterialExtensions

`Readonly`setDirty

setDirty: (this: IMaterial, options?: IMaterialSetDirtyOptions) => void = iMaterialCommons.setDirty

uiConfig

uiConfig: UiObjectConfig = ...

unregisterMaterialExtensions

unregisterMaterialExtensions: (
this: IMaterial,
customMaterialExtensions: MaterialExtension[],
) => void = iMaterialCommons.unregisterMaterialExtensions

userData

userData: IMaterialUserData

An object that can be used to store custom data about the Material. It should not hold references to functions as these will not be cloned.

Default

{}

`Static` `Readonly`MaterialProperties

MaterialProperties: {
    alphaTest: number;
    alphaToCoverage: boolean;
    blendDst: 205;
    blendDstAlpha: null;
    blendEquation: 100;
    blendEquationAlpha: null;
    blending: 1;
    blendSrc: 204;
    blendSrcAlpha: null;
    clipIntersection: boolean;
    clippingPlanes: null;
    clipShadows: boolean;
    color: Color;
    colorWrite: boolean;
    depthFunc: 3;
    depthTest: boolean;
    depthWrite: boolean;
    dithering: boolean;
    fog: boolean;
    forceSinglePass: boolean;
    linecap: string;
    linejoin: string;
    linewidth: number;
    map: null;
    name: string;
    opacity: number;
    polygonOffset: boolean;
    polygonOffsetFactor: number;
    polygonOffsetUnits: number;
    precision: null;
    premultipliedAlpha: boolean;
    shadowSide: null;
    side: 0;
    stencilFail: 7680;
    stencilFunc: 519;
    stencilFuncMask: number;
    stencilRef: number;
    stencilWrite: boolean;
    stencilWriteMask: number;
    stencilZFail: 7680;
    stencilZPass: 7680;
    toneMapped: boolean;
    transparent: boolean;
    userData: {};
    vertexColors: boolean;
    visible: boolean;
} = ...

`Static`MaterialTemplate

MaterialTemplate: IMaterialTemplate<
    UnlitLineMaterial,
    Partial<
        {
            alphaTest: number;
            alphaToCoverage: boolean;
            blendDst: 205;
            blendDstAlpha: null;
            blendEquation: 100;
            blendEquationAlpha: null;
            blending: 1;
            blendSrc: 204;
            blendSrcAlpha: null;
            clipIntersection: boolean;
            clippingPlanes: null;
            clipShadows: boolean;
            color: Color;
            colorWrite: boolean;
            depthFunc: 3;
            depthTest: boolean;
            depthWrite: boolean;
            dithering: boolean;
            fog: boolean;
            forceSinglePass: boolean;
            linecap: string;
            linejoin: string;
            linewidth: number;
            map: null;
            name: string;
            opacity: number;
            polygonOffset: boolean;
            polygonOffsetFactor: number;
            polygonOffsetUnits: number;
            precision: null;
            premultipliedAlpha: boolean;
            shadowSide: null;
            side: 0;
            stencilFail: 7680;
            stencilFunc: 519;
            stencilFuncMask: number;
            stencilRef: number;
            stencilWrite: boolean;
            stencilWriteMask: number;
            stencilZFail: 7680;
            stencilZPass: 7680;
            toneMapped: boolean;
            transparent: boolean;
            userData: {};
            vertexColors: boolean;
            visible: boolean;
        },
    >,
> = ...

`Static` `Readonly`TYPE

TYPE: "UnlitLineMaterial" = 'UnlitLineMaterial'

`Static` `Readonly`TypeSlug

TypeSlug: "blmat" = 'blmat'

Methods

clone

clone(): this
Return a new material with the same parameters as this material.

Returns this
Inherited from UnlitLineMaterial.clone
- Defined in src/core/material/UnlitLineMaterial.ts:40

copy

copy(source: any): this
Copy the parameters from the passed material into this material.
Parameters
- source: any
Returns this
Inherited from UnlitLineMaterial.copy
- Defined in src/core/material/UnlitLineMaterial.ts:112

customProgramCacheKey

customProgramCacheKey(): string
In case onBeforeCompile is used, this callback can be used to identify values of settings used in onBeforeCompile, so three.js can reuse a cached shader or recompile the shader as needed.

Returns string
Inherited from UnlitLineMaterial.customProgramCacheKey
- Defined in src/core/material/UnlitLineMaterial.ts:62

dispatchEvent

dispatchEvent(event: IMaterialEvent): void
Fire an event type.
Parameters
- event: IMaterialEvent
  The event that gets fired.
Returns void
Inherited from UnlitLineMaterial.dispatchEvent
- Defined in src/core/material/UnlitLineMaterial.ts:41

dispose

dispose(): this
This disposes the material. Textures of a material don't get disposed. These needs to be disposed by Texture.

Returns this
Inherited from UnlitLineMaterial.dispose
- Defined in src/core/material/UnlitLineMaterial.ts:39

fromJSON

fromJSON(
    data: any,
    meta?: SerializationMetaType,
    _internal?: boolean,
): null | LineBasicMaterial2
Deserializes the material from JSON. Textures should be loaded and in meta.textures before calling this method. todo - needs to be tested
Parameters
- data: any
- Optionalmeta: SerializationMetaType
- _internal: boolean = false
Returns null | LineBasicMaterial2
Inherited from UnlitLineMaterial.fromJSON
- Defined in src/core/material/UnlitLineMaterial.ts:137

onBeforeCompile

onBeforeCompile(shader: Shader, renderer: WebGLRenderer): void
An optional callback that is executed immediately before the shader program is compiled. This function is called with the shader source code as a parameter. Useful for the modification of built-in materials.
Parameters
- shader: Shader
  Source code of the shader
- renderer: WebGLRenderer
  WebGLRenderer Context that is initializing the material
Returns void
Inherited from UnlitLineMaterial.onBeforeCompile
- Defined in src/core/material/UnlitLineMaterial.ts:66

setValues

setValues(
    parameters: Material | LineBasicMaterialParameters & { type?: string },
    allowInvalidType?: boolean,
    clearCurrentUserData?: undefined | boolean,
): this
Sets the values of this material based on the values of the passed material or an object with material properties The input is expected to be a valid material or a deserialized material parameters object(including the deserialized userdata)
Parameters
- parameters: Material | LineBasicMaterialParameters & { type?: string }
  material or material parameters object
- allowInvalidType: boolean = true
  if true, the type of the oldMaterial is not checked. Objects without type are always allowed.
- clearCurrentUserData: undefined | boolean = undefined
  if undefined, then depends on material.isMaterial. if true, the current userdata is cleared before setting the new values, because it can have data which wont be overwritten if not present in the new material.
Returns this
Inherited from UnlitLineMaterial.setValues
- Defined in src/core/material/UnlitLineMaterial.ts:99

toJSON

toJSON(meta?: SerializationMetaType, _internal?: boolean): any
Serializes this material to JSON.
Parameters
- Optionalmeta: SerializationMetaType
  metadata for serialization
- _internal: boolean = false
  Calls only super.toJSON, does internal three.js serialization and
Returns any
Serialize
tags. Set it to true only if you know what you are doing. This is used in Serialization->serializer->material
Inherited from UnlitLineMaterial.toJSON
- Defined in src/core/material/UnlitLineMaterial.ts:121

Class LineBasicMaterial2

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns LineBasicMaterial2

Properties

ReadonlyappliedMeshes

assetType

constructor

extraUniformsToUpload

Optionalgenerator

ReadonlyisUnlitLineMaterial

materialExtensions

onAfterRender

onBeforeRender

registerMaterialExtensions

ReadonlysetDirty

uiConfig

unregisterMaterialExtensions

userData

Default

Static ReadonlyMaterialProperties

StaticMaterialTemplate

Static ReadonlyTYPE

Static ReadonlyTypeSlug

Methods

clone

Returns this

copy

Parameters

Returns this

customProgramCacheKey

Returns string

dispatchEvent

Parameters

Returns void

dispose

Returns this

fromJSON

Parameters

Returns null | LineBasicMaterial2

onBeforeCompile

Parameters

Returns void

setValues

Parameters

Returns this

toJSON

Parameters

Returns any

Serialize

Settings

On This Page

`Readonly`appliedMeshes

`Optional`generator

`Readonly`isUnlitLineMaterial

`Readonly`setDirty

`Static` `Readonly`MaterialProperties

`Static`MaterialTemplate

`Static` `Readonly`TYPE

`Static` `Readonly`TypeSlug