From d39f7617b8e20c86334b372a4ed5db224cbb60dd Mon Sep 17 00:00:00 2001 From: Petr Vanek Date: Thu, 18 Jun 2026 14:39:08 +0200 Subject: [PATCH 1/4] Add Amplifier object --- gdtf-spec.md | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) diff --git a/gdtf-spec.md b/gdtf-spec.md index fbc3edcb..e1736a89 100644 --- a/gdtf-spec.md +++ b/gdtf-spec.md @@ -1847,6 +1847,62 @@ defined XML attributes of a speaker geometry are specified in 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 ) +### Geometry Type Amplifier + +This type of geometry is used to describe an amplifier block in a audio device. (XML node ``). The currently +defined XML attributes of a speaker geometry are specified in [table 55](#user-content-table-XX ). + + +#### Table XX. *Amplifier Attributes* + +| Attribute Name | Value Type / Unit | Description | +| -------------- | ----------------: | -------------------------------------------- | +| Name | [Name](#user-content-attrtype-name ) | 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 | +| -------------- | ----------------: | ------------------------------------------------------ | +| ChannelCount | [Int](#user-content-attrtype-int ) | Number of amplifier channels or logical output groups. | +| AmplifierClass | [Enum](#user-content-attrtype-enum ) |Defined values are: `A`, `AB`, `D`, `Other`. Default: Other | +| DSP | [Enum](#user-content-attrtype-enum )| Defines whether the amplifier includes DSP. Defined values are "Yes", "No". Default value: "No" +| Latency | [Float](#user-content-attrtype-float ) | Amplifier or amplifier/DSP latency. Unit: ms. Default: 0 | +| CoolingType | [Enum](#user-content-attrtype-enum )|Defined values are: `Passive`, `Fan`, `Other`. Default value: Other | + +As children the Amplifier has a list of [Amplifier Channel](#user-content-amplifier-channel). + +#### `AmplifierChannel` + +`AmplifierChannel` describes one amplifier output channel or logical output group. + The currently defined XML attributes of AmplifierChannel are specified in +[table xx](#user-content-table-xx). + +#### Table xx. *Amplifier Channel Attributes* + +| Attribute Name | Value Type / Unit | Description | +| ------------------ | ----------------: | ---------------------------------------------------------------------------------------------------------------------- | +| Name | [Name](#user-content-attrtype-name ) | Required unique channel name. | +| ChannelIndex | [Int](#user-content-attrtype-int ) | Channel index. | +| Mode | [Enum](#user-content-attrtype-enum ) | Defined values are: `SingleEnded`, `Bridge`, `ParallelBridge`, `HighImpedance70V`, `HighImpedance100V`, `Other`. Default value: Other | +| OutputPower | [Float](#user-content-attrtype-float )| Rated output power for the documented condition. Unit: watt. Default value: 0 | +| LoadImpedance | [Float](#user-content-attrtype-float ) | Nominal load impedance for the rating. Unit: ohm. Default value: 0 | +| MinLoadImpedance | [Float](#user-content-attrtype-float ) | Minimum supported load impedance. Unit: ohm. Default value: 0 | +| MaxOutputVoltage | [Float](#user-content-attrtype-float ) | Maximum output voltage. Unit: volt. Default value: 0 | +| VoltageMeasurement | [Enum](#user-content-attrtype-enum ) | Defined values are: `Peak`, `RMS`. Default value: TBD. | +| MaxOutputCurrent | [Float](#user-content-attrtype-float ) | Maximum output current. Unit: ampere. Default value: 0 | +| CurrentMeasurement | [Enum](#user-content-attrtype-enum ) | Defined values are: `Peak`, `RMS`. Default value: TBD | +| THDN | [Float](#user-content-attrtype-float ) | Optional total harmonic distortion plus noise. Unit: percent. Default value: 0 | +| CrestFactor | [Float](#user-content-attrtype-float ) | Optional crest factor for the rating. Unit: decibel. Default value: 0 | +| FrequencyRangeMin | [Float](#user-content-attrtype-float ) | Minimum frequency of the amplifier channel. Unit: hertz. Default value: 0 | +| FrequencyRangeMax | [Float](#user-content-attrtype-float ) | Maximum frequency of the amplifier channel. Unit: hertz. Default value: 0 | +| LinkedOutput | [Node](#user-content-attrtype-node ) | Optional link to the GDTF `WiringObject` that represents the amplifier output. | +| LinkedSpeaker | [Node](#user-content-attrtype-node ) | Optional link to the `Speaker` geometry fed by this amplifier channel when the speaker is inside the same GDTF device. | + +For a self-powered loudspeaker, the `Amplifier` and `Speaker` should normally be children of the same device hierarchy. + +The amplifier channel may link to the internal speaker output `WiringObject` and/or directly to the `Speaker` geometry through `LinkedSpeaker`. + +For a passive loudspeaker driven by an external amplifier, do not directly link the external amplifier’s GDTF to the passive speaker’s GDTF. The instance-to-instance relationship belongs in MVR using `Connections`. + + ## DMX Mode Collect ### General From cde414a9c19ce2656d9290b0c90dcd356e248a7b Mon Sep 17 00:00:00 2001 From: Petr Vanek Date: Thu, 18 Jun 2026 14:43:55 +0200 Subject: [PATCH 2/4] Add amplifier example --- gdtf-spec.md | 26 +++++++++++++++++++++++++- 1 file changed, 25 insertions(+), 1 deletion(-) diff --git a/gdtf-spec.md b/gdtf-spec.md index e1736a89..3cb8b6b7 100644 --- a/gdtf-spec.md +++ b/gdtf-spec.md @@ -1860,7 +1860,6 @@ defined XML attributes of a speaker geometry are specified in [table 55](#user-c | Name | [Name](#user-content-attrtype-name ) | 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 | -| -------------- | ----------------: | ------------------------------------------------------ | | ChannelCount | [Int](#user-content-attrtype-int ) | Number of amplifier channels or logical output groups. | | AmplifierClass | [Enum](#user-content-attrtype-enum ) |Defined values are: `A`, `AB`, `D`, `Other`. Default: Other | | DSP | [Enum](#user-content-attrtype-enum )| Defines whether the amplifier includes DSP. Defined values are "Yes", "No". Default value: "No" @@ -1902,6 +1901,31 @@ The amplifier channel may link to the internal speaker output `WiringObject` and For a passive loudspeaker driven by an external amplifier, do not directly link the external amplifier’s GDTF to the passive speaker’s GDTF. The instance-to-instance relationship belongs in MVR using `Connections`. +EXAMPLE: + +```xml + + + +``` ## DMX Mode Collect From cb971c556bbf52d1bc722b9162a9dde2952e9622 Mon Sep 17 00:00:00 2001 From: Petr Vanek Date: Thu, 18 Jun 2026 14:59:28 +0200 Subject: [PATCH 3/4] Define starting poing of node path --- gdtf-spec.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/gdtf-spec.md b/gdtf-spec.md index 3cb8b6b7..d12fcc55 100644 --- a/gdtf-spec.md +++ b/gdtf-spec.md @@ -1892,8 +1892,8 @@ As children the Amplifier has a list of [Amplifier Channel](#user-content-amplif | CrestFactor | [Float](#user-content-attrtype-float ) | Optional crest factor for the rating. Unit: decibel. Default value: 0 | | FrequencyRangeMin | [Float](#user-content-attrtype-float ) | Minimum frequency of the amplifier channel. Unit: hertz. Default value: 0 | | FrequencyRangeMax | [Float](#user-content-attrtype-float ) | Maximum frequency of the amplifier channel. Unit: hertz. Default value: 0 | -| LinkedOutput | [Node](#user-content-attrtype-node ) | Optional link to the GDTF `WiringObject` that represents the amplifier output. | -| LinkedSpeaker | [Node](#user-content-attrtype-node ) | Optional link to the `Speaker` geometry fed by this amplifier channel when the speaker is inside the same GDTF device. | +| LinkedOutput | [Node](#user-content-attrtype-node ) | Optional link to the GDTF `WiringObject` that represents the amplifier output. Starting point is the[Geometries Collect](#user-content-geometry-collect)| +| LinkedSpeaker | [Node](#user-content-attrtype-node ) | Optional link to the `Speaker` geometry fed by this amplifier channel when the speaker is inside the same GDTF device. Starting point is the [Geometries Collect](#user-content-geometry-collect)| For a self-powered loudspeaker, the `Amplifier` and `Speaker` should normally be children of the same device hierarchy. From 05d9c0f6b0c47b10f96c010e8d1f182a52799b4e Mon Sep 17 00:00:00 2001 From: Petr Vanek Date: Fri, 19 Jun 2026 11:34:11 +0200 Subject: [PATCH 4/4] Adjust amplifier definition --- gdtf-spec.md | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/gdtf-spec.md b/gdtf-spec.md index d12fcc55..77a77bfa 100644 --- a/gdtf-spec.md +++ b/gdtf-spec.md @@ -1849,8 +1849,8 @@ TODO: Define default orientation of the speaker. Clarify if the values are for o ### Geometry Type Amplifier -This type of geometry is used to describe an amplifier block in a audio device. (XML node ``). The currently -defined XML attributes of a speaker geometry are specified in [table 55](#user-content-table-XX ). +This type of geometry is used to describe an amplifier in an audio device. (XML node ``). The currently +defined XML attributes of an Amplifier geometry are specified in [table xx](#user-content-table-XX ). #### Table XX. *Amplifier Attributes* @@ -1860,7 +1860,6 @@ defined XML attributes of a speaker geometry are specified in [table 55](#user-c | Name | [Name](#user-content-attrtype-name ) | 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 | -| ChannelCount | [Int](#user-content-attrtype-int ) | Number of amplifier channels or logical output groups. | | AmplifierClass | [Enum](#user-content-attrtype-enum ) |Defined values are: `A`, `AB`, `D`, `Other`. Default: Other | | DSP | [Enum](#user-content-attrtype-enum )| Defines whether the amplifier includes DSP. Defined values are "Yes", "No". Default value: "No" | Latency | [Float](#user-content-attrtype-float ) | Amplifier or amplifier/DSP latency. Unit: ms. Default: 0 | @@ -1868,11 +1867,11 @@ defined XML attributes of a speaker geometry are specified in [table 55](#user-c As children the Amplifier has a list of [Amplifier Channel](#user-content-amplifier-channel). -#### `AmplifierChannel` +#### AmplifierChannel -`AmplifierChannel` describes one amplifier output channel or logical output group. - The currently defined XML attributes of AmplifierChannel are specified in -[table xx](#user-content-table-xx). +AmplifierChannel describes one amplifier output channel. The currently defined +XML attributes of AmplifierChannel are specified in [table +xx](#user-content-table-xx). #### Table xx. *Amplifier Channel Attributes* @@ -1892,7 +1891,7 @@ As children the Amplifier has a list of [Amplifier Channel](#user-content-amplif | CrestFactor | [Float](#user-content-attrtype-float ) | Optional crest factor for the rating. Unit: decibel. Default value: 0 | | FrequencyRangeMin | [Float](#user-content-attrtype-float ) | Minimum frequency of the amplifier channel. Unit: hertz. Default value: 0 | | FrequencyRangeMax | [Float](#user-content-attrtype-float ) | Maximum frequency of the amplifier channel. Unit: hertz. Default value: 0 | -| LinkedOutput | [Node](#user-content-attrtype-node ) | Optional link to the GDTF `WiringObject` that represents the amplifier output. Starting point is the[Geometries Collect](#user-content-geometry-collect)| +| LinkedOutput | [Node](#user-content-attrtype-node ) | Optional link to the GDTF `WiringObject` that represents the amplifier channel output. Starting point is the[Geometries Collect](#user-content-geometry-collect)| | LinkedSpeaker | [Node](#user-content-attrtype-node ) | Optional link to the `Speaker` geometry fed by this amplifier channel when the speaker is inside the same GDTF device. Starting point is the [Geometries Collect](#user-content-geometry-collect)| For a self-powered loudspeaker, the `Amplifier` and `Speaker` should normally be children of the same device hierarchy.