How the MVR generator treats GDTF files

MVR generator 2.5, 26 October 2026. Applies to the MVR export, its API and the AI chat on gdtf-lights.com and stagelights.cz.

Principles

Rules R1–R6

RuleWhenWhat the generator doesPrograms
R1The GDTF is invalid by the specification or XSD, or cannot be read as intendedRepairs it: DEF-09, DEF-20, DEF-21, DEF-22; writes Revision in XSD order; fills Default where the XSD requires itall
R2The GDTF is valid but lacks data every visualizer needs (model, light source, axes, ranges)Adds an estimate derived from the structure of the file: DEF-01, 02, 03, 04, 06all
R3A valid GDTF that only BlenderDMX reads wronglyExtra heuristics for BlenderDMX's GDTF reader; the Revision text adds ; profile blenderdmxBlenderDMX only
R4A change that adds no informationNot done: no synthetic min/max/center ChannelSets, no generated thumbnails unless asked, DEF-11 only reportedall
R5The GDTF has a valid .soh.jsonAudit only; the GDTF goes in byte-identical and the extension is packedall
R6Roles, placement and size warnings of fixturesComputed by the same rules for every program; only the GDTF bytes of the BlenderDMX variant differall

Defect codes

CodeProblemTreatment
DEF-01no 3D modelprimitive model from the GDTF PrimitiveType list, with dimensions, for the root and Yoke/Head only (R2)
DEF-02moving head without AxisPan/Tilt axes added (R2); galvo lasers are left alone (DEF-18)
DEF-03Beam missingBeam added (R2): under the root of each light mode; power only from Properties/PowerConsumption, otherwise 100 W → 8,000 lm, never above 10,000 lm. Dimmer packs and LED decoders get a weak Glow beam without flux in every zone their Dimmer channels drive. Pixel bars and heads get a beam per pixel geometry that has none.
DEF-04Pan/Tilt without physical rangephysical range added (R2); for galvo lasers the scan field (ScanAngle, otherwise ±30°/±20°). A single-value function that takes one DMX step next to a function of the same attribute with real travel (laser rest at DMX 0, e.g. Pan_1 0…0 beside Pan_2) is a rest position and is kept (since 9 Nov 2026)
DEF-05ChannelFunction without ChannelSetsonly sets for the slots of an indexed wheel (WheelSlotIndex); nothing synthetic (R4)
DEF-06ChannelFunction without Defaultvalue inside the function's own range: Dimmer and colour minimum, shutter open, Pan/Tilt/Zoom/Focus centre (R1/R2)
DEF-07missing thumbnailonly with option thumbnails (off by default, R4)
DEF-08empty DMX modereported; the mode cannot be chosen
DEF-09broken XML (NUL bytes, junk after the root element)sanitized (R1)
DEF-10gobo slot without a media filereported
DEF-11no ColorSpace / Emittersreported only (R4)
DEF-12missing DataVersionreported; the file is not used
DEF-13dummy stub GDTFreported
DEF-14–16identifiers with spaces, virtual channels / Relations, footprint via GeometryReferenceinformative
DEF-17virtual Dimmer with Default 0 or without it, and no physical Dimmer (the fixture may look dark)reported; option fix_virtual_dimmer sets it to full
DEF-18galvo laser: Pan/Tilt without axesinformative, intentionally not repaired
DEF-19no light channel (hazer, motor, media)informative; no beam is invented
DEF-20mode without root geometryDMXMode/@Geometry set when the root is unambiguous (R1)
DEF-21mode channels outside the root geometryDMXMode/@Geometry redirected to a root that covers them (R1)
DEF-22geometry reference without targetturned into a plain Geometry (R1)

Target programs

The job field visualizer (step “Program” on the export page) selects the profile. Only BlenderDMX has its own repair variant; GET /mvr-generate.php?action=visualizers reports it in the field gdtf_repairs.

ProfileProgramgdtf_repairs
genericGeneric (maximum compatibility)generic
stageviz3D Stage Visualizergeneric
grandma3, capture, depence, wysiwyg, vision, l8grandMA3, Capture, Depence, WYSIWYG, Vision, L8generic
blenderdmxBlenderDMXblenderdmx

Job options: options.repair_gdtf (default true; false = audit only), options.thumbnails (default false), options.fix_virtual_dimmer (default false). Each GDTF in the report has audit[].soh_extension and, for the BlenderDMX variant, audit[].gdtf_variant.

In numbers

Library scan of 26 October 2026, profile generic:

FilesCountChanged by 2.4Changed by 2.5
GDTF from manufacturers and the community10,8906,2572,382
SOH library1704141
SOH with .soh.json400

The drop comes from rule R4 alone (no synthetic ChannelSets, no generated thumbnails). Validated against the GDTF XSD, the 2.5 output has no error that the 2.4 output did not have.

Known limits