Class MaterialConfiguratorPlugin

Material Configurator Plugin (Basic UI) This plugin allows you to create variations of materials mapped to material names or uuids in the scene. These variations can be applied to the materials in the scene. (This copies the properties to the same material instances instead of assigning new materials) The plugin interfaces with the picking plugin and also provides uiConfig to show and edit the variations. This functionality is inherited from MaterialConfiguratorBasePlugin

Additionally this plugin adds a Grid UI using GridItemListPlugin in the DOM over the viewer canvas to show various material variations and allow the user to apply them. The UI can also be used in the editor to edit the variations and apply them.

Hierarchy

  • MaterialConfiguratorBasePlugin
    • MaterialConfiguratorPlugin

Constructors

constructor

Properties

_dirty _previewGenerator _viewer? _viewerListeners applyOnLoad constructor dependencies enableEditContextMenus enabled uiConfig variations OldPluginType? PluginType

Accessors

dirty

Methods

_onViewerEvent _refreshUi _storeKey addVariation applyVariation createVariation disable dispose enable exportState findVariation fromJSON getPreview getSelectedVariation importState isDisabled materialContextMenuItems onAdded onRemove reapplyAll refreshUi removeVariation removeVariationForMaterial setDirty? toJSON variationsContextMenuItems

Constructors

constructor

Properties

Protected _dirty

_dirty: boolean = false

Protected _previewGenerator

_previewGenerator: undefined | MaterialPreviewGenerator

Protected Optional _viewer

_viewer?: ThreeViewer

Protected _viewerListeners

_viewerListeners: PartialRecord<"dispose" | "*" | "update" | "preRender" | "postRender" | "preFrame" | "postFrame" | "addPlugin" | "removePlugin" | "renderEnabled" | "renderDisabled", ((e) => void)> = {}

Type declaration

    • (e): void

    • Parameters

      • e: IViewerEvent

      Returns void

applyOnLoad

applyOnLoad: boolean = true

Apply all variations(by selected index or first item) when a config is loaded

constructor

constructor: typeof AViewerPluginSync & typeof AViewerPlugin

dependencies

dependencies: typeof GridItemListPlugin[] = ...

enableEditContextMenus

enableEditContextMenus: boolean = false

enabled

enabled: boolean = true

uiConfig

uiConfig: UiObjectConfig<any, string, any> = ...

variations

variations: MaterialVariations[] = []

Static Optional Readonly OldPluginType

OldPluginType?: string

Static PluginType

PluginType: string = 'MaterialConfiguratorPlugin'

Accessors

dirty

Methods

Protected _onViewerEvent

  • _onViewerEvent(e): IViewerEvent

  • Parameters

    • e: IViewerEvent

    Returns IViewerEvent

Protected _refreshUi

Protected _storeKey

  • _storeKey(prefix?): string

  • Parameters

    • Optional prefix: string

    Returns string

addVariation

applyVariation

  • applyVariation(variations, matUuidOrIndex): boolean

  • Apply a material variation based on index or uuid.

    Parameters

    • variations: MaterialVariations
    • matUuidOrIndex: string | number

    Returns boolean

createVariation

disable

dispose

enable

exportState

  • exportState(): ISerializedConfig | Record<string, never>

  • Returns ISerializedConfig | Record<string, never>

findVariation

fromJSON

getPreview

  • getPreview(material, preview, viewerSetDirty?): string

  • Get the preview for a material variation Should be called from preFrame ideally. (or preRender but set viewerSetDirty = false)

    Parameters

    • material: IMaterial<IMaterialEvent<IMaterialEventTypes>, IMaterialEventTypes>

      Material or index of the material in the variation.

    • preview: string

      Type of preview. Could be generate:sphere, generate:cube, color, map, emissive, etc.

    • viewerSetDirty: boolean = true

      call viewer.setDirty() after setting the preview. So that the preview is cleared from the canvas.

    Returns string

getSelectedVariation

importState

  • importState(state): Promise<void>

  • Parameters

    • state: any

    Returns Promise<void>

isDisabled

materialContextMenuItems

  • materialContextMenuItems(variation, uuid): {
        Remove: (() => Promise<void>);
    }

  • Parameters

    • variation: MaterialVariations
    • uuid: string

    Returns {
        Remove: (() => Promise<void>);
    }

    • Remove: (() => Promise<void>)
        • (): Promise<void>

        • Returns Promise<void>

onAdded

onRemove

reapplyAll

refreshUi

removeVariation

removeVariationForMaterial

Optional setDirty

  • setDirty(...args): any

  • Parameters

    • Rest ...args: any[]

    Returns any

toJSON

  • toJSON(meta?): ISerializedConfig

  • Parameters

    • Optional meta: SerializationMetaType

    Returns ISerializedConfig

variationsContextMenuItems

  • variationsContextMenuItems(variation): {
        Clear Materials: (() => Promise<void>);
        Remove Section: (() => Promise<void>);
        Rename mapping: (() => Promise<void>);
        Rename title: (() => Promise<void>);
    }

  • Parameters

    • variation: MaterialVariations

    Returns {
        Clear Materials: (() => Promise<void>);
        Remove Section: (() => Promise<void>);
        Rename mapping: (() => Promise<void>);
        Rename title: (() => Promise<void>);
    }

    • Clear Materials: (() => Promise<void>)
        • (): Promise<void>

        • Returns Promise<void>

    • Remove Section: (() => Promise<void>)
        • (): Promise<void>

        • Returns Promise<void>

    • Rename mapping: (() => Promise<void>)
        • (): Promise<void>

        • Returns Promise<void>

    • Rename title: (() => Promise<void>)
        • (): Promise<void>

        • Returns Promise<void>

Settings

Member Visibility

Theme

On This Page

Generated using TypeDoc