Skip to content

Commit fe652d3

Browse files
petrvanekrobepetrvanekrobe
committed
Add table of attributes mapping, rename png, add notes
1 parent dc1f17a commit fe652d3

3 files changed

Lines changed: 70 additions & 16 deletions

File tree

proposal/tracking-attributes/ControlSide.PNG renamed to proposal/tracking-attributes/ControlSide.png

File renamed without changes.

‎proposal/tracking-attributes/proposal.md‎

Lines changed: 27 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -8,22 +8,33 @@ On the control side, you can use the encoders to group the properties also of th
88

99
![ControlSide](./ControlSide.png)
1010

11-
| Attribute | Description | What will happen in visualizers | What the Physical Value will mean |
12-
|---|---|---|---|
13-
| 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. |
14-
| 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. | |
15-
| TrackerTime | | |
16-
| 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. |
17-
| 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.|
18-
| 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. |
19-
| TrackerMode | Defines settings that you can make for the device and the tracker that is assigned to the device. | |
20-
| TrackerControlHeight | Allows to define the offset in Z direction that the tracker will have for all devices using this tracker for positioning. | |
21-
| TrackerControlSpeed | Defines how fast the device reacts to changes in the position of the tracker. | |
22-
| TrackerControlFreeze | Defines how accurate the device reacts to changes in the position of the tracker. | |
23-
| TrackerControlBeamSize | Defines how big the beam size for the fixture should be. | |
24-
| TrackerControlMode | Defines settings that you can make to the tracker. | |
25-
| TrackerControlShow | Defines settings that you can make to the show. | |
11+
## Fixture Tracking Attributes
2612

13+
| Attribute | Name | Description | What will happen in visualizers | What the Physical Value will mean |
14+
|-------------------------|------|---|---|---|
15+
| TrackerID | Actor/FocusPoint/Tracker ID | Defines the tracker ID that be used as a target for the fixture. Note1 | The fixture that is the parent of the tracker fixture, will point to the tracker with the given ID. See Note1| The Physical Value will be interpreted as an integer ID with rounding. |
16+
| TrackerCrossFade | Cross Fade | Defines how the value for the position and rotation of the device are calculated. 0% means fully from the device, 100% means fully from the tracker position. | |
17+
| TrackerTime | Transition Time | | |
18+
| TrackerOffsetX | Beam Offset X | Defines the offset in X direction the device will point in relation the actual tracker position. | | In the global coordinate system the tracking target will offsetted with in X direction. |
19+
| TrackerOffsetY | Beam Offset Y | Defines the offset in Y direction the device will point in relation the actual tracker position. | | In the global coordinate system the tracking target will offsetted with in X direction.|
20+
| TrackerOffsetZ | Beam Offset Z | Defines the offset in Z direction the device will point in relation the actual tracker position. | | In the global coordinate system the tracking target will offsetted with in X direction. |
21+
| TrackerMode | ? Mode | Defines settings that you can make for the device and the tracker that is assigned to the device. | |
22+
23+
## Tracker Attributes
24+
25+
| Attribute | Name | Description | What will happen in visualizers | What the Physical Value will mean |
26+
|-------------------------|------|---|---|---|
27+
| TrackerControlHeight | | Allows to define the offset in Z direction that the tracker will have for all devices using this tracker for positioning. | |
28+
| TrackerControlSpeed | | Defines how fast the device reacts to changes in the position of the tracker. | |
29+
| TrackerControlFreeze | | Defines how accurate the device reacts to changes in the position of the tracker. | |
30+
| TrackerControlBeamSize | | Defines how big the beam size for the fixture should be. | |
31+
| TrackerControlMode | | Defines settings that you can make to the tracker. | |
32+
| TrackerControlShow | | Defines settings that you can make to the show. | |
33+
34+
35+
- Note1: Currently there is no "tracker" in MVR but we have concept of focus
36+
points, adding an integer id to the focus point would allow to select this
37+
focus point.
2738

