Skip to content

Parse OSCQuery JSON tree into parameter map #15

@joaodotwork

Description

@joaodotwork

Description

Fetch and parse the OSCQuery JSON tree from VDMX's HTTP endpoint into a structured parameter map for the bridge to use.

Tasks

  • Fetch OSCQuery root JSON via HTTP (urllib or requests)
  • Recursively parse CONTENTS tree into flat parameter list
  • Extract per-parameter: address, TYPE, RANGE (min/max), VALUE, ACCESS
  • Filter to writable float parameters (ACCESS includes write, TYPE is "f")
  • Build parameter map: {name: {address, type, min, max, value}}
  • Support periodic refresh to pick up new parameters

Acceptance Criteria

  • Produces a complete parameter map from VDMX's OSCQuery tree
  • Handles nested Control Surface structures
  • Correctly parses normalized 0.0–1.0 ranges and custom ISF shader ranges

Technical Notes

{
  "CONTENTS": {
    "Control Surface 1": {
      "CONTENTS": {
        "blur_amount": {
          "TYPE": "f",
          "RANGE": [{"MIN": 0.0, "MAX": 1.0}],
          "VALUE": [0.5],
          "ACCESS": 3
        }
      }
    }
  }
}
  • ACCESS: 1 = read-only, 2 = write-only, 3 = read-write

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions