<m-light>

The m-light element is a light that supports various types (e.g. point, spotlight) and can be coloured.

Try it

Attributes

  • intensity: float

    The intensity of the light in candela (cd). Default value is 1.

  • distance: float

    The maximum distance in meters that the light will affect objects. Objects beyond this distance will not be illuminated. Default value is 0, which means the light has no maximum distance.

  • angle: float

    The angle of the light in degrees (only applicable to spotlight type). Default value is 45.

  • enabled: boolean

    Whether the light is enabled (true) or disabled (false). Default value is true.

  • cast-shadow: boolean

    Whether the light cast shadows (true) or not (false). Default value is true.

  • type: enum

    point

    spotlight

Attribute Groups

  • Attribute Group: debuggable

    • debug: boolean

      A boolean that indicates whether the element should be drawn with debug information (e.g. axes helper). Default value is false.

  • Attribute Group: transformable

    • x: float

      The position of the element along the X-axis in meters. Default value is 0.

    • y: float

      The position of the element along the Y-axis in meters. Default value is 0.

    • z: float

      The position of the element along the Z-axis in meters. Default value is 0.

    • rx: float

      The rotation of the element around the X-axis in degrees. Default value is 0.

    • ry: float

      The rotation of the element around the Y-axis in degrees. Default value is 0.

    • rz: float

      The rotation of the element around the Z-axis in degrees. Default value is 0.

    • sx: float

      The scale of the element along the X-axis. Default value is 1.

    • sy: float

      The scale of the element along the Y-axis. Default value is 1.

    • sz: float

      The scale of the element along the Z-axis. Default value is 1.

    • visible: boolean

      Whether the element is visible (true) or hidden (false) in the scene. Default value is true.

    • socket: string

      The name of a bone in the parent element's skeletal mesh to which this element will be attached. If not specified, the element will attach to the origin of its parent.

  • Attribute Group: colorable

    • color: string

      The color of the element. Accepts color values in formats such as "#FF0000", "red", or "rgb(255,0,0)". If not specified, the default color is "white".

  • Attribute Group: coreattrs

    • id: ID

      A unique identifier for the element, used for selection and manipulation through scripting. It must be unique within the document.

    • class: string

      A space-separated list of class names that can be used for scripting purposes.

  • Attribute Group: clickable

    • onclick: script

      A script expression that is executed when the element is clicked. Events are also dispatched to "click" event listeners.

Examples

Spotlight

This is a spotlight m-light example.

Point

This is a point m-light example.

Compatibility Table

WEBUNREAL
m-light✓✓
intensity✓✓
distance✓✓
angle✓✓
enabled✓✓
type✓✓
cast-shadow✓✗
debug✓✓
x✓✓
y✓✓
z✓✓
rx✓✓
ry✓✓
rz✓✓
sx✓✓
sy✓✓
sz✓✓
visible✓✓
socket✓✗
color✓✓
id✓✓
class✓✓
onclick✓✓