2839
```xml
2940
   <AttributeDefinitions>
@@ -56,4 +67,4 @@ On the control side, you can use the encoders to group the properties also of th
5667
           <Attribute Name="TrackerControlShow" Pretty="Show Mode" Feature="Tracking.FixtureControl" PhysicalUnit="None"/>
5768
       </Attributes>
5869
   </AttributeDefinitions>
59-
```
70+
```

‎proposal/tracking-attributes/tracking-attributes.md‎

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
<style>
2+
table { border-collapse: collapse; width: 100%; }
3+
th, td { border: 1px solid #666; padding: 6px 8px; vertical-align: top; }
4+
th { background: #f3f3f3; text-align: left; }
5+
</style>
6+
7+
| Brand | Designation | Name | Prefix | Group | Name2 | GDTF Attribute | Multiple Use | Description |
8+
| ------------- | ----------- | ------------------------------ | ------ | ------- | ---------------- | -------------------------- | ------------ | ------------------------------------------------------------------------------------------ |
9+
| zacTrack | Actor | Height | TR | Target | Height | TR_Target_Height | | Target height: in 2D sets Z height; in 3D applies a height offset to the tracked position. |
10+
| zacTrack | Actor | Speed | TR | Target | Speed | TR_Target_Speed | | Selects a speed preset that changes the movement behavior of tracking. |
11+
| zacTrack | Actor | Smart Beam | TR | Fixture | FrameAssist | TR_Fixture_FrameAssist | | Auto-controls zoom/iris to keep beam size constant when the fixture can handle it. |
12+
| zacTrack | Actor | Freeze | TR | Target | Freeze | TR_Target_Freeze | | Filters small movements; can hold position so the beam stays steady. |
13+
| zacTrack | Actor | Actor Mode | TR | Target | Mode | TR_Target_Mode | | Selects tracker mode. |
14+
| zacTrack | Actor | Actor Fallback | TR | Target | Fallback | TR_Target_Fallback | | Fallback behavior/source when the primary tracking source is lost. |
15+
| zacTrack | Fixture | Actor | TR | Fixture | TrackerID | TR_Fixture_TrackerID | ☑️ | Assigns the fixture to follow a specific tracker/target. |
16+
| zacTrack | Fixture | CrossFade | TR | Fixture | CrossFade | TR_Fixture_CrossFade | ☑️ | Fades between console data and tracking data. |
17+
| zacTrack | Fixture | TransitionTime | TR | Fixture | CrossFadeTime | TR_Fixture_CrossFadeTime | | Transition time (fade time) or position delay for an assignment, depending on settings. |
18+
| zacTrack | Fixture | X-OffSet | TR | Fixture | OffsetX | TR_Fixture_OffsetX | | Applies an X offset to the tracked position. |
19+
| zacTrack | Fixture | Y-OffSet | TR | Fixture | OffsetY | TR_Fixture_OffsetY | | Applies a Y offset to the tracked position. |
20+
| zacTrack | Fixture | Z-OffSet | TR | Fixture | OffsetZ | TR_Fixture_OffsetZ | ☑️ | Applies a Z offset to the tracked position. |
21+
| zacTrack | Fixture | FixtureMode | TR | Fixture | Mode | TR_Fixture_Mode | | Selects the fixture tracking/merge mode. |
22+
| zacTrack | Show | Scene | TR | Show | Scene | TR_Show_Scene | | Selects the active scene via show control. |
23+
| zacTrack | Show | Terrain | TR | Show | Terrain | TR_Show_Terrain | | Selects the active terrain via show control. |
24+
| GroundControl | MultiToggle | Control Selection | TR | Fixture | Selection | TR_Fixture_Selection | ☑️ | Selects which fixture is controlled when one controller can address multiple fixtures. |
25+
| GroundControl | MultiToggle | Store Target Points | TR | Fixture | StoreTarget | TR_Fixture_StoreTarget | ☑️ | Stores target points/presets for later recall. |
26+
| GroundControl | Multi Main | Controller Configuration | TR | Global | ControllerConfig | TR_Global_ControllerConfig | | Controller configuration/settings. |
27+
| GroundControl | Multi Main | Camera Exposure | TR | Fixture | CameraExposure | TR_Fixture_CameraExposure | | Camera exposure control. |
28+
| GroundControl | Multi Main | Camera Zoom | TR | Fixture | CameraZoom | TR_Fixture_CameraZoom | | Camera zoom control. |
29+
| GroundControl | Multi Main | Camera White Balance + Reticle | TR | Fixture | CameraWBReticle | TR_Fixture_CameraWBReticle | | Camera white balance and reticle on/off control. |
30+
| GroundControl | Multi Main | Control Selection | TR | Fixture | Selection | TR_Fixture_Selection | ☑️ | Selects which fixture is controlled when one controller can address multiple fixtures. |
31+
| GroundControl | Multi Main | Store Target Points | TR | Fixture | StoreTarget | TR_Fixture_StoreTarget | ☑️ | Stores target points/presets for later recall. |
32+
| FollowMe | Fixture | Follow-Me Enable | TR | Fixture | CrossFade | TR_Fixture_CrossFade | ☑️ | Fades between console data and tracking data. |
33+
| FollowMe | Fixture | Target Assignment | TR | Fixture | TrackerID | TR_Fixture_TrackerID | ☑️ | Assigns the fixture to follow a specific tracker/target. |
34+
| FollowMe | Fixture | Enable CBS | TR | Fixture | FrameModel | TR_Fixture_FrameModel | | Enables/disables Continuous Beam Size (CBS). |
35+
| FollowMe | Fixture | CBS Size | TR | Fixture | FrameScale | TR_Fixture_FrameScale | | Sets CBS size between the configured minimum and maximum values. |
36+
| FollowMe | Fixture | Fixture Prediction | TR | Fixture | Prediction | TR_Fixture_Prediction | | Sets fixture prediction (0 to 1 second) to compensate for fixture lag. |
37+
| FollowMe | Fixture | Z Offset | TR | Fixture | OffsetZ | TR_Fixture_OffsetZ | ☑️ | Applies a Z offset to the tracked position. |
38+
| FollowMe | Target | Enable | TR | Target | Enable | TR_Target_Enable | | Enables/disables a target for tracking. |
39+
| FollowMe | Target | Target | TR | Target | TrackerID | TR_Target_TrackerID | | Selects the target/tracker ID. |
40+
| FollowMe | Target | CBS | TR | Target | BodyModel | TR_Target_BodyModel | | Enables Continuous Beam Size behavior for the target. |
41+
| FollowMe | Target | CBS Size | TR | Target | BodyScale | TR_Target_BodyScale | | Sets target beam diameter used for continuous beam size; copied to assigned fixtures. |
42+
| FollowMe | Target | Acceleration | TR | Target | Acceleration | TR_Target_Acceleration | | Acceleration scaling (0-100%) for tracking/fixture movement. |
43+
| FollowMe | Target | Z Offset | TR | Target | OffsetZ | TR_Target_OffsetZ | | Adjusts target z-offset (beam height) during the show. |

0 commit comments

Comments
 (0)