From f8b66ff3afdb3c24f8c5103c94c6bd9302749d30 Mon Sep 17 00:00:00 2001 From: Moritz Staffel Date: Thu, 18 Apr 2024 11:15:58 +0200 Subject: [PATCH 1/2] More description about the structure of the repo and how we work --- README.md | 35 +++++++++++++++++++++++++++++++---- 1 file changed, 31 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 633efb99..1b63fb1c 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,35 @@ ![Logo from GDTF](gdtf-mvr-logo-color.png) -# DIN SPEC 15800 General Device Type Format (GDTF) and My Virtual Rig (MVR) File Format description +# DIN SPEC 15800 General Device Type Format (GDTF) and DIN SPEC 15801 My Virtual Rig (MVR) File Format description -The General Device Type Format (GDTF) creates a unified data exchange definition for the operation of intelligent luminaires, such as moving lights. By creating a manufacturer-supported, unified standard, customers/users of lighting control systems, CAD systems, and pre-visualizers benefit by knowing the tools they use to perform their job will work consistently and dependably. The file format is developed using open source formats, and luminaire manufacturers in the entertainment design, production, and performance industries are welcome to use this open source technology. +The General Device Type Format (GDTF) creates a unified data exchange definition for the operation of devices used in the entertainment industry. By creating a manufacturer-supported, unified standard, customers/users of lighting control systems, CAD systems, and pre-visualizers benefit by knowing the tools they use to perform their job will work consistently and dependably. The file format is developed using open source formats, and manufacturers in the entertainment design, production, and performance industries are welcome to use this open source technology. -The GDTF file format is standardized in [DIN SPEC 15800:2022-02](https://www.beuth.de/en/technical-rule/din-spec-15800/349717520). +The GDTF file format is standardized in [DIN SPEC 15800](https://www.beuth.de/en/technical-rule/din-spec-15800/349717520). The current version is: `DIN SPEC 15800:2022-02` +The MVR file format is standardized in [DIN SPEC 15801](https://www.beuth.de/en/technical-rule/din-spec-15801/373968511). The current version is: `DIN SPEC 15801:2023-12` -To gain commenting access, please email your GitHub username to info@gdtf-share.com , together with brief introduction about who you represent. +## About this repo + +This repo contain the [MVR](mvr-spec.md) and [GDTF](gdtf-spec.md) spec in markdown format for convenience. + +The [main](https://github.com/mvrdevelopment/spec/tree/main) branch contains the latest specs for the MVR and GDTF spec. + +The [next](https://github.com/mvrdevelopment/spec/tree/next) branch contains the current approved changes for the next DIN SPEC version. + +The folder [proposal](https://github.com/mvrdevelopment/spec/tree/main/proposal) contains the proposals that where considered for the given version of GDTF and MVR. This contains the changes to the GDTF/MVR spec together with a description of the changes. Normally this also has information about the motivation of the change, considered alternatives and examples. + + +The folder [examples](https://github.com/mvrdevelopment/spec/tree/main/examples) contain some examples of usage of the GDTF file format + +The folder [meshes](https://github.com/mvrdevelopment/spec/tree/main/meshes) contain the default meshes that are used by the GDTF spec. + +## How we work in the spec + +We use [Releases](https://github.com/mvrdevelopment/spec/releases) to tag versions of the GDTF/MVR spec. We tag the current DIN SPEC version as [latest](https://github.com/mvrdevelopment/spec/releases/latest). +This releases will be created out of the `main` branch. + +Creating a DIN SPEC takes some time. To get new features and definition to the GDTF/MVR specs faster, we also create intermediate version of GDTF and MVR so that companies can start implementing this. We tag this version as `pre-release`, but give them a version number so that this can be used in production. When a new DIN SPEC is released, this changes will be come part of it. +This releases will be created out of the `next` branch. + +Changes that we will do have their own branch and pull request while we actively working on them. When they have been approved by the group we will merge this changes into the `next` branch. + +## How to get involved +To gain commenting access, please email your GitHub username to info@gdtf-share.com, together with brief introduction about who you represent. From 5e144f9dfba2300c4747e4710945d4f1728fc237 Mon Sep 17 00:00:00 2001 From: Moritz Staffel Date: Tue, 23 Apr 2024 17:04:22 +0200 Subject: [PATCH 2/2] Update README.md --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 1b63fb1c..0bfec686 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ The MVR file format is standardized in [DIN SPEC 15801](https://www.beuth.de/en/ ## About this repo -This repo contain the [MVR](mvr-spec.md) and [GDTF](gdtf-spec.md) spec in markdown format for convenience. +This repo contains the [MVR](mvr-spec.md) and [GDTF](gdtf-spec.md) spec in markdown format for convenience. The [main](https://github.com/mvrdevelopment/spec/tree/main) branch contains the latest specs for the MVR and GDTF spec. @@ -17,9 +17,9 @@ The [next](https://github.com/mvrdevelopment/spec/tree/next) branch contains the The folder [proposal](https://github.com/mvrdevelopment/spec/tree/main/proposal) contains the proposals that where considered for the given version of GDTF and MVR. This contains the changes to the GDTF/MVR spec together with a description of the changes. Normally this also has information about the motivation of the change, considered alternatives and examples. -The folder [examples](https://github.com/mvrdevelopment/spec/tree/main/examples) contain some examples of usage of the GDTF file format +The folder [examples](https://github.com/mvrdevelopment/spec/tree/main/examples) contains some examples of usage of the GDTF file format. -The folder [meshes](https://github.com/mvrdevelopment/spec/tree/main/meshes) contain the default meshes that are used by the GDTF spec. +The folder [meshes](https://github.com/mvrdevelopment/spec/tree/main/meshes) contains the default meshes that are used by the GDTF spec. ## How we work in the spec