diff --git a/gdtf-spec.md b/gdtf-spec.md index fbc3edc..6a95501 100644 --- a/gdtf-spec.md +++ b/gdtf-spec.md @@ -1812,41 +1812,71 @@ 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.
#### 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. 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. | | 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. | - -#### 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?)| +| 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. 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 ) - - + +TODO: Define default orientation of the speaker. + +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