Functions
Ref. Architecture
I/O Data
SubAIMs
JSON Metadata
Profiles
Ref. Software
Conformance
Performance
1 Functions
The Audio Scene Editing (CAE-ASE) AIM:
| Receives | User Command RQ (CAE-UCM) | From the User: one per User action. |
| Audio Object (OSD-AUO) | An Audio Object to place in the open Scene, from Audio Object Editing. | |
| Audio Scene Descriptors (OSD-ASD) | The Audio Scene to open. | |
| Produces | Audio Scene Descriptors (OSD-ASD) | The open Audio Scene, as edited. |
| User Command RS (CAE-UCM) | The User Command with its response. |
One Audio Scene is open at a time, so that a User Command need not name it: an Audio Scene arriving at the Input Port is opened, and the first Audio Object added when no Scene is open creates one. Objects and Scenes are identified by the name the User gave them (“violin”, “concert”). Every amount in a User Command is a number it carries, and a User Command is absolute: it places an Object at a position and orientation, it moves an Object to a new position and orientation, it does not move it by an amount. A User Command acts on the open Audio Scene:
- Added Objects – places the named Audio Objects in the Scene, each with its Spatial Attitude, a position and an orientation given as numbers. The name of the Scene the command creates, when none is open, is given in the command; a name that is taken becomes the name followed by the next free number (“concert 2”).
- Moved Objects – moves an Object, named, to its new Spatial Attitude; the new Spatial Attitude is required.
- Changed Objects – changes where the Objects are.
- Removed Objects – takes Objects out of the Scene.
- Deleted Objects – deletes, from where the Module keeps them, the Audio Scenes named, by the name the User gave them, with all their versions. A Scene is deleted without its members: they stay kept. A name that is not known fails. Deleting is not removing: Removed Objects takes an Object out of the open Scene and leaves it kept.
- User PoV – sets where the Scene is heard from; the User Point of View is carried by the User Command (UserPoV).
- Listed Objects – lists Audio Scenes (Kind Audio Scene). For a Scene named in the request the response gives the number of its members and, for each member, its name and its PoV: its position and orientation as provided in the Scene. No Object is touched.
Every edit is a new version, which has the name of the Scene. The AIM produces Audio Scene Descriptors; it has no Basic Data Type at its Ports. The response (UserCommandRS) says how each action was executed.
2 Reference Model
Figure 1 depicts the Reference Model of the Audio Scene Editing (CAE-ASE) AIM.
Figure 1 – The Reference Model of the Audio Scene Editing (CAE-ASE) AIM
3 I/O Data
Table 1 specifies the Input and Output Data of the Audio Scene Editing (CAE-ASE) AIM. A Port is addressed by its Data Type and its Port Number (#); where the metadata gives none, none is shown.
| Input | Description |
| Audio Object (OSD-AUO) | An Audio Object that may be placed in the Scene, from Audio Object Editing. |
| Audio Scene Descriptors (OSD-ASD) | The Audio Scene to open. |
| User Command RQ (CAE-UCM) | Instruction directing the operation of the CAE-ASE AIM. It carries the User Point of View (UserPoV). |
| Output | Description |
| Audio Scene Descriptors (OSD-ASD) | The open Audio Scene after the User Command. |
| User Command RS (CAE-UCM) | The response to the User Command. |
4 SubAIMs
No SubAIMs.
5 JSON Metadata
https://schemas.mpai.community/CAE3/V1.0/AIMs/AudioSceneEditing.json
6 Profiles
No Profiles.
7 Reference Software
See Reference Software.
8 Conformance Testing
Table 2 provides the Conformance Testing Method for the Audio Scene Editing (CAE-ASE) AIM.
If a schema contains references to other schemas, conformance of data for the primary schema implies that any data referencing a secondary schema shall also validate against the relevant schema, if present, and conform with the Qualifier, if present.
| Receives | Audio Object (OSD-AUO) | Shall validate against the Audio Object schema. |
| Audio Scene Descriptors (OSD-ASD) | Shall validate against the Audio Scene Descriptors schema. | |
| User Command RQ (CAE-UCM) | Shall validate against the User Command schema, and contain a UserCommandRQ. | |
| Produces | Audio Scene Descriptors (OSD-ASD) | Shall validate against the Audio Scene Descriptors schema. |
| User Command RS (CAE-UCM) | Shall validate against the User Command schema, and contain a UserCommandRS. |
9 Performance Assessment
Not part of this specification.
