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/3] 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/3] 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. | From 7ba9d7eb67bd4859f649b61341f51ded3c6127c1 Mon Sep 17 00:00:00 2001 From: Kevin Linzey <33553205+klinzey@users.noreply.github.com> Date: Wed, 24 Jun 2026 18:39:47 -0400 Subject: [PATCH 3/3] Revise speaker geometry and SPL attributes Updated speaker geometry attributes and added new SPL attributes. Clarified the purpose of the node and provided an example of a node definition. --- gdtf-spec.md | 31 +++++++++++++++++-------------- 1 file changed, 17 insertions(+), 14 deletions(-) diff --git a/gdtf-spec.md b/gdtf-spec.md index 314d98c4..6a955019 100644 --- a/gdtf-spec.md +++ b/gdtf-spec.md @@ -1812,6 +1812,7 @@ This type of geometry is used to describe a speaker in a audio device. (XML node defined XML attributes of a speaker geometry are specified in [table 55](#user-content-table-XX ). +Note: `` data is typically represents the completed speaker assembly and not the individual emitters; however mutiple `` nodes can be used if required.
@@ -1819,8 +1820,8 @@ defined XML attributes of a speaker geometry are specified in | 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 | +| Model | [Name](#user-content-attrtype-name ) | Optional. Link to the corresponding model. Can be empty. | +| Position | [Matrix](#user-content-attrtype-matrix ) | Relative position of model location and point of orign for coverage calculation and sound emission. 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. | @@ -1829,20 +1830,17 @@ defined XML attributes of a speaker geometry are specified in | 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. | - -#### Table XX. *MaxSPL Attributes* -| XML Attribute Name | Value Type | Description | -|----|----|----| -|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 | +| 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.| +| SPLExcitationSignal | [Enum](#user-content-attrtype-enum ) | The currently defined unit values are: Pink noise, IEC60268, EIA426B, AES75| +| SPLFrequencyWeighting | [Enum](#user-content-attrtype-enum ) | The currently defined unit values are: None, A-Weighting, C-Weighting | +| SPLUnit | [Enum](#user-content-attrtype-enum ) | The currently defined unit values are: DBZ, dB, DBSPL, dBA, dBC | +| SPLUnitMark | [Enum](#user-content-attrtype-enum ) | The currently defined unit values are: Leq, Laeq, LCeq, F, S | +| SPLTimeWeighting | [Enum](#user-content-attrtype-enum ) | The currently defined unit values are: Fast, Slow, Leq, Peak |
+ +TODO: Define default orientation of the speaker. -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 @@ -1861,7 +1859,12 @@ EXAMPLE An example of a node definition is shown below: SoundAngleRotationMax="30.000000" FrequencyMin="120.000000" FrequencyMax="20.000000" - MaxSPL="55.000000" /> + MaxSPL="55.000000" + SPLExcitationSignal="Pink noise" + SPLFrequencyWeighting=None" + SPLUnit="DBX" + SPLUnitMark="Leq" + SPLTimeWeighting="Fast"/>