What is GDTF?
Before discussing the specifics, let me give you an example of why GDTF and MVR are powerful. As a lighting designer and programmer, I’m often in the seat of creating the lighting plot, the patch, the lighting paperwork, and the previz model. If you’ve been in those seats on a project, you likely know that there are constant updates to information across all platforms that have to be coordinated in each location. In the early days of lighting design and programming, that could mean updating the plot in one program, then opening the console and typing in the changes, then opening the paperwork files and updating the changes, then opening the previz model and making the changes, again and again until the rig is patched and all changes are complete. Very time consuming! Granted, consoles like the grandMA have come a long way from those days by being able to receive patch information from applications like Vectorworks via an XML file, and Vectorworks has certainly taken steps to allow for importing and exporting fixture data between apps like Lightwright. But these necessary steps have remained disconnected for the most part, and the workflow doesn’t readily flow between programs. Enter GDTF and MVR. GDTF 1.0 and the My Virtual Rig (MVR) file format are used to create a two-way connection between planning, previz, and console systems. These file types are now fully implemented into Vectorworks 2019, Vision 2019, and grandMA3. And the GDTF file format is currently supported by 20 other manufacturers including Robe, ETC, Martin, AVOLITES, SGM, and Green Hippo, to name a few.The Power of GDTF and MVR
GDTF is an open source, unified data exchange format stored in an XML file that contains valuable fixture information including:- Fixture name
- Short fixture name
- Manufacturer
- Fixture description
- 3D model geometry (3DS)
- DMX mapping
- DMX modes- channels and channels functions
- Wheels
- Physical descriptions of emitters, filters, and color of the light
- Attribute groupings
- Date and user stamp on all uploaded GDTF files

ROBE GDTF fixture files on the GDTF-share.com website.
The fixture builder on the GDTF-share.com.
On the GDTF-share.com website, a web-based fixture builder is available for manufacturers to build their approved GDTF files. The files are then added to searchable online database for anyone to access. The web-based builder isn’t restricted to just manufacturers. Users can build and create GDTF files too. MVR is an XML file that provides a complete 3D model with data describing the different fixtures’ locations in the scene and contains all the GDTF files for the lighting fixtures used in a design. When exported from Vectorworks, it can then be imported into any previz program that supports MVR, such as Vision, or a lighting console like grandMA3. MVR files contain geometry for objects in the scene including:- Fixture
- Focus point
- Truss
- Video screen
- Other scene objects

The new MVR workflow.
So by using GDTF and MVR, the more efficient GDTF/MVR workflow looks like this:- Designer draws the lighting plot in Vectorworks;
- Designer selects a Fixture Mode from the manufacturer approved GDTF for each fixture in the plot;
- Designer exports the file as an MVR;
- Designer (or programmer) imports the MVR into the Lighting Console, previz system, etc.

Exporting the file as an MVR.

The import screen on the grandMA3.
The MVR export screen on the grandMA3.
With the collaboration between Vectorworks, Robe, and MA Lighting, a new unified data exchange platform is taking shape in our industry. The advantages of moving toward incorporating this type of format enables us, as end users, to achieve a more efficient workflow. And in this business, we all know that time is money, so we are always scanning the horizon for ways to make our workflows and processes simpler and more efficient. And the lesson we’ve learned since those early days of DMX… if end users ask for these types of tools often enough, manufacturers will eventually embrace them. When that happens, the industry as a whole improves. So, the time is now to reach out to your favorite lighting manufacturers and start asking them to support GDTF… we’ll all be glad you did!See the full August issue of PLSN Magazine.
For more info, visit the GDTF-share website at gdtf-share.com. For official documentation, please visit at https://gdtf-share.com/wiki/GDTF_File_Description. This site also offers GDTF and MVR file descriptions, GDTF tutorials, an MVR portable library, and more. For manufacturers interested in participating, please email info@gdtf-share.com or post in the GDTF forum at https://gdtf-share.com/forum/.About the Author
