Skip to content

Tracking Attributes Proposal #199

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

Open
moritzstaffel wants to merge 9 commits into
base: next
Choose a base branch
from
Open

Tracking Attributes Proposal #199

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
8476ea3
Add basic info here
moritzstaffel May 15, 2024
6f9ff15
Add Physical Units
moritzstaffel May 16, 2024
8fdd232
Add more samples and some info
moritzstaffel May 16, 2024
a6cc72e
Some basic text
moritzstaffel May 16, 2024
af7c2c7
Update proposal from notes
moritzstaffel May 22, 2024
ab91543
Update proposal.md
moritzstaffel May 22, 2024
2ebf387
Update spec with latest changes
moritzstaffel May 22, 2024
f263401
Update
moritzstaffel Jun 13, 2024
dc1f17a
Update
moritzstaffel Jun 13, 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
27 changes: 25 additions & 2 deletions gdtf-spec.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2674,7 +2674,7 @@ are not enumerated. The enumeration starts with 1. Attributes names are
considered as normalized. The upper and lower case of attribute names is
not taken into account.

```
``` xml
   <AttributeDefinitions>
       <ActivationGroups>
           <ActivationGroup Name="PanTilt" />
Expand All @@ -2694,6 +2694,7 @@ not taken into account.
           <ActivationGroup Name="Prism" />
           <ActivationGroup Name="BeamShaper" />
           <ActivationGroup Name="Shaper" />
           <ActivationGroup Name="Tracking" />
       </ActivationGroups>
       <FeatureGroups>
           <FeatureGroup Name="Dimmer">
Expand Down Expand Up @@ -2734,6 +2735,11 @@ not taken into account.
           <FeatureGroup Name="Video">
               <Feature Name="Video" />
           </FeatureGroup>
           <FeatureGroup Name="Tracking">
               <Feature Name="Fixture" />
               <Feature Name="Actor" />
               <Feature Name="Control" />
           </FeatureGroup>
       </FeatureGroups>
       <Attributes>
           <Attribute Name="Dimmer" Pretty="Dim" Feature="Dimmer.Dimmer" />
Expand Down Expand Up @@ -3074,14 +3080,31 @@ not taken into account.
           <Attribute Name="InputSource" Pretty="ISrc" Feature="Video.Video" PhysicalUnit="None" />
           <Attribute Name="VideoBlendMode" Pretty="BlendMode" Feature="Video.Video" PhysicalUnit="None" />
           <Attribute Name="VideoSoundVolume(n)" Pretty="Volume(n)" Feature="Video.Video" PhysicalUnit="Percent" />
           <Attribute Name="TrackerID" Pretty="ID" Feature="Tracking.Fixture" PhysicalUnit="None"/>
           <Attribute Name="TrackerCrossFade" Pretty="Cross Fade" Feature="Tracking.Fixture" PhysicalUnit="Percent"/>
           <Attribute Name="TrackerTime" Pretty="Tine" Feature="Tracking.Fixture" PhysicalUnit="Time"/>
           <Attribute Name="TrackerOffsetX" Pretty="Offset X" Feature="Tracking.Fixture" PhysicalUnit="Length"/>
           <Attribute Name="TrackerOffsetY" Pretty="Offset Y" Feature="Tracking.Fixture" PhysicalUnit="Length"/>
           <Attribute Name="TrackerOffsetZ" Pretty="Offset Z" Feature="Tracking.Fixture" PhysicalUnit="Length"/>
           <Attribute Name="TrackerMode" Pretty="Mode" Feature="Tracking.Fixture" PhysicalUnit="None"/>

           <Attribute Name="TrackerControlHeight" Pretty="Height" Feature="Tracking.Actor" PhysicalUnit="Length"/>
           <Attribute Name="TrackerControlSpeed" Pretty="Speed" Feature="Tracking.Actor" PhysicalUnit="Speed"/>
           <Attribute Name="TrackerControlFreeze" Pretty="Freeze" Feature="Tracking.Actor" PhysicalUnit="Percent"/>
           <Attribute Name="TrackerControlBeamSize" Pretty="Beam Size" Feature="Tracking.Actor" PhysicalUnit="Length"/>
           <Attribute Name="TrackerControlMode" Pretty="Control Mode" Feature="Tracking.Actor" PhysicalUnit="None"/>

           <Attribute Name="TrackerControlShow" Pretty="Show Mode" Feature="Tracking.Control" PhysicalUnit="None"/>
       </Attributes>

       </Attributes>
   </AttributeDefinitions>

