⬅️ Back to Table of Contents

📄 Sidebar.Material.RangeValueProperty.js

📊 Analysis Summary

Metric	Count
🔧 Functions	3
📦 Imports	4
📊 Variables & Constants	7

📚 Table of Contents

• Imports
• Variables & Constants
• Functions

🛠️ File Location:

📂 editor/js/Sidebar.Material.RangeValueProperty.js

📦 Imports

Name	Source
UINumber	./libs/ui.js
UIRow	./libs/ui.js
UIText	./libs/ui.js
SetMaterialRangeCommand	./commands/SetMaterialRangeCommand.js

---

Variables & Constants

Name	Type	Kind	Value	Exported
signals	any	let/var	editor.signals	✗
container	UIRow	let/var	new UIRow()	✗
object	any	let/var	null	✗
materialSlot	any	let/var	null	✗
material	any	let/var	null	✗
minValue	any	let/var	isMin ? number.getValue() : material[ property ][ 0 ]	✗
maxValue	any	let/var	isMin ? material[ property ][ 1 ] : number.getValue()	✗

---

Functions

SidebarMaterialRangeValueProperty(editor: any, property: any, name: any, isMin: any, range: number[], precision: number, step: number, nudge: number, unit: string): UIRow

Parameters:

• editor any
• property any
• name any
• isMin any
• range number[]
• precision number
• step number
• nudge number
• unit string

Returns: UIRow

Calls:

• container.add
• new UIText( name ).setClass
• new UINumber().setWidth( '60px' ).setRange( range[ 0 ], range[ 1 ] ).setPrecision( precision ).setStep( step ).setNudge( nudge ).setUnit( unit ).onChange
• number.getValue
• editor.execute
• editor.getObjectMaterial
• number.setValue
• container.setDisplay
• signals.objectSelected.add
• signals.materialChanged.add

Internal Comments:

// (x5)

Code

function SidebarMaterialRangeValueProperty( editor, property, name, isMin, range = [ - Infinity, Infinity ], precision = 2, step = 1, nudge = 0.01, unit = '' ) {

    const signals = editor.signals;

    const container = new UIRow();
    container.add( new UIText( name ).setClass( 'Label' ) );

    const number = new UINumber().setWidth( '60px' ).setRange( range[ 0 ], range[ 1 ] ).setPrecision( precision ).setStep( step ).setNudge( nudge ).setUnit( unit ).onChange( onChange );
    container.add( number );

    let object = null;
    let materialSlot = null;
    let material = null;

    function onChange() {

        if ( material[ property ][ isMin ? 0 : 1 ] !== number.getValue() ) {

            const minValue = isMin ? number.getValue() : material[ property ][ 0 ];
            const maxValue = isMin ? material[ property ][ 1 ] : number.getValue();

            editor.execute( new SetMaterialRangeCommand( editor, object, property, minValue, maxValue, materialSlot ) );

        }

    }

    function update( currentObject, currentMaterialSlot = 0 ) {

        object = currentObject;
        materialSlot = currentMaterialSlot;

        if ( object === null ) return;
        if ( object.material === undefined ) return;

        material = editor.getObjectMaterial( object, materialSlot );

        if ( property in material ) {

            number.setValue( material[ property ][ isMin ? 0 : 1 ] );
            container.setDisplay( '' );

        } else {

            container.setDisplay( 'none' );

        }

    }

    //

    signals.objectSelected.add( update );
    signals.materialChanged.add( update );

    return container;

}

onChange(): void

Returns: void

Calls:

• number.getValue
• editor.execute

Code

function onChange() {

        if ( material[ property ][ isMin ? 0 : 1 ] !== number.getValue() ) {

            const minValue = isMin ? number.getValue() : material[ property ][ 0 ];
            const maxValue = isMin ? material[ property ][ 1 ] : number.getValue();

            editor.execute( new SetMaterialRangeCommand( editor, object, property, minValue, maxValue, materialSlot ) );

        }

    }

update(currentObject: any, currentMaterialSlot: number): void

Parameters:

• currentObject any
• currentMaterialSlot number

Returns: void

Calls:

• editor.getObjectMaterial
• number.setValue
• container.setDisplay

Code

function update( currentObject, currentMaterialSlot = 0 ) {

        object = currentObject;
        materialSlot = currentMaterialSlot;

        if ( object === null ) return;
        if ( object.material === undefined ) return;

        material = editor.getObjectMaterial( object, materialSlot );

        if ( property in material ) {

            number.setValue( material[ property ][ isMin ? 0 : 1 ] );
            container.setDisplay( '' );

        } else {

            container.setDisplay( 'none' );

        }

    }

---