Schemas / Meta / render

`rig.render.light`

v0.31.0 · draft 10 fields 0 required

Fields

Field	Type		Meaning
`enabled`	bool	optional	Optional. Light on; absent = true
`type`	enumdirectional · point · spot	optional	Optional. directional, point, spot; absent = point
`rgb`	rgb	optional	Optional. Light colour (0-1); absent = white. Hosts may store as three floats
`intensity`	float	optional	Optional. Scale; absent = 1
`ambient`	float	optional	Optional. Fill / darkest band level; absent = 0
`banded`	bool	optional	Optional. Discrete shade steps when true; absent = false
`bands`	int	optional	Band count; required when `banded`
`range`	float	optional	Optional. Attenuation cutoff in content units. Absent = no cutoff (infinite). Ignored on directional
`innerConeDegrees`	float	optional	Optional. Spot penumbra inner half-angle; absent = 0. Ignored unless `type` is spot
`outerConeDegrees`	float	optional	Optional. Spot cone outer half-angle; absent = 45. Ignored unless `type` is spot

Pose on transform. Directional and spot shine along local −Z (world). Point and spot use world translation.

A patched show lamp is this light plus rig.dmx.fixture on the same entity. Looks compose rig.light.look.

No area lights. No light object handle.

JSON Schema

Resolves at https://rig.works/schemas/rig.render.light.schema.json — raw file.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://rig.works/schemas/rig.render.light.schema.json",
  "title": "rig.render.light",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "enabled": {
      "$ref": "./_defs.schema.json#/$defs/bool"
    },
    "type": {
      "type": "string",
      "enum": [
        "directional",
        "point",
        "spot"
      ]
    },
    "rgb": {
      "$ref": "./_defs.schema.json#/$defs/rgb"
    },
    "intensity": {
      "$ref": "./_defs.schema.json#/$defs/float"
    },
    "ambient": {
      "$ref": "./_defs.schema.json#/$defs/float"
    },
    "banded": {
      "$ref": "./_defs.schema.json#/$defs/bool"
    },
    "bands": {
      "$ref": "./_defs.schema.json#/$defs/int"
    },
    "range": {
      "$ref": "./_defs.schema.json#/$defs/float"
    },
    "innerConeDegrees": {
      "$ref": "./_defs.schema.json#/$defs/float"
    },
    "outerConeDegrees": {
      "$ref": "./_defs.schema.json#/$defs/float"
    }
  }
}

Seen in

lights.json