Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

More description about the structure of the repo and how we work #192

Merged
merged 2 commits into from
Apr 23, 2024
Merged

More description about the structure of the repo and how we work #192

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f8b66ff
More description about the structure of the repo and how we work
moritzstaffel Apr 18, 2024
5e144f9
Update README.md
moritzstaffel Apr 23, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 31 additions & 4 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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 [email protected] , together with brief introduction about who you represent.
## About this repo

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.

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) contains some examples of usage of the GDTF file format.

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

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 [email protected], together with brief introduction about who you represent.
Loading