Skip to content

Draft for Audio Support #179

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
moritzstaffel wants to merge 19 commits into
base: next
Choose a base branch
from
+395 −4
Open

Draft for Audio Support #179

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
19 commits
Select commit Hold shift + click to select a range
8d43ff4
Speaker Geometry
moritzstaffel Feb 11, 2024
a4ab9d0
Create proposal.md
moritzstaffel Feb 11, 2024
7f6335d
Update proposal.md
moritzstaffel Apr 5, 2024
4bc35bd
Merge branch 'next' into audio-proposal
moritzstaffel Apr 17, 2024
8aa14bc
Add Properties of Speaker
moritzstaffel Apr 18, 2024
6196614
Add listenting plane
moritzstaffel Apr 18, 2024
5e70ae3
Update proposal.md
moritzstaffel Apr 18, 2024
3c2362f
Update proposal.md
moritzstaffel Apr 18, 2024
167cdc2
Update proposal.md
moritzstaffel Apr 18, 2024
3bb7fc4
Update the proposal based on latest feedback/comments
petrvanekrobe May 12, 2026
6d19ab3
Add initial Amplifier specification
petrvanekrobe May 12, 2026
729f0a6
Define ListeningPlane node and its attributes
klinzey May 14, 2026
a22f2d9
Revise speaker and MaxSPL attributes in gdtf-spec
klinzey May 14, 2026
9db2c0f
Define Speaker node with attributes and children
klinzey May 14, 2026
0f0e268
Adjusting attributes and their definitions, adding some todo items
petrvanekrobe May 14, 2026
4e0a1c0
Further definitions for Audio proposal
petrvanekrobe Jun 11, 2026
6a050f9
Extend the definition for the ListeningPlaneHeatMaps
petrvanekrobe Jun 11, 2026
ef17329
Remove old ListeningPlane example
petrvanekrobe Jun 11, 2026
c496c7e
Refine ListeningPlaneHeatMap and Face node definitions
klinzey Jun 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
64 changes: 61 additions & 3 deletions gdtf-spec.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1214,6 +1214,7 @@ of geometry collect are specified in [table 34](#user-content-table-34 ).
| [Structure](#user-content-geometry-type-structure ) | Any | Geometry that describes the internal framing of an object (like members). |
| [Support](#user-content-geometry-type-support ) | Any | Geometry that describes a support like a base plate or a hoist. |
| [Magnet](#user-content-geometry-type-magnet ) | Any | Geometry that describes a point where other geometries should be attached. |
| [Speaker](#user-content-geometry-type-audio ) | Any | Geometry that describes a audio source. |


</div>
Expand Down Expand Up @@ -1716,7 +1717,7 @@ defined XML attributes of a structure geometry are specified in
| 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 |
| LinkedGeometry | [Name](#user-content-attrtype-name ) | The linked geometry. |
| StructureType | [Enum](#user-content-attrtype-enum ) | The type of structure. Defined values are "CenterLineBased", "Detail". |
| StructureType | [Enum](#user-content-attrtype-enum ) | The type of structure. Defined values are "CenterLineBased", "Detail", "SpeakerBumper". |
| CrossSectionType <a id="attrtype-crosssectiontype" /> | [Enum](#user-content-attrtype-enum ) | The type of cross section. Defined values are "TrussFramework", "Tube". |
| CrossSectionHeight | [Float](#user-content-attrtype-float ) | The height of the cross section. Only for [Tubes](#user-content-attrtype-crosssectiontype ). Unit: meter. |
| CrossSectionWallThickness | [Float](#user-content-attrtype-float ) | The thickness of the wall of the cross section.Only for [Tubes](#user-content-attrtype-crosssectiontype ). Unit: meter. |
Expand Down Expand Up @@ -1783,12 +1784,69 @@ defined XML attributes of a magnet geometry are specified in
| 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 |

The magnet geometry has the same children types as the geometry
collect (see [table 34](#user-content-table-34 )).

</div>
### Geometry Type HangingPoint

The magnet geometry has the same children types as the geometry
This type of geometry is used to describe a hanging point, a point for attachment (XML node `<HangingPoint>`). The currently
defined XML attributes of a hanging point geometry are specified in
[table xx](#user-content-table-xx ).

<div id="table-xx">

#### Table 55. *HangingPoint 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 |

The hanging point geometry has the same children types as the geometry
collect (see [table 34](#user-content-table-34 )).

### Geometry Type Speaker

This type of geometry is used to describe a speaker in a audio device. (XML node `<Speaker>`). The currently
defined XML attributes of a speaker geometry are specified in
[table 55](#user-content-table-XX ).


<div id="table-XX">

#### 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. |
| 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 |
| 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?)|

</div>

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 )


## DMX Mode Collect

### General
Expand Down
Loading
Loading