From 001c1cedbc98114df6881c009f1c10f9d7b7f403 Mon Sep 17 00:00:00 2001 From: Kevin Linzey <33553205+klinzey@users.noreply.github.com> Date: Wed, 17 Jun 2026 20:12:17 -0400 Subject: [PATCH 1/2] Revise speaker attributes and add XML example Updated speaker attributes table and added examples for clarity. --- gdtf-spec.md | 53 +++++++++++++++++++++++++++++++++++++++------------- 1 file changed, 40 insertions(+), 13 deletions(-) diff --git a/gdtf-spec.md b/gdtf-spec.md index fbc3edcb..bb4244e9 100644 --- a/gdtf-spec.md +++ b/gdtf-spec.md @@ -1818,17 +1818,15 @@ defined XML attributes of a speaker geometry are specified in #### Table XX. *Speaker Attributes* | XML Attribute Name | Value Type | Description | -|----|----|----| -| Name | [Name](#user-content-attrtype-name ) | The unique name of the geometry. | -| Model | [Name](#user-content-attrtype-name ) | Link to the corresponding model. | -| Position | [Matrix](#user-content-attrtype-matrix ) | Relative position of geometry; Default value: Identity Matrix | -| LinkedConsumer | [Node](#user-content-attrtype-node ) | Name of the Wire Geometry that this speaker is connected to. Need to an consumer type. | +|----|----|----| | +| Model | [Name](#user-content-attrtype-name ) | Optional. Link to the corresponding model. | +| Position | [Matrix](#user-content-attrtype-matrix ) | Relative position of model location and point of orign for ; Default value: Identity Matrix | | Impedance | [Float](#user-content-attrtype-float ) | Nominal impedance of the speaker, Ohms. | | VerticalCoverageUp | [Float](#user-content-attrtype-float ) | Vertical Coverage of the sound angle ?? (todo: define the axis) direction. (Degrees) Note that this values are defined in the Global Coordinate System of the GDTF. | | VerticalCoverageDown | [Float](#user-content-attrtype-float ) | Vertical Coverage of the sound angle ?? (todo: define the axis) direction. (Degrees) Note that this values are defined in the Global Coordinate System of the GDTF. | | HorizontalCoverageLeft | [Float](#user-content-attrtype-float ) | Horizontal Coverage of the sound angle ?? (todo: define the axis) direction. (Degrees) Note that this values are defined in the Global Coordinate System of the GDTF. | | HorizontalCoverageRight | [Float](#user-content-attrtype-float ) | Horizontal Coverage of the sound angle ?? (todo: define the axis) direction. (Degrees) Note that this values are defined in the Global Coordinate System of the GDTF. | -| SoundAngleRotationMax | | [Float](#user-content-attrtype-float ) |Maximum rotation of the sound dispersion around the speaker axis ?? which axis | +| SoundAngleRotationMax | [Float](#user-content-attrtype-float ) |Maximum rotation of the sound dispersion around the speaker axis ?? which axis | | FrequencyRangeMin | [Float](#user-content-attrtype-float ) | Minimal frequency of the speaker at the -6 dB mark. | | FrequencyRangeMax | [Float](#user-content-attrtype-float ) | Maximal frequency of the speaker at the -6 dB mark. | | MaxSPL | [Float](#user-content-attrtype-float ) | Maximum sound pressure level measured at 1 meter from the speaker. The value is interpreted together with the SPL format attributes below. | @@ -1836,17 +1834,46 @@ defined XML attributes of a speaker geometry are specified in #### Table XX. *MaxSPL Attributes* | XML Attribute Name | Value Type | Description | |----|----|----| -|ExcitationSignal | [String](#user-content-attrtype-string) | Pink noise, IEC60268, EIA426B, AES75 (enums?)| -|FrequencyWeighting | [String](#user-content-attrtype-string) | None, A-Weighting, C-Weighting (enums?)| -|Unit | [String](#user-content-attrtype-string) | DBZ, dB, DBSPL, dBA, dBC (enums?)| -|UnitMark | [String](#user-content-attrtype-string) | Leq, Laeq, LCeq, F, S | -|TimeWeighting | [String](#user-content-attrtype-string) | Fast, Slow, Leq, Peak, (enums?)| +|ExcitationSignal | [Enum](#user-content-attrtype-enum ) | The currently defined unit values are: Pink noise, IEC60268, EIA426B, AES75| +|FrequencyWeighting | [Enum](#user-content-attrtype-enum ) | The currently defined unit values are: None, A-Weighting, C-Weighting | +|Unit | [Enum](#user-content-attrtype-enum ) | The currently defined unit values are: DBZ, dB, DBSPL, dBA, dBC | +|UnitMark | [Enum](#user-content-attrtype-enum ) | The currently defined unit values are: Leq, Laeq, LCeq, F, S | +|TimeWeighting | [Enum](#user-content-attrtype-enum ) | The currently defined unit values are: Fast, Slow, Leq, Peak | TODO: Define default orientation of the speaker. Clarify if the values are for one speaker object ("speaker") or for the whole "speaker box". (Needed for MVR linking to the SoundAngleRotationMax and for the LinkedConsumer ) - - +EXAMPLE An example of a node definition is shown below: +```xml + + + + + + + + + + + + + + + + +``` +ToDO: *MaxSPL Attributes* Do we need to restructure above to support the attributes ## DMX Mode Collect ### General From 48f2a38678b37124d5468ef3ceeb352d60fc9083 Mon Sep 17 00:00:00 2001 From: petrvanekrobe <45997318+petrvanekrobe@users.noreply.github.com> Date: Thu, 18 Jun 2026 07:27:38 +0200 Subject: [PATCH 2/2] Fix table --- gdtf-spec.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/gdtf-spec.md b/gdtf-spec.md index bb4244e9..314d98c4 100644 --- a/gdtf-spec.md +++ b/gdtf-spec.md @@ -1818,7 +1818,7 @@ defined XML attributes of a speaker geometry are specified in #### Table XX. *Speaker Attributes* | XML Attribute Name | Value Type | Description | -|----|----|----| | +|----|----|----| | Model | [Name](#user-content-attrtype-name ) | Optional. Link to the corresponding model. | | Position | [Matrix](#user-content-attrtype-matrix ) | Relative position of model location and point of orign for ; Default value: Identity Matrix | | Impedance | [Float](#user-content-attrtype-float ) | Nominal impedance of the speaker, Ohms. |