From dfa3fa7ee4a277032d76923df7f9221a71b99b93 Mon Sep 17 00:00:00 2001 From: Dandaedre Date: Sun, 15 Nov 2026 15:19:43 +0100 Subject: [PATCH] Survey presentation switcher adapter candidates --- docs/canvas-pilot/changelog.md | 4 + docs/canvas-pilot/plan.md | 6 + .../presentation-switcher-adapters.md | 131 ++++++++++++++++++ 3 files changed, 141 insertions(+) create mode 100644 docs/canvas-pilot/presentation-switcher-adapters.md diff --git a/docs/canvas-pilot/changelog.md b/docs/canvas-pilot/changelog.md index 954efc9..10c4591 100644 --- a/docs/canvas-pilot/changelog.md +++ b/docs/canvas-pilot/changelog.md @@ -4,6 +4,10 @@ ## Unreleased +- Add a sourced presentation-switcher adapter survey, ranked by public control + documentation with separate geometry feasibility assessments, and a stretch + goal to consider selected families. Research only; no new support is enabled. + - Compact Measure position from into a dropdown with side-by-side From screen and To layer pickers and a summary of both points. Preserve linked/independent point selection and project autosave; regression checks exercise the popup. diff --git a/docs/canvas-pilot/plan.md b/docs/canvas-pilot/plan.md index 92a5ec8..1193bc6 100644 --- a/docs/canvas-pilot/plan.md +++ b/docs/canvas-pilot/plan.md @@ -84,6 +84,12 @@ device readback and physical-screen acceptance. ## Stretch goals (distant future) +- [ ] **Consider additional presentation-switcher adapters.** Use the + [adapter candidate survey](presentation-switcher-adapters.md) to select useful + families by documentation, geometry/readback coverage and available test + hardware. Investigate Analog Way Alta 4K first, then selected non-AW candidates; + the list is a research backlog, not a commitment to support every product. + - [ ] **Multiple editor screens in one project.** Use a dropdown to select the active screen, displaying and editing one screen at a time. Preserve each screen's layout when switching; simultaneous multi-screen editing is outside diff --git a/docs/canvas-pilot/presentation-switcher-adapters.md b/docs/canvas-pilot/presentation-switcher-adapters.md new file mode 100644 index 0000000..b6a2a34 --- /dev/null +++ b/docs/canvas-pilot/presentation-switcher-adapters.md @@ -0,0 +1,131 @@ +# Presentation switcher adapter candidates + +Research date: **2026-11-15**. This is a documentation and feasibility survey for +Canvas Pilot's [stretch goals](plan.md#stretch-goals-distant-future), not a support +announcement or purchasing guide. Analog Way comes first; other manufacturers +follow in documentation tiers. Models sharing a control family are grouped. + +Scope: major live-event presentation switchers and multi-window processors, +including relevant legacy equipment and adjacent production switchers. This is +not an exhaustive inventory of every regional product, discontinued SKU or OEM +variant. A manufacturer name or shared protocol never implies compatibility +across its range. Unknowns below mean **not established by this survey**, not +that integration is impossible. + +## How the ranking works + +Documentation rank measures availability, not product quality or market share: + +| Tier | Evidence available | Meaning for planning | +| --- | --- | --- | +| A | Public, detailed programming reference or API schema | We can investigate an adapter without first requesting a private protocol. | +| B | Official protocol/SDK download exists, but package, version coverage or geometry details need further inspection | Promising; obtain and audit the exact reference before estimating work. | +| C | Product manuals, integration packages or external-control claims found, but no complete public geometry/readback contract established | Request the missing interface documentation before committing to support. | +| D | No verified model-specific programming reference located in this survey | Research only; do not plan implementation yet. | + +Rows are ordered by tier within each section; equal tiers are ties. The +**feasibility assessments are engineering judgments**, not vendor guarantees. +A useful Canvas Pilot adapter must discover destinations and dimensions, read +layer geometry/source framing, write selected geometry, and verify the result. +Preset recall, TAKE, routing or tally alone do not meet that requirement. + +## Analog Way first + +| Tier | Family / representative models | Documentation evidence | Canvas Pilot feasibility and next step | +| --- | --- | --- | --- | +| A | **LivePremier / Aquilon**: C/C+, Cmax and RS variants | Public [AWJ 6.2 programmer's guide](https://dwn01.analogway.com/Site+Internet/Series/Aquilon/Common/AWJ+Protocol/AW_Aquilon_AWJ_ProgrammersGuide_V6.2.pdf). | **Already implemented for standalone AQL Cmax 6.2.x only.** Extend model/firmware profiles after fixtures and acceptance checks; linked systems need explicit unit identity and topology handling. See [current acceptance limits](aquilon-compatibility.md). | +| A | **Midra 4K**: Eikos 4K, Pulse 4K, QuickVu 4K, QuickMatrix 4K | AWJ and REST guides in the [official downloads](https://www.analogway.com/downloads); [vendor FAQ](https://www.analogway.com/midra-4k-faqs) documents control options and simulator. | **Existing adapter.** Broaden tested coverage deliberately; current Eikos hardware evidence does not certify every model/mode. See [hardware checks](device-check.md). | +| B | **Alta 4K**: Zenith 100 / 200 | AWJ v1.2 and REST guides plus simulator listed in [official downloads](https://www.analogway.com/downloads); [family overview](https://www.analogway.com/alta-4k-faqs). | **Best next new AW family to investigate.** Likely reuse transport and normalized geometry, but audit native paths, layers, banks and apply behavior. No Alta protocol package or device was exercised here. | +| B | **LiveCore**: Ascender 16/32/48 and LE/4K variants; NeXtage 08/16; SmartMatriX Ultra | [NeXtage support page](https://www.analogway.com/products/nextage-08-livecore) lists the LiveCore programmer's guide and simulator; [Ascender page](https://www.analogway.com/products/ascender-16) lists the family documentation. | **Plausible separate legacy adapter.** Inspect the programmer package and firmware-specific command tables; do not assume AWJ compatibility. Validate linked processors and output expanders separately. | +| B | **Legacy Midra (non-4K)**: Eikos², Pulse², QuickVu, QuickMatriX; Saphyr / SmartMatriX² variants need individual confirmation | Legacy Midra programmer's guide and AW Gateway listed in [official downloads](https://www.analogway.com/downloads). | **Plausible separate adapter.** Confirm command coverage, readback and connection-sharing limits. The existing Midra 4K adapter is not evidence of support for this generation. | +| D | **Earlier generations**: Pulse PLS300, legacy Di-VentiX, Eikos and other pre-Midra models | No exact current manufacturer-hosted protocol package verified during this survey. Start with the [vendor archive](https://www.analogway.com/downloads). | **Unknown per model.** Obtain the exact manual/command set and hardware before estimating; avoid one generic “old Analog Way” adapter. | + +**Adjacent AW products:** [VIO 4K](https://www.analogway.com/products/vio-4k) +is a conversion/scaling candidate rather than the first choice for a multi-layer +editor adapter. Picturall media-server integration and control surfaces such as +Vertige/LiveTakes belong to separate workflow investigations, not extra switcher +profiles. Expanders should be represented through their host topology. + +## Other presentation and multi-window processors + +| Tier | Family / representative models | Documentation evidence | Canvas Pilot feasibility and next step | +| --- | --- | --- | --- | +| A | **Barco Event Master**: E2 / E2 Gen 2 / E2 Jr, S3 variants, **ENCORE3** | Public [remote-control reference R5919184](https://www.barco.com/en/support/docs/R5919184), with online edition and version history; [device guide](https://www.barco.com/en/support/docs/R5905948) documents JSON-RPC. | **High-value candidate; conditional geometry support.** Audit the exact toolset's layer discovery/read/write methods first. The presence of JSON-RPC alone does not prove complete geometry round trips. Model, toolset and linked-frame differences need profiles. | +| A | **Barco PDS-4K / PDS-4K SDI** | Listed in the same [remote-control reference](https://www.barco.com/en/support/docs/R5919184). | **Promising smaller target.** Check its implemented command subset and layer limits independently of E2; do not inherit capabilities just because it shares a reference. | +| A | **tvONE CORIOmaster / mini / micro** | Public [API portal](https://api.tvone.com/products/c3-series/c3-5xx/index.html): REST, JSON schemas, WebSocket events and CLI. | **Strong candidate.** Audit canvas/window coordinates, crop, rotation and staging behavior. A video-wall canvas may differ from one physical output; preserve that distinction in the adapter. | +| A | **tvONE CORIOmaster2 and CALICO C7 PRO** | Separate product APIs in the [vendor API directory](https://api.tvone.com/). | **Strong candidates, separate profiles.** Compare their schemas with CORIOmaster before deciding what transport/conversion code is genuinely reusable. | +| A | **Extron MGP 641 / MGP 641 xi / xi 5K**; older MGP generations separately | Public [MGP 641 SIS command tables](https://media.extron.com/public/download/files/userman/68-2396-01_C_MGP_641_UG.pdf); [xi 5K setup guide](https://media.extron.com/public/download/files/userman/68-2396-52_A_MGP_641_xi_5K_Series_SUG.pdf) points to its own full manual. | **Strong bounded multi-window candidate.** Confirm window size/position and source framing queries per generation. Model native live-update behavior explicitly; do not invent an AW-style Preview bank. Newer profiles may require SSH transport. | +| A | **NovaStar H series**: H2/H5/H9/H15/H20 family | Public [H OpenAPI](https://openapi.novastar.tech/en/h/), including [layer details](https://openapi.novastar.tech/en/h/api-365455770) and [layer edits](https://openapi.novastar.tech/en/h/api-365455773). | **Strong candidate.** Audit authentication/project keys, coordinate units, layer limits and preset versus live editing. This is considerably stronger evidence than an “open API” marketing claim. Exact firmware coverage still needs validation. | +| A | **Christie Spyder X80** | Public [serial-command reference](https://www.christiedigital.com/globalassets/resources/public/020-102207-08-christie-lit-man-ref-spyder-commands.pdf), including layer position, size and combined `LSP` commands. | **Plausible, with a readback gate.** Geometry writes are documented; prove complete current layer/crop/source and PixelSpace discovery before promising bidirectional support. UDP response handling and PixelSpace mapping need care. | +| A | **Christie Spyder X20** | Public [user manual with external-control protocol](https://www.christiedigital.com/globalassets/020-000916-01-lit-man--usr-spyder-x20.pdf). | **Plausible legacy candidate.** Audit independently of X80; establish state queries and framing conversion. Public write commands are not sufficient acceptance evidence. | +| A | **Kramer VP-771 / VP-772** | Public [VP-771 manual](https://cdn.kramerav.com/web/downloads/manuals/vp-771_rev_8.pdf) and [VP-772 manual](https://cdn.kramerav.com/web/downloads/manuals/vp-772_rev_4.pdf) cover window controls and remote command protocols. | **Possible limited adapter.** Confirm window geometry queries and supported modes; do not generalize to Kramer matrix switchers without composition layers. | +| B | **tvONE CORIOview** | Product-specific APIs linked from the [vendor API directory](https://api.tvone.com/). | **Conditional fit.** Establish whether the desired arbitrary geometry is editable or constrained to supported layouts; a layout selector alone is not equivalent to Canvas Pilot's editor. | +| C | **PIXELHUE P10 / P20 / P20-DS / Q8 / P80** | [Official downloads](https://www.pixelhue.com/index.php/Content/index/catid/7/id/0.html) and [official archive](https://community.pixelhue.com/t/pixelhue-software-firmware-archive-version-history-downloads/26) include software and integration packages. | **Relevant but documentation-blocked.** Obtain a versioned geometry/state protocol. Existing Companion/Crestron/Q-SYS packages do not by themselves establish arbitrary layer read/write support. | +| C | **RGBlink X series**, starting with X7; X3/X-series variants separately | [X7 product/download page](https://www.rgblink.com/x7) provides manuals. | **Conditional.** Request the model-specific external-control/SDK reference and verify discovery, geometry and readback. No full public contract was established here. | +| C | **Magnimage MIG series**: H8/H9 and related event processors | [Manufacturer download centre](https://www.magnimage.com/article/download) lists control software and product documentation. | **Conditional.** Obtain processor-specific protocol documentation before estimating. Controller software availability is not an API specification. | +| C | **Legacy Barco/Folsom**: ScreenPRO-II, original Encore, PresentationPRO and older PDS | [ScreenPRO-II support archive](https://www.barco.com/en/support/screenpro-ii-series/documentation) remains available. | **Research per generation.** Locate exact geometry/readback commands and hardware. Original Encore must not be confused with ENCORE3/Event Master. | + +## Adjacent production switchers and LED controllers + +These are worth recording, but their composition models may only support a +subset of Canvas Pilot. Documentation grades still refer to control access, +not proof of arbitrary multi-layer editing. + +| Tier | Family | Documentation evidence | Feasibility | +| --- | --- | --- | --- | +| A | **Roland V-600UHD** | Public [LAN/RS-232 reference](https://static.roland.com/assets/media/pdf/V-600UHD_reference_eng05_W.pdf). | **Potential PinP/ROI subset.** Audit geometry read/write parameters and convert native scaling units explicitly. | +| A | **Ross Carbonite / Graphite / Acuity** | Public [RossTalk reference](https://documentation.rossvideo.com/files/Manuals/Protocol%20Documents/RossTalk-Commands%284802DR-403%29.pdf). | **Not yet a full geometry candidate.** Prove continuous DVE geometry and state feedback through an appropriate interface; macro/bus control alone is insufficient. | +| A | **NovaStar COEX / MX / KU / CX controllers** | Public [COEX API manual](https://oss.novastar.tech/uploads/2023/02/COEX-Series-Interface-API-User-Manual.pdf). | **Low priority for this editor.** The inspected reference establishes controller/source/preset functions, not a general layer-composition contract. Do not reuse H-series API assumptions. | +| B | **Blackmagic Design ATEM**, particularly models with SuperSource | Official [ATEM SDK downloads](https://www.blackmagicdesign.com/ca/developer/partial/atem/sdk-and-software). | **Promising restricted SuperSource/DVE adapter.** Audit SDK geometry/crop and callbacks, supported host platforms and Rust binding/deployment costs. Do not equate SDK availability with a published wire protocol or assume every ATEM has SuperSource. | +| B | **Roland V-160HD / V-1200HD / V-800HD and other V-series** | [Official protocol index](https://support.roland.com/hc/en-us/articles/360025923832-Professional-A-V-LAN-and-RS-232-Control-Tips-and-Documentation); [V-160HD details](https://support.roland.com/hc/en-us/articles/7816887053083-V-160HD-LAN-and-RS-232-Control-Tips). | **Possible model-specific subsets.** Transport, command encoding and parameter coverage differ; V-160HD uses SysEx wrappers and some commands require additional documentation. | +| B | **Panasonic AV-UHS500 / AV-HS6000 / AV-HS410** | [Official protocol document index](https://eww.pass.panasonic.co.jp/pro-av/support/content/guide/EN/top.html). | **Conditional, lower priority.** Audit exact external-control/plugin references for DVE state and geometry; bus, macro and tally access is not enough. | +| B | **Datavideo SE-3200**; other SE models separately | [Official product downloads](https://datavideo.com/in/product/SE-3200) list its RS-232 control protocol. | **Possible PinP subset.** Inspect parameter readback and geometry coverage before considering an adapter. Do not assume DVIP and serial command parity. | + +Plain HDMI/SDI matrices, distribution devices and LED sending-only controllers +are not initial geometry-adapter targets. Media servers and software mixers +would deserve a separate survey if that scope becomes useful. + +## Suggested investigation order + +This is an implementation-priority judgment, distinct from the documentation +ranking above: + +1. **Alta 4K**, alongside broader tested Midra 4K/Aquilon profiles: closest to the + current architecture and operator workflow. +2. **Barco Event Master**, starting with one available E2/S3/PDS-4K target: + investigate the layer read/write contract before promising support. +3. **tvONE CORIOmaster or Extron MGP**, whichever hardware is available: good + public references and a useful test of the intermediate representation. +4. **NovaStar H**, then **Christie Spyder X80** once complete readback is proven. +5. **LiveCore / legacy Midra** when there is an actual equipment need; **ATEM + SuperSource / Roland PinP** if a constrained composition workflow is wanted. +6. **PIXELHUE, RGBlink and Magnimage** after obtaining the missing protocol + evidence. Documentation discovery can move them up; their current tier is + not a statement about hardware capability. + +## Keep future adapters small and first class + +Use the existing [adapter contract](../interfaces/device-adapters.md): normalize +native screens/canvases, stable layer IDs, dimensions, source framing and +supported geometry into the shared representation. Keep native units, paths, +bank semantics and transports in each family implementation. Share proven +mechanisms, not assumed similarities between vendors. + +Before accepting a new adapter, establish: + +- A specific model/firmware profile and legal access to its programming interface. +- Fresh bounded state reads, stable destination identity, crop/geometry semantics + and explicit behavior for live-only devices or absent Preview/Program banks. +- Selective writes, stale-state checks and actual geometry readback; unsupported + transforms must remain explicit rather than silently approximated. +- Sanitized fixtures, transport/conversion regression checks and controlled + emulator or hardware acceptance, followed by physical-output inspection. + +Input thumbnails are optional capabilities, not a prerequisite for basic +geometry exchange. Do not build a generic plugin framework, general show-control +engine or SDK abstraction merely to accommodate this list. Extend persistence +and document migration only when a concrete adapter needs it. Multi-screen +project editing remains its own stretch goal. + +No new device, simulator or SDK was tested for this survey. Only the existing +Midra/Aquilon acceptance records represent completed integration work.