Schemas / Meta / render

rig.render.blend

v0.31.0 · draft 2 fields 0 required

Fields

FieldTypeMeaning
blendMode enumnormal · multiply · screen · overlay · darken · lighten · color-dodge · color-burn · hard-light · soft-light · difference · exclusion · hue · saturation · color · luminosity · add · subtract · disabled optional Optional. See table; absent = normal
opacity number0 – 1 optional Optional. 0-1; absent = 1

Per-entity opacity and blend mode. Format when present.

Compose on any drawable - scene geometry, meshes, and compositor stack entries. This is the only portable blend / opacity for scene entities. Do not put blendMode or opacity on rig.pixel.layer or geometry schemas.

Absent component means opaque normal blend, so a document only pays for entities that differ.

Show/hide is rig.render.visibility - a hidden entity is not drawn; this scales coverage when it is. disabled is not hide: it still draws, and skips the blend equation.

Hosts may implement a subset. Unknown or unimplemented modes treat as normal.

blendMode literals are the Compositing and Blending Level 1 tokens, plus add / subtract / disabled.

Literal Meaning
normal Source over dest
multiply Multiply
screen Screen
overlay Overlay
darken Darken
lighten Lighten
color-dodge Color dodge
color-burn Color burn
hard-light Hard light
soft-light Soft light
difference Difference
exclusion Exclusion
hue Hue
saturation Saturation
color Color
luminosity Luminosity
add Source plus dest (not in CSS)
subtract Clamped source minus dest (not in CSS)
disabled Write source coverage as-is; do not run the blend equation

JSON Schema

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

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://rig.works/schemas/rig.render.blend.schema.json",
  "title": "rig.render.blend",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "blendMode": {
      "type": "string",
      "enum": [
        "normal",
        "multiply",
        "screen",
        "overlay",
        "darken",
        "lighten",
        "color-dodge",
        "color-burn",
        "hard-light",
        "soft-light",
        "difference",
        "exclusion",
        "hue",
        "saturation",
        "color",
        "luminosity",
        "add",
        "subtract",
        "disabled"
      ]
    },
    "opacity": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    }
  }
}