GDTF & MVR

---

GDTF and MVR are open standards for the entertainment industry, main site GDTF Share, documentation and projects on GDTF.eu.

GDTF#

GDTF: The General Device Type Format is an open standard for describing devices of the entertainment industry.

These devices may be lighting fixtures, trusses, distribution boxes, media servers, lasers or other devices used in the entertainment industry.

A GDTF Profile includes 3D Models, information about Geometry, DMX channels, Color Wheels and a lot of other properties a Lighting Fixture might have.

Download and Build Profiles#

The GDTF Share contains profiles from multiple brands, as well as profiles built by the community. GDTF Share is fully integrated into Blender-DMX, allowing downloading GDTF profiles directly from Blender-DMX.

There’s also a GDTF Builder available for creating and editing GDTF Profiles.

Supported GDTF features in BlenderDMX#

BlenderDMX utilizes GDTF files to be able to visualize a device. GDTF files from GDTF Share can be downloaded directly from BlenderDMX. Following GDTF properties are utilized:

• A dynamic fixture object from a GDTF profile, either from primitives or custom models from 3DS and GLB mesh files
• GeometryReferences
• BeamGeometry and it’s attributes (Lamp Power, Beam Angle, Beam Type)
• LaserGeometry and it’s Beam Diameter attribute
• CameraGeometry (and selecting a view through the camera)
• Pigtail geometry (identifying typically back of the fixture)
• 2D SVG symbol
• media images (gobo) from wheels folder
• Supported GDTF Attributes
• GDTF Share integration
• more features as per pygdtf library

Supported GDTF Attributes#

Features or properties of GDTF devices, controlled by DMX channels:

• Dimmer (8/16bit)
• Pan (8/16 bit)
• Tilt (8/16bit)
• Shutter1 (used for Strobing in BlenderDMX)
• ColorAdd_R, G, B
• ColorRGB_Red, Green, Blue
• ColorSub_C, M, Y
• ColorAdd_C, M, Y
• Color1, Color2
• ColorMacro1
• Zoom
• Gobo1, Gobo2
• Gobo1Pos, Gobo2Pos
• XYZ_X, Y, Z
• Rot_X, Y, Z

ChannelFunctions and Physical Values are not implemented at the moment.

Read this section about usage and Implementation details of GDTF Attributes in BlenderDMX.

MVR#

Do note that when importing MVR files, Blender 4.x can be 10x slower then Blender 3.x .

MVR: The My Virtual Rig file format is an open standard which allows programs to share data and geometry of a scene for the entertainment industry.

A scene is a set of parametric objects such as fixtures, trusses, video screens, and other objects that are used in the entertainment industry.

Supported MVR features#

• Fixtures (with Address, Focus Points, Fixture Color, Fixture ID…)
• Scene Objects (with Symbols and Symdef…)
• Trusses
• Layers
• Group Objects
• more features as per pymvr library
• MVR-xchange Protocol

MVR-xchange Protocol#

GDTF Share Integration in Blender#

GDTF files can be downloaded directly from Blender:

• Register a free account on GDTF Share
• Fill in username and password into Blender-DMX addon preferences