Class UnlitLineMaterial

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

Hierarchy (View Summary)

Implements

Constructors

constructor

Properties

appliedMeshes assetType constructor extraUniformsToUpload generator? isUnlitLineMaterial materialExtensions onAfterRender onBeforeRender registerMaterialExtensions setDirty uiConfig unregisterMaterialExtensions userData MaterialProperties MaterialTemplate TYPE TypeSlug

Methods

clone copy customProgramCacheKey dispatchEvent dispose fromJSON onBeforeCompile setValues toJSON

Constructors

constructor

Properties

ReadonlyappliedMeshes

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> = {}

Optionalgenerator

generator?: IMaterialGenerator

Managed internally, do not change manually

ReadonlyisUnlitLineMaterial

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

ReadonlysetDirty

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 ReadonlyMaterialProperties

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;
} = ...

StaticMaterialTemplate

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 ReadonlyTYPE

TYPE: "UnlitLineMaterial" = 'UnlitLineMaterial'

Static ReadonlyTypeSlug

TypeSlug: "blmat" = 'blmat'

Methods

clone

  • clone(): this

  • Return a new material with the same parameters as this material.

    Returns this

copy

  • copy(source: any): this

  • Copy the parameters from the passed material into this material.

    Parameters

    • source: any

    Returns this

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

dispatchEvent

dispose

fromJSON

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

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

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

Settings

Member Visibility

On This Page

Constructors
Properties
Methods