```

Example for enumeration:

```
```xml
   <Attribute Name="Gobo1" Pretty="G1" ActivationGroup="Gobo1" Feature="Gobo.Gobo" />
   <Attribute Name="Gobo2" Pretty="G2" ActivationGroup="Gobo2" Feature="Gobo.Gobo" />
```
Expand Down
Binary file added proposal/tracking-attributes/ControlSide.PNG
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added proposal/tracking-attributes/KinematicChain.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added proposal/tracking-attributes/Sample.mvr
View file
Open in desktop
Binary file not shown.
59 changes: 59 additions & 0 deletions proposal/tracking-attributes/proposal.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
# Tracking Proposal

We will support tracking systems with new attributes. By default it is intended that the tracking info will be a child of the fixture it is for. This uses the Kinematic Chain feature from MVR.

![Kinematic Chain](./KinematicChain.png)

On the control side, you can use the encoders to group the properties also of the child fixtures.

![ControlSide](./ControlSide.png)

| Attribute | Description | What will happen in visualizers | What the Physical Value will mean |
|---|---|---|---|
| TrackerID | Defines the tracker ID that be used as a target for the fixture. | The fixture that is the parent of the tracker fixture, will point to the tracker with the given ID. | The Physical Value will be interpreted as an integer ID with rounding. |
| TrackerCrossFade | Defines how the value for the position and rotation of the device are calcualted. 0% means fully from the device, 100% means fully from the tracker position. | |
| TrackerTime | | |
| TrackerOffsetX | Defines the offset in X direction the device will point in relation the the actual tracker position. | | In the global coordinate system the tracking target will offsetted with in X direction. |
| TrackerOffsetY | Defines the offset in Y direction the device will point in relation the the actual tracker position. | | In the global coordinate system the tracking target will offsetted with in X direction.|
| TrackerOffsetZ | Defines the offset in Z direction the device will point in relation the the actual tracker position. | | In the global coordinate system the tracking target will offsetted with in X direction. |
| TrackerMode | Defines settings that you can make for the device and the tracker that is assigned to the device. | |
| TrackerControlHeight | Allows to define the offset in Z direction that the tracker will have for all devices using this tracker for positioning. | |
| TrackerControlSpeed | Defines how fast the device reacts to changes in the position of the tracker. | |
| TrackerControlFreeze | Defines how accurate the device reacts to changes in the position of the tracker. | |
| TrackerControlBeamSize | Defines how big the beam size for the fixture should be. | |
| TrackerControlMode | Defines settings that you can make to the tracker. | |
| TrackerControlShow | Defines settings that you can make to the show. | |


```xml
   <AttributeDefinitions>
       <ActivationGroups>
           ...
           <ActivationGroup Name="Tracking" />
       </ActivationGroups>
       <FeatureGroups>
...
           <FeatureGroup Name="Tracking">
               <Feature Name="Tracking" />
               <Feature Name="Actor" />
           </FeatureGroup>
       </FeatureGroups>
       <Attributes>
           <Attribute Name="TrackerID" Pretty="ID" Feature="Tracking.Fixture" PhysicalUnit="None"/>
           <Attribute Name="TrackerCrossFade" Pretty="Cross Fade" Feature="Tracking.Fixture" PhysicalUnit="Percent"/>
           <Attribute Name="TrackerTime" Pretty="Tine" Feature="Tracking.Fixture" PhysicalUnit="Time"/>
           <Attribute Name="TrackerOffsetX" Pretty="Offset X" Feature="Tracking.Fixture" PhysicalUnit="Length"/>
           <Attribute Name="TrackerOffsetY" Pretty="Offset Y" Feature="Tracking.Fixture" PhysicalUnit="Length"/>
           <Attribute Name="TrackerOffsetZ" Pretty="Offset Z" Feature="Tracking.Fixture" PhysicalUnit="Length"/>
           <Attribute Name="TrackerMode" Pretty="Mode" Feature="Tracking.Fixture" PhysicalUnit="None"/>

           <Attribute Name="TrackerControlHeight" Pretty="Height" Feature="Tracking.FixtureControl" PhysicalUnit="Length"/>
           <Attribute Name="TrackerControlSpeed" Pretty="Speed" Feature="Tracking.FixtureControl" PhysicalUnit="Speed"/>
           <Attribute Name="TrackerControlFreeze" Pretty="Freeze" Feature="Tracking.FixtureControl" PhysicalUnit="Percent"/>
           <Attribute Name="TrackerControlBeamSize" Pretty="Beam Size" Feature="Tracking.FixtureControl" PhysicalUnit="Length"/>
           <Attribute Name="TrackerControlMode" Pretty="Control Mode" Feature="Tracking.FixtureControl" PhysicalUnit="None"/>

           <Attribute Name="TrackerControlShow" Pretty="Show Mode" Feature="Tracking.FixtureControl" PhysicalUnit="None"/>
       </Attributes>
   </AttributeDefinitions>
```