Skip to content

Attributes listing and wheels usage#300

Open
petrvanekrobe wants to merge 9 commits intonextfrom
attributes_listing_and_wheels_usage
Open

Attributes listing and wheels usage#300
petrvanekrobe wants to merge 9 commits intonextfrom
attributes_listing_and_wheels_usage

Conversation

@petrvanekrobe
Copy link
Copy Markdown
Contributor

@petrvanekrobe petrvanekrobe commented Mar 6, 2026

This PR is merging the gdtf_attributes_with_description.json with the GDTF Attributes listing attributes_listing.xml Annex B (normative) Attribute Listing. This is to resolve #299 .

Further requirements:

  • Update Channel Set - WheelSlotLink definition to refer to attributes needs for requirements of WheelSlotIndex usage
  • Update all places with Emitter
  • Update all places with Filter
  • Update all places with Gammut
  • Update all places with Wheel
  • Update all places with WheelSlot
  • Update all places with ColorSpace
  • Update the attributes_listing.xml and set the required fields for each attribute, by default set to False now:
    "UseEmmiter": "False",
    "UseFilter": "False",
    "UseWheel": "False",
    "UseWheelSlot": "False",
    "UseGamut": "False",
    "UseColorSpace": "False",

Helper python script is still included, but can be removed later. Right now, it could be modified and re-run to change the default values / can also be done by find-replace...

@petrvanekrobe petrvanekrobe changed the base branch from main to next March 11, 2026 15:20
@petrvanekrobe petrvanekrobe force-pushed the attributes_listing_and_wheels_usage branch from a979e6b to 4583f7e Compare March 11, 2026 15:28
Copy link
Copy Markdown
Contributor Author

@petrvanekrobe petrvanekrobe left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good

@petrvanekrobe
Copy link
Copy Markdown
Contributor Author

Define/describe new XML attributes for Attribute, (table 9).
Generate Annex A1.

@petrvanekrobe
Copy link
Copy Markdown
Contributor Author

I have updated the Attribute description, updated the Annex A and Annex B, see individual commits.

Comment thread gdtf-spec.md
| ActivationGroup | [Node](#user-content-attrtype-node ) | Optional link to the activation group. The starting point is the [activation groups](#user-content-activation-groups ) node. |
| Feature | [Node](#user-content-attrtype-node ) | Link to the corresponding feature. The starting point is the [feature groups](#user-content-feature-groups ) node. |
| MainAttribute | [Node](#user-content-attrtype-node ) | Optional link to the main attribute. The starting point is the [attribute](#user-content-attribute ) node. |
| PhysicalUnit | [Enum](#user-content-attrtype-enum ) | The currently defined unit values are: “None”, “Percent”, “Length” (m), “Mass” (kg), “Time” (s), “Temperature” (K), “LuminousIntensity”(cd), “Angle” (degree), “Force” (N), “Frequency” (Hz), “Current” (A), “Voltage” (V), “Power” (W), “Energy” (J), “Area” (m2), “Volume” (m3), “Speed” (m/s), “Acceleration” (m/s2), “AngularSpeed” (degree/s), “AngularAccc” (degree/s2), “WaveLength” (nm), “ColorComponent”. Default: “None”. |
| Color | [ColorCIE](#user-content-attrtype-colorcie ) | Optional. Defines the color for the attribute. |
| | | |

| Definition | [String](#user-content-attrtype-string ) | Description of what the attribute defines. |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think Definition and Explanation should be optional

Comment thread gdtf-spec.md
| | | |

| Definition | [String](#user-content-attrtype-string ) | Description of what the attribute defines. |
| Explanation | [String](#user-content-attrtype-string ) | Longer form explanation of what the attribute defines with focus on the user. |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The other ones should have a default = false

Comment thread gdtf-spec.md
| WhiteCount | Controls if White LED is proportionally added to RGB. |
| StrobeMode | Changes strobe style - strobe, pulse, random strobe, etc. - of the shutter attribute. |
| ZoomMode | Changes modes of the fixture´s zoom. |
| FocusMode | Changes modes of the fixture’s focus - manual or auto- focus. |
| IrisMode | Changes modes of the fixture’s iris - linear, strobe, pulse. |
| Fan(n)Mode | Controls fan (n) mode. |
| FanMode | Controls fan (n) mode. |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we should remove the (n) from the description, too

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Clarify which attributes require link to a Wheel

2 participants