diff --git a/gdtf-spec.md b/gdtf-spec.md index 1172413f..9a43f954 100644 --- a/gdtf-spec.md +++ b/gdtf-spec.md @@ -2779,7 +2779,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                         @@ -2799,6 +2799,7 @@ not taken into account.                                     +                                        @@ -2839,6 +2840,11 @@ not taken into account.                                         +            +                +                +                +                                        @@ -3179,6 +3185,23 @@ not taken into account.                                     +            +            +            +            +            +            +            + +            +            +            +            +            + +            +        +             @@ -3186,7 +3209,7 @@ not taken into account. Example for enumeration: -``` +```xml         ``` diff --git a/proposal/tracking-attributes/ControlSide.png b/proposal/tracking-attributes/ControlSide.png new file mode 100644 index 00000000..55e25299 Binary files /dev/null and b/proposal/tracking-attributes/ControlSide.png differ diff --git a/proposal/tracking-attributes/KinematicChain.png b/proposal/tracking-attributes/KinematicChain.png new file mode 100644 index 00000000..68bce2a3 Binary files /dev/null and b/proposal/tracking-attributes/KinematicChain.png differ diff --git a/proposal/tracking-attributes/Sample.mvr b/proposal/tracking-attributes/Sample.mvr new file mode 100644 index 00000000..ed1c7ada Binary files /dev/null and b/proposal/tracking-attributes/Sample.mvr differ diff --git a/proposal/tracking-attributes/proposal.md b/proposal/tracking-attributes/proposal.md new file mode 100644 index 00000000..d53df052 --- /dev/null +++ b/proposal/tracking-attributes/proposal.md @@ -0,0 +1,70 @@ +# 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) + +## Fixture Tracking Attributes + +| Attribute | Name | Description | What will happen in visualizers | What the Physical Value will mean | +|-------------------------|------|---|---|---| +| 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. | +| 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. | | +| TrackerTime | Transition Time | | | +| 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. | +| 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.| +| 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. | +| TrackerMode | ? Mode | Defines settings that you can make for the device and the tracker that is assigned to the device. | | + +## Tracker Attributes + +| Attribute | Name | Description | What will happen in visualizers | What the Physical Value will mean | +|-------------------------|------|---|---|---| +| 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. | | + + +- Note1: Currently there is no "tracker" in MVR but we have concept of focus + points, adding an integer id to the focus point would allow to select this + focus point. + +```xml +    +        +           ... +            +        +        + ... +            +                +                +            +        +        +            +            +            +            +            +            +            + +            +            +            +            +            + +            +        +    +``` diff --git a/proposal/tracking-attributes/tracking-attributes.md b/proposal/tracking-attributes/tracking-attributes.md new file mode 100644 index 00000000..427ee789 --- /dev/null +++ b/proposal/tracking-attributes/tracking-attributes.md @@ -0,0 +1,49 @@ + + +| Brand | Designation | Name | Prefix | Group | Name2 | GDTF Attribute | Multiple Use | Description | Pretty Name | Physical | Column1 | +| ------------- | ----------- | ------------------------------ | ------ | ------- | ---------------- | -------------------------- | ------------ | ------------------------------------------------------------------------------------------ | ----------- | -------- | ---------------------------------------------------- | +| 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. | | | | +| zacTrack | Actor | Speed | TR | Target | Speed | TR_Target_Speed | | Selects a speed preset that changes the movement behavior of tracking. | | | | +| zacTrack | Actor | Smart Beam | TR | Fixture | BeamSizeEnable | TR_Fixture_BeamSizeEnable | ☑️ | Auto-controls zoom/iris to keep beam size constant when the fixture can handle it | | | | +| zacTrack | Actor | Freeze | TR | Target | Freeze | TR_Target_Freeze | | Filters small movements; can hold position so the beam stays steady. | | | | +| zacTrack | Actor | Actor Mode | TR | Target | Mode | TR_Target_Mode | | Selects tracker mode. | | | | +| zacTrack | Actor | Actor Fallback | TR | Target | Fallback | TR_Target_Fallback | | Fallback behavior/source when the primary tracking source is lost. | | | | +| zacTrack | Fixture | Actor | TR | Fixture | TargetID | TR_Fixture_TargetID | ☑️ | Assigns the fixture to follow a specific actor/target | | | | +| zacTrack | Fixture | CrossFade | TR | Fixture | CrossFade | TR_Fixture_CrossFade | ☑️ | Fades between console data and tracking data. | | | | +| zacTrack | Fixture | TransitionTime | TR | Fixture | CrossFadeTime | TR_Fixture_CrossFadeTime | | Transition time (fade time) or position delay for an assignment, depending on settings. | | | | +| zacTrack | Fixture | X-OffSet | TR | Fixture | OffsetX | TR_Fixture_OffsetX | | Applies an X offset to the tracked position. | | | | +| zacTrack | Fixture | Y-OffSet | TR | Fixture | OffsetY | TR_Fixture_OffsetY | | Applies a Y offset to the tracked position. | | | | +| zacTrack | Fixture | Z-OffSet | TR | Fixture | OffsetZ | TR_Fixture_OffsetZ | ☑️ | Applies a Z offset to the tracked position. | | | | +| zacTrack | Fixture | FixtureMode | TR | Fixture | Mode | TR_Fixture_Mode | | Selects the fixture tracking/merge mode. | | | | +| zacTrack | Show | Scene | TR | Show | Scene | TR_Show_Scene | | Selects the active scene via show control. | | | | +| zacTrack | Show | Terrain | TR | Show | Terrain | TR_Show_Terrain | | Selects the active terrain via show control. | | | | +| GroundControl | MultiToggle | Control Selection | TR | Fixture | Selection | TR_Fixture_Selection | ☑️ | Selects which fixture is controlled when one controller can address multiple fixtures. | | | | +| GroundControl | MultiToggle | Store Target Points | TR | Fixture | StoreTarget | TR_Fixture_StoreTarget | ☑️ | Stores target points/presets for later recall. | | | | +| GroundControl | Multi Main | Controller Configuration | TR | Global | ControllerConfig | TR_Global_ControllerConfig | | Controller configuration/settings. | | | | +| GroundControl | Multi Main | Camera Exposure | TR | Fixture | CameraExposure | TR_Fixture_CameraExposure | | Camera exposure control. | | | | +| GroundControl | Multi Main | Camera Zoom | TR | Fixture | CameraZoom | TR_Fixture_CameraZoom | | Camera zoom control. | | | | +| GroundControl | Multi Main | Camera White Balance + Reticle | TR | Fixture | CameraWBReticle | TR_Fixture_CameraWBReticle | | Camera white balance and reticle on/off control. | | | | +| GroundControl | Multi Main | Control Selection | TR | Fixture | Selection | TR_Fixture_Selection | ☑️ | Selects which fixture is controlled when one controller can address multiple fixtures. | | | | +| GroundControl | Multi Main | Store Target Points | TR | Fixture | StoreTarget | TR_Fixture_StoreTarget | ☑️ | Stores target points/presets for later recall. | | | | +| FollowMe | Fixture | Follow-Me Enable | TR | Fixture | CrossFade | TR_Fixture_CrossFade | ☑️ | Fades between console data and tracking data. | | | | +| FollowMe | Fixture | Target Assignment | TR | Fixture | TargetID | TR_Fixture_TargetID | ☑️ | Assigns the fixture to follow a specific actor/target | | | | +| FollowMe | Fixture | Enable CBS | TR | Fixture | BeamSizeEnable | TR_Fixture_BeamSizeEnable | ☑️ | Auto-controls zoom/iris to keep beam size constant when the fixture can handle it | | | | +| FollowMe | Fixture | CBS Size | TR | Fixture | BeamSize | TR_Fixture_BeamSize | | Defines the value for the constant BeamSize of the auto control | | | | +| FollowMe | Fixture | Fixture Prediction | TR | Fixture | Prediction | TR_Fixture_Prediction | | Sets fixture prediction (0 to 1 second) to compensate for fixture lag. | | | | +| FollowMe | Fixture | Z Offset | TR | Fixture | OffsetZ | TR_Fixture_OffsetZ | ☑️ | Applies a Z offset to the tracked position. | | | | +| FollowMe | Target | Enable | TR | Target | Enable | TR_Target_Enable | | Enables/disables a target for tracking. | | | | +| FollowMe | Target | CBS | TR | Target | BeamSizeEnable | TR_Target_BeamSizeEnable | | Auto-controls zoom/iris to keep beam size constant when the fixture can handle it | | | | +| FollowMe | Target | CBS Size | TR | Target | BeamSize | TR_Target_BeamSize | | Defines the value for the constant BeamSize of the auto control | | | | +| FollowMe | Target | Acceleration | TR | Target | Acceleration | TR_Target_Acceleration | | Acceleration scaling (0-100%) for tracking/fixture movement. | | | | +| FollowMe | Target | Z Offset | TR | Target | OffsetZ | TR_Target_OffsetZ | | Adjusts target z-offset (beam height) during the show. | | | | +| Macula | | | | | | | ☑️ | | | | | +| BlackTrax | | | | | | | ☑️ | | | | | +| RJ SpotMe | | | | | | | ☑️ | | | | https://www.robertjuliat.com/accessories/SpotMe.html | +| SpotTrack | | | | | | | ☑️ | | | | | +| RoboSpot | | | | | | | ☑️ | | | | | +| Vivien CAST | | | | | | | ☑️ | | | | | +