| 1 Definition | 2 Functional Requirements | 3 Syntax | 4 Semantics |
1 Definition
The Action of a User requesting that a Locate Service modify the characteristics of an Item:
1. Change the Perceptibility of the Item.
2. Apply an affine transformation to the Item.
3. Change the attributes of
4.1 SourceType, ColourInfo, Intensity (if a Light Source)
4.2 SourceType (If an Audio Source)
4.3 Mass, Material, Gravity Property, TextureMap (if a Basic Visual Object or a Basic 3D Object)
5. Set the perceptibility status of an Item.
6. Display a specific Personal Status (if a Persona).
7. Grant Rights to the MM-PropertyChanged Item based on Model Rights.
If the request is accepted, the Locate Service responds changes the properties as requested and provides actual Rights to the requesting User.
2 Functional Requirements
The MM-Embed Process Action includes:
In the request
– One of
– The ID Item to be Property Changed.
– The M-Location wrapping the Item.
– A set of parameters selected from Property Change Parameters.
– The Model Rights to the Property Changed Item.
– A Transaction if requested by the Locate Service.
In the response
– The Rights per the Model Rights if request is successful.
3 Syntax
https://schemas.mpai.community/MMM4/V2.1/actions/PropertyChangePA.json
4 Semantics
| Label | Description |
| Header | MM-Embed Process Action Header |
| – Standard-PropertyChangePA | The characters “MMM-PCP-V” |
| – Version | Major version – 1 or 2 characters |
| – Dot-separator | The character “.” |
| – Subversion | Minor version – 1 or 2 characters |
| MInstanceID | Identifier of M-Instance. |
| MEnvironmentID | Identifier of M-Environment. |
| PropertyChangePAData | Data included in the MM-Embed Process Action. |
| – Time | Time of PA request emission and Time of PA request execution. |
| – RQ-Complements | Complements in the PA Request. |
| – Nil ItemID | Item whose Properties are to be Changed. |
| – At MLocationID | M-Location where the Item is MM-Added. |
| – With PerceptibilityStatus | 0= non perceptible, 1 = perceptible. |
| – With Resize | Resize the Item by Rx, Ry, Rz where x, y, and z are the Objects axes rotated according to an Orientation. |
| – With 3DModelObject | Change Mass, Material Property, and Gravity Property, TextureMap, Object Audio Characteristics. |
| – With VisualObject | Change Mass, Gravity and Material Property, TextureMap, Object Audio Characteristics. |
| – With ObjectAudioCharacteristics | (OAC) Change the audio characteristics of an Item. |
| – With LightSource | Change any of SourceType, ColourInfo, Intensity. |
| – With AudioSource | Change Source Type. |
| – With PersonalStatus | Display a specific Personal Status (if a Persona). |
| – With ModelRights | Rights that are requested to the Property Changed Item. |
| – With Transaction | Transaction made to Locate Service if requested. |
| – RS-Complements | Complements in the PA Request. |
| – With Rights | Actual Rights based on Model Rights if PA Request is accepted. |
| – With PAStatus | Possible Error Messages. |
| – Ack | If PA Request could be performed. |
| – Err | If PA Request could not be performed. |
| – FaultyPA | Faulty PA Request. |
| – IncID | Incorrect ID. |
| – MLocOOR | M-Location out of range. |
| – InsRights | Insufficient Rights. |
| – InsValue | Insufficient Value in Wallet. |
| DescMetadata | Descriptive Metadata. |
