Schemas / Other

rig.picture.analysis

v1.0.0 · stable maturity: stable 2 fields 1 required

Fields

FieldTypeMeaning
source entity required Frame to read: a rig.pixel.canvas, raster, image rig.media.asset_ref, video source, or a rig.visualizer.deck output
features array<enum>color · temperature optional Optional. Which live signals to publish: color, temperature. Absent = both

Request for live frame analysis of a picture. Format when present.

This describes the analysis to perform, not its results. Dominant / average color (rgba) and temperature (0 = cold, 1 = warm) change every frame and are host state.

The same two live names are used by rig.audio.analysis. rig.art.image is a documentary still of a work - not this.

To drive a property from the live color, use rig.mod.binding.

JSON Schema

Resolves at https://rig.works/schemas/rig.picture.analysis.schema.json — raw file.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://rig.works/schemas/rig.picture.analysis.schema.json",
  "title": "rig.picture.analysis",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "source": {
      "$ref": "./_defs.schema.json#/$defs/entity"
    },
    "features": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "color",
          "temperature"
        ]
      }
    }
  },
  "required": [
    "source"
  ],
  "x-rig-maturity": "stable"
}

Seen in

visualizer